From b273c4e8bfb87d9e1bfa4b770fba76f40d6f627f Mon Sep 17 00:00:00 2001 From: Marijn Suijten Date: Tue, 5 Jan 2021 02:44:18 +0100 Subject: [PATCH] gir-files: Re-run fix.sh on freshly imported files Rerunning it on existing files doesn't perform all whitespace cleanup when nodes are not modified. --- gir-files/GES-1.0.gir | 925 +------ gir-files/GLib-2.0.gir | 2331 ----------------- gir-files/GModule-2.0.gir | 15 - gir-files/GObject-2.0.gir | 768 ------ gir-files/Gio-2.0.gir | 4125 ------------------------------- gir-files/Gst-1.0.gir | 2852 +-------------------- gir-files/GstAllocators-1.0.gir | 37 - gir-files/GstApp-1.0.gir | 96 +- gir-files/GstAudio-1.0.gir | 644 +---- gir-files/GstBase-1.0.gir | 760 +----- gir-files/GstCheck-1.0.gir | 179 +- gir-files/GstController-1.0.gir | 92 +- gir-files/GstGL-1.0.gir | 668 +---- gir-files/GstGLEGL-1.0.gir | 41 - gir-files/GstGLWayland-1.0.gir | 9 - gir-files/GstGLX11-1.0.gir | 9 - gir-files/GstMpegts-1.0.gir | 217 -- gir-files/GstNet-1.0.gir | 74 +- gir-files/GstPbutils-1.0.gir | 270 +- gir-files/GstPlayer-1.0.gir | 201 +- gir-files/GstRtp-1.0.gir | 318 +-- gir-files/GstRtsp-1.0.gir | 216 -- gir-files/GstRtspServer-1.0.gir | 822 +----- gir-files/GstSdp-1.0.gir | 227 +- gir-files/GstTag-1.0.gir | 121 +- gir-files/GstVideo-1.0.gir | 943 +------ gir-files/GstWebRTC-1.0.gir | 79 - 27 files changed, 162 insertions(+), 16877 deletions(-) diff --git a/gir-files/GES-1.0.gir b/gir-files/GES-1.0.gir index 5d632241b..69300ef1c 100644 --- a/gir-files/GES-1.0.gir +++ b/gir-files/GES-1.0.gir @@ -13,7 +13,6 @@ and/or use gtk-doc annotations. --> A datatype to hold a frame number. - @@ -110,7 +109,6 @@ its default and be returned on requests, but the others will be ordered to take its place once it is removed. You can add a proxy to an asset, or set its default, using ges_asset_set_proxy(), and you can remove them with ges_asset_unproxy(). - @@ -124,7 +122,6 @@ available. Note, the asset is not immediately changed, but will only actually reload on the next call to ges_asset_request() or ges_asset_request_async(). - %TRUE if the specified asset exists in the cache and could be marked for reloading. @@ -176,7 +173,6 @@ assets, such as #GESUriClip. For such assets this method will fail, and you should use ges_asset_request_async() instead. In the case of #GESUriClip, you can use ges_uri_clip_asset_request_sync() if you only want to wait for the request to finish. - A reference to the requested asset, or %NULL if an error occurred. @@ -237,7 +233,6 @@ asset_loaded_cb (GESAsset * source, GAsyncResult * res, gpointer user_data) ges_asset_request_async (GES_TYPE_URI_CLIP, some_uri, NULL, (GAsyncReadyCallback) asset_loaded_cb, user_data); ``` - @@ -268,7 +263,6 @@ asset request, or %NULL to ignore Fetches an asset requested by ges_asset_request_async(), which finalises the request. - The requested asset, or %NULL if an error occurred. @@ -285,7 +279,6 @@ occurred. Extracts a new #GESAsset:extractable-type object from the asset. The #GESAsset:id of the asset may determine the properties and state of the newly created object. - A newly created object, or %NULL if an error occurred. @@ -299,7 +292,6 @@ error occurred. - @@ -313,7 +305,6 @@ error occurred. - @@ -327,7 +318,6 @@ error occurred. - @@ -344,7 +334,6 @@ error occurred. - @@ -358,7 +347,6 @@ error occurred. Extracts a new #GESAsset:extractable-type object from the asset. The #GESAsset:id of the asset may determine the properties and state of the newly created object. - A newly created object, or %NULL if an error occurred. @@ -373,7 +361,6 @@ error occurred. Retrieve the error that was set on the asset when it was loaded. - The error set on @asset, or %NULL if no error occurred when @asset was loaded. @@ -388,7 +375,6 @@ error occurred. Gets the #GESAsset:extractable-type of the asset. - The extractable type of @self. @@ -402,7 +388,6 @@ error occurred. Gets the #GESAsset:id of the asset. - The ID of @self. @@ -416,7 +401,6 @@ error occurred. Gets the default #GESAsset:proxy of the asset. - The default proxy of @asset. @@ -433,7 +417,6 @@ error occurred. Note that the proxy target may have loaded with an error, so you should call ges_asset_get_error() on the returned target. - The asset that @proxy is a proxy of. @@ -450,7 +433,6 @@ of. Get all the proxies that the asset has. The first item of the list will be the default #GESAsset:proxy. The second will be the proxy that is 'next in line' to be default, and so on. - The list of proxies that @asset has. @@ -480,7 +462,6 @@ Note that an asset can only act as a proxy for one other asset. As a special case, if @proxy is %NULL, then this method will actually remove **all** proxies from the asset. - %TRUE if @proxy was successfully set as the default for @asset. @@ -503,7 +484,6 @@ the given proxy is the default proxy of the list, then the next proxy in the available list (see ges_asset_list_proxies()) will become the default. If there are no other proxies, then the asset will no longer have a default #GESAsset:proxy. - %TRUE if @proxy was successfully removed from @asset's proxy list. @@ -573,13 +553,11 @@ asset it is now the proxy of/no longer the proxy of. - - @@ -592,7 +570,6 @@ asset it is now the proxy of/no longer the proxy of. - A newly created object, or %NULL if an error occurred. @@ -608,7 +585,6 @@ error occurred. - @@ -624,7 +600,6 @@ error occurred. - @@ -640,7 +615,6 @@ error occurred. - @@ -664,7 +638,6 @@ error occurred. - Indicates that an error occurred @@ -677,9 +650,7 @@ asynchronously error - - - + ## Children Properties @@ -688,7 +659,6 @@ You can use the following children properties through the - #gdouble `volume`: volume factor, 1.0=100%. - #gboolean `mute`: mute channel. - @@ -704,13 +674,11 @@ You can use the following children properties through the - - @@ -727,19 +695,15 @@ You can use the following children properties through the - - - + Outputs a test audio stream using audiotestsrc. The default property values output silence. Useful for testing pipelines, or to fill gaps in an audio track. - Get the current frequency of @self. - The current frequency of @self. @@ -753,7 +717,6 @@ track. Get the current volume of @self. - The current volume of @self @@ -767,7 +730,6 @@ track. Lets you set the frequency applied on the track element - @@ -784,7 +746,6 @@ track. Sets the volume of the test audio signal. - @@ -812,7 +773,6 @@ track. - @@ -822,9 +782,7 @@ track. - - - + A #GESAudioTrack is a default audio #GESTrack, with a #GES_TRACK_TYPE_AUDIO #GESTrack:track-type and "audio/x-raw(ANY)" @@ -844,7 +802,6 @@ ges_track_update_restriction_caps() with new values for the fields you wish to change, and any additional fields you may want to add. Unlike using ges_track_set_restriction_caps(), this will ensure that these default fields will at least have some value set. - @@ -859,7 +816,6 @@ default fields will at least have some value set. You should use ges_track_update_restriction_caps() if you wish to modify these fields, or add additional ones. - The newly created audio track. @@ -878,7 +834,6 @@ modify these fields, or add additional ones. - @@ -888,18 +843,14 @@ modify these fields, or add additional ones. - - - + - Creates a new #GESAudioTransition. This should never be called by applications as this will be created by clips. - The newly created #GESAudioTransition. @@ -918,7 +869,6 @@ be created by clips. - @@ -928,14 +878,11 @@ be created by clips. - - - + ### Children Properties {{ libs/GESVideoUriSource-children-props.md }} - @@ -958,7 +905,6 @@ be created by clips. - @@ -968,9 +914,7 @@ be created by clips. - - - + A #GESBaseEffect is some operation that applies an effect to the data it receives. @@ -1021,14 +965,12 @@ obeys: Note that a constant-rate-change effect that is not extremely fast or slow would satisfy these conditions. For such effects, you may wish to use ges_effect_class_register_rate_property(). - Get whether the effect is considered a time effect or not. An effect with registered time properties or set translation functions is considered a time effect. - %TRUE if @effect is considered a time effect. @@ -1050,7 +992,6 @@ ges_base_effect_set_time_translation_funcs(). Note that @effect must not be part of a clip, nor can it have #GESTrackElement:has-internal-source set to %TRUE. - %TRUE if the child property was found and newly registered. @@ -1087,7 +1028,6 @@ use the currently set values. Note that @effect must not be part of a clip, nor can it have #GESTrackElement:has-internal-source set to %TRUE. - %TRUE if the translation functions were set. @@ -1134,7 +1074,6 @@ source coordinates of @effect - parent class @@ -1158,7 +1097,6 @@ of the core effects of the clip that they share a #GESTrack with. See Note that you cannot add time effects to #GESBaseEffectClip, neither as core children, nor as additional effects. - @@ -1174,7 +1112,6 @@ as core children, nor as additional effects. - @@ -1184,12 +1121,8 @@ as core children, nor as additional effects. - - - - - - + + A function for querying how an effect would translate a time if it had the given child property values set. The keys for @time_properties will @@ -1197,7 +1130,6 @@ be the same string that was passed to ges_base_effect_register_time_property(), the values will be #GValue* values of the corresponding child properties. You should always use the values given in @time_properties before using the currently set values. - The translated time. @@ -1226,7 +1158,6 @@ property name/value pairs - @@ -1242,7 +1173,6 @@ property name/value pairs - @@ -1252,11 +1182,8 @@ property name/value pairs - - - + - @@ -1274,7 +1201,6 @@ property name/value pairs - @@ -1283,7 +1209,6 @@ property name/value pairs - @@ -1303,13 +1228,10 @@ property name/value pairs - - - + Whether the class allows for the user to add additional non-core #GESBaseEffect-s to clips from this class. - A #GESClipClass @@ -1318,7 +1240,6 @@ property name/value pairs The #GList containing the children of @obj. - a #GESContainer @@ -1327,7 +1248,6 @@ property name/value pairs The #GESContainer:height of @obj. - a #GESContainer @@ -1337,7 +1257,6 @@ property name/value pairs To be used by subclasses only. This indicate how to handle a change in a child. - @@ -1527,11 +1446,9 @@ do_time_effect_change (GESClip * clip) gst_object_unref (source); } ``` - - The #GESTrackElement created by @clip, or %NULL if @clip can not provide a track element for the @@ -1550,7 +1467,6 @@ given @type or an error occurred. - A list of the #GESTrackElement-s created by @clip for the given @type, or %NULL @@ -1575,7 +1491,6 @@ if no track elements are created or an error occurred. This can be used to add effects that derive from the asset to the clip, but this method is not intended to be used to create the core elements of the clip. - The newly created element, or %NULL if an error occurred. @@ -1616,7 +1531,6 @@ This method can also fail if the adding the track element to the track would break a configuration rule of the corresponding #GESTimeline, such as causing three sources to overlap at a single time, or causing a source to completely overlap another in the same track. - The element that was added to @track, either @child or a copy of child, or %NULL if the element could not be added. @@ -1650,7 +1564,6 @@ and #GESBaseEffectClip) can have additional top effects added. Note, if the effect is a time effect, this may be refused if the clip would not be able to adapt itself once the effect is added. - %TRUE if @effect was successfully added to @clip at @index. @@ -1680,7 +1593,6 @@ Note, if multiple track elements in the clip match the given criteria, this will return the element amongst them with the highest #GESTimelineElement:priority (numerically, the smallest). See ges_clip_find_track_elements() if you wish to find all such elements. - The element controlled by @clip, in @track, and of the given @type, or %NULL if no such element @@ -1723,7 +1635,6 @@ of the same type. You may also give @type to _further_ restrict the search to track elements of the given @type. - A list of all the #GESTrackElement-s controlled by @clip, in @track or of the given @@ -1756,7 +1667,6 @@ match any type Gets the #GESClip:duration-limit of the clip. - The duration-limit of @clip. @@ -1806,7 +1716,6 @@ child. See ges_clip_get_timeline_time_from_internal_time(), which performs the reverse. - The time in the internal coordinates of @child corresponding to @timeline_time, or #GST_CLOCK_TIME_NONE if the conversion could not @@ -1831,7 +1740,6 @@ be performed. Gets the #GESClip:layer of the clip. - The layer @clip is in, or %NULL if @clip is not in any layer. @@ -1846,7 +1754,6 @@ be performed. Gets the #GESClip:supported-formats of the clip. - The #GESTrackType-s supported by @clip. @@ -1902,7 +1809,6 @@ using this position to trim the end of a clip. See ges_clip_get_internal_time_from_timeline_time(), which performs the reverse, or ges_clip_get_timeline_time_from_source_frame() which does the same conversion, but using frame numbers. - The time in the timeline coordinates corresponding to @internal_time, or #GST_CLOCK_TIME_NONE if the conversion could not be @@ -1936,7 +1842,6 @@ frame. Note that you can get the frame timestamp of a particular clip asset with ges_clip_asset_get_frame_time(). - The timestamp corresponding to @frame_number in the core children of @clip, in the timeline coordinates, or #GST_CLOCK_TIME_NONE @@ -1962,7 +1867,6 @@ effects. If two effects share the same #GESTrackElement:track, the effect with the numerically lower index will be applied to the source data **after** the other effect, i.e. output data will always flow from a higher index effect to a lower index effect. - The index of @effect in @clip, or -1 if something went wrong. @@ -1979,7 +1883,6 @@ a higher index effect to a lower index effect. - @@ -1996,7 +1899,6 @@ a higher index effect to a lower index effect. Gets the #GESBaseEffect-s that have been added to the clip. The returned list is ordered by their internal index in the clip. See ges_clip_get_top_effect_index(). - A list of all #GESBaseEffect-s that have been added to @clip. @@ -2013,7 +1915,6 @@ ges_clip_get_top_effect_index(). See ges_clip_move_to_layer_full(), which also gives an error. - %TRUE if @clip was successfully moved to @layer. @@ -2033,7 +1934,6 @@ ges_clip_get_top_effect_index(). Moves a clip to a new layer. If the clip already exists in a layer, it is first removed from its current layer before being added to the new layer. - %TRUE if @clip was successfully moved to @layer. @@ -2054,7 +1954,6 @@ layer. Note, if the effect is a time effect, this may be refused if the clip would not be able to adapt itself once the effect is removed. - %TRUE if @effect was successfully added to @clip at @index. @@ -2074,7 +1973,6 @@ would not be able to adapt itself once the effect is removed. Sets the #GESClip:supported-formats of the clip. This should normally only be called by subclasses, which should be responsible for updating its value, rather than the user. - @@ -2091,7 +1989,6 @@ its value, rather than the user. See ges_clip_set_top_effect_index_full(), which also gives an error. - %TRUE if @effect was successfully moved to @newindex. @@ -2117,7 +2014,6 @@ ges_clip_get_top_effect_index(). The new index must be an existing index of the clip. The effect is moved to the new index, and the other effects may be shifted in index accordingly to otherwise maintain the ordering. - %TRUE if @effect was successfully moved to @newindex. @@ -2138,7 +2034,6 @@ ordering. - @@ -2156,7 +2051,6 @@ ordering. See ges_clip_split_full(), which also gives an error. - The newly created clip resulting from the splitting @clip, or %NULL if @clip can't be split. @@ -2201,7 +2095,6 @@ result if you place the clip in a separate sub #GESProject, which only contains this clip (and its effects), and in the original layer create two neighbouring #GESUriClip-s that reference this sub-project, but at a different #GESTimelineElement:in-point. - The newly created clip resulting from the splitting @clip, or %NULL if @clip can't be split. @@ -2267,13 +2160,11 @@ signal emission may be stopped internally. The #GESUriClipAsset is a special #GESAsset specilized in #GESClip. it is mostly used to get information about the #GESTrackType-s the objects extracted from it can potentialy create #GESTrackElement for. - Result: %TRUE if @self has a natural framerate %FALSE otherwise - %TRUE if @self has a natural framerate @FALSE otherwise. @@ -2299,7 +2190,6 @@ rate of the asset. You can use this to reference a specific frame in a media file and use this as, for example, the `in-point` or `max-duration` of a #GESClip. - The timestamp corresponding to @frame_number in the element source, given in internal time coordinates, or #GST_CLOCK_TIME_NONE if the clip asset does not have a @@ -2319,7 +2209,6 @@ natural frame rate. Result: %TRUE if @self has a natural framerate %FALSE otherwise - @@ -2340,7 +2229,6 @@ natural frame rate. Gets track types for which objects extracted from @self can create #GESTrackElement - The track types on which @self will create TrackElement when added to a layer @@ -2355,7 +2243,6 @@ a layer Sets track types for which objects extracted from @self can create #GESTrackElement - @@ -2387,13 +2274,11 @@ a layer - - %TRUE if @self has a natural framerate @FALSE otherwise. @@ -2420,11 +2305,8 @@ a layer - - - + - @@ -2444,28 +2326,22 @@ is implemented, this should be kept as the default implementation - - - - - + - - @@ -2486,14 +2362,11 @@ is implemented, this should be kept as the default implementation - - - - + A #GESContainer is a timeline element that controls other #GESTimelineElement-s, which are its children. In particular, it is @@ -2503,7 +2376,6 @@ container is temporally adjusted or moved to a new layer, it may accordingly adjust and move its children. Similarly, a change in one of its children may prompt the parent to correspondingly change its siblings. - @@ -2517,7 +2389,6 @@ and #GESTimelineElement:in-point; exist in the same layer; and all of the sources share the same #GESAsset. If this fails, or one of the elements is not a #GESClip, this method will try to create a #GESGroup instead. - The container created by merging @containers, or %NULL if they could not be merged into a single @@ -2535,7 +2406,6 @@ The #GESContainer-s to group - @@ -2549,7 +2419,6 @@ The #GESContainer-s to group - @@ -2563,7 +2432,6 @@ The #GESContainer-s to group - @@ -2579,7 +2447,6 @@ The #GESContainer-s to group Edits the container within its timeline. use #ges_timeline_element_edit instead. - %TRUE if the edit of @container completed, %FALSE on failure. @@ -2618,7 +2485,6 @@ be moved to. -1 means no move - @@ -2643,7 +2509,6 @@ an audio clip and a video clip), where each clip contains all the If @recursive is %TRUE, and the container contains other containers as children, then they will also be ungrouped, and so on. - The list of new #GESContainer-s created from the splitting of @container. @@ -2673,7 +2538,6 @@ Additionally, the children properties of the newly added element will be shared with the container, meaning they can also be read and set using ges_timeline_element_get_child_property() and ges_timeline_element_set_child_property() on the container. - %TRUE if @child was successfully added to @container. @@ -2692,7 +2556,6 @@ ges_timeline_element_set_child_property() on the container. Edits the container within its timeline. use #ges_timeline_element_edit instead. - %TRUE if the edit of @container completed, %FALSE on failure. @@ -2735,7 +2598,6 @@ be moved to. -1 means no move @recursive is %TRUE, and the container contains other containers as children, then their children will be added to the list, in addition to themselves, and so on. - The list of #GESTimelineElement-s contained in @container. @@ -2757,7 +2619,6 @@ themselves, and so on. Removes a timeline element from the container. The element will no longer be controlled by the container. - %TRUE if @child was successfully removed from @container. @@ -2785,7 +2646,6 @@ an audio clip and a video clip), where each clip contains all the If @recursive is %TRUE, and the container contains other containers as children, then they will also be ungrouped, and so on. - The list of new #GESContainer-s created from the splitting of @container. @@ -2867,13 +2727,11 @@ may be stopped internally. - - @@ -2889,7 +2747,6 @@ may be stopped internally. - @@ -2905,7 +2762,6 @@ may be stopped internally. - @@ -2921,7 +2777,6 @@ may be stopped internally. - @@ -2937,7 +2792,6 @@ may be stopped internally. - The list of new #GESContainer-s created from the splitting of @container. @@ -2959,7 +2813,6 @@ new #GESContainer-s created from the splitting of @container. - @@ -2974,7 +2827,6 @@ new #GESContainer-s created from the splitting of @container. - %TRUE if the edit of @container completed, %FALSE on failure. @@ -3022,14 +2874,11 @@ be moved to. -1 means no move - - - + A function that creates a #GstElement that can be used as a source to fill the gaps of the track. A gap is a timeline region where the track has no #GESTrackElement sources. - A source #GstElement to fill gaps in @track. @@ -3047,7 +2896,6 @@ to a #GESTrack of the given track type. If a clip may produce several track elements per track type, #GESCreateTrackElementsFunc is more appropriate. - The #GESTrackElement created by @clip, or %NULL if @clip can not provide a track element for the @@ -3068,7 +2916,6 @@ given @type or an error occurred. A method for creating the core #GESTrackElement-s of a clip, to be added to #GESTrack-s of the given track type. - A list of the #GESTrackElement-s created by @clip for the given @type, or %NULL @@ -3090,7 +2937,6 @@ if no track elements are created or an error occurred. - @@ -3101,14 +2947,12 @@ if no track elements are created or an error occurred. - - @@ -3116,21 +2960,17 @@ if no track elements are created or an error occurred. The edges of an object contain in a #GESTimeline or #GESTrack - Represents the start of an object. - Represents the end of an object. - Represent the fact we are not working with any edge of an object. - A human friendly name for @edge @@ -3240,7 +3080,6 @@ by the same amount such that the snapped edges will touch. You can also find more explanation about the behaviour of those modes at: [trim, ripple and roll](http://pitivi.org/manual/trimming.html) and [clip management](http://pitivi.org/manual/usingclips.html). - The element is edited the normal way (default). If acting on the element as a whole (#GES_EDGE_NONE), this will MOVE @@ -3252,7 +3091,6 @@ and [clip management](http://pitivi.org/manual/usingclips.html). of the element (#GES_EDGE_END), this will END-TRIM the element, leaving its toplevel unchanged. - The element is edited in ripple mode: moving itself as well as later elements, keeping their relative times. This @@ -3267,7 +3105,6 @@ and [clip management](http://pitivi.org/manual/usingclips.html). edited element. These additional elements will also be shifted by the same shift in layers as the edited element. - The element is edited in roll mode: swapping its content for its neighbour's, or vis versa, in the timeline output. @@ -3286,14 +3123,12 @@ and [clip management](http://pitivi.org/manual/usingclips.html). whole (#GES_EDGE_NONE) is not defined. The element can not shift layers under this mode. - The element is edited in trim mode. When acting on the start of the element, this will START-TRIM it. When acting on the end of the element, this will END-TRIM it. Acting on the element as a whole (#GES_EDGE_NONE) is not defined. - The element is edited in slide mode (not yet implemented): moving the element replacing or consuming content on @@ -3309,7 +3144,6 @@ and [clip management](http://pitivi.org/manual/usingclips.html). Return a string representation of @mode. - a string representation of @mode. @@ -3331,7 +3165,6 @@ GES will always request at most one sinkpad per effect (when required). > Note: GES always adds converters (`audioconvert ! audioresample ! > audioconvert` for audio effects and `videoconvert` for video effects) to > make it simpler for end users. - @@ -3341,7 +3174,6 @@ possible to determine the type of the effect through the element In that corner case, you should use: #ges_asset_request (GES_TYPE_EFFECT, "audio your ! bin ! description", NULL); and extract that asset to be in full control. - a newly created #GESEffect, or %NULL if something went wrong. @@ -3376,7 +3208,6 @@ Example: "videobalance saturation=1.5 hue=+0.5" This asset has a GStreamer bin-description as ID and is able to determine to what track type the effect should be used in. - @@ -3393,7 +3224,6 @@ to what track type the effect should be used in. - @@ -3403,11 +3233,8 @@ to what track type the effect should be used in. - - - + - parent class @@ -3448,7 +3275,6 @@ Note, you can obtain a reference to the GESEffectClass using ``` GES_EFFECT_CLASS (g_type_class_ref (GES_TYPE_EFFECT)); ``` - %TRUE if the rate property was successfully registered. When this method returns %FALSE, a warning is emitted with more information. @@ -3480,12 +3306,10 @@ The asset ID of an effect clip is in the form: ``` "audio ! bin ! description || video ! bin ! description" ``` - Creates a new #GESEffectClip from the description of the bin. - a newly created #GESEffectClip, or %NULL if something went wrong. @@ -3529,7 +3353,6 @@ Example: "videobalance saturation=1.5 hue=+0.5" - @@ -3539,14 +3362,9 @@ Example: "videobalance saturation=1.5 hue=+0.5" - - - - - - + + - The ID passed is malformed @@ -3597,7 +3415,6 @@ the default. After the object is extracted, it will have a reference to the asset it came from, which you can retrieve using ges_extractable_get_asset(). - Gets the #GESAsset:id of some associated asset. It may be the case @@ -3607,7 +3424,6 @@ yet exist in the GES cache. Instead, this will return the asset as determined by the #GESExtractable implementer. If it was indeed extracted from an asset, this should return the same as its corresponding asset #GESAsset:id. - The #GESAsset:id of some associated #GESAsset that is compatible with @self's current state. @@ -3621,7 +3437,6 @@ that is compatible with @self's current state. - @@ -3635,7 +3450,6 @@ that is compatible with @self's current state. - @@ -3650,7 +3464,6 @@ that is compatible with @self's current state. Get the asset that has been set on the extractable object. - The asset set on @self, or %NULL if no asset has been set. @@ -3671,7 +3484,6 @@ yet exist in the GES cache. Instead, this will return the asset as determined by the #GESExtractable implementer. If it was indeed extracted from an asset, this should return the same as its corresponding asset #GESAsset:id. - The #GESAsset:id of some associated #GESAsset that is compatible with @self's current state. @@ -3696,7 +3508,6 @@ means and does not yet have an asset. Or, for some implementations of #GESExtractable, you can use this to change the asset of the given extractable object, which will lead to a change in its state to match the new asset #GESAsset:id. - %TRUE if @asset could be successfully set on @self. @@ -3721,7 +3532,6 @@ with different #GESAsset:id, that would otherwise act the same. Returns (transfer full) (nullable): The actual #GESAsset:id to set on any corresponding assets, based on @id, or %NULL if @id is not valid. - @@ -3737,7 +3547,6 @@ any corresponding assets, based on @id, or %NULL if @id is not valid. - @@ -3769,7 +3578,6 @@ the new asset on the object. - @@ -3785,7 +3593,6 @@ the new asset on the object. - @@ -3801,7 +3608,6 @@ the new asset on the object. - @@ -3817,7 +3623,6 @@ the new asset on the object. - The #GESAsset:id of some associated #GESAsset that is compatible with @self's current state. @@ -3833,7 +3638,6 @@ that is compatible with @self's current state. - @@ -3849,7 +3653,6 @@ that is compatible with @self's current state. - @@ -3874,7 +3677,6 @@ that is compatible with @self's current state. Tests if a given GESFrameNumber represents a valid frame - @@ -3882,7 +3684,6 @@ that is compatible with @self's current state. Constant to define an undefined frame number - @@ -3892,7 +3693,6 @@ track element needs to be filled. The implementer of this function shall add the proper #GstElement to @nleobj using gst_bin_add(). This method type is no longer used. - %TRUE if the implementer successfully filled the @nleobj. @@ -3914,12 +3714,10 @@ using gst_bin_add(). Base class for timeline data serialization and deserialization. - Checks if there is a #GESFormatter available which can load a #GESTimeline from the given URI. - TRUE if there is a #GESFormatter that can support the given uri or FALSE if not. @@ -3935,7 +3733,6 @@ or FALSE if not. Returns TRUE if there is a #GESFormatter available which can save a #GESTimeline to the given URI. - TRUE if the given @uri is supported, else FALSE. @@ -3950,14 +3747,12 @@ or FALSE if not. Get the default #GESAsset to use as formatter. It will return the asset for the #GESFormatter that has the highest @rank - The #GESAsset for the formatter with highest @rank - @@ -3973,7 +3768,6 @@ the asset for the #GESFormatter that has the highest @rank Load data from the given URI into timeline. Use @ges_timeline_load_from_uri - TRUE if the timeline data was successfully loaded from the URI, else FALSE. @@ -3997,7 +3791,6 @@ else FALSE. Save data from timeline to the given URI. Use @ges_timeline_save_to_uri - TRUE if the timeline data was successfully saved to the URI else FALSE. @@ -4025,7 +3818,6 @@ else FALSE. Load data from the given URI into timeline. Use @ges_timeline_load_from_uri - TRUE if the timeline data was successfully loaded from the URI, else FALSE. @@ -4049,7 +3841,6 @@ else FALSE. Save data from timeline to the given URI. Use @ges_timeline_save_to_uri - TRUE if the timeline data was successfully saved to the URI else FALSE. @@ -4093,7 +3884,6 @@ else FALSE. - @@ -4108,7 +3898,6 @@ else FALSE. GES Formatter class. Override the vmethods to implement the formatter functionnality. - the parent class structure @@ -4149,7 +3938,6 @@ else FALSE. - @@ -4193,7 +3981,6 @@ handles. Virtual method for loading a timeline from a given URI. Every #GESFormatter subclass needs to implement this method. - TRUE if the timeline data was successfully loaded from the URI, else FALSE. @@ -4214,14 +4001,11 @@ else FALSE. - - - + Virtual method for saving a timeline to a uri. Every #GESFormatter subclass needs to implement this method. - TRUE if the timeline data was successfully saved to the URI else FALSE. @@ -4281,14 +4065,12 @@ ges_timeline_element_get_layer_priority() and ges_timeline_element_edit() a group is considered to have a layer priority that is the highest #GESLayer:priority (numerically, the smallest) of all the layers it spans. - Created a new empty group. You may wish to use ges_container_group() instead, which can return a different #GESContainer subclass if possible. - The new empty group. @@ -4337,7 +4119,6 @@ amongst its children. - @@ -4347,9 +4128,7 @@ amongst its children. - - - + Outputs the video stream from a given file as a still frame. The frame chosen will be determined by the in-point property on the track element. For image @@ -4357,7 +4136,6 @@ files, do not set the in-point property. This won't be used anymore and has been replaced by #GESUriSource instead which now plugs an `imagefreeze` element when #ges_uri_source_asset_is_image returns %TRUE. - @@ -4380,7 +4158,6 @@ files, do not set the in-point property. - @@ -4390,9 +4167,7 @@ files, do not set the in-point property. - - - + #GESLayer-s are responsible for collecting and ordering #GESClip-s. @@ -4412,19 +4187,16 @@ have its images shown first. The other layer will only have its image shown if the higher priority layer has no content at the given playtime, or is transparent in some way. Audio content in separate layers will simply play in addition. - Creates a new layer. - A new layer. - @@ -4437,7 +4209,6 @@ layers will simply play in addition. - @@ -4451,7 +4222,6 @@ layers will simply play in addition. - @@ -4466,7 +4236,6 @@ layers will simply play in addition. See ges_layer_add_asset_full(), which also gives an error. - The newly created clip. @@ -4506,7 +4275,6 @@ clip, or #GES_TRACK_TYPE_UNKNOWN to use the default Extracts a new clip from an asset and adds it to the layer with the given properties. - The newly created clip. @@ -4545,7 +4313,6 @@ clip, or #GES_TRACK_TYPE_UNKNOWN to use the default See ges_layer_add_clip_full(), which also gives an error. - %TRUE if @clip was properly added to @layer, or %FALSE if @layer refused to add @clip. @@ -4569,7 +4336,6 @@ will take ownership of the clip. This method will fail and return %FALSE if @clip already resides in some layer. It can also fail if the additional clip breaks some compositional rules (see #GESTimelineElement). - %TRUE if @clip was properly added to @layer, or %FALSE if @layer refused to add @clip. @@ -4589,7 +4355,6 @@ if @layer refused to add @clip. Gets whether the layer is active for the given track. See ges_layer_set_active_for_tracks(). - %TRUE if @layer is active for @track, or %FALSE otherwise. @@ -4607,7 +4372,6 @@ ges_layer_set_active_for_tracks(). Gets the #GESLayer:auto-transition of the layer. - %TRUE if transitions are automatically added to @layer. @@ -4621,7 +4385,6 @@ ges_layer_set_active_for_tracks(). Get the #GESClip-s contained in this layer. - A list of clips in @layer. @@ -4638,7 +4401,6 @@ ges_layer_set_active_for_tracks(). Gets the clips within the layer that appear between @start and @end. - A list of #GESClip-s that intersect the interval `[start, end)` in @layer. @@ -4665,7 +4427,6 @@ that intersect the interval `[start, end)` in @layer. Retrieves the duration of the layer, which is the difference between the start of the layer (always time 0) and the end (which will be the end time of the final clip). - The duration of @layer. @@ -4680,7 +4441,6 @@ be the end time of the final clip). Get the priority of the layer. When inside a timeline, this is its index in the timeline. See ges_timeline_move_layer(). - The priority of @layer within its timeline. @@ -4694,7 +4454,6 @@ index in the timeline. See ges_timeline_move_layer(). Gets the timeline that the layer is a part of. - The timeline that @layer is currently part of, or %NULL if it is not associated with any @@ -4711,7 +4470,6 @@ timeline. Convenience method to check if the layer is empty (doesn't contain any #GESClip), or not. - %TRUE if @layer is empty, %FALSE if it contains at least one clip. @@ -4726,7 +4484,6 @@ one clip. Removes the given clip from the layer. - %TRUE if @clip was removed from @layer, or %FALSE if the operation failed. @@ -4754,7 +4511,6 @@ active in the track, regardless of their individual Note that by default a layer will be active for all of its timeline's tracks. - %TRUE if the operation worked %FALSE otherwise. @@ -4785,7 +4541,6 @@ ges_timeline_set_auto_transition() if you want all layers within a method if you want different values for different layers (and make sure to keep #GESTimeline:auto-transition as %FALSE for the corresponding timeline). - @@ -4806,7 +4561,6 @@ the layer use #ges_timeline_move_layer instead. This deprecation means that you will not need to handle layer priorities at all yourself, GES will make sure there is never 'gaps' between layer priorities. - @@ -4822,7 +4576,6 @@ will make sure there is never 'gaps' between layer priorities. - @@ -4927,13 +4680,11 @@ which have been activated or deactivated Subclasses can override the @get_objects if they can provide a more efficient way of providing the list of contained #GESClip-s. - - @@ -4948,7 +4699,6 @@ efficient way of providing the list of contained #GESClip-s. - @@ -4964,7 +4714,6 @@ efficient way of providing the list of contained #GESClip-s. - @@ -4984,67 +4733,53 @@ efficient way of providing the list of contained #GESClip-s. - - - + The description of the object, to be used in various contexts (string). - The file extension of files produced by a #GESFormatter (string). - The mimetype used for the file produced by a #GESFormatter (string). - The name of a formatter, used as the #GESAsset:id for #GESFormatter assets (string). - The rank of a #GESFormatter (a #GstRank). - The version of a #GESFormatter (double). - The version of the format in which a project is serialized (string). - The ARGB color of a #GESMarker (an AARRGGBB hex as a uint). - The volume for a #GESTrack or a #GESLayer (float). - The default volume for a #GESTrack or a #GESLayer as a float. - - A timed #GESMetaContainer object. - Current position (in nanoseconds) of the #GESMarker @@ -5052,24 +4787,20 @@ assets (string). - A #GESMarker can be colored by setting the #GES_META_MARKER_COLOR meta. - Creates a new #GESMarkerList. - A new #GESMarkerList - The newly-added marker, the list keeps ownership of the marker @@ -5086,7 +4817,6 @@ of the marker - a #GList of the #GESMarker within the GESMarkerList. The user will have @@ -5103,7 +4833,6 @@ to unref each #GESMarker and free the #GList. Moves a @marker in a @list to a new @position - %TRUE if the marker could be moved, %FALSE otherwise (if the marker was not present in the list for example) @@ -5124,7 +4853,6 @@ to unref each #GESMarker and free the #GList. Removes @marker from @list, this decreases the refcount of the marker by 1. - %TRUE if the marker could be removed, %FALSE otherwise (if the marker was not present in the list for example) @@ -5140,7 +4868,6 @@ marker by 1. - The number of markers in @list @@ -5201,7 +4928,6 @@ marker by 1. - @@ -5230,12 +4956,10 @@ changed, it must be changed to a value of the same type. Internally, some GES objects will be initialized with static metadata fields. These will correspond to some standard keys, such as #GES_META_VOLUME. - Deserializes the given string, and adds and sets the found fields and their values on the container. The string should be the return of ges_meta_container_metas_to_string(). - %TRUE if the fields in @str was successfully deserialized and added to @container. @@ -5257,7 +4981,6 @@ and added to @container. gets the registered type and flags of the field, as used in ges_meta_container_register_meta() and ges_meta_container_register_static_meta(). - %TRUE if the @meta_item field has been registered on @container. @@ -5287,7 +5010,6 @@ the field, or %NULL to ignore Calls the given function on each of the meta container's set metadata fields. - @@ -5311,7 +5033,6 @@ metadata fields Gets the current boolean value of the specified field of the meta container. If the field does not have a set value, or it is of the wrong type, the method will fail. - %TRUE if the boolean value under @meta_item was copied to @dest. @@ -5337,7 +5058,6 @@ should be copied. Gets the current date value of the specified field of the meta container. If the field does not have a set value, or it is of the wrong type, the method will fail. - %TRUE if the date value under @meta_item was copied to @dest. @@ -5363,7 +5083,6 @@ should be copied. Gets the current date time value of the specified field of the meta container. If the field does not have a set value, or it is of the wrong type, the method will fail. - %TRUE if the date time value under @meta_item was copied to @dest. @@ -5389,7 +5108,6 @@ should be copied. Gets the current double value of the specified field of the meta container. If the field does not have a set value, or it is of the wrong type, the method will fail. - %TRUE if the double value under @meta_item was copied to @dest. @@ -5415,7 +5133,6 @@ should be copied. Gets the current float value of the specified field of the meta container. If the field does not have a set value, or it is of the wrong type, the method will fail. - %TRUE if the float value under @meta_item was copied to @dest. @@ -5441,7 +5158,6 @@ should be copied. Gets the current int value of the specified field of the meta container. If the field does not have a set value, or it is of the wrong type, the method will fail. - %TRUE if the int value under @meta_item was copied to @dest. @@ -5467,7 +5183,6 @@ should be copied. Gets the current int64 value of the specified field of the meta container. If the field does not have a set value, or it is of the wrong type, the method will fail. - %TRUE if the int64 value under @meta_item was copied to @dest. @@ -5493,7 +5208,6 @@ should be copied. Gets the current marker list value of the specified field of the meta container. If the field does not have a set value, or it is of the wrong type, the method will fail. - A copy of the marker list value under @key, or %NULL if it could not be fetched. @@ -5512,7 +5226,6 @@ or %NULL if it could not be fetched. Gets the current value of the specified field of the meta container. - The value under @key, or %NULL if @container does not have the field set. @@ -5533,7 +5246,6 @@ does not have the field set. Gets the current string value of the specified field of the meta container. If the field does not have a set value, or it is of the wrong type, the method will fail. - The string value under @meta_item, or %NULL if it could not be fetched. @@ -5554,7 +5266,6 @@ if it could not be fetched. Gets the current uint value of the specified field of the meta container. If the field does not have a set value, or it is of the wrong type, the method will fail. - %TRUE if the uint value under @meta_item was copied to @dest. @@ -5580,7 +5291,6 @@ should be copied. Gets the current uint64 value of the specified field of the meta container. If the field does not have a set value, or it is of the wrong type, the method will fail. - %TRUE if the uint64 value under @meta_item was copied to @dest. @@ -5604,7 +5314,6 @@ should be copied. Serializes the set metadata fields of the meta container to a string. - A serialized @container, or %NULL if an error occurred. @@ -5623,7 +5332,6 @@ given value, and registers the field to only hold a value of the same type. After calling this, only values of the same type as @value can be set for this field. The given flags can be set to make this field only readable after calling this method. - %TRUE if the @meta_item field was successfully registered on @container to only hold @value types, with the given @flags, and the @@ -5655,7 +5363,6 @@ given boolean value, and registers the field to only hold a boolean typed value. After calling this, only boolean values can be set for this field. The given flags can be set to make this field only readable after calling this method. - %TRUE if the @meta_item field was successfully registered on @container to only hold boolean typed values, with the given @flags, @@ -5687,7 +5394,6 @@ given date value, and registers the field to only hold a date typed value. After calling this, only date values can be set for this field. The given flags can be set to make this field only readable after calling this method. - %TRUE if the @meta_item field was successfully registered on @container to only hold date typed values, with the given @flags, @@ -5719,7 +5425,6 @@ given date time value, and registers the field to only hold a date time typed value. After calling this, only date time values can be set for this field. The given flags can be set to make this field only readable after calling this method. - %TRUE if the @meta_item field was successfully registered on @container to only hold date time typed values, with the given @flags, @@ -5751,7 +5456,6 @@ given double value, and registers the field to only hold a double typed value. After calling this, only double values can be set for this field. The given flags can be set to make this field only readable after calling this method. - %TRUE if the @meta_item field was successfully registered on @container to only hold double typed values, with the given @flags, @@ -5783,7 +5487,6 @@ given float value, and registers the field to only hold a float typed value. After calling this, only float values can be set for this field. The given flags can be set to make this field only readable after calling this method. - %TRUE if the @meta_item field was successfully registered on @container to only hold float typed values, with the given @flags, @@ -5815,7 +5518,6 @@ given int value, and registers the field to only hold an int typed value. After calling this, only int values can be set for this field. The given flags can be set to make this field only readable after calling this method. - %TRUE if the @meta_item field was successfully registered on @container to only hold int typed values, with the given @flags, @@ -5847,7 +5549,6 @@ given int64 value, and registers the field to only hold an int64 typed value. After calling this, only int64 values can be set for this field. The given flags can be set to make this field only readable after calling this method. - %TRUE if the @meta_item field was successfully registered on @container to only hold int64 typed values, with the given @flags, @@ -5879,7 +5580,6 @@ given string value, and registers the field to only hold a string typed value. After calling this, only string values can be set for this field. The given flags can be set to make this field only readable after calling this method. - %TRUE if the @meta_item field was successfully registered on @container to only hold string typed values, with the given @flags, @@ -5911,7 +5611,6 @@ given uint value, and registers the field to only hold a uint typed value. After calling this, only uint values can be set for this field. The given flags can be set to make this field only readable after calling this method. - %TRUE if the @meta_item field was successfully registered on @container to only hold uint typed values, with the given @flags, @@ -5943,7 +5642,6 @@ given uint64 value, and registers the field to only hold a uint64 typed value. After calling this, only uint64 values can be set for this field. The given flags can be set to make this field only readable after calling this method. - %TRUE if the @meta_item field was successfully registered on @container to only hold uint64 typed values, with the given @flags, @@ -5983,7 +5681,6 @@ registered, then its type must match the registering type, and its value will be left in place. If the field has no set value, then you will likely want to include #GES_META_WRITABLE in @flags to allow the value to be set later. - %TRUE if the @meta_item field was successfully registered on @container to only hold @type values, with the given @flags. @@ -6011,7 +5708,6 @@ the value to be set later. Sets the value of the specified field of the meta container to the given boolean value. - %TRUE if @value was set under @meta_item for @container. @@ -6034,7 +5730,6 @@ given boolean value. Sets the value of the specified field of the meta container to the given date value. - %TRUE if @value was set under @meta_item for @container. @@ -6057,7 +5752,6 @@ given date value. Sets the value of the specified field of the meta container to the given date time value. - %TRUE if @value was set under @meta_item for @container. @@ -6080,7 +5774,6 @@ given date time value. Sets the value of the specified field of the meta container to the given double value. - %TRUE if @value was set under @meta_item for @container. @@ -6103,7 +5796,6 @@ given double value. Sets the value of the specified field of the meta container to the given float value. - %TRUE if @value was set under @meta_item for @container. @@ -6126,7 +5818,6 @@ given float value. Sets the value of the specified field of the meta container to the given int value. - %TRUE if @value was set under @meta_item for @container. @@ -6149,7 +5840,6 @@ given int value. Sets the value of the specified field of the meta container to the given int64 value. - %TRUE if @value was set under @meta_item for @container. @@ -6172,7 +5862,6 @@ given int64 value. Sets the value of the specified field of the meta container to the given marker list value. - %TRUE if @value was set under @meta_item for @container. @@ -6196,7 +5885,6 @@ given marker list value. Sets the value of the specified field of the meta container to a copy of the given value. If the given @value is %NULL, the field given by @meta_item is removed and %TRUE is returned. - %TRUE if @value was set under @meta_item for @container. @@ -6220,7 +5908,6 @@ remove the corresponding field Sets the value of the specified field of the meta container to the given string value. - %TRUE if @value was set under @meta_item for @container. @@ -6243,7 +5930,6 @@ given string value. Sets the value of the specified field of the meta container to the given uint value. - %TRUE if @value was set under @meta_item for @container. @@ -6266,7 +5952,6 @@ given uint value. Sets the value of the specified field of the meta container to the given uint64 value. - %TRUE if @value was set under @meta_item for @container. @@ -6306,7 +5991,6 @@ the latter case, @value will be %NULL. - @@ -6329,7 +6013,6 @@ the latter case, @value will be %NULL. A method to be called on all of a meta container's fields. - @@ -6360,11 +6043,9 @@ This should not be used anymore, the `imagesequence://` protocol should be used instead. Check the #imagesequencesrc GStreamer element for more information. Use #GESUriSource instead - - @@ -6403,7 +6084,6 @@ multifile://20:50@/home/you/sequence/\%04d.png - @@ -6413,12 +6093,9 @@ multifile://20:50@/home/you/sequence/\%04d.png - - - + Base class for overlays, transitions, and effects - @@ -6434,7 +6111,6 @@ multifile://20:50@/home/you/sequence/\%04d.png - @@ -6446,7 +6122,6 @@ multifile://20:50@/home/you/sequence/\%04d.png Operations are any kind of object that both outputs AND consumes data. - @@ -6462,7 +6137,6 @@ multifile://20:50@/home/you/sequence/\%04d.png - @@ -6472,12 +6146,8 @@ multifile://20:50@/home/you/sequence/\%04d.png - - - - - - + + Overlays are objects which modify the underlying layer(s). @@ -6485,7 +6155,6 @@ Examples of overlays include text, image watermarks, or audio dubbing. Transitions, which change from one source to another over time, are not considered overlays. - @@ -6501,7 +6170,6 @@ not considered overlays. - parent class @@ -6512,17 +6180,13 @@ not considered overlays. - - - + - - @@ -6537,12 +6201,10 @@ the timeline by setting the #GESPipeline:audio-sink and You can set the encoding and save location used in rendering by calling ges_pipeline_set_render_settings(). - Creates a new pipeline. - The newly created pipeline. @@ -6550,7 +6212,6 @@ ges_pipeline_set_render_settings(). Gets the #GESPipeline:mode of the pipeline. - The current mode of @pipeline. @@ -6569,7 +6230,6 @@ preview, in the specified format. Note that if you use "ANY" caps for @caps, then the current format of the image is used. You can retrieve these caps from the returned sample with gst_sample_get_caps(). - A sample of @self's current image preview in the format given by @caps, or %NULL if an error prevented fetching the @@ -6594,7 +6254,6 @@ preview, in the 24-bit "RGB" format and of the desired width and height. See ges_pipeline_get_thumbnail(). - A sample of @self's current image preview in the "RGB" format, scaled to @width and @height, or %NULL if an error @@ -6620,7 +6279,6 @@ native size Gets the #GESPipeline:audio-sink of the pipeline. - The audio sink used by @self for preview. @@ -6634,7 +6292,6 @@ native size Gets the #GESPipeline:video-sink of the pipeline. - The video sink used by @self for preview. @@ -6648,7 +6305,6 @@ native size Sets the #GESPipeline:audio-sink of the pipeline. - @@ -6665,7 +6321,6 @@ native size Sets the #GESPipeline:video-sink of the pipeline. - @@ -6683,7 +6338,6 @@ native size Saves the currently displayed image of the pipeline in preview to the given location, in the specified dimensions and format. - %TRUE if @self's current image preview was successfully saved to @location using the given @format, @height and @width. @@ -6725,7 +6379,6 @@ after calling this. > set before setting @mode to #GES_PIPELINE_MODE_RENDER or > #GES_PIPELINE_MODE_SMART_RENDER, the call to this method will fail > otherwise. - %TRUE if the mode of @pipeline was successfully set to @mode. @@ -6747,7 +6400,6 @@ after calling this. This method **must** be called before setting the pipeline mode to #GES_PIPELINE_MODE_RENDER. - %TRUE if the settings were successfully set on @pipeline. @@ -6775,7 +6427,6 @@ the pipeline. Note that you should only call this method once on a given pipeline because a pipeline can not have its #GESPipeline:timeline changed after it has been set. - %TRUE if @timeline was successfully given to @pipeline. @@ -6841,7 +6492,6 @@ immediately before the #GESPipeline:video-sink. This exposes the - parent class @@ -6879,17 +6529,13 @@ avoiding decoding/reencoding (the underlying #encodebin has its > is enabled. - - - + This is a legacy format and you should avoid to use it. The formatter is really not in good shape and is deprecated. - - @@ -6908,7 +6554,6 @@ is really not in good shape and is deprecated. - @@ -6918,9 +6563,7 @@ is really not in good shape and is deprecated. - - - + The #GESProject is used to control a set of #GESAsset and is a #GESAsset with `GES_TYPE_TIMELINE` as @extractable_type itself. That @@ -6961,7 +6604,6 @@ writable local files. If you want to edit the subproject timeline, you should retrieve the subproject from the parent project asset list and extract the timeline with ges_asset_extract() and save it at the same temporary location. - @@ -6971,7 +6613,6 @@ if @uri is not valid or %NULL, the uri of the project will then be set the first time you save the project. If you then save the project to other locations, it will never be updated again and the first valid URI is the URI it will keep refering to. - A newly created #GESProject @@ -6984,7 +6625,6 @@ the URI it will keep refering to. - @@ -6998,7 +6638,6 @@ the URI it will keep refering to. - @@ -7012,7 +6651,6 @@ the URI it will keep refering to. - @@ -7026,7 +6664,6 @@ the URI it will keep refering to. - @@ -7040,7 +6677,6 @@ the URI it will keep refering to. - @@ -7056,7 +6692,6 @@ the URI it will keep refering to. - @@ -7076,7 +6711,6 @@ the URI it will keep refering to. - @@ -7095,7 +6729,6 @@ the URI it will keep refering to. Adds a #GESAsset to @project, the project will keep a reference on @asset. - %TRUE if the asset could be added %FALSE it was already in the project @@ -7116,7 +6749,6 @@ in the project Adds @profile to the project. It lets you save in what format the project has been renders and keep a reference to those formats. Also, those formats will be saves to the project file when possible. - %TRUE if @profile could be added, %FALSE otherwize @@ -7135,7 +6767,6 @@ the same name already exists, it will be replaced Adds a formatter as used to load @project - @@ -7154,7 +6785,6 @@ the same name already exists, it will be replaced Create and add a #GESAsset to @project. You should connect to the "asset-added" signal to get the asset when it finally gets added to @project - %TRUE if the asset started to be added %FALSE it was already in the project @@ -7179,7 +6809,6 @@ in the project Create and add a #GESAsset to @project. You should connect to the "asset-added" signal to get the asset when it finally gets added to @project - The newly created #GESAsset or %NULL. @@ -7200,7 +6829,6 @@ in the project - The #GESAsset with @id or %NULL if no asset with @id as an ID @@ -7224,7 +6852,6 @@ to retrieve from @object Get the assets that are being loaded - A set of loading asset that will be added to @project. Note that those Asset are *not* loaded yet, @@ -7242,7 +6869,6 @@ and thus can not be used Retrieve the uri that is currently set on @project - a newly allocated string representing uri. @@ -7258,7 +6884,6 @@ and thus can not be used List all @asset contained in @project filtering per extractable_type as defined by @filter. It copies the asset and thus will not be updated in time. - The list of #GESAsset the object contains @@ -7281,7 +6906,6 @@ all assets Lists the encoding profile that have been set to @project. The first one is the latest added. - The list of #GstEncodingProfile used in @project @@ -7298,7 +6922,6 @@ list of #GstEncodingProfile used in @project Loads @project into @timeline - %TRUE if the project could be loaded %FALSE otherwize. @@ -7316,7 +6939,6 @@ list of #GstEncodingProfile used in @project remove a @asset to from @project. - %TRUE if the asset could be removed %FALSE otherwise @@ -7336,7 +6958,6 @@ list of #GstEncodingProfile used in @project Save the timeline of @project to @uri. You should make sure that @timeline is one of the timelines that have been extracted from @project (using ges_asset_extract (@project);) - %TRUE if the project could be save, %FALSE otherwize @@ -7510,13 +7131,11 @@ only to find out what the new location is. - - @@ -7532,7 +7151,6 @@ only to find out what the new location is. - @@ -7548,7 +7166,6 @@ only to find out what the new location is. - @@ -7564,7 +7181,6 @@ only to find out what the new location is. - @@ -7583,7 +7199,6 @@ only to find out what the new location is. - @@ -7605,7 +7220,6 @@ only to find out what the new location is. - @@ -7621,7 +7235,6 @@ only to find out what the new location is. - @@ -7643,12 +7256,9 @@ only to find out what the new location is. - - - + Base class for single-media sources - @@ -7664,7 +7274,6 @@ only to find out what the new location is. - @@ -7683,12 +7292,10 @@ only to find out what the new location is. elements. These effects are applied to the core sources of the clip that they share a #GESTrack with. See #GESClip for how to add and move these effects from the clip. - Creates a new #GESSourceClip that renders a time overlay on top - The newly created #GESSourceClip, or %NULL if there was an error. @@ -7709,7 +7316,6 @@ or %NULL if there was an error. An asset types from which #GESSourceClip will be extracted - @@ -7718,13 +7324,11 @@ or %NULL if there was an error. - - @@ -7734,15 +7338,10 @@ or %NULL if there was an error. - - - - - - + + The #GESTimelineElement:duration of @obj. - A #GESTimelineElement @@ -7752,7 +7351,6 @@ or %NULL if there was an error. The end position of @obj: #GESTimelineElement:start + #GESTimelineElement:duration. - A #GESTimelineElement @@ -7761,7 +7359,6 @@ or %NULL if there was an error. The #GESTimelineElement:in-point of @obj. - A #GESTimelineElement @@ -7770,7 +7367,6 @@ or %NULL if there was an error. See #ges_timeline_element_get_layer_priority. - The object to retrieve the layer priority from @@ -7779,7 +7375,6 @@ or %NULL if there was an error. The #GESTimelineElement:max-duration of @obj. - A #GESTimelineElement @@ -7788,7 +7383,6 @@ or %NULL if there was an error. The #GESTimelineElement:name of @obj. - A #GESTimelineElement @@ -7797,12 +7391,10 @@ or %NULL if there was an error. Layer priority when a timeline element is not in any layer. - The #GESTimelineElement:parent of @obj. - A #GESTimelineElement @@ -7811,7 +7403,6 @@ or %NULL if there was an error. The #GESTimelineElement:priority of @obj. - A #GESTimelineElement @@ -7820,7 +7411,6 @@ or %NULL if there was an error. The #GESTimelineElement:start of @obj. - A #GESTimelineElement @@ -7829,7 +7419,6 @@ or %NULL if there was an error. The #GESTimelineElement:timeline of @obj. - A #GESTimelineElement @@ -7837,14 +7426,12 @@ or %NULL if there was an error. - - @@ -7853,7 +7440,6 @@ or %NULL if there was an error. What the default #GESTrackElement:has-internal-source value should be for new elements from this class. - A #GESTrackElementClass @@ -7873,12 +7459,10 @@ framerate=60/1, width=1920, height=1080, max-duration=5.0 ``` Note: `max-duration` can be provided in seconds as float, or as GstClockTime as guint64 or gint. - Creates a new #GESTestClip. - The newly created #GESTestClip, or %NULL if there was an error. @@ -7887,7 +7471,6 @@ or %NULL if there was an error. Creates a new #GESTestClip for the provided @nick. - The newly created #GESTestClip, or %NULL if there was an error. @@ -7902,7 +7485,6 @@ or %NULL if there was an error. Get the frequency @self generates. - The frequency @self generates. See audiotestsrc element. @@ -7916,7 +7498,6 @@ or %NULL if there was an error. Get the volume of the test audio signal applied on @self. - The volume of the test audio signal applied on @self. @@ -7930,7 +7511,6 @@ or %NULL if there was an error. Get the #GESVideoTestPattern which is applied on @self. - The #GESVideoTestPattern which is applied on @self. @@ -7944,7 +7524,6 @@ or %NULL if there was an error. Let you know if the audio track of @self is muted or not. - Whether the audio track of @self is muted or not. @@ -7958,7 +7537,6 @@ or %NULL if there was an error. Sets the frequency to generate. See audiotestsrc element. - @@ -7975,7 +7553,6 @@ or %NULL if there was an error. Sets whether the audio track of this clip is muted or not. - @@ -7992,7 +7569,6 @@ or %NULL if there was an error. Sets the volume of the test audio signal. - @@ -8009,7 +7585,6 @@ or %NULL if there was an error. Sets which video pattern to display on @self. - @@ -8053,7 +7628,6 @@ or %NULL if there was an error. - @@ -8063,9 +7637,7 @@ or %NULL if there was an error. - - - + Horizontal alignment of the text. @@ -8084,14 +7656,12 @@ or %NULL if there was an error. - Creates a new #GESTextOverlay. This should never be called by applications as this will be created by clips. - The newly created #GESTextOverlay or %NULL if something went wrong. @@ -8100,7 +7670,6 @@ be created by clips. Get the color used by @source. - The color used by @source. @@ -8114,7 +7683,6 @@ be created by clips. Get the pango font description currently set on @source. - The pango font description currently set on @source. @@ -8128,7 +7696,6 @@ be created by clips. Get the horizontal aligment used by @source. - The horizontal aligment used by @source. @@ -8142,7 +7709,6 @@ be created by clips. Get the text currently set on @source. - The text currently set on @source. @@ -8156,7 +7722,6 @@ be created by clips. Get the vertical aligment used by @source. - The vertical aligment used by @source. @@ -8170,7 +7735,6 @@ be created by clips. Get the horizontal position used by @source. - The horizontal position used by @source. @@ -8184,7 +7748,6 @@ be created by clips. Get the vertical position used by @source. - The vertical position used by @source. @@ -8198,7 +7761,6 @@ be created by clips. Sets the color of the text. - @@ -8216,7 +7778,6 @@ be created by clips. Sets the pango font description of the text this track element will render. - @@ -8233,7 +7794,6 @@ will render. Sets the horizontal aligment of the text. - @@ -8251,7 +7811,6 @@ of the text render by @self. Sets the text this track element will render. - @@ -8269,7 +7828,6 @@ made. Sets the vertical aligment of the text. - @@ -8287,7 +7845,6 @@ of the text render by @self. Sets the horizontal position of the text. - @@ -8304,7 +7861,6 @@ of the text render by @self. Sets the vertical position of the text. - @@ -8332,7 +7888,6 @@ of the text render by @self. - @@ -8344,12 +7899,10 @@ of the text render by @self. Renders text onto the next lower priority stream using textrender. - Creates a new #GESTextOverlayClip - The newly created #GESTextOverlayClip, or %NULL if there was an error. @@ -8358,7 +7911,6 @@ of the text render by @self. Get the color used by @source. - The color used by @source. @@ -8372,7 +7924,6 @@ of the text render by @self. Get the pango font description used by @self. - The pango font description used by @self. @@ -8386,7 +7937,6 @@ of the text render by @self. Get the horizontal aligment used by @self. - The horizontal aligment used by @self. @@ -8400,7 +7950,6 @@ of the text render by @self. Get the text currently set on @self. - The text currently set on @self. @@ -8414,7 +7963,6 @@ of the text render by @self. Get the vertical aligment used by @self. - The vertical aligment used by @self. @@ -8428,7 +7976,6 @@ of the text render by @self. Get the horizontal position used by @source. - The horizontal position used by @source. @@ -8442,7 +7989,6 @@ of the text render by @self. Get the vertical position used by @source. - The vertical position used by @source. @@ -8456,7 +8002,6 @@ of the text render by @self. Sets the color of the text. - @@ -8473,7 +8018,6 @@ of the text render by @self. Sets the pango font description of the text - @@ -8490,7 +8034,6 @@ of the text render by @self. Sets the horizontal aligment of the text. - @@ -8507,7 +8050,6 @@ of the text render by @self. Sets the text this clip will render. - @@ -8525,7 +8067,6 @@ made. Sets the vertical aligment of the text. - @@ -8542,7 +8083,6 @@ made. Sets the horizontal position of the text. - @@ -8559,7 +8099,6 @@ made. Sets the vertical position of the text. - @@ -8615,7 +8154,6 @@ made. - @@ -8625,12 +8163,8 @@ made. - - - - - - + + Vertical alignment of the text. @@ -8753,13 +8287,11 @@ be able to play or capture the content of the timeline. You can use a #GESPipeline to easily preview/play the timeline's content, or render it to a file. - Creates a new empty timeline. - The new timeline. @@ -8768,7 +8300,6 @@ content, or render it to a file. Creates a new timeline containing a single #GESAudioTrack and a single #GESVideoTrack. - The new timeline, or %NULL if the tracks could not be created and added. @@ -8777,7 +8308,6 @@ could not be created and added. Creates a timeline from the given URI. - A new timeline if the uri was loaded successfully, or %NULL if the uri could not be loaded. @@ -8791,7 +8321,6 @@ successfully, or %NULL if the uri could not be loaded. - @@ -8805,7 +8334,6 @@ successfully, or %NULL if the uri could not be loaded. - @@ -8824,7 +8352,6 @@ successfully, or %NULL if the uri could not be loaded. - @@ -8838,7 +8365,6 @@ successfully, or %NULL if the uri could not be loaded. - @@ -8852,7 +8378,6 @@ successfully, or %NULL if the uri could not be loaded. - @@ -8866,7 +8391,6 @@ successfully, or %NULL if the uri could not be loaded. - @@ -8895,7 +8419,6 @@ adding the clip would cause such an error. This method requires you to ensure the layer's #GESLayer:priority will be unique to the timeline. Use ges_timeline_append_layer() and ges_timeline_move_layer() instead. - %TRUE if @layer was properly added. @@ -8922,7 +8445,6 @@ would break one of the configuration rules for the timeline in the track. In such cases, some track elements would fail to be added to the track, but this method would still return %TRUE. As such, it is advised that you avoid adding tracks to timelines that already contain clips. - %TRUE if @track was properly added. @@ -8941,7 +8463,6 @@ that you avoid adding tracks to timelines that already contain clips. Append a newly created layer to the timeline. The layer will be added at the lowest #GESLayer:priority (numerically, the highest). - The newly created layer. @@ -8973,7 +8494,6 @@ Note that all the pending changes will automatically be executed when the timeline goes from #GST_STATE_READY to #GST_STATE_PAUSED, which is usually triggered by a corresponding state changes in a containing #GESPipeline. - %TRUE if pending changes were committed, or %FALSE if nothing needed to be committed. @@ -8991,7 +8511,6 @@ needed to be committed. timeline and wait for the changes to complete. See ges_timeline_commit(). - %TRUE if pending changes were committed, or %FALSE if nothing needed to be committed. @@ -9006,7 +8525,6 @@ needed to be committed. Gets #GESTimeline:auto-transition for the timeline. - The auto-transition of @self. @@ -9020,7 +8538,6 @@ needed to be committed. Get the current #GESTimeline:duration of the timeline - The current duration of @timeline. @@ -9034,7 +8551,6 @@ needed to be committed. Gets the element contained in the timeline with the given name. - The timeline element in @timeline with the given @name, or %NULL if it was not found. @@ -9054,7 +8570,6 @@ with the given @name, or %NULL if it was not found. This method allows you to convert a timeline #GstClockTime into its corresponding #GESFrameNumber in the timeline's output. - The frame number @timestamp corresponds to. @@ -9075,7 +8590,6 @@ corresponding #GESFrameNumber in the timeline's output. timeline #GstClockTime. For example, this time could be used to seek to a particular frame in the timeline's output, or as the edit position for an element within the timeline. - The timestamp corresponding to @frame_number in the output of @self. @@ -9094,7 +8608,6 @@ an element within the timeline. Get the list of #GESGroup-s present in the timeline. - The list of groups that contain clips present in @timeline's layers. @@ -9113,7 +8626,6 @@ Must not be changed. Retrieve the layer whose index in the timeline matches the given priority. - The layer with the given @priority, or %NULL if none was found. @@ -9134,7 +8646,6 @@ Since 1.6 Get the list of #GESLayer-s present in the timeline. - The list of layers present in @timeline sorted by priority. @@ -9152,7 +8663,6 @@ layers present in @timeline sorted by priority. Search for the #GstPad corresponding to the given timeline's track. You can link to this pad to receive the output data of the given track. - The pad corresponding to @track, or %NULL if there is an error. @@ -9171,7 +8681,6 @@ or %NULL if there is an error. Gets the #GESTimeline:snapping-distance for the timeline. - The snapping distance (in nanoseconds) of @timeline. @@ -9185,7 +8694,6 @@ or %NULL if there is an error. Search for the #GESTrack corresponding to the given timeline's pad. - The track corresponding to @pad, or %NULL if there is an error. @@ -9204,7 +8712,6 @@ or %NULL if there is an error. Get the list of #GESTrack-s used by the timeline. - The list of tracks used by @timeline. @@ -9221,7 +8728,6 @@ used by @timeline. Check whether the timeline is empty or not. - %TRUE if @timeline is empty. @@ -9235,7 +8741,6 @@ used by @timeline. Loads the contents of URI into the timeline. - %TRUE if the timeline was loaded successfully from @uri. @@ -9257,7 +8762,6 @@ used by @timeline. An index of 0 corresponds to the layer with the highest priority in a timeline. If @new_layer_priority is greater than the number of layers present in the timeline, it will become the lowest priority layer. - @@ -9293,7 +8797,6 @@ returned element and paste that copy (although, this is only possible if the paste was successful). See also ges_timeline_element_paste(). - The newly created element, or %NULL if pasting fails. @@ -9322,7 +8825,6 @@ i.e. the #GESTimelineElement:start value for the pasted element. Removes a layer from the timeline. - %TRUE if @layer was properly removed. @@ -9340,7 +8842,6 @@ i.e. the #GESTimelineElement:start value for the pasted element. Remove a track from the timeline. - %TRUE if @track was properly removed. @@ -9360,7 +8861,6 @@ i.e. the #GESTimelineElement:start value for the pasted element. Saves the timeline to the given location. If @formatter_asset is %NULL, the method will attempt to save in the same format the timeline was loaded from, before defaulting to the formatter with highest rank. - %TRUE if @timeline was successfully saved to @uri. @@ -9389,7 +8889,6 @@ loaded from, before defaulting to the formatter with highest rank. the corresponding #GESLayer:auto-transition for all of the timeline's layers to the same value. See ges_layer_set_auto_transition() if you wish to set the layer's #GESLayer:auto-transition individually. - @@ -9409,7 +8908,6 @@ to @timeline's layers Sets #GESTimeline:snapping-distance for the timeline. This new value will only effect future snappings and will not be used to snap the current element positions within the timeline. - @@ -9723,14 +9221,12 @@ tracks were created for the timeline. - parent class - @@ -9746,7 +9242,6 @@ tracks were created for the timeline. - @@ -9762,7 +9257,6 @@ tracks were created for the timeline. - @@ -9778,7 +9272,6 @@ tracks were created for the timeline. - @@ -9794,7 +9287,6 @@ tracks were created for the timeline. - @@ -9810,7 +9302,6 @@ tracks were created for the timeline. - @@ -9917,11 +9408,9 @@ sub-classed objects will be created with pre-registered children properties; for example, to expose part of an underlying #GstElement that is used internally. The registered properties can be listed with ges_timeline_element_list_children_properties(). - - @@ -9938,7 +9427,6 @@ ges_timeline_element_list_children_properties(). Gets the priority of the layer the element is in. A #GESGroup may span several layers, so this would return the highest priority (numerically, the smallest) amongst them. - The priority of the layer @self is in, or #GES_TIMELINE_ELEMENT_NO_LAYER_PRIORITY if @self does not exist in a @@ -9962,7 +9450,6 @@ be that of the video source. For example, if the uri of a #GESUriClip points to a file that contains both a video and audio stream, then the corresponding #GESAudioUriSource will share the natural framerate of the corresponding #GESVideoUriSource. - Whether @self has a natural framerate or not, @framerate_n and @framerate_d will be set to, respectively, 0 and -1 if it is @@ -9987,7 +9474,6 @@ not the case. Gets the track types that the element can interact with, i.e. the type of #GESTrack it can exist in, or will create #GESTrackElement-s for. - The track types that @self supports. @@ -10000,7 +9486,6 @@ of #GESTrack it can exist in, or will create #GESTrackElement-s for. - @@ -10027,7 +9512,6 @@ The first child found with the given "prop-name" property that was registered with ges_timeline_element_add_child_property() (and of the type "TypeName", if it was given) will be passed to @child, and the registered specification of this property will be passed to @pspec. - %TRUE if a child corresponding to the property was found, in which case @child and @pspec are set. @@ -10055,7 +9539,6 @@ specification of the child property - @@ -10075,7 +9558,6 @@ specification of the child property Edits the start time of an element within its timeline in ripple mode. See ges_timeline_element_edit() with #GES_EDIT_MODE_RIPPLE and #GES_EDGE_NONE. - %TRUE if the ripple edit of @self completed, %FALSE on failure. @@ -10096,7 +9578,6 @@ failure. Edits the end time of an element within its timeline in ripple mode. See ges_timeline_element_edit() with #GES_EDIT_MODE_RIPPLE and #GES_EDGE_END. - %TRUE if the ripple edit of @self completed, %FALSE on failure. @@ -10117,7 +9598,6 @@ failure. Edits the end time of an element within its timeline in roll mode. See ges_timeline_element_edit() with #GES_EDIT_MODE_ROLL and #GES_EDGE_END. - %TRUE if the roll edit of @self completed, %FALSE on failure. @@ -10137,7 +9617,6 @@ See ges_timeline_element_edit() with #GES_EDIT_MODE_ROLL and Edits the start time of an element within its timeline in roll mode. See ges_timeline_element_edit() with #GES_EDIT_MODE_ROLL and #GES_EDGE_START. - %TRUE if the roll edit of @self completed, %FALSE on failure. @@ -10157,7 +9636,6 @@ See ges_timeline_element_edit() with #GES_EDIT_MODE_ROLL and Method for setting the child property given by @pspec on @child to @value. Default implementation will use g_object_set_property(). - @@ -10180,7 +9658,6 @@ g_object_set_property(). Similar to @set_child_property, except setting can fail, with the @error being optionally set. Default implementation will call @set_child_property and return %TRUE. - @@ -10210,7 +9687,6 @@ different timeline time difference from the one given. In addition, setting may fail if it would place the timeline in an unsupported configuration, or the element does not have enough internal content to last the desired duration. - %TRUE if @duration could be set for @self. @@ -10230,7 +9706,6 @@ last the desired duration. Sets #GESTimelineElement:in-point for the element. If the new in-point is above the current #GESTimelineElement:max-duration of the element, this method will fail. - %TRUE if @inpoint could be set for @self. @@ -10250,7 +9725,6 @@ this method will fail. Sets #GESTimelineElement:max-duration for the element. If the new maximum duration is below the current #GESTimelineElement:in-point of the element, this method will fail. - %TRUE if @maxduration could be set for @self. @@ -10280,7 +9754,6 @@ new parent. If @parent is not %NULL, you must ensure it already has a (non-floating) reference to @self before calling this. - %TRUE if @parent could be set for @self. @@ -10301,7 +9774,6 @@ If @parent is not %NULL, you must ensure it already has a All priority management is done by GES itself now. To set #GESEffect priorities #ges_clip_set_top_effect_index should be used. - %TRUE if @priority could be set for @self. @@ -10327,7 +9799,6 @@ editing the element with ges_timeline_element_edit() under #GESTimelineElement:start of the element may be snapped to a different timeline time from the one given. In addition, setting may fail if it would place the timeline in an unsupported configuration. - %TRUE if @start could be set for @self. @@ -10347,7 +9818,6 @@ would place the timeline in an unsupported configuration. Edits the start time of an element within its timeline in trim mode. See ges_timeline_element_edit() with #GES_EDIT_MODE_TRIM and #GES_EDGE_START. - %TRUE if the trim edit of @self completed, %FALSE on failure. @@ -10371,7 +9841,6 @@ will also appear in the #GESTimelineElement::deep-notify signal. @pspec should be unique from other children properties that have been registered on @self. - %TRUE if the property was successfully registered. @@ -10405,7 +9874,6 @@ anything else and can only be used **once** in a pasting operation. In particular, the new element itself is not an actual 'deep' copy of @self, but should be thought of as an intermediate object used for a single paste operation. - The newly create element, copied from @self. @@ -10427,7 +9895,6 @@ copied from @self. Note that the @layers argument is currently ignored, so you should just pass %NULL. - %TRUE if the edit of @self completed, %FALSE on failure. @@ -10488,7 +9955,6 @@ snapped to the edge of some element under the edited element. moved by the edit, to a new layer. New layers may be be created if the the corresponding layer priority/index does not yet exist for the timeline. - %TRUE if the edit of @self completed, %FALSE on failure. @@ -10521,7 +9987,6 @@ moved to. -1 means no move Gets several of the children properties of the element. See ges_timeline_element_get_child_property(). - @@ -10558,7 +10023,6 @@ property copied into @value. Note that ges_timeline_element_get_child_properties() may be more convenient for C programming. - %TRUE if the property was found and copied to @value. @@ -10582,7 +10046,6 @@ convenient for C programming. Gets the property of a child of the element. Specifically, the property corresponding to the @pspec used in ges_timeline_element_add_child_property() is copied into @value. - @@ -10604,7 +10067,6 @@ ges_timeline_element_add_child_property() is copied into @value. Gets several of the children properties of the element. See ges_timeline_element_get_child_property(). - @@ -10626,7 +10088,6 @@ optionally by more name/return location pairs, followed by %NULL Gets the #GESTimelineElement:duration for the element. - The duration of @self (in nanoseconds). @@ -10640,7 +10101,6 @@ optionally by more name/return location pairs, followed by %NULL Gets the #GESTimelineElement:in-point for the element. - The in-point of @self (in nanoseconds). @@ -10656,7 +10116,6 @@ optionally by more name/return location pairs, followed by %NULL Gets the priority of the layer the element is in. A #GESGroup may span several layers, so this would return the highest priority (numerically, the smallest) amongst them. - The priority of the layer @self is in, or #GES_TIMELINE_ELEMENT_NO_LAYER_PRIORITY if @self does not exist in a @@ -10672,7 +10131,6 @@ layer. Gets the #GESTimelineElement:max-duration for the element. - The max-duration of @self (in nanoseconds). @@ -10686,7 +10144,6 @@ layer. Gets the #GESTimelineElement:name for the element. - The name of @self. @@ -10708,7 +10165,6 @@ be that of the video source. For example, if the uri of a #GESUriClip points to a file that contains both a video and audio stream, then the corresponding #GESAudioUriSource will share the natural framerate of the corresponding #GESVideoUriSource. - Whether @self has a natural framerate or not, @framerate_n and @framerate_d will be set to, respectively, 0 and -1 if it is @@ -10732,7 +10188,6 @@ not the case. Gets the #GESTimelineElement:parent for the element. - The parent of @self, or %NULL if @self has no parent. @@ -10747,7 +10202,6 @@ not the case. Gets the #GESTimelineElement:priority for the element. - The priority of @self. @@ -10761,7 +10215,6 @@ not the case. Gets the #GESTimelineElement:start for the element. - The start of @self (in nanoseconds). @@ -10775,7 +10228,6 @@ not the case. Gets the #GESTimelineElement:timeline for the element. - The timeline of @self, or %NULL if @self has no timeline. @@ -10790,7 +10242,6 @@ if @self has no timeline. Gets the toplevel #GESTimelineElement:parent of the element. - The toplevel parent of @self. @@ -10805,7 +10256,6 @@ if @self has no timeline. Gets the track types that the element can interact with, i.e. the type of #GESTrack it can exist in, or will create #GESTrackElement-s for. - The track types that @self supports. @@ -10821,7 +10271,6 @@ of #GESTrack it can exist in, or will create #GESTrackElement-s for. Get a list of children properties of the element, which is a list of all the specifications passed to ges_timeline_element_add_child_property(). - An array of #GParamSpec corresponding to the child properties of @self, or %NULL if @@ -10856,7 +10305,6 @@ The first child found with the given "prop-name" property that was registered with ges_timeline_element_add_child_property() (and of the type "TypeName", if it was given) will be passed to @child, and the registered specification of this property will be passed to @pspec. - %TRUE if a child corresponding to the property was found, in which case @child and @pspec are set. @@ -10901,7 +10349,6 @@ returned element and paste that copy (although, this is only possible if the paste was successful). See also ges_timeline_paste_element(). - The newly created element, or %NULL if pasting fails. @@ -10924,7 +10371,6 @@ to, i.e. the #GESTimelineElement:start value for the pasted element. specification that was passed to ges_timeline_element_add_child_property(). The corresponding property will no longer be registered as a child property for the element. - %TRUE if the property was successfully un-registered for @self. @@ -10944,7 +10390,6 @@ will no longer be registered as a child property for the element. Edits the start time of an element within its timeline in ripple mode. See ges_timeline_element_edit() with #GES_EDIT_MODE_RIPPLE and #GES_EDGE_NONE. - %TRUE if the ripple edit of @self completed, %FALSE on failure. @@ -10965,7 +10410,6 @@ failure. Edits the end time of an element within its timeline in ripple mode. See ges_timeline_element_edit() with #GES_EDIT_MODE_RIPPLE and #GES_EDGE_END. - %TRUE if the ripple edit of @self completed, %FALSE on failure. @@ -10986,7 +10430,6 @@ failure. Edits the end time of an element within its timeline in roll mode. See ges_timeline_element_edit() with #GES_EDIT_MODE_ROLL and #GES_EDGE_END. - %TRUE if the roll edit of @self completed, %FALSE on failure. @@ -11006,7 +10449,6 @@ See ges_timeline_element_edit() with #GES_EDIT_MODE_ROLL and Edits the start time of an element within its timeline in roll mode. See ges_timeline_element_edit() with #GES_EDIT_MODE_ROLL and #GES_EDGE_START. - %TRUE if the roll edit of @self completed, %FALSE on failure. @@ -11025,7 +10467,6 @@ See ges_timeline_element_edit() with #GES_EDIT_MODE_ROLL and Sets several of the children properties of the element. See ges_timeline_element_set_child_property(). - @@ -11051,7 +10492,6 @@ error. Note that ges_timeline_element_set_child_properties() may be more convenient for C programming. - %TRUE if the property was found and set. @@ -11075,7 +10515,6 @@ convenient for C programming. Sets the property of a child of the element. Specifically, the property corresponding to the @pspec used in ges_timeline_element_add_child_property() is set to @value. - @@ -11109,7 +10548,6 @@ registered with ges_timeline_element_add_child_property() (and of the type "TypeName", if it was given) will have the corresponding property set to @value. Other children that may have also matched the property name (and type name) are left unchanged! - %TRUE if the property was found and set. @@ -11132,7 +10570,6 @@ property name (and type name) are left unchanged! Sets several of the children properties of the element. See ges_timeline_element_set_child_property(). - @@ -11163,7 +10600,6 @@ different timeline time difference from the one given. In addition, setting may fail if it would place the timeline in an unsupported configuration, or the element does not have enough internal content to last the desired duration. - %TRUE if @duration could be set for @self. @@ -11183,7 +10619,6 @@ last the desired duration. Sets #GESTimelineElement:in-point for the element. If the new in-point is above the current #GESTimelineElement:max-duration of the element, this method will fail. - %TRUE if @inpoint could be set for @self. @@ -11203,7 +10638,6 @@ this method will fail. Sets #GESTimelineElement:max-duration for the element. If the new maximum duration is below the current #GESTimelineElement:in-point of the element, this method will fail. - %TRUE if @maxduration could be set for @self. @@ -11237,7 +10671,6 @@ attempt to ensure that the generated names will not conflict with the chosen name, which may lead to a different name being set instead, but the uniqueness between generated and user-chosen names is not guaranteed. - %TRUE if @name or a generated name for @self could be set. @@ -11267,7 +10700,6 @@ new parent. If @parent is not %NULL, you must ensure it already has a (non-floating) reference to @self before calling this. - %TRUE if @parent could be set for @self. @@ -11288,7 +10720,6 @@ If @parent is not %NULL, you must ensure it already has a All priority management is done by GES itself now. To set #GESEffect priorities #ges_clip_set_top_effect_index should be used. - %TRUE if @priority could be set for @self. @@ -11314,7 +10745,6 @@ editing the element with ges_timeline_element_edit() under #GESTimelineElement:start of the element may be snapped to a different timeline time from the one given. In addition, setting may fail if it would place the timeline in an unsupported configuration. - %TRUE if @start could be set for @self. @@ -11345,7 +10775,6 @@ start tracking @self. Note, in the latter case, @self must not already have a timeline set. Therefore, if you wish to switch timelines, you will need to call this function twice: first to set the timeline to %NULL, and then to the new timeline. - %TRUE if @timeline could be set for @self. @@ -11365,7 +10794,6 @@ will need to call this function twice: first to set the timeline to Edits the start time of an element within its timeline in trim mode. See ges_timeline_element_edit() with #GES_EDIT_MODE_TRIM and #GES_EDGE_START. - %TRUE if the trim edit of @self completed, %FALSE on failure. @@ -11566,13 +10994,11 @@ used as a signal detail. Vmethods in subclasses should apply all the operation they need to but the real method implementation is in charge of setting the proper field, and emitting the notify signal. - - %TRUE if @parent could be set for @self. @@ -11591,7 +11017,6 @@ and emitting the notify signal. - %TRUE if @start could be set for @self. @@ -11610,7 +11035,6 @@ and emitting the notify signal. - %TRUE if @inpoint could be set for @self. @@ -11629,7 +11053,6 @@ and emitting the notify signal. - %TRUE if @duration could be set for @self. @@ -11648,7 +11071,6 @@ and emitting the notify signal. - %TRUE if @maxduration could be set for @self. @@ -11667,7 +11089,6 @@ and emitting the notify signal. - %TRUE if @priority could be set for @self. @@ -11686,7 +11107,6 @@ and emitting the notify signal. - %TRUE if the ripple edit of @self completed, %FALSE on failure. @@ -11706,7 +11126,6 @@ failure. - %TRUE if the ripple edit of @self completed, %FALSE on failure. @@ -11726,7 +11145,6 @@ failure. - %TRUE if the roll edit of @self completed, %FALSE on failure. @@ -11745,7 +11163,6 @@ failure. - %TRUE if the roll edit of @self completed, %FALSE on failure. @@ -11764,7 +11181,6 @@ failure. - %TRUE if the trim edit of @self completed, %FALSE on failure. @@ -11783,7 +11199,6 @@ failure. - @@ -11799,7 +11214,6 @@ failure. - @@ -11818,7 +11232,6 @@ failure. - @@ -11834,7 +11247,6 @@ failure. - %TRUE if a child corresponding to the property was found, in which case @child and @pspec are set. @@ -11864,7 +11276,6 @@ specification of the child property - The track types that @self supports. @@ -11879,7 +11290,6 @@ specification of the child property - @@ -11901,7 +11311,6 @@ specification of the child property - The priority of the layer @self is in, or #GES_TIMELINE_ELEMENT_NO_LAYER_PRIORITY if @self does not exist in a @@ -11918,7 +11327,6 @@ layer. - Whether @self has a natural framerate or not, @framerate_n and @framerate_d will be set to, respectively, 0 and -1 if it is @@ -11943,7 +11351,6 @@ not the case. - @@ -11969,21 +11376,15 @@ not the case. - - - - - - + + Renders the given text in the specified font, at specified position, and with the specified background pattern. - Creates a new #GESTitleClip - The newly created #GESTitleClip, or %NULL if there was an error. @@ -11994,7 +11395,6 @@ or %NULL if there was an error. Get the background used by @self. use #ges_timeline_element_get_children_properties instead. See #GESTitleSource for more information about exposed properties - The color used by @self. @@ -12010,7 +11410,6 @@ See #GESTitleSource for more information about exposed propertiesGet the pango font description used by @self. use #ges_timeline_element_get_children_properties instead. See #GESTitleSource for more information about exposed properties - The pango font description used by @self. @@ -12026,7 +11425,6 @@ See #GESTitleSource for more information about exposed propertiesGet the horizontal aligment used by @self. use #ges_timeline_element_get_children_properties instead. See #GESTitleSource for more information about exposed properties - The horizontal aligment used by @self. @@ -12042,7 +11440,6 @@ See #GESTitleSource for more information about exposed propertiesGet the text currently set on @self. use #ges_timeline_element_get_children_properties instead. See #GESTitleSource for more information about exposed properties - The text currently set on @self. @@ -12058,7 +11455,6 @@ See #GESTitleSource for more information about exposed propertiesGet the color used by @self. use #ges_timeline_element_get_children_properties instead. See #GESTitleSource for more information about exposed properties - The color used by @self. @@ -12074,7 +11470,6 @@ See #GESTitleSource for more information about exposed propertiesGet the vertical aligment used by @self. use #ges_timeline_element_get_children_properties instead. See #GESTitleSource for more information about exposed properties - The vertical aligment used by @self. @@ -12090,7 +11485,6 @@ See #GESTitleSource for more information about exposed propertiesGet the horizontal position used by @self. use #ges_timeline_element_get_children_properties instead. See #GESTitleSource for more information about exposed properties - The horizontal position used by @self. @@ -12105,7 +11499,6 @@ See #GESTitleSource for more information about exposed properties Get the vertical position used by @self. use #ges_timeline_element_get_children_property instead - The vertical position used by @self. @@ -12121,7 +11514,6 @@ See #GESTitleSource for more information about exposed propertiesSets the background of the text. use #ges_timeline_element_set_children_properties instead. See #GESTitleSource for more information about exposed properties - @@ -12140,7 +11532,6 @@ See #GESTitleSource for more information about exposed propertiesSets the color of the text. use #ges_timeline_element_set_children_properties instead. See #GESTitleSource for more information about exposed properties - @@ -12159,7 +11550,6 @@ See #GESTitleSource for more information about exposed propertiesSets the pango font description of the text. use #ges_timeline_element_set_children_properties instead. See #GESTitleSource for more information about exposed properties - @@ -12178,7 +11568,6 @@ See #GESTitleSource for more information about exposed propertiesSets the horizontal aligment of the text. use #ges_timeline_element_set_children_properties instead. See #GESTitleSource for more information about exposed properties - @@ -12197,7 +11586,6 @@ See #GESTitleSource for more information about exposed propertiesSets the text this clip will render. use #ges_timeline_element_set_children_properties instead. See #GESTitleSource for more information about exposed properties - @@ -12217,7 +11605,6 @@ made. Sets the vertical aligment of the text. use #ges_timeline_element_set_children_properties instead. See #GESTitleSource for more information about exposed properties - @@ -12236,7 +11623,6 @@ See #GESTitleSource for more information about exposed propertiesSets the horizontal position of the text. use #ges_timeline_element_set_children_properties instead. See #GESTitleSource for more information about exposed properties - @@ -12255,7 +11641,6 @@ See #GESTitleSource for more information about exposed propertiesSets the vertical position of the text. use #ges_timeline_element_set_children_properties instead. See #GESTitleSource for more information about exposed properties - @@ -12339,7 +11724,6 @@ See #GESTitleSource for more information about exposed properties - @@ -12349,18 +11733,14 @@ See #GESTitleSource for more information about exposed properties - - - + #GESTitleSource is a GESTimelineElement that implements the notion of titles in GES. - Get the background used by @source. - The background used by @source. @@ -12376,7 +11756,6 @@ of titles in GES. Get the pango font description used by @source. Use ges_timeline_element_get_child_property instead (this actually returns a newly allocated string) - The pango font description used by this @source. @@ -12391,7 +11770,6 @@ of titles in GES. Get the horizontal aligment used by @source. - The horizontal aligment used by @source. @@ -12407,7 +11785,6 @@ of titles in GES. Get the text currently set on the @source. Use ges_timeline_element_get_child_property instead (this actually returns a newly allocated string) - The text currently set on the @source. @@ -12421,7 +11798,6 @@ of titles in GES. Get the color used by @source. - The color used by @source. @@ -12435,7 +11811,6 @@ of titles in GES. Get the vertical aligment used by @source. - The vertical aligment used by @source. @@ -12449,7 +11824,6 @@ of titles in GES. Get the horizontal position used by @source. - The horizontal position used by @source. @@ -12463,7 +11837,6 @@ of titles in GES. Get the vertical position used by @source. - The vertical position used by @source. @@ -12477,7 +11850,6 @@ of titles in GES. Sets the color of the background - @@ -12495,7 +11867,6 @@ of titles in GES. Set the pango font description this source will use to render the text. - @@ -12512,7 +11883,6 @@ the text. Sets the vertical aligment of the text. - @@ -12531,7 +11901,6 @@ the text. Sets the text this track element will render. use ges_track_element_get/set_children_properties on the GESTrackElement instead - @@ -12549,7 +11918,6 @@ made. Sets the color of the text. - @@ -12566,7 +11934,6 @@ made. Sets the vertical aligment of the text. - @@ -12583,7 +11950,6 @@ made. Sets the horizontal position of the text. - @@ -12600,7 +11966,6 @@ made. Sets the vertical position of the text. - @@ -12628,7 +11993,6 @@ made. - parent class @@ -12639,9 +12003,7 @@ made. - - - + A #GESTrack acts an output source for a #GESTimeline. Each one essentially provides an additional #GstPad for the timeline, with @@ -12662,7 +12024,6 @@ tracks to a timeline, but never directly add an element to a track. Whenever a #GESClip is added to a timeline, the clip adds its elements to the timeline's tracks and assumes responsibility for updating them. - @@ -12684,7 +12045,6 @@ instead. Otherwise, a plain #GESTrack is returned. You will likely want to set the #GESTrack:restriction-caps and call ges_track_set_create_element_for_gap_func() on the returned track. - A new track. @@ -12701,7 +12061,6 @@ ges_track_set_create_element_for_gap_func() on the returned track. - @@ -12713,7 +12072,6 @@ ges_track_set_create_element_for_gap_func() on the returned track. See ges_track_add_element(), which also gives an error. - %TRUE if @object was successfully added to @track. @@ -12737,7 +12095,6 @@ Note that this can fail if it would break a configuration rule of the track's #GESTimeline. Note that a #GESTrackElement can only be added to one track. - %TRUE if @object was successfully added to @track. @@ -12767,7 +12124,6 @@ Any pending changes will be executed in the backend. The Note that ges_timeline_commit() will call this method on all of its tracks, so you are unlikely to need to use this directly. - %TRUE if pending changes were committed, or %FALSE if nothing needed to be committed. @@ -12782,7 +12138,6 @@ needed to be committed. Get the #GESTrack:caps of the track. - The caps of @track. @@ -12798,7 +12153,6 @@ needed to be committed. Gets the track elements contained in the track. The returned list is sorted by the element's #GESTimelineElement:priority and #GESTimelineElement:start. - A list of all the #GESTrackElement-s in @track. @@ -12815,7 +12169,6 @@ all the #GESTrackElement-s in @track. Gets the #GESTrack:mixing of the track. - Whether @track is mixing. @@ -12829,7 +12182,6 @@ all the #GESTrackElement-s in @track. Gets the #GESTrack:restriction-caps of the track. - The restriction-caps of @track. @@ -12843,7 +12195,6 @@ all the #GESTrackElement-s in @track. Get the timeline this track belongs to. - The timeline that @track belongs to, or %NULL if it does not belong to a timeline. @@ -12858,7 +12209,6 @@ it does not belong to a timeline. See ges_track_remove_element_full(), which also returns an error. - %TRUE if @object was successfully removed from @track. @@ -12877,7 +12227,6 @@ it does not belong to a timeline. Removes the given track element from the track, which revokes ownership of the element. - %TRUE if @object was successfully removed from @track. @@ -12903,7 +12252,6 @@ transparent frames for a video, or mute samples for audio. #GESAudioTrack and #GESVideoTrack objects are created with such a function already set appropriately. - @@ -12921,7 +12269,6 @@ function already set appropriately. Sets the #GESTrack:mixing for the track. - @@ -12941,7 +12288,6 @@ function already set appropriately. > **NOTE**: Restriction caps are **not** taken into account when > using #GESPipeline:mode=#GES_PIPELINE_MODE_SMART_RENDER. - @@ -12962,7 +12308,6 @@ does not actually add the track to the timeline. For that, you should use ges_timeline_add_track(), which will also take care of informing the track that it belongs to the timeline. As such, there is no need for you to call this method. - @@ -12994,7 +12339,6 @@ For example, if the existing #GESTrack:restriction-caps are the new #GESTrack:restriction-caps after calling this will be "video/x-raw, width=500, height=360, format=I420; video/x-bayer, width=400". - @@ -13118,13 +12462,11 @@ committed (see #nlecomposition::commited). - - @@ -13169,11 +12511,9 @@ internal source coordinates (see #GESTimelineElement). By default, these will be updated to lie between the #GESTimelineElement:in-point and out-point of the element. This can be switched off by setting #GESTrackElement:auto-clamp-control-sources to %FALSE. - - @@ -13187,7 +12527,6 @@ and out-point of the element. This can be switched off by setting - @@ -13198,7 +12537,6 @@ and out-point of the element. This can be switched off by setting - @@ -13209,7 +12547,6 @@ and out-point of the element. This can be switched off by setting - @@ -13220,7 +12557,6 @@ and out-point of the element. This can be switched off by setting - @@ -13238,7 +12574,6 @@ and out-point of the element. This can be switched off by setting contained elements have this property name you will get the first one, unless you specify the class name in @name. Use #ges_timeline_element_lookup_child - TRUE if @element and @pspec could be found. FALSE otherwise. In that case the values for @pspec and @element are not modified. Unref @element after @@ -13281,7 +12616,6 @@ child properties of @self using ges_timeline_element_add_child_property(). This is intended to be used by subclasses when constructing. - @@ -13332,7 +12666,6 @@ ges_track_element_set_control_source(), nothing happens. Otherwise, if a timed value for the control source lies before the in-point of the element, or after its out-point, then it will be removed. At the in-point and out-point times, a new interpolated value will be placed. - @@ -13351,7 +12684,6 @@ source of Edits the element within its track. use #ges_timeline_element_edit instead. - %TRUE if the edit of @object completed, %FALSE on failure. @@ -13391,7 +12723,6 @@ ges_track_element_set_control_source(). The keys used in the returned hash table are the child property names that were passed to ges_track_element_set_control_source(), and their values are the corresponding created #GstControlBinding. - A hash table containing all child-property-name/control-binding pairs @@ -13410,7 +12741,6 @@ for @trackelement. Gets #GESTrackElement:auto-clamp-control-sources. - Whether the control sources for the child properties of @object are automatically clamped. @@ -13426,7 +12756,6 @@ for @trackelement. Gets properties of a child of @object. Use #ges_timeline_element_get_child_properties - @@ -13457,7 +12786,6 @@ Note that #ges_track_element_get_child_property is really intended for language bindings, #ges_track_element_get_child_properties is much more convenient for C programming. Use #ges_timeline_element_get_child_property - %TRUE if the property was found, %FALSE otherwise. @@ -13481,7 +12809,6 @@ be initialized if it is initialized with 0 Gets a property of a child of @object. Use #ges_timeline_element_get_child_property_by_pspec - @@ -13506,7 +12833,6 @@ that have the same property name, you can distinguish them using the following syntax: 'ClasseName::property_name' as property name. If you don't, the corresponding property of the first element found will be set. Use #ges_timeline_element_get_child_property_valist - @@ -13532,7 +12858,6 @@ property of the track element using ges_track_element_set_control_source(). The given @property_name must be the same name of the child property that was passed to ges_track_element_set_control_source(). - The control binding that was created for the specified child property of @object, or %NULL if @@ -13554,7 +12879,6 @@ binding of Get the #GstElement that the track element's underlying nleobject controls. - The #GstElement being controlled by the nleobject that @object wraps. @@ -13570,7 +12894,6 @@ nleobject that @object wraps. Get the GNonLin object this object is controlling. use #ges_track_element_get_nleobject instead. - The GNonLin object this object is controlling. @@ -13584,7 +12907,6 @@ nleobject that @object wraps. Get the nleobject that this element wraps. - The nleobject that @object wraps. @@ -13598,7 +12920,6 @@ nleobject that @object wraps. Get the #GESTrackElement:track for the element. - The track that @object belongs to, or %NULL if it does not belong to a track. @@ -13613,7 +12934,6 @@ or %NULL if it does not belong to a track. Gets the #GESTrackElement:track-type for the element. - The track-type of @object. @@ -13627,7 +12947,6 @@ or %NULL if it does not belong to a track. Gets #GESTrackElement:has-internal-source for the element. - %TRUE if @object can have its 'internal time' properties set. @@ -13641,7 +12960,6 @@ or %NULL if it does not belong to a track. Gets #GESTrackElement:active for the element. - %TRUE if @object is active in its track. @@ -13668,7 +12986,6 @@ ges_container_ungroup(), but you could not move the core child from a Moreover, if a core track element is added to a clip, it will always be added as a core child. Therefore, if this returns %TRUE, then @element will be a core child of its parent clip. - %TRUE if @element is a core track element. @@ -13684,7 +13001,6 @@ will be a core child of its parent clip. Gets an array of #GParamSpec* for all configurable properties of the children of @object. Use #ges_timeline_element_list_children_properties - An array of #GParamSpec* which should be freed after use or %NULL if something went wrong. @@ -13708,7 +13024,6 @@ children of @object. contained elements have this property name you will get the first one, unless you specify the class name in @name. Use #ges_timeline_element_lookup_child - TRUE if @element and @pspec could be found. FALSE otherwise. In that case the values for @pspec and @element are not modified. Unref @element after @@ -13746,7 +13061,6 @@ property of the track element using ges_track_element_set_control_source(). The given @property_name must be the same name of the child property that was passed to ges_track_element_set_control_source(). - %TRUE if the control binding was removed from the specified child property of @object, or %FALSE if an error occurred. @@ -13766,7 +13080,6 @@ binding from Sets #GESTrackElement:active for the element. - %TRUE if the property was *toggled*. @@ -13785,7 +13098,6 @@ binding from Sets #GESTrackElement:auto-clamp-control-sources. If set to %TRUE, this will immediately clamp all the control sources. - @@ -13807,7 +13119,6 @@ that have the same property name, you can distinguish them using the following syntax: 'ClasseName::property_name' as property name. If you don't, the corresponding property of the first element found will be set. Use #ges_timeline_element_set_child_properties - @@ -13834,7 +13145,6 @@ Note that #ges_track_element_set_child_property is really intended for language bindings, #ges_track_element_set_child_properties is much more convenient for C programming. use #ges_timeline_element_set_child_property instead - %TRUE if the property was set, %FALSE otherwise. @@ -13857,7 +13167,6 @@ is much more convenient for C programming. Sets a property of a child of @object. Use #ges_timeline_element_set_child_property_by_spec - @@ -13882,7 +13191,6 @@ that have the same property name, you can distinguish them using the following syntax: 'ClasseName::property_name' as property name. If you don't, the corresponding property of the first element found will be set. Use #ges_timeline_element_set_child_property_valist - @@ -13912,7 +13220,6 @@ If @binding_type is "direct", then the control binding is created with gst_direct_control_binding_new() using the given control source. If @binding_type is "direct-absolute", it is created with gst_direct_control_binding_new_absolute() instead. - %TRUE if the specified child property could be bound to @source, or %FALSE if an error occurred. @@ -13943,7 +13250,6 @@ gst_direct_control_binding_new_absolute() instead. set to %FALSE, this method will also set the #GESTimelineElement:in-point of the element to 0 and its #GESTimelineElement:max-duration to #GST_CLOCK_TIME_NONE. - %FALSE if @has_internal_source is forbidden for @object and %TRUE in any other case. @@ -13963,7 +13269,6 @@ set to %FALSE, this method will also set the Sets the #GESTrackElement:track-type for the element. - @@ -14090,13 +13395,11 @@ property of the track element. - Result: %TRUE if @self has a natural framerate %FALSE otherwise - %TRUE if @self has a natural framerate @FALSE otherwise. @@ -14118,7 +13421,6 @@ property of the track element. Result: %TRUE if @self has a natural framerate %FALSE otherwise - @@ -14140,7 +13442,6 @@ property of the track element. Get the GESAssetTrackType the #GESTrackElement extracted from @self should get into - a #GESTrackType @@ -14155,7 +13456,6 @@ should get into Set the #GESTrackType the #GESTrackElement extracted from @self should get into - @@ -14186,13 +13486,11 @@ should get into - - %TRUE if @self has a natural framerate @FALSE otherwise. @@ -14219,11 +13517,8 @@ should get into - - - + - @@ -14234,7 +13529,6 @@ create the underlying nleobject of a track element - @@ -14247,7 +13541,6 @@ create the underlying nleobject of a track element - @@ -14260,7 +13553,6 @@ create the underlying nleobject of a track element - @@ -14276,7 +13568,6 @@ create the underlying nleobject of a track element - @@ -14289,7 +13580,6 @@ create the underlying nleobject of a track element - @@ -14305,7 +13595,6 @@ create the underlying nleobject of a track element - TRUE if @element and @pspec could be found. FALSE otherwise. In that case the values for @pspec and @element are not modified. Unref @element after @@ -14339,14 +13628,12 @@ usage. - - @@ -14356,12 +13643,8 @@ usage. - - - - - - + + Types of content handled by a track. If the content is not one of @GES_TRACK_TYPE_AUDIO, @GES_TRACK_TYPE_VIDEO or @GES_TRACK_TYPE_TEXT, @@ -14385,7 +13668,6 @@ by users A custom-content track - @@ -14398,7 +13680,6 @@ by users Base class for media transitions. - @@ -14414,7 +13695,6 @@ by users - @@ -14437,12 +13717,10 @@ supported. The ID of the ExtractableType is the nickname of the vtype property value. Note that this value can be changed after creation and the GESExtractable.asset value will be updated when needed. - Creates a new #GESTransitionClip. - a newly created #GESTransitionClip, or %NULL if something went wrong. @@ -14457,7 +13735,6 @@ or %NULL if something went wrong. Creates a new #GESTransitionClip for the provided @nick. - The newly created #GESTransitionClip, or %NULL if something went wrong @@ -14492,7 +13769,6 @@ to apply. - @@ -14502,16 +13778,11 @@ to apply. - - - - - - + + Represents all the output streams from a particular uri. It is assumed that the URI points to a file of some type. - @@ -14521,7 +13792,6 @@ the URI points to a file of some type. > an IO and processing intensive task that you probably don't want to run in > an application mainloop. Have a look at #ges_asset_request_async to see how > to make that operation happen **asynchronously**. - The newly created #GESUriClip, or %NULL if there was an error. @@ -14536,7 +13806,6 @@ the URI points to a file of some type. Get the location of the resource. - The location of the resource. @@ -14550,7 +13819,6 @@ the URI points to a file of some type. Lets you know if @self is an image or not. - %TRUE if @self is a still image %FALSE otherwise. @@ -14564,7 +13832,6 @@ the URI points to a file of some type. Lets you know if the audio track of @self is muted or not. - %TRUE if the audio track of @self is muted, %FALSE otherwise. @@ -14578,7 +13845,6 @@ the URI points to a file of some type. Sets whether the clip is a still image or not. - @@ -14595,7 +13861,6 @@ the URI points to a file of some type. Sets whether the audio track of this clip is muted or not. - @@ -14639,13 +13904,11 @@ before create_track_elements is called. - Finalize the request of an async #GESUriClipAsset - The #GESUriClipAsset previously requested @@ -14686,7 +13949,6 @@ filesource_asset_loaded_cb (GESAsset * source, GAsyncResult * res, gpointer user // The request: ges_uri_clip_asset_new (uri, (GAsyncReadyCallback) filesource_asset_loaded_cb, user_data); ]| - @@ -14712,7 +13974,6 @@ ges_uri_clip_asset_new (uri, (GAsyncReadyCallback) filesource_asset_loaded_cb, u Creates a #GESUriClipAsset for @uri syncronously. You should avoid to use it in application, and rather create #GESUriClipAsset asynchronously - A reference to the requested asset or %NULL if an error happened @@ -14728,7 +13989,6 @@ You can also use multi file uris for #GESMultiFileSource. Gets duration of the file represented by @self - The duration of @self @@ -14742,7 +14002,6 @@ You can also use multi file uris for #GESMultiFileSource. Gets #GstDiscovererInfo about the file - #GstDiscovererInfo of specified asset @@ -14759,7 +14018,6 @@ You can also use multi file uris for #GESMultiFileSource. it is usually the same as GESUriClipAsset::duration, but in the case of nested timelines, for example, they are different as those can be extended 'infinitely'. - The maximum duration of @self @@ -14773,7 +14031,6 @@ are different as those can be extended 'infinitely'. Get the GESUriSourceAsset @self containes - a #GList of #GESUriSourceAsset @@ -14790,7 +14047,6 @@ are different as those can be extended 'infinitely'. Gets Whether the file represented by @self is an image or not - Whether the file represented by @self is an image or not @@ -14823,7 +14079,6 @@ are different as those can be extended 'infinitely'. - @@ -14835,7 +14090,6 @@ are different as those can be extended 'infinitely'. - @@ -14862,7 +14116,6 @@ are different as those can be extended 'infinitely'. Sets the timeout of #GESUriClipAsset loading - @@ -14878,11 +14131,8 @@ are different as those can be extended 'infinitely'. - - - + - @@ -14892,25 +14142,20 @@ are different as those can be extended 'infinitely'. - - - + - Asset to create a stream specific #GESSource for a media file. NOTE: You should never request such a #GESAsset as they will be created automatically by #GESUriClipAsset-s. - Get the #GESUriClipAsset @self is contained in - a #GESUriClipAsset @@ -14924,7 +14169,6 @@ by #GESUriClipAsset-s. Get the #GstDiscovererStreamInfo user by @asset - a #GESUriClipAsset @@ -14937,7 +14181,6 @@ by #GESUriClipAsset-s. - @@ -14949,7 +14192,6 @@ by #GESUriClipAsset-s. Check if @asset contains a single image - %TRUE if the video stream corresponds to an image (i.e. only contains one frame) @@ -14975,7 +14217,6 @@ contains one frame) - @@ -14985,28 +14226,21 @@ contains one frame) - - - + - - - - Base class for video sources - @@ -15017,7 +14251,6 @@ NOTE: The sources take into account the potential video rotation applied by the #videoflip element that is inside the source, effects applied on the clip which potentially also rotate the element are not taken into account. - %TRUE if the object has a natural size, %FALSE otherwise. @@ -15050,13 +14283,11 @@ account. - - @@ -15068,20 +14299,17 @@ account. - - - @@ -15094,7 +14322,6 @@ account. - @@ -15113,7 +14340,6 @@ account. - @@ -15135,9 +14361,7 @@ account. - - - + Transition type has not been set, @@ -15417,12 +14641,10 @@ account. ### Children Properties {{ libs/GESVideoTestSource-children-props.md }} - Get the video pattern used by the @source. - The video pattern used by the @source. @@ -15436,7 +14658,6 @@ account. Sets the source to use the given @pattern. - @@ -15464,7 +14685,6 @@ account. - @@ -15474,9 +14694,7 @@ account. - - - + A #GESVideoTrack is a default video #GESTrack, with a #GES_TRACK_TYPE_VIDEO #GESTrack:track-type and "video/x-raw(ANY)" @@ -15495,7 +14713,6 @@ ges_track_update_restriction_caps() with new values for the fields you wish to change, and any additional fields you may want to add. Unlike using ges_track_set_restriction_caps(), this will ensure that these default fields will at least have some value set. - @@ -15509,7 +14726,6 @@ default fields will at least have some value set. You should use ges_track_update_restriction_caps() if you wish to modify these fields, or add additional ones. - The newly created video track. @@ -15528,7 +14744,6 @@ modify these fields, or add additional ones. - @@ -15538,15 +14753,11 @@ modify these fields, or add additional ones. - - - + - - @@ -15554,7 +14765,6 @@ modify these fields, or add additional ones. Get the border property of @self, this value represents the border width of the transition. - The border values of @self or -1 if not meaningful (this will happen when not using a smpte transition). @@ -15569,7 +14779,6 @@ the border width of the transition. Get the transition type used by @trans. - The transition type used by @trans. @@ -15584,7 +14793,6 @@ the border width of the transition. Get the invert property of @self, this value represents the direction of the transition. - The invert value of @self @@ -15601,7 +14809,6 @@ the direction of the transition. the border width of the transition. In case this value does not make sense for the current transition type, it is cached for later use. - @@ -15621,7 +14828,6 @@ for later use. the direction of the transition. In case this value does not make sense for the current transition type, it is cached for later use. - @@ -15638,7 +14844,6 @@ for later use. Sets the transition being used to @type. - %TRUE if the transition type was properly changed, else %FALSE. @@ -15678,7 +14883,6 @@ for later use. - parent class @@ -15689,14 +14893,11 @@ for later use. - - - + ### Children Properties {{ libs/GESVideoUriSource-children-props.md }} - @@ -15719,7 +14920,6 @@ for later use. - @@ -15729,11 +14929,8 @@ for later use. - - - + - @@ -15748,7 +14945,6 @@ for later use. - @@ -15758,11 +14954,8 @@ for later use. - - - + - @@ -15784,13 +14977,11 @@ This function is therefore mostly used by testsuites and other memory profiling This function should be called from the thread where ges_init() was called. After this call GES should not be used until another ges_init() call. - - A human friendly name for @edge @@ -15804,7 +14995,6 @@ After this call GES should not be used until another ges_init() call. Return a string representation of @mode. - a string representation of @mode. @@ -15820,7 +15010,6 @@ After this call GES should not be used until another ges_init() call. Get the best formatter for @uri. It tries to find a formatter compatible with @uri extension, if none is found, it returns the default formatter asset. - The #GESAsset for the best formatter to save to @uri @@ -15871,7 +15060,6 @@ MT safety. GStreamer Editing Services do not guarantee MT safety. An application is required to use GES APIs (including ges_deinit()) in the thread where ges_init() was called. - @@ -15882,7 +15070,6 @@ and loading evrything needed. This function will return %FALSE if GES could not be initialized for some reason. - %TRUE if GES could be initialized. @@ -15913,7 +15100,6 @@ If you use this function, you should make sure you initialise the GStreamer as one of the very first things in your program. That means you need to use gst_init_get_option_group() and add it to the option context before using the ges_init_get_option_group() result. - a pointer to GES's option group. @@ -15922,7 +15108,6 @@ using the ges_init_get_option_group() result. Use this function to check if GES has been initialized with ges_init() or ges_init_check(). - %TRUE if initialization has been done, %FALSE otherwise. @@ -15936,7 +15121,6 @@ subclasses). Note that, since only a #GESExtractable can be extracted from an asset, using `GES_TYPE_EXTRACTABLE` as @filter will return all the assets in the current cache. - A list of all #GESAsset-s currently in the cache whose #GESAsset:extractable-type is @@ -15956,7 +15140,6 @@ of the @filter type. Get the last buffer @playsink showed Use the "convert-sample" action signal of #playsink instead. - A #GstSample containing the last frame from @playsink in the format defined by the @caps @@ -15974,7 +15157,6 @@ of the @filter type. - @@ -15988,7 +15170,6 @@ of the @filter type. - @@ -16000,7 +15181,6 @@ of the @filter type. Helper macro to retrieve the project from which @obj was extracted - The #GESTimeline from which to retrieve the project @@ -16008,7 +15188,6 @@ of the @filter type. - @@ -16019,14 +15198,12 @@ of the @filter type. - Gets the version number of the GStreamer Editing Services library. - diff --git a/gir-files/GLib-2.0.gir b/gir-files/GLib-2.0.gir index 08934e1bf..539310472 100644 --- a/gir-files/GLib-2.0.gir +++ b/gir-files/GLib-2.0.gir @@ -9,24 +9,20 @@ and/or use gtk-doc annotations. --> Integer representing a day of the month; between 1 and 31. #G_DATE_BAD_DAY represents an invalid day of the month. - Integer representing a year; #G_DATE_BAD_YEAR is the invalid value. The year must be 1 or higher; negative (BC) years are not allowed. The year is represented with four digits. - Opaque type. See g_main_context_pusher_new() for details. - Opaque type. See g_mutex_locker_new() for details. - @@ -37,28 +33,23 @@ while Windows uses process handles (which are pointers). GPid is used in GLib only for descendant processes spawned with the g_spawn functions. - A GQuark is a non-zero integer which uniquely identifies a particular string. A GQuark value of zero is associated to %NULL. - Opaque type. See g_rw_lock_reader_locker_new() for details. - Opaque type. See g_rw_lock_writer_locker_new() for details. - Opaque type. See g_rec_mutex_locker_new() for details. - @@ -69,13 +60,11 @@ called on `char*` arrays not allocated using g_ref_string_new(). If using #GRefString with autocleanups, g_autoptr() must be used rather than g_autofree(), so that the reference counting metadata is also freed. - A typedef alias for gchar**. This is mostly useful when used together with g_auto(). - @@ -99,16 +88,13 @@ gtime = (GTime)ttime; ]| This is not [Y2038-safe](https://en.wikipedia.org/wiki/Year_2038_problem). Use #GDateTime or #time_t instead. - A value representing an interval of time, in microseconds. - - @@ -121,7 +107,6 @@ Note this is not necessarily the same as the value returned by GCC’s `__alignof__` operator, which returns the preferred alignment for a type. The preferred alignment may be a stricter alignment than the minimal alignment. - a type-name @@ -129,7 +114,6 @@ alignment. - @@ -141,7 +125,6 @@ For example, - `G_APPROX_VALUE (3.14, 3.15, 0.001)` evaluates to false - `G_APPROX_VALUE (n, 0.f, FLT_EPSILON)` evaluates to true if `n` is within the single precision floating point epsilon from zero - a numeric value @@ -165,11 +148,9 @@ The typical usage would be something like: fprintf (out, "value=%s\n", g_ascii_dtostr (buf, sizeof (buf), value)); ]| - - @@ -177,7 +158,6 @@ The typical usage would be something like: Contains the public fields of a GArray. - a pointer to the element data. The data may be moved as elements are added to the #GArray. @@ -190,7 +170,6 @@ The typical usage would be something like: Adds @len elements onto the end of the array. - the #GArray @@ -241,7 +220,6 @@ guint matched_index; gboolean result = g_array_binary_search (garray, &i, cmpint, &matched_index); ... ]| - %TRUE if @target is one of the elements of @array, %FALSE otherwise. @@ -271,7 +249,6 @@ gboolean result = g_array_binary_search (garray, &i, cmpint, &matched_in Create a shallow copy of a #GArray. If the array elements consist of pointers to data, the pointers are copied but the actual data is not. - A copy of @array. @@ -302,7 +279,6 @@ function has been set for @array. This function is not thread-safe. If using a #GArray from multiple threads, use only the atomic g_array_ref() and g_array_unref() functions. - the element data if @free_segment is %FALSE, otherwise %NULL. The element data should be freed using g_free(). @@ -323,7 +299,6 @@ functions. Gets the size of the elements in @array. - Size of each element, in bytes @@ -351,7 +326,6 @@ upwards. @data may be %NULL if (and only if) @len is zero. If @len is zero, this function is a no-op. - the #GArray @@ -381,7 +355,6 @@ function is a no-op. Creates a new #GArray with a reference count of 1. - the new #GArray @@ -414,7 +387,6 @@ function is a no-op. This operation is slower than g_array_append_vals() since the existing elements in the array have to be moved to make space for the new elements. - the #GArray @@ -441,7 +413,6 @@ the new elements. Atomically increments the reference count of @array by one. This function is thread-safe and may be called from any thread. - The passed in #GArray @@ -460,7 +431,6 @@ This function is thread-safe and may be called from any thread. Removes the element at the given index from a #GArray. The following elements are moved down one place. - the #GArray @@ -485,7 +455,6 @@ elements are moved down one place. element in the array is used to fill in the space, so this function does not preserve the order of the #GArray. But it is faster than g_array_remove_index(). - the #GArray @@ -508,7 +477,6 @@ g_array_remove_index(). Removes the given number of elements starting at the given index from a #GArray. The following elements are moved to close the gap. - the #GArray @@ -543,7 +511,6 @@ pointer to the element to clear, rather than the element itself. Note that in contrast with other uses of #GDestroyNotify functions, @clear_func is expected to clear the contents of the array element it is given, but not free the element itself. - @@ -563,7 +530,6 @@ the array element it is given, but not free the element itself. Sets the size of the array, expanding it if necessary. If the array was created with @clear_ set to %TRUE, the new elements are set to 0. - the #GArray @@ -588,7 +554,6 @@ was created with @clear_ set to %TRUE, the new elements are set to 0. a reference count of 1. This avoids frequent reallocation, if you are going to add many elements to the array. Note however that the size of the array is still 0. - the new #GArray @@ -623,7 +588,6 @@ than second arg, zero for equal, greater zero if first arg is greater than second arg). This is guaranteed to be a stable sort since version 2.32. - @@ -649,7 +613,6 @@ This is guaranteed to be a stable sort since version 2.32. There used to be a comment here about making the sort stable by using the addresses of the elements in the comparison function. This did not actually work, so any such code should be removed. - @@ -689,7 +652,6 @@ gsize data_len; data = g_array_steal (some_array, &data_len); ... ]| - the element data, which should be freed using g_free(). @@ -714,7 +676,6 @@ data = g_array_steal (some_array, &data_len); reference count drops to 0, all memory allocated by the array is released. This function is thread-safe and may be called from any thread. - @@ -729,7 +690,6 @@ thread. - @@ -757,7 +717,6 @@ thread. The GAsyncQueue struct is an opaque data structure which represents an asynchronous queue. It should only be accessed through the g_async_queue_* functions. - Returns the length of the queue. @@ -767,7 +726,6 @@ value means waiting threads, and a positive value means available entries in the @queue. A return value of 0 could mean n entries in the queue and n threads waiting. This can happen due to locking of the queue or due to scheduling. - the length of the @queue @@ -790,7 +748,6 @@ in the queue and n threads waiting. This can happen due to locking of the queue or due to scheduling. This function must be called while holding the @queue's lock. - the length of the @queue. @@ -812,7 +769,6 @@ Call g_async_queue_unlock() to drop the lock again. While holding the lock, you can only call the g_async_queue_*_unlocked() functions on @queue. Otherwise, deadlock may occur. - @@ -826,7 +782,6 @@ deadlock may occur. Pops data from the @queue. If @queue is empty, this function blocks until data becomes available. - data from the queue @@ -843,7 +798,6 @@ blocks until data becomes available. blocks until data becomes available. This function must be called while holding the @queue's lock. - data from the queue. @@ -857,7 +811,6 @@ This function must be called while holding the @queue's lock. Pushes the @data into the @queue. @data must not be %NULL. - @@ -877,7 +830,6 @@ This function must be called while holding the @queue's lock. In contrast to g_async_queue_push(), this function pushes the new item ahead of the items already in the queue, so that it will be the next one to be popped off the queue. - @@ -899,7 +851,6 @@ pushes the new item ahead of the items already in the queue, so that it will be the next one to be popped off the queue. This function must be called while holding the @queue's lock. - @@ -925,7 +876,6 @@ This function will lock @queue before it sorts the queue and unlock it when it is finished. For an example of @func see g_async_queue_sort(). - @@ -964,7 +914,6 @@ new elements, see g_async_queue_sort(). This function must be called while holding the @queue's lock. For an example of @func see g_async_queue_sort(). - @@ -991,7 +940,6 @@ For an example of @func see g_async_queue_sort(). Pushes the @data into the @queue. @data must not be %NULL. This function must be called while holding the @queue's lock. - @@ -1009,7 +957,6 @@ This function must be called while holding the @queue's lock. Increases the reference count of the asynchronous @queue by 1. You do not need to hold the lock to call this function. - the @queue that was passed in (since 2.6) @@ -1026,7 +973,6 @@ You do not need to hold the lock to call this function. Reference counting is done atomically. so g_async_queue_ref() can be used regardless of the @queue's lock. - @@ -1039,7 +985,6 @@ lock. Remove an item from the queue. - %TRUE if the item was removed @@ -1059,7 +1004,6 @@ lock. Remove an item from the queue. This function must be called while holding the @queue's lock. - %TRUE if the item was removed @@ -1098,7 +1042,6 @@ lowest priority would be at the top of the queue, you could use: return (id1 > id2 ? +1 : id1 == id2 ? 0 : -1); ]| - @@ -1127,7 +1070,6 @@ if the first element should be lower in the @queue than the second element. This function must be called while holding the @queue's lock. - @@ -1155,7 +1097,6 @@ If no data is received before @end_time, %NULL is returned. To easily calculate @end_time, a combination of g_get_real_time() and g_time_val_add() can be used. use g_async_queue_timeout_pop(). - data from the queue or %NULL, when no data is received before @end_time. @@ -1183,7 +1124,6 @@ and g_time_val_add() can be used. This function must be called while holding the @queue's lock. use g_async_queue_timeout_pop_unlocked(). - data from the queue or %NULL, when no data is received before @end_time. @@ -1205,7 +1145,6 @@ This function must be called while holding the @queue's lock. @timeout microseconds, or until data becomes available. If no data is received before the timeout, %NULL is returned. - data from the queue or %NULL, when no data is received before the timeout. @@ -1229,7 +1168,6 @@ If no data is received before the timeout, %NULL is returned. If no data is received before the timeout, %NULL is returned. This function must be called while holding the @queue's lock. - data from the queue or %NULL, when no data is received before the timeout. @@ -1249,7 +1187,6 @@ This function must be called while holding the @queue's lock. Tries to pop data from the @queue. If no data is available, %NULL is returned. - data from the queue or %NULL, when no data is available immediately. @@ -1267,7 +1204,6 @@ This function must be called while holding the @queue's lock. %NULL is returned. This function must be called while holding the @queue's lock. - data from the queue or %NULL, when no data is available immediately. @@ -1286,7 +1222,6 @@ This function must be called while holding the @queue's lock. Calling this function when you have not acquired the with g_async_queue_lock() leads to undefined behaviour. - @@ -1304,7 +1239,6 @@ If the reference count went to 0, the @queue will be destroyed and the memory allocated will be freed. So you are not allowed to use the @queue afterwards, as it might have disappeared. You do not need to hold the lock to call this function. - @@ -1323,7 +1257,6 @@ will be destroyed and the memory allocated will be freed. Reference counting is done atomically. so g_async_queue_unref() can be used regardless of the @queue's lock. - @@ -1336,7 +1269,6 @@ lock. Creates a new asynchronous queue. - a new #GAsyncQueue. Free with g_async_queue_unref() @@ -1346,7 +1278,6 @@ lock. Creates a new asynchronous queue and sets up a destroy notify function that is used to free any remaining queue items when the queue is destroyed after the final unref. - a new #GAsyncQueue. Free with g_async_queue_unref() @@ -1362,13 +1293,11 @@ the queue is destroyed after the final unref. Specifies one of the possible types of byte order. See #G_BYTE_ORDER. - The `GBookmarkFile` structure contains only private data and should not be directly accessed. - Adds the application with @name and @exec to the list of applications that have registered a bookmark for @uri into @@ -1392,7 +1321,6 @@ with the same @name had already registered a bookmark for @uri inside @bookmark. If no bookmark for @uri is found, one is created. - @@ -1421,7 +1349,6 @@ If no bookmark for @uri is found, one is created. belongs to. If no bookmark for @uri is found then it is created. - @@ -1442,7 +1369,6 @@ If no bookmark for @uri is found then it is created. Frees a #GBookmarkFile. - @@ -1460,7 +1386,6 @@ In the event the URI cannot be found, -1 is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. Use g_bookmark_file_get_added_date_time() instead, as `time_t` is deprecated due to the year 2038 problem. - a timestamp @@ -1481,7 +1406,6 @@ In the event the URI cannot be found, -1 is returned and In the event the URI cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - a #GDateTime @@ -1513,7 +1437,6 @@ the command line fails, an error of the #G_SHELL_ERROR domain is set and %FALSE is returned. Use g_bookmark_file_get_application_info() instead, as `time_t` is deprecated due to the year 2038 problem. - %TRUE on success. @@ -1559,7 +1482,6 @@ for @uri, %FALSE is returned and error is set to #G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. In the event that unquoting the command line fails, an error of the #G_SHELL_ERROR domain is set and %FALSE is returned. - %TRUE on success. @@ -1597,7 +1519,6 @@ bookmark for @uri. In the event the URI cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - a newly allocated %NULL-terminated array of strings. Use g_strfreev() to free it. @@ -1625,7 +1546,6 @@ In the event the URI cannot be found, %NULL is returned and In the event the URI cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - a newly allocated string or %NULL if the specified URI cannot be found. @@ -1650,7 +1570,6 @@ In the event the URI cannot be found, %NULL is returned and The returned array is %NULL terminated, so @length may optionally be %NULL. - a newly allocated %NULL-terminated array of group names. Use g_strfreev() to free it. @@ -1678,7 +1597,6 @@ be %NULL. In the event the URI cannot be found, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - %TRUE if the icon for the bookmark for the URI was found. You should free the returned strings. @@ -1710,7 +1628,6 @@ In the event the URI cannot be found, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the event that the private flag cannot be found, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_INVALID_VALUE. - %TRUE if the private flag is set, %FALSE otherwise. @@ -1733,7 +1650,6 @@ In the event the URI cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the event that the MIME type cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_INVALID_VALUE. - a newly allocated string or %NULL if the specified URI cannot be found. @@ -1757,7 +1673,6 @@ In the event the URI cannot be found, -1 is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. Use g_bookmark_file_get_modified_date_time() instead, as `time_t` is deprecated due to the year 2038 problem. - a timestamp @@ -1778,7 +1693,6 @@ In the event the URI cannot be found, -1 is returned and In the event the URI cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - a #GDateTime @@ -1796,7 +1710,6 @@ In the event the URI cannot be found, %NULL is returned and Gets the number of bookmarks inside @bookmark. - the number of bookmarks @@ -1815,7 +1728,6 @@ If @uri is %NULL, the title of @bookmark is returned. In the event the URI cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - a newly allocated string or %NULL if the specified URI cannot be found. @@ -1836,7 +1748,6 @@ In the event the URI cannot be found, %NULL is returned and Returns all URIs of the bookmarks in the bookmark file @bookmark. The array of returned URIs will be %NULL-terminated, so @length may optionally be %NULL. - a newly allocated %NULL-terminated array of strings. Use g_strfreev() to free it. @@ -1862,7 +1773,6 @@ In the event the URI cannot be found, -1 is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. Use g_bookmark_file_get_visited_date_time() instead, as `time_t` is deprecated due to the year 2038 problem. - a timestamp. @@ -1883,7 +1793,6 @@ In the event the URI cannot be found, -1 is returned and In the event the URI cannot be found, %NULL is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - a #GDateTime @@ -1905,7 +1814,6 @@ registered by application @name. In the event the URI cannot be found, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - %TRUE if the application @name was found @@ -1931,7 +1839,6 @@ the bookmark for @uri belongs to. In the event the URI cannot be found, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - %TRUE if @group was found. @@ -1953,7 +1860,6 @@ In the event the URI cannot be found, %FALSE is returned and Looks whether the desktop bookmark has an item with its URI set to @uri. - %TRUE if @uri is inside @bookmark, %FALSE otherwise @@ -1973,7 +1879,6 @@ In the event the URI cannot be found, %FALSE is returned and Loads a bookmark file from memory into an empty #GBookmarkFile structure. If the object cannot be created then @error is set to a #GBookmarkFileError. - %TRUE if a desktop bookmark could be loaded. @@ -2002,7 +1907,6 @@ paths returned from g_get_user_data_dir() and g_get_system_data_dirs(), loads the file into @bookmark and returns the file's full path in @full_path. If the file could not be loaded then @error is set to either a #GFileError or #GBookmarkFileError. - %TRUE if a key file could be loaded, %FALSE otherwise @@ -2027,7 +1931,6 @@ set to either a #GFileError or #GBookmarkFileError. Loads a desktop bookmark file into an empty #GBookmarkFile structure. If the file could not be loaded then @error is set to either a #GFileError or #GBookmarkFileError. - %TRUE if a desktop bookmark file could be loaded @@ -2051,7 +1954,6 @@ existing bookmark for @new_uri will be overwritten. If @new_uri is In the event the URI cannot be found, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. - %TRUE if the URI was successfully changed @@ -2080,7 +1982,6 @@ In the event the URI cannot be found, %FALSE is returned and In the event that no application with name @app_name has registered a bookmark for @uri, %FALSE is returned and error is set to #G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. - %TRUE if the application was successfully removed. @@ -2108,7 +2009,6 @@ In the event the URI cannot be found, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND. In the event no group was defined, %FALSE is returned and @error is set to #G_BOOKMARK_FILE_ERROR_INVALID_VALUE. - %TRUE if @group was successfully removed. @@ -2130,7 +2030,6 @@ In the event no group was defined, %FALSE is returned and Removes the bookmark for @uri from the bookmark file @bookmark. - %TRUE if the bookmark was removed successfully. @@ -2152,7 +2051,6 @@ In the event no group was defined, %FALSE is returned and If no bookmark for @uri is found then it is created. Use g_bookmark_file_set_added_date_time() instead, as `time_t` is deprecated due to the year 2038 problem. - @@ -2175,7 +2073,6 @@ If no bookmark for @uri is found then it is created. Sets the time the bookmark for @uri was added into @bookmark. If no bookmark for @uri is found then it is created. - @@ -2225,7 +2122,6 @@ for @uri, %FALSE is returned and error is set to for @uri is found, one is created. Use g_bookmark_file_set_application_info() instead, as `time_t` is deprecated due to the year 2038 problem. - %TRUE if the application's meta-data was successfully changed. @@ -2286,7 +2182,6 @@ in the event that no application @name has registered a bookmark for @uri, %FALSE is returned and error is set to #G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED. Otherwise, if no bookmark for @uri is found, one is created. - %TRUE if the application's meta-data was successfully changed. @@ -2326,7 +2221,6 @@ for @uri is found, one is created. If @uri is %NULL, the description of @bookmark is set. If a bookmark for @uri cannot be found then it is created. - @@ -2350,7 +2244,6 @@ If a bookmark for @uri cannot be found then it is created. set group name list is removed. If @uri cannot be found then an item for it is created. - @@ -2382,7 +2275,6 @@ the currently set icon. @href can either be a full URL for the icon file or the icon name following the Icon Naming specification. If no bookmark for @uri is found one is created. - @@ -2409,7 +2301,6 @@ If no bookmark for @uri is found one is created. Sets the private flag of the bookmark for @uri. If a bookmark for @uri cannot be found then it is created. - @@ -2432,7 +2323,6 @@ If a bookmark for @uri cannot be found then it is created. Sets @mime_type as the MIME type of the bookmark for @uri. If a bookmark for @uri cannot be found then it is created. - @@ -2462,7 +2352,6 @@ modifies a bookmark also changes the modification time, except for g_bookmark_file_set_visited_date_time(). Use g_bookmark_file_set_modified_date_time() instead, as `time_t` is deprecated due to the year 2038 problem. - @@ -2490,7 +2379,6 @@ The "modified" time should only be set when the bookmark's meta-data was actually changed. Every function of #GBookmarkFile that modifies a bookmark also changes the modification time, except for g_bookmark_file_set_visited_date_time(). - @@ -2516,7 +2404,6 @@ bookmark file @bookmark. If @uri is %NULL, the title of @bookmark is set. If a bookmark for @uri cannot be found then it is created. - @@ -2547,7 +2434,6 @@ using g_bookmark_file_get_mime_type(). Changing the "visited" time does not affect the "modified" time. Use g_bookmark_file_set_visited_date_time() instead, as `time_t` is deprecated due to the year 2038 problem. - @@ -2576,7 +2462,6 @@ either using the command line retrieved by g_bookmark_file_get_application_info( or by the default application for the bookmark's MIME type, retrieved using g_bookmark_file_get_mime_type(). Changing the "visited" time does not affect the "modified" time. - @@ -2597,7 +2482,6 @@ does not affect the "modified" time. This function outputs @bookmark as a string. - a newly allocated string holding the contents of the #GBookmarkFile @@ -2619,7 +2503,6 @@ does not affect the "modified" time. This function outputs @bookmark into a file. The write process is guaranteed to be atomic by using g_file_set_contents() internally. - %TRUE if the file was successfully written. @@ -2646,7 +2529,6 @@ guaranteed to be atomic by using g_file_set_contents() internally. Use g_bookmark_file_load_from_file(), g_bookmark_file_load_from_data() or g_bookmark_file_load_from_data_dirs() to read an existing bookmark file. - an empty #GBookmarkFile @@ -2655,7 +2537,6 @@ file. Error codes returned by bookmark file parsing. - URI was ill-formed @@ -2685,7 +2566,6 @@ file. Contains the public fields of a GByteArray. - a pointer to the element data. The data may be moved as elements are added to the #GByteArray @@ -2698,7 +2578,6 @@ file. Adds the given bytes to the end of the #GByteArray. The array will grow in size automatically if necessary. - the #GByteArray @@ -2727,7 +2606,6 @@ The array will grow in size automatically if necessary. %TRUE it frees the actual byte data. If the reference count of @array is greater than one, the #GByteArray wrapper is preserved but the size of @array will be set to zero. - the element data if @free_segment is %FALSE, otherwise %NULL. The element data should be freed using g_free(). @@ -2755,7 +2633,6 @@ will be set to zero. This is identical to using g_bytes_new_take() and g_byte_array_free() together. - a new immutable #GBytes representing same byte data that was in the array @@ -2772,7 +2649,6 @@ together. Creates a new #GByteArray with a reference count of 1. - the new #GByteArray @@ -2783,7 +2659,6 @@ together. Create byte array containing the data. The data will be owned by the array and will be freed with g_free(), i.e. it could be allocated using g_strdup(). - a new #GByteArray @@ -2806,7 +2681,6 @@ and will be freed with g_free(), i.e. it could be allocated using g_strdup(). Adds the given data to the start of the #GByteArray. The array will grow in size automatically if necessary. - the #GByteArray @@ -2833,7 +2707,6 @@ The array will grow in size automatically if necessary. Atomically increments the reference count of @array by one. This function is thread-safe and may be called from any thread. - The passed in #GByteArray @@ -2852,7 +2725,6 @@ This function is thread-safe and may be called from any thread. Removes the byte at the given index from a #GByteArray. The following bytes are moved down one place. - the #GByteArray @@ -2877,7 +2749,6 @@ The following bytes are moved down one place. element in the array is used to fill in the space, so this function does not preserve the order of the #GByteArray. But it is faster than g_byte_array_remove_index(). - the #GByteArray @@ -2900,7 +2771,6 @@ than g_byte_array_remove_index(). Removes the given number of bytes starting at the given index from a #GByteArray. The following elements are moved to close the gap. - the #GByteArray @@ -2926,7 +2796,6 @@ than g_byte_array_remove_index(). Sets the size of the #GByteArray, expanding it if necessary. - the #GByteArray @@ -2951,7 +2820,6 @@ than g_byte_array_remove_index(). This avoids frequent reallocation, if you are going to add many bytes to the array. Note however that the size of the array is still 0. - the new #GByteArray @@ -2976,7 +2844,6 @@ is undefined. If you want equal elements to keep their order (i.e. you want a stable sort) you can write a comparison function that, if two elements would otherwise compare equal, compares them by their addresses. - @@ -2996,7 +2863,6 @@ their addresses. Like g_byte_array_sort(), but the comparison function takes an extra user data argument. - @@ -3021,7 +2887,6 @@ user data argument. Frees the data in the array and resets the size to zero, while the underlying array is preserved for use elsewhere and returned to the caller. - the element data, which should be freed using g_free(). @@ -3046,7 +2911,6 @@ to the caller. reference count drops to 0, all memory allocated by the array is released. This function is thread-safe and may be called from any thread. - @@ -3085,12 +2949,10 @@ The data pointed to by this bytes must not be modified. For a mutable array of bytes see #GByteArray. Use g_bytes_unref_to_array() to create a mutable array for a #GBytes sequence. To create an immutable #GBytes from a mutable #GByteArray, use the g_byte_array_free_to_bytes() function. - Creates a new #GBytes from @data. @data is copied. If @size is 0, @data may be %NULL. - a new #GBytes @@ -3114,7 +2976,6 @@ a mutable #GByteArray, use the g_byte_array_free_to_bytes() function. @data must be static (ie: never modified or freed). It may be %NULL if @size is 0. - a new #GBytes @@ -3146,7 +3007,6 @@ For creating #GBytes with memory from other allocators, see g_bytes_new_with_free_func(). @data may be %NULL if @size is 0. - a new #GBytes @@ -3175,7 +3035,6 @@ When the last reference is dropped, @free_func will be called with the been called to indicate that the bytes is no longer in use. @data may be %NULL if @size is 0. - a new #GBytes @@ -3212,7 +3071,6 @@ prefix of the longer one then the shorter one is considered to be less than the longer one. Otherwise the first byte where both differ is used for comparison. If @bytes1 has a smaller value at that position it is considered less, otherwise greater than @bytes2. - a negative value if @bytes1 is less than @bytes2, a positive value if @bytes1 is greater than @bytes2, and zero if @bytes1 is equal to @@ -3236,7 +3094,6 @@ considered less, otherwise greater than @bytes2. This function can be passed to g_hash_table_new() as the @key_equal_func parameter, when using non-%NULL #GBytes pointers as keys in a #GHashTable. - %TRUE if the two keys match. @@ -3260,7 +3117,6 @@ This function will always return the same pointer for a given #GBytes. %NULL may be returned if @size is 0. This is not guaranteed, as the #GBytes may represent an empty string with @data non-%NULL and @size as 0. %NULL will not be returned if @size is non-zero. - a pointer to the byte data, or %NULL @@ -3283,7 +3139,6 @@ not be returned if @size is non-zero. Get the size of the byte data in the #GBytes. This function will always return the same value for a given #GBytes. - the size @@ -3300,7 +3155,6 @@ This function will always return the same value for a given #GBytes. This function can be passed to g_hash_table_new() as the @key_hash_func parameter, when using non-%NULL #GBytes pointers as keys in a #GHashTable. - a hash value corresponding to the key. @@ -3324,7 +3178,6 @@ Since 2.56, if @offset is 0 and @length matches the size of @bytes, then is a slice of another #GBytes, then the resulting #GBytes will reference the same #GBytes instead of @bytes. This allows consumers to simplify the usage of #GBytes when asynchronously writing to streams. - a new #GBytes @@ -3346,7 +3199,6 @@ usage of #GBytes when asynchronously writing to streams. Increase the reference count on @bytes. - the #GBytes @@ -3361,7 +3213,6 @@ usage of #GBytes when asynchronously writing to streams. Releases a reference on @bytes. This may result in the bytes being freed. If @bytes is %NULL, it will return immediately. - @@ -3380,7 +3231,6 @@ As an optimization, the byte data is transferred to the array without copying if this was the last reference to bytes and bytes was created with g_bytes_new(), g_bytes_new_take() or g_byte_array_free_to_bytes(). In all other cases the data is copied. - a new mutable #GByteArray containing the same byte data @@ -3402,7 +3252,6 @@ As an optimization, the byte data is returned without copying if this was the last reference to bytes and bytes was created with g_bytes_new(), g_bytes_new_take() or g_byte_array_free_to_bytes(). In all other cases the data is copied. - a pointer to the same byte data, which should be freed with g_free() @@ -3425,7 +3274,6 @@ data is copied. Checks the version of the GLib library that is being compiled against. See glib_check_version() for a runtime check. - the major version to check for @@ -3442,28 +3290,24 @@ against. See glib_check_version() for a runtime check. The set of uppercase ASCII alphabet characters. Used for specifying valid identifier characters in #GScannerConfig. - The set of ASCII digits. Used for specifying valid identifier characters in #GScannerConfig. - The set of lowercase ASCII alphabet characters. Used for specifying valid identifier characters in #GScannerConfig. - An opaque structure representing a checksumming operation. To create a new GChecksum, use g_checksum_new(). To free a GChecksum, use g_checksum_free(). - Creates a new #GChecksum, using the checksum algorithm @checksum_type. If the @checksum_type is not known, %NULL is returned. @@ -3478,7 +3322,6 @@ vector of raw bytes. Once either g_checksum_get_string() or g_checksum_get_digest() have been called on a #GChecksum, the checksum will be closed and it won't be possible to call g_checksum_update() on it anymore. - the newly created #GChecksum, or %NULL. Use g_checksum_free() to free the memory allocated by it. @@ -3495,7 +3338,6 @@ on it anymore. Copies a #GChecksum. If @checksum has been closed, by calling g_checksum_get_string() or g_checksum_get_digest(), the copied checksum will be closed as well. - the copy of the passed #GChecksum. Use g_checksum_free() when finished using it. @@ -3510,7 +3352,6 @@ checksum will be closed as well. Frees the memory allocated for @checksum. - @@ -3527,7 +3368,6 @@ into @buffer. The size of the digest depends on the type of checksum. Once this function has been called, the #GChecksum is closed and can no longer be updated with g_checksum_update(). - @@ -3556,7 +3396,6 @@ Once this function has been called the #GChecksum can no longer be updated with g_checksum_update(). The hexadecimal characters will be lower case. - the hexadecimal representation of the checksum. The returned string is owned by the checksum and should not be modified @@ -3572,7 +3411,6 @@ The hexadecimal characters will be lower case. Resets the state of the @checksum back to its initial state. - @@ -3587,7 +3425,6 @@ The hexadecimal characters will be lower case. Feeds @data into an existing #GChecksum. The checksum must still be open, that is g_checksum_get_string() or g_checksum_get_digest() must not have been called on @checksum. - @@ -3610,7 +3447,6 @@ not have been called on @checksum. Gets the length in bytes of digests of type @checksum_type - the checksum length, or -1 if @checksum_type is not supported. @@ -3630,7 +3466,6 @@ digest of some data. Note that the #GChecksumType enumeration may be extended at a later date to include new hashing algorithm types. - Use the MD5 hashing algorithm @@ -3651,7 +3486,6 @@ date to include new hashing algorithm types. Prototype of a #GChildWatchSource callback, called when a child process has exited. To interpret @status, see the documentation for g_spawn_check_exit_status(). - @@ -3676,7 +3510,6 @@ for g_spawn_check_exit_status(). The implementation is expected to free the resource identified by @handle_id; for instance, if @handle_id is a #GSource ID, g_source_remove() can be used. - @@ -3692,7 +3525,6 @@ g_source_remove() can be used. values. The function should return a negative integer if the first value comes before the second, 0 if they are equal, or a positive integer if the first value comes after the second. - negative value if @a < @b; zero if @a = @b; positive value if @a > @b @@ -3718,7 +3550,6 @@ integer if the first value comes after the second. values. The function should return a negative integer if the first value comes before the second, 0 if they are equal, or a positive integer if the first value comes after the second. - negative value if @a < @b; zero if @a = @b; positive value if @a > @b @@ -3801,7 +3632,6 @@ without initialisation. Otherwise, you should call g_cond_init() on it and g_cond_clear() when done. A #GCond should only be accessed via the g_cond_ functions. - @@ -3815,7 +3645,6 @@ A #GCond should only be accessed via the g_cond_ functions. If no threads are waiting for @cond, this function has no effect. It is good practice to lock the same mutex as the waiting threads while calling this function, though not required. - @@ -3834,7 +3663,6 @@ statically allocated. Calling g_cond_clear() for a #GCond on which threads are blocking leads to undefined behaviour. - @@ -3857,7 +3685,6 @@ needed, use g_cond_clear(). Calling g_cond_init() on an already-initialised #GCond leads to undefined behaviour. - @@ -3873,7 +3700,6 @@ to undefined behaviour. If no threads are waiting for @cond, this function has no effect. It is good practice to hold the same lock as the waiting thread while calling this function, though not required. - @@ -3899,7 +3725,6 @@ condition is no longer met. For this reason, g_cond_wait() must always be used in a loop. See the documentation for #GCond for a complete example. - @@ -3963,7 +3788,6 @@ time on this API -- if a relative time of 5 seconds were passed directly to the call and a spurious wakeup occurred, the program would have to start over waiting again (which would lead to a total wait time of more than 5 seconds). - %TRUE on a signal, %FALSE on a timeout @@ -3986,7 +3810,6 @@ time of more than 5 seconds). Error codes returned by character set conversion routines. - Conversion between the requested character sets is not supported. @@ -4020,7 +3843,6 @@ time of more than 5 seconds). A function of this signature is used to copy the node data when doing a deep-copy of a tree. - A pointer to the copy @@ -4040,22 +3862,18 @@ when doing a deep-copy of a tree. A bitmask that restricts the possible flags passed to g_datalist_set_flags(). Passing a flags value where flags & ~G_DATALIST_FLAGS_MASK != 0 is an error. - Represents an invalid #GDateDay. - Represents an invalid Julian day number. - Represents an invalid year. - @@ -4076,7 +3894,6 @@ G_DEFINE_AUTOPTR_CLEANUP_FUNC(GObject, g_object_unref) This macro should be used unconditionally; it is a no-op on compilers where cleanup is not supported. - a type name to define a g_autoptr() cleanup function for @@ -4100,7 +3917,6 @@ G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC(GQueue, g_queue_clear) This macro should be used unconditionally; it is a no-op on compilers where cleanup is not supported. - a type name to define a g_auto() cleanup function for @@ -4131,7 +3947,6 @@ G_DEFINE_AUTO_CLEANUP_FREE_FUNC(GStrv, g_strfreev, NULL) This macro should be used unconditionally; it is a no-op on compilers where cleanup is not supported. - a type name to define a g_auto() cleanup function for @@ -4151,7 +3966,6 @@ where cleanup is not supported. Note that the quark name will be stringified automatically in the macro, so you shouldn't use double quotes. - the name to return a #GQuark for @@ -4162,154 +3976,132 @@ in the macro, so you shouldn't use double quotes. - - - - - - - - - - - - - - - - - - - - - - @@ -4325,7 +4117,6 @@ before the function declaration. G_DEPRECATED_FOR(my_replacement) int my_mistake (void); ]| - the name of the function that this function was deprecated for @@ -4333,455 +4124,390 @@ int my_mistake (void); - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -4790,26 +4516,22 @@ int my_mistake (void); The directory separator character. This is '/' on UNIX machines and '\' under Windows. - The directory separator as a string. This is "/" on UNIX machines and "\" under Windows. - The #GData struct is an opaque data structure to represent a [Keyed Data List][glib-Keyed-Data-Lists]. It should only be accessed via the following functions. - Specifies the type of function passed to g_dataset_foreach(). It is called with each #GQuark id and associated data element, together with the @user_data parameter supplied to g_dataset_foreach(). - @@ -4840,7 +4562,6 @@ initialized with g_date_clear(). g_date_clear() makes the date invalid but safe. An invalid date doesn't represent a day, it's "empty." A date becomes valid after you set it to a Julian day or you set a day, month, and year. - the Julian representation of the date @@ -4872,7 +4593,6 @@ and year. it to a safe state. The new date will be cleared (as if you'd called g_date_clear()) but invalid (it won't represent an existing day). Free the return value with g_date_free(). - a newly-allocated #GDate @@ -4882,7 +4602,6 @@ represent an existing day). Free the return value with g_date_free(). Like g_date_new(), but also sets the value of the date. Assuming the day-month-year triplet you pass in represents an existing day, the returned date will be valid. - a newly-allocated #GDate initialized with @day, @month, and @year @@ -4906,7 +4625,6 @@ returned date will be valid. Like g_date_new(), but also sets the value of the date. Assuming the Julian day number you pass in is valid (greater than 0, less than an unreasonably large number), the returned date will be valid. - a newly-allocated #GDate initialized with @julian_day @@ -4922,7 +4640,6 @@ unreasonably large number), the returned date will be valid. Increments a date some number of days. To move forward by weeks, add weeks*7 days. The date must be valid. - @@ -4943,7 +4660,6 @@ If the day of the month is greater than 28, this routine may change the day of the month (because the destination month may not have the current day in it). The date must be valid. - @@ -4963,7 +4679,6 @@ the current day in it). The date must be valid. If the date is February 29, and the destination year is not a leap year, the date will be changed to February 28. The date must be valid. - @@ -4984,7 +4699,6 @@ If @date falls after @max_date, sets @date equal to @max_date. Otherwise, @date is unchanged. Either of @min_date and @max_date may be %NULL. All non-%NULL dates must be valid. - @@ -5008,7 +4722,6 @@ All non-%NULL dates must be valid. state. The cleared dates will not represent an existing date, but will not contain garbage. Useful to init a date declared on the stack. Validity can be tested with g_date_valid(). - @@ -5026,7 +4739,6 @@ Validity can be tested with g_date_valid(). qsort()-style comparison function for dates. Both dates must be valid. - 0 for equal, less than zero if @lhs is less than @rhs, greater than zero if @lhs is greater than @rhs @@ -5047,7 +4759,6 @@ Both dates must be valid. Copies a GDate to a newly-allocated GDate. If the input was invalid (as determined by g_date_valid()), the invalid state will be copied as is into the new object. - a newly-allocated #GDate initialized from @date @@ -5063,7 +4774,6 @@ as is into the new object. Computes the number of days between two dates. If @date2 is prior to @date1, the returned value is negative. Both dates must be valid. - the number of days between @date1 and @date2 @@ -5081,7 +4791,6 @@ Both dates must be valid. Frees a #GDate returned from g_date_new(). - @@ -5094,7 +4803,6 @@ Both dates must be valid. Returns the day of the month. The date must be valid. - day of the month @@ -5109,7 +4817,6 @@ Both dates must be valid. Returns the day of the year, where Jan 1 is the first day of the year. The date must be valid. - day of the year @@ -5124,7 +4831,6 @@ year. The date must be valid. Returns the week of the year, where weeks are interpreted according to ISO 8601. - ISO 8601 week number of the year. @@ -5141,7 +4847,6 @@ to ISO 8601. Julian day is simply the number of days since January 1, Year 1; i.e., January 1, Year 1 is Julian day 1; January 2, Year 1 is Julian day 2, etc. The date must be valid. - Julian day @@ -5157,7 +4862,6 @@ etc. The date must be valid. Returns the week of the year, where weeks are understood to start on Monday. If the date is before the first Monday of the year, return 0. The date must be valid. - week of the year @@ -5171,7 +4875,6 @@ The date must be valid. Returns the month of the year. The date must be valid. - month of the year as a #GDateMonth @@ -5187,7 +4890,6 @@ The date must be valid. Returns the week of the year during which this date falls, if weeks are understood to begin on Sunday. The date must be valid. Can return 0 if the day is before the first Sunday of the year. - week number @@ -5201,7 +4903,6 @@ Can return 0 if the day is before the first Sunday of the year. Returns the day of the week for a #GDate. The date must be valid. - day of the week as a #GDateWeekday. @@ -5215,7 +4916,6 @@ Can return 0 if the day is before the first Sunday of the year. Returns the year of a #GDate. The date must be valid. - year in which the date falls @@ -5230,7 +4930,6 @@ Can return 0 if the day is before the first Sunday of the year. Returns %TRUE if the date is on the first of a month. The date must be valid. - %TRUE if the date is the first of the month @@ -5245,7 +4944,6 @@ The date must be valid. Returns %TRUE if the date is the last day of the month. The date must be valid. - %TRUE if the date is the last day of the month @@ -5260,7 +4958,6 @@ The date must be valid. Checks if @date1 is less than or equal to @date2, and swap the values if this is not the case. - @@ -5278,7 +4975,6 @@ and swap the values if this is not the case. Sets the day of the month for a #GDate. If the resulting day-month-year triplet is invalid, the date will be invalid. - @@ -5298,7 +4994,6 @@ day-month-year triplet is invalid, the date will be invalid. The day-month-year triplet must be valid; if you aren't sure it is, call g_date_valid_dmy() to check before you set it. - @@ -5323,7 +5018,6 @@ set it. Sets the value of a #GDate from a Julian day number. - @@ -5341,7 +5035,6 @@ set it. Sets the month of the year for a #GDate. If the resulting day-month-year triplet is invalid, the date will be invalid. - @@ -5368,7 +5061,6 @@ isn't very precise, and its exact behavior varies with the locale. It's intended to be a heuristic routine that guesses what the user means by a given string (and it does work pretty well in that capacity). - @@ -5387,7 +5079,6 @@ capacity). Sets the value of a date from a #GTime value. The time to date conversion is done using the user's current timezone. Use g_date_set_time_t() instead. - @@ -5414,7 +5105,6 @@ To set the value of a date to the current day, you could write: // handle the error g_date_set_time_t (date, now); ]| - @@ -5437,7 +5127,6 @@ additional precision. The time to date conversion is done using the user's current timezone. #GTimeVal is not year-2038-safe. Use g_date_set_time_t() instead. - @@ -5455,7 +5144,6 @@ The time to date conversion is done using the user's current timezone. Sets the year for a #GDate. If the resulting day-month-year triplet is invalid, the date will be invalid. - @@ -5474,7 +5162,6 @@ triplet is invalid, the date will be invalid. Moves a date some number of days into the past. To move by weeks, just move by weeks*7 days. The date must be valid. - @@ -5494,7 +5181,6 @@ The date must be valid. If the current day of the month doesn't exist in the destination month, the day of the month may change. The date must be valid. - @@ -5515,7 +5201,6 @@ If the current day doesn't exist in the destination year (i.e. it's February 29 and you move to a non-leap-year) then the day is changed to February 29. The date must be valid. - @@ -5533,7 +5218,6 @@ must be valid. Fills in the date-related bits of a struct tm using the @date value. Initializes the non-date parts with something safe but meaningless. - @@ -5552,7 +5236,6 @@ Initializes the non-date parts with something safe but meaningless. Returns %TRUE if the #GDate represents an existing day. The date must not contain garbage; it should have been initialized with g_date_clear() if it wasn't allocated by one of the g_date_new() variants. - Whether the date is valid @@ -5567,7 +5250,6 @@ if it wasn't allocated by one of the g_date_new() variants. Returns the number of days in a month, taking leap years into account. - number of days in @month during the @year @@ -5591,7 +5273,6 @@ plus 1 or 2 extra days depending on whether it's a leap year. This function is basically telling you how many Mondays are in the year, i.e. there are 53 Mondays if one of the extra days happens to be a Monday.) - number of Mondays in the year @@ -5611,7 +5292,6 @@ plus 1 or 2 extra days depending on whether it's a leap year. This function is basically telling you how many Sundays are in the year, i.e. there are 53 Sundays if one of the extra days happens to be a Sunday.) - the number of weeks in @year @@ -5630,7 +5310,6 @@ For the purposes of this function, leap year is every year divisible by 4 unless that year is divisible by 100. If it is divisible by 100 it would be a leap year only if that year is also divisible by 400. - %TRUE if the year is a leap year @@ -5656,7 +5335,6 @@ addition to those implemented by the platform's C library. For example, don't expect that using g_date_strftime() would make the \%F provided by the C99 strftime() work on Windows where the C library only complies to C89. - number of characters written to the buffer, or 0 the buffer was too small @@ -5683,7 +5361,6 @@ where the C library only complies to C89. Returns %TRUE if the day of the month is valid (a day is valid if it's between 1 and 31 inclusive). - %TRUE if the day is valid @@ -5699,7 +5376,6 @@ between 1 and 31 inclusive). Returns %TRUE if the day-month-year triplet forms a valid, existing day in the range of days #GDate understands (Year 1 or later, no more than a few thousand years in the future). - %TRUE if the date is a valid one @@ -5722,7 +5398,6 @@ a few thousand years in the future). Returns %TRUE if the Julian day is valid. Anything greater than zero is basically a valid Julian, though there is a 32-bit limit. - %TRUE if the Julian day is valid @@ -5737,7 +5412,6 @@ is basically a valid Julian, though there is a 32-bit limit. Returns %TRUE if the month value is valid. The 12 #GDateMonth enumeration values are the only valid months. - %TRUE if the month is valid @@ -5752,7 +5426,6 @@ enumeration values are the only valid months. Returns %TRUE if the weekday is valid. The seven #GDateWeekday enumeration values are the only valid weekdays. - %TRUE if the weekday is valid @@ -5767,7 +5440,6 @@ values are the only valid weekdays. Returns %TRUE if the year is valid. Any year greater than 0 is valid, though there is a 16-bit limit to what #GDate will understand. - %TRUE if the year is valid @@ -5783,7 +5455,6 @@ though there is a 16-bit limit to what #GDate will understand. This enumeration isn't used in the API, but may be useful if you need to mark a number as a day, month, or year. - a day @@ -5797,7 +5468,6 @@ to mark a number as a day, month, or year. Enumeration representing a month; values are #G_DATE_JANUARY, #G_DATE_FEBRUARY, etc. #G_DATE_BAD_MONTH is the invalid value. - invalid value @@ -5841,7 +5511,6 @@ to mark a number as a day, month, or year. `GDateTime` is an opaque structure whose members cannot be accessed directly. - Creates a new #GDateTime corresponding to the given date and time in the time zone @tz. @@ -5871,7 +5540,6 @@ return %NULL. You should release the return value by calling g_date_time_unref() when you are done with it. - a new #GDateTime, or %NULL @@ -5951,7 +5619,6 @@ formatted string. You should release the return value by calling g_date_time_unref() when you are done with it. - a new #GDateTime, or %NULL @@ -5983,7 +5650,6 @@ You should release the return value by calling g_date_time_unref() when you are done with it. #GTimeVal is not year-2038-safe. Use g_date_time_new_from_unix_local() instead. - a new #GDateTime, or %NULL @@ -6008,7 +5674,6 @@ You should release the return value by calling g_date_time_unref() when you are done with it. #GTimeVal is not year-2038-safe. Use g_date_time_new_from_unix_utc() instead. - a new #GDateTime, or %NULL @@ -6032,7 +5697,6 @@ of the supported range of #GDateTime. You should release the return value by calling g_date_time_unref() when you are done with it. - a new #GDateTime, or %NULL @@ -6055,7 +5719,6 @@ of the supported range of #GDateTime. You should release the return value by calling g_date_time_unref() when you are done with it. - a new #GDateTime, or %NULL @@ -6073,7 +5736,6 @@ the local time zone. This call is equivalent to calling g_date_time_new() with the time zone returned by g_time_zone_new_local(). - a #GDateTime, or %NULL @@ -6115,7 +5777,6 @@ year 9999. You should release the return value by calling g_date_time_unref() when you are done with it. - a new #GDateTime, or %NULL @@ -6133,7 +5794,6 @@ time zone. This is equivalent to calling g_date_time_new_now() with the time zone returned by g_time_zone_new_local(). - a new #GDateTime, or %NULL @@ -6144,7 +5804,6 @@ zone returned by g_time_zone_new_local(). This is equivalent to calling g_date_time_new_now() with the time zone returned by g_time_zone_new_utc(). - a new #GDateTime, or %NULL @@ -6156,7 +5815,6 @@ UTC. This call is equivalent to calling g_date_time_new() with the time zone returned by g_time_zone_new_utc(). - a #GDateTime, or %NULL @@ -6190,7 +5848,6 @@ zone returned by g_time_zone_new_utc(). Creates a copy of @datetime and adds the specified timespan to the copy. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6210,7 +5867,6 @@ zone returned by g_time_zone_new_utc(). Creates a copy of @datetime and adds the specified number of days to the copy. Add negative values to subtract days. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6230,7 +5886,6 @@ copy. Add negative values to subtract days. Creates a new #GDateTime adding the specified values to the current date and time in @datetime. Add negative values to subtract. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6270,7 +5925,6 @@ time in @datetime. Add negative values to subtract. Creates a copy of @datetime and adds the specified number of hours. Add negative values to subtract hours. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6290,7 +5944,6 @@ Add negative values to subtract hours. Creates a copy of @datetime adding the specified number of minutes. Add negative values to subtract minutes. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6315,7 +5968,6 @@ The day of the month of the resulting #GDateTime is clamped to the number of days in the updated calendar month. For example, if adding 1 month to 31st January 2018, the result would be 28th February 2018. In 2020 (a leap year), the result would be 29th February. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6335,7 +5987,6 @@ year), the result would be 29th February. Creates a copy of @datetime and adds the specified number of seconds. Add negative values to subtract seconds. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6355,7 +6006,6 @@ Add negative values to subtract seconds. Creates a copy of @datetime and adds the specified number of weeks to the copy. Add negative values to subtract weeks. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6378,7 +6028,6 @@ copy. Add negative values to subtract years. As with g_date_time_add_months(), if the resulting date would be 29th February on a non-leap year, the day will be clamped to 28th February. - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6399,7 +6048,6 @@ February on a non-leap year, the day will be clamped to 28th February. Calculates the difference in time between @end and @begin. The #GTimeSpan that is returned is effectively @end - @begin (ie: positive if the first parameter is larger). - the difference between the two #GDateTime, as a time span expressed in microseconds. @@ -6516,7 +6164,6 @@ some languages (Baltic, Slavic, Greek, and more) due to their grammatical rules. For other languages there is no difference. \%OB is a GNU and BSD strftime() extension expected to be added to the future POSIX specification, \%Ob and \%Oh are GNU strftime() extensions. Since: 2.56 - a newly allocated string formatted to the requested format or %NULL in the case that there was an error (such @@ -6542,7 +6189,6 @@ including the date, time and time zone, and return that as a UTF-8 encoded string. Since GLib 2.66, this will output to sub-second precision if needed. - a newly allocated string formatted in ISO 8601 format or %NULL in the case that there was an error. The string @@ -6559,7 +6205,6 @@ Since GLib 2.66, this will output to sub-second precision if needed. Retrieves the day of the month represented by @datetime in the gregorian calendar. - the day of the month @@ -6574,7 +6219,6 @@ calendar. Retrieves the ISO 8601 day of the week on which @datetime falls (1 is Monday, 2 is Tuesday... 7 is Sunday). - the day of the week @@ -6589,7 +6233,6 @@ Monday, 2 is Tuesday... 7 is Sunday). Retrieves the day of the year represented by @datetime in the Gregorian calendar. - the day of the year @@ -6603,7 +6246,6 @@ calendar. Retrieves the hour of the day represented by @datetime - the hour of the day @@ -6617,7 +6259,6 @@ calendar. Retrieves the microsecond of the date represented by @datetime - the microsecond of the second @@ -6631,7 +6272,6 @@ calendar. Retrieves the minute of the hour represented by @datetime - the minute of the hour @@ -6646,7 +6286,6 @@ calendar. Retrieves the month of the year represented by @datetime in the Gregorian calendar. - the month represented by @datetime @@ -6660,7 +6299,6 @@ calendar. Retrieves the second of the minute represented by @datetime - the second represented by @datetime @@ -6675,7 +6313,6 @@ calendar. Retrieves the number of seconds since the start of the last minute, including the fractional part. - the number of seconds @@ -6689,7 +6326,6 @@ including the fractional part. Get the time zone for this @datetime. - the time zone @@ -6708,7 +6344,6 @@ the time zone of @datetime. For example, in Toronto this is currently "EST" during the winter months and "EDT" during the summer months when daylight savings time is in effect. - the time zone abbreviation. The returned string is owned by the #GDateTime and it should not be @@ -6731,7 +6366,6 @@ arrive at local time for the time zone (ie: negative numbers for time zones west of GMT, positive numbers for east). If @datetime represents UTC time, then the offset is always zero. - the number of microseconds that should be added to UTC to get the local time @@ -6776,7 +6410,6 @@ week (Monday to Sunday). Note that January 1 0001 in the proleptic Gregorian calendar is a Monday, so this function never returns 0. - the ISO 8601 week-numbering year for @datetime @@ -6804,7 +6437,6 @@ year are considered as being contained in the last week of the previous year. Similarly, the final days of a calendar year may be considered as being part of the first ISO 8601 week of the next year if 4 or more days of that week are contained within the new year. - the ISO 8601 week number for @datetime. @@ -6818,7 +6450,6 @@ if 4 or more days of that week are contained within the new year. Retrieves the year represented by @datetime in the Gregorian calendar. - the year represented by @datetime @@ -6832,7 +6463,6 @@ if 4 or more days of that week are contained within the new year. Retrieves the Gregorian day, month, and year of a given #GDateTime. - @@ -6858,7 +6488,6 @@ if 4 or more days of that week are contained within the new year. Determines if daylight savings time is in effect at the time and in the time zone of @datetime. - %TRUE if daylight savings time is in effect @@ -6872,7 +6501,6 @@ the time zone of @datetime. Atomically increments the reference count of @datetime by one. - the #GDateTime with the reference count increased @@ -6890,7 +6518,6 @@ the time zone of @datetime. This call is equivalent to calling g_date_time_to_timezone() with the time zone returned by g_time_zone_new_local(). - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6919,7 +6546,6 @@ out of range. On systems where 'long' is 64bit, this function never fails. #GTimeVal is not year-2038-safe. Use g_date_time_to_unix() instead. - %TRUE if successful, else %FALSE @@ -6942,7 +6568,6 @@ On systems where 'long' is 64bit, this function never fails. This call can fail in the case that the time goes out of bounds. For example, converting 0001-01-01 00:00:00 UTC to a time zone west of Greenwich will fail (due to the year 0 being out of range). - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -6965,7 +6590,6 @@ nearest second. Unix time is the number of seconds that have elapsed since 1970-01-01 00:00:00 UTC, regardless of the time zone associated with @datetime. - the Unix time corresponding to @datetime @@ -6983,7 +6607,6 @@ Unix time is the number of seconds that have elapsed since 1970-01-01 This call is equivalent to calling g_date_time_to_timezone() with the time zone returned by g_time_zone_new_utc(). - the newly created #GDateTime which should be freed with g_date_time_unref(), or %NULL @@ -7001,7 +6624,6 @@ time zone returned by g_time_zone_new_utc(). When the reference count reaches zero, the resources allocated by @datetime are freed - @@ -7015,7 +6637,6 @@ When the reference count reaches zero, the resources allocated by A comparison function for #GDateTimes that is suitable as a #GCompareFunc. Both #GDateTimes must be non-%NULL. - -1, 0 or 1 if @dt1 is less than, equal to or greater than @dt2. @@ -7037,7 +6658,6 @@ as a #GCompareFunc. Both #GDateTimes must be non-%NULL. Equal here means that they represent the same moment after converting them to the same time zone. - %TRUE if @dt1 and @dt2 are equal @@ -7055,7 +6675,6 @@ them to the same time zone. Hashes @datetime into a #guint, suitable for use within #GHashTable. - a #guint containing the hash @@ -7071,7 +6690,6 @@ them to the same time zone. Enumeration representing a day of the week; #G_DATE_MONDAY, #G_DATE_TUESDAY, etc. #G_DATE_BAD_WEEKDAY is an invalid weekday. - invalid value @@ -7100,7 +6718,6 @@ them to the same time zone. Associates a string with a bit flag. Used in g_parse_debug_string(). - the string @@ -7114,7 +6731,6 @@ Used in g_parse_debug_string(). Specifies the type of function which is called when a data element is destroyed. It is passed the pointer to the data element and should free any memory and resources allocated for it. - @@ -7127,10 +6743,8 @@ should free any memory and resources allocated for it. An opaque structure representing an opened directory. - Closes the directory and deallocates all related resources. - @@ -7155,7 +6769,6 @@ name is in the on-disk encoding. On Windows, as is true of all GLib functions which operate on filenames, the returned name is in UTF-8. - The entry's name or %NULL if there are no more entries. The return value is owned by GLib and @@ -7172,7 +6785,6 @@ filenames, the returned name is in UTF-8. Resets the given directory. The next call to g_dir_read_name() will return the first entry again. - @@ -7195,7 +6807,6 @@ basename, no directory components are allowed. If template is Note that in contrast to g_mkdtemp() (and mkdtemp()) @tmpl is not modified, and might thus be a read-only literal string. - The actual name used. This string should be freed with g_free() when not needed any longer and is @@ -7215,7 +6826,6 @@ modified, and might thus be a read-only literal string. Opens a directory for reading. The names of the files in the directory can then be retrieved using g_dir_read_name(). Note that the ordering is not defined. - a newly allocated #GDir on success, %NULL on failure. If non-%NULL, you must free the result with g_dir_close() @@ -7240,13 +6850,11 @@ that the ordering is not defined. mantissa and exponent of IEEE floats and doubles. These unions are defined as appropriate for a given platform. IEEE floats and doubles are supported (used for storage) by at least Intel, PPC and Sparc. - the double value - @@ -7266,7 +6874,6 @@ as appropriate for a given platform. IEEE floats and doubles are supported What this means depends on the context, it could just be incrementing the reference count, if @data is a ref-counted object. - a duplicate of data @@ -7285,11 +6892,9 @@ object. The base of natural logarithms. - - @@ -7301,7 +6906,6 @@ object. Specifies the type of a function used to test two values for equality. The function should return %TRUE if both values are equal and %FALSE otherwise. - %TRUE if @a = @b; %FALSE otherwise @@ -7320,7 +6924,6 @@ and %FALSE otherwise. The `GError` structure contains information about an error that has occurred. - error domain, e.g. #G_FILE_ERROR @@ -7336,7 +6939,6 @@ an error that has occurred. Creates a new #GError with the given @domain and @code, and a message formatted with @format. - a new #GError @@ -7365,7 +6967,6 @@ and a message formatted with @format. not a printf()-style format string. Use this function if @message contains text you don't have control over, that could include printf() escape sequences. - a new #GError @@ -7388,7 +6989,6 @@ that could include printf() escape sequences. Creates a new #GError with the given @domain and @code, and a message formatted with @format. - a new #GError @@ -7414,7 +7014,6 @@ and a message formatted with @format. Makes a copy of @error. - a new #GError @@ -7428,7 +7027,6 @@ and a message formatted with @format. Frees a #GError and associated resources. - @@ -7450,7 +7048,6 @@ instead treat any not-explicitly-recognized error code as being equivalent to the `FAILED` code. This way, if the domain is extended in the future to provide a more specific error code for a certain case, your code will still work. - whether @error has @domain and @code @@ -7474,7 +7071,6 @@ a certain case, your code will still work. The possible errors, used in the @v_error field of #GTokenValue, when the token is a %G_TOKEN_ERROR. - unknown error @@ -7513,7 +7109,6 @@ It's not very portable to make detailed assumptions about exactly which errors will be returned from a given operation. Some errors don't occur on some systems, etc., sometimes there are subtle differences in when a system will report a given error, etc. - Operation not permitted; only the owner of the file (or other resource) or processes with special privileges @@ -7635,7 +7230,6 @@ differences in when a system will report a given error, etc. Flags to pass to g_file_set_contents_full() to affect its safety and performance. - No guarantees about file consistency or durability. The most dangerous setting, which is slightly faster than other settings. @@ -7663,7 +7257,6 @@ performance. A test to perform on a file using g_file_test(). - %TRUE if the file is a regular file (not a directory). Note that this test will also return %TRUE @@ -7688,13 +7281,11 @@ performance. mantissa and exponent of IEEE floats and doubles. These unions are defined as appropriate for a given platform. IEEE floats and doubles are supported (used for storage) by at least Intel, PPC and Sparc. - the double value - @@ -7708,7 +7299,6 @@ as appropriate for a given platform. IEEE floats and doubles are supported Flags to modify the format of the string returned by g_format_size_full(). - behave the same as g_format_size() @@ -7731,7 +7321,6 @@ as appropriate for a given platform. IEEE floats and doubles are supported Declares a type of function which takes an arbitrary data pointer argument and has no return value. It is not currently used in GLib or GTK+. - @@ -7745,7 +7334,6 @@ not currently used in GLib or GTK+. Specifies the type of functions passed to g_list_foreach() and g_slist_foreach(). - @@ -7773,7 +7361,6 @@ sscanf ("42", "%" G_GINT16_FORMAT, &in) out = in * 1000; g_print ("%" G_GINT32_FORMAT, out); ]| - @@ -7788,26 +7375,22 @@ The following example prints "0x7b"; gint16 value = 123; g_print ("%#" G_GINT16_MODIFIER "x", value); ]| - This is the platform dependent conversion specifier for scanning and printing values of type #gint32. See also #G_GINT16_FORMAT. - The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gint32 or #guint32. It is a string literal. See also #G_GINT16_MODIFIER. - This macro is used to insert 64-bit integer literals into the source code. - a literal integer value, e.g. 0x1d636b02300a7aa7 @@ -7824,7 +7407,6 @@ is not defined. Note that scanf() may not support 64-bit integers, even if %G_GINT64_FORMAT is defined. Due to its weak error handling, scanf() is not recommended for parsing anyway; consider using g_ascii_strtoull() instead. - @@ -7835,20 +7417,17 @@ It is a string literal. Some platforms do not support printing 64-bit integers, even though the types are supported. On such platforms %G_GINT64_MODIFIER is not defined. - This is the platform dependent conversion specifier for scanning and printing values of type #gintptr. - The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gintptr or #guintptr. It is a string literal. - @@ -7865,7 +7444,6 @@ gpointer g_malloc (gsize n_bytes) G_GNUC_MALLOC G_GNUC_ALLOC_SIZE(1); ]| See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-alloc_005fsize-function-attribute) for more details. - the index of the argument specifying the allocation size @@ -7887,7 +7465,6 @@ gpointer g_malloc_n (gsize n_blocks, ]| See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-alloc_005fsize-function-attribute) for more details. - the index of the argument specifying one factor of the allocation size @@ -7906,7 +7483,6 @@ the following would only match on compilers such as GCC 4.8 or newer. #if G_GNUC_CHECK_VERSION(4, 8) #endif ]| - major version to check against @@ -7932,7 +7508,6 @@ See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function Note that if @f is a macro, it will be expanded in the warning message. You can enclose it in quotes to prevent this. (The quotes will show up in the warning, but it's better than showing the macro expansion.) - the intended replacement for the deprecated symbol, @@ -7957,7 +7532,6 @@ See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function |[<!-- language="C" --> gchar *g_dgettext (gchar *domain_name, gchar *msgid) G_GNUC_FORMAT (2); ]| - the index of the argument @@ -7968,14 +7542,12 @@ gchar *g_dgettext (gchar *domain_name, gchar *msgid) G_GNUC_FORMAT (2); Expands to "" on all modern compilers, and to __FUNCTION__ on gcc version 2.x. Don't use it. Use G_STRFUNC() instead - Expands to "" on all modern compilers, and to __PRETTY_FUNCTION__ on gcc version 2.x. Don't use it. Use G_STRFUNC() instead - @@ -7997,7 +7569,6 @@ gint g_snprintf (gchar *string, gchar const *format, ...) G_GNUC_PRINTF (3, 4); ]| - the index of the argument corresponding to the @@ -8027,7 +7598,6 @@ int my_vscanf (MyStream *stream, See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-Wformat-3288) for details. - the index of the argument corresponding to @@ -8054,7 +7624,6 @@ gsize my_strftime (MyBuffer *buffer, See the [GNU C documentation](https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-Wformat-3288) for details. - the index of the argument corresponding to @@ -8067,7 +7636,6 @@ for details. into the source code. See also #G_GINT64_CONSTANT. - a literal integer value, e.g. 0x1d636b02300a7aa7 @@ -8077,45 +7645,38 @@ See also #G_GINT64_CONSTANT. This is the platform dependent conversion specifier for scanning and printing values of type #gsize. See also #G_GINT16_FORMAT. - The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gsize. It is a string literal. - This is the platform dependent conversion specifier for scanning and printing values of type #gssize. See also #G_GINT16_FORMAT. - The platform dependent length modifier for conversion specifiers for scanning and printing values of type #gssize. It is a string literal. - This is the platform dependent conversion specifier for scanning and printing values of type #guint16. See also #G_GINT16_FORMAT - This is the platform dependent conversion specifier for scanning and printing values of type #guint32. See also #G_GINT16_FORMAT. - This macro is used to insert 64-bit unsigned integer literals into the source code. - a literal integer value, e.g. 0x1d636b02300a7aa7U @@ -8132,41 +7693,33 @@ is not defined. Note that scanf() may not support 64-bit integers, even if %G_GINT64_FORMAT is defined. Due to its weak error handling, scanf() is not recommended for parsing anyway; consider using g_ascii_strtoull() instead. - This is the platform dependent conversion specifier for scanning and printing values of type #guintptr. - - - Defined to 1 if gcc-style visibility handling is supported. - - - Specifies the type of the function passed to g_hash_table_foreach(). It is called with each key/value pair, together with the @user_data parameter which is passed to g_hash_table_foreach(). - @@ -8187,7 +7740,6 @@ parameter which is passed to g_hash_table_foreach(). Casts a pointer to a `GHook*`. - a pointer @@ -8197,7 +7749,6 @@ parameter which is passed to g_hash_table_foreach(). Returns %TRUE if the #GHook is active, which is normally the case until the #GHook is destroyed. - a #GHook @@ -8206,7 +7757,6 @@ until the #GHook is destroyed. Gets the flags of a hook. - a #GHook @@ -8218,12 +7768,10 @@ until the #GHook is destroyed. use be the #GHook implementation, i.e. `1 << G_HOOK_FLAG_USER_SHIFT` is the first bit which can be used for application-defined flags. - Returns %TRUE if the #GHook function is currently executing. - a #GHook @@ -8232,7 +7780,6 @@ bit which can be used for application-defined flags. Returns %TRUE if the #GHook is not in a #GHookList. - a #GHook @@ -8242,7 +7789,6 @@ bit which can be used for application-defined flags. Returns %TRUE if the #GHook is valid, i.e. it is in a #GHookList, it is active and it has not been destroyed. - a #GHook @@ -8255,7 +7801,6 @@ g_hash_table_foreach_remove(). It is called with each key/value pair, together with the @user_data parameter passed to g_hash_table_foreach_remove(). It should return %TRUE if the key/value pair should be removed from the #GHashTable. - %TRUE if the key/value pair should be removed from the #GHashTable @@ -8307,7 +7852,6 @@ The key to choosing a good hash is unpredictability. Even cryptographic hashes are very easy to find collisions for when the remainder is taken modulo a somewhat predictable prime number. There must be an element of randomness that an attacker is unable to guess. - the hash value corresponding to the key @@ -8323,7 +7867,6 @@ must be an element of randomness that an attacker is unable to guess. The #GHashTable struct is an opaque data structure to represent a [Hash Table][glib-Hash-Tables]. It should only be accessed via the following functions. - This is a convenience function for using a #GHashTable as a set. It is equivalent to calling g_hash_table_replace() with @key as both the @@ -8340,7 +7883,6 @@ the discussion in the section description. Starting from GLib 2.40, this function returns a boolean value to indicate whether the newly added value was already in the hash table or not. - %TRUE if the key did not exist yet @@ -8361,7 +7903,6 @@ or not. Checks if @key is in @hash_table. - %TRUE if @key is in @hash_table, %FALSE otherwise. @@ -8387,7 +7928,6 @@ you should either free them first or create the #GHashTable with destroy notifiers using g_hash_table_new_full(). In the latter case the destroy functions you supplied will be called on all keys and values during the destruction phase. - @@ -8415,7 +7955,6 @@ once per every entry in a hash table) should probably be reworked to use additional or different data structures for reverse lookups (keep in mind that an O(n) find/foreach operation issued for all n values in a hash table ends up needing O(n*n) operations). - The value of the first key/value pair is returned, for which @predicate evaluates to %TRUE. If no pair with the @@ -8453,7 +7992,6 @@ the hash table is not defined. See g_hash_table_find() for performance caveats for linear order searches in contrast to g_hash_table_lookup(). - @@ -8484,7 +8022,6 @@ used to free the memory allocated for the removed keys and values. See #GHashTableIter for an alternative way to loop over the key/value pairs in the hash table. - the number of key/value pairs removed @@ -8515,7 +8052,6 @@ destroy functions are called. See #GHashTableIter for an alternative way to loop over the key/value pairs in the hash table. - the number of key/value pairs removed. @@ -8545,7 +8081,6 @@ until changes to the hash release those keys. This iterates over every entry in the hash table to build its return value. To iterate over the entries in a #GHashTable more efficiently, use a #GHashTableIter. - a #GList containing all the keys inside the hash table. The content of the list is owned by the @@ -8583,7 +8118,6 @@ You should always free the return result with g_free(). In the above-mentioned case of a string-keyed hash table, it may be appropriate to use g_strfreev() if you call g_hash_table_steal_all() first to transfer ownership of the keys. - a %NULL-terminated array containing each key from the table. @@ -8612,7 +8146,6 @@ is valid until @hash_table is modified. This iterates over every entry in the hash table to build its return value. To iterate over the entries in a #GHashTable more efficiently, use a #GHashTableIter. - a #GList containing all the values inside the hash table. The content of the list is owned by the @@ -8645,7 +8178,6 @@ key is freed using that function. Starting from GLib 2.40, this function returns a boolean value to indicate whether the newly added value was already in the hash table or not. - %TRUE if the key did not exist yet @@ -8673,7 +8205,6 @@ or not. distinguish between a key that is not present and one which is present and has the value %NULL. If you need this distinction, use g_hash_table_lookup_extended(). - the associated value, or %NULL if the key is not found @@ -8701,7 +8232,6 @@ for example before calling g_hash_table_remove(). You can actually pass %NULL for @lookup_key to test whether the %NULL key exists, provided the hash and equal functions of @hash_table are %NULL-safe. - %TRUE if the key was found in the #GHashTable @@ -8746,7 +8276,6 @@ a similar fashion to g_direct_equal(), but without the overhead of a function call. @key_equal_func is called with the key from the hash table as its first parameter, and the user-provided key to check against as its second. - a new #GHashTable @@ -8777,7 +8306,6 @@ permissible if the application still holds a reference to the hash table. This means that you may need to ensure that the hash table is empty by calling g_hash_table_remove_all() before releasing the last reference using g_hash_table_unref(). - a new #GHashTable @@ -8811,7 +8339,6 @@ g_hash_table_unref(). Atomically increments the reference count of @hash_table by one. This function is MT-safe and may be called from any thread. - the passed in #GHashTable @@ -8836,7 +8363,6 @@ If the #GHashTable was created using g_hash_table_new_full(), the key and value are freed using the supplied destroy functions, otherwise you have to make sure that any dynamically allocated values are freed yourself. - %TRUE if the key was found and removed from the #GHashTable @@ -8862,7 +8388,6 @@ If the #GHashTable was created using g_hash_table_new_full(), the keys and values are freed using the supplied destroy functions, otherwise you have to make sure that any dynamically allocated values are freed yourself. - @@ -8888,7 +8413,6 @@ If you supplied a @key_destroy_func when creating the Starting from GLib 2.40, this function returns a boolean value to indicate whether the newly added value was already in the hash table or not. - %TRUE if the key did not exist yet @@ -8913,7 +8437,6 @@ or not. Returns the number of elements contained in the #GHashTable. - the number of key/value pairs in the #GHashTable. @@ -8931,7 +8454,6 @@ or not. Removes a key and its associated value from a #GHashTable without calling the key and value destroy functions. - %TRUE if the key was found and removed from the #GHashTable @@ -8953,7 +8475,6 @@ calling the key and value destroy functions. Removes all keys and their associated values from a #GHashTable without calling the key and value destroy functions. - @@ -8978,7 +8499,6 @@ the caller of this method; as with g_hash_table_steal(). You can pass %NULL for @lookup_key, provided the hash and equal functions of @hash_table are %NULL-safe. - %TRUE if the key was found in the #GHashTable @@ -9012,7 +8532,6 @@ of @hash_table are %NULL-safe. If the reference count drops to 0, all keys and values will be destroyed, and all memory allocated by the hash table is released. This function is MT-safe and may be called from any thread. - @@ -9035,7 +8554,6 @@ with g_hash_table_iter_init(). The iteration order of a #GHashTableIter over the keys/values in a hash table is not defined. - @@ -9056,7 +8574,6 @@ table is not defined. Returns the #GHashTable associated with @iter. - the #GHashTable associated with @iter. @@ -9089,7 +8606,6 @@ while (g_hash_table_iter_next (&iter, &key, &value)) // do something with key and value } ]| - @@ -9111,7 +8627,6 @@ while (g_hash_table_iter_next (&iter, &key, &value)) Advances @iter and retrieves the key and/or value that are now pointed to as a result of this advancement. If %FALSE is returned, @key and @value are not set, and the iterator becomes invalid. - %FALSE if the end of the #GHashTable has been reached. @@ -9150,7 +8665,6 @@ while (g_hash_table_iter_next (&iter, &key, &value)) g_hash_table_iter_remove (&iter); } ]| - @@ -9168,7 +8682,6 @@ g_hash_table_iter_next() returned %TRUE. If you supplied a @value_destroy_func when creating the #GHashTable, the old value is freed using that function. - @@ -9189,7 +8702,6 @@ iterator from its associated #GHashTable, without calling the key and value destroy functions. Can only be called after g_hash_table_iter_next() returned %TRUE, and cannot be called more than once for the same key/value pair. - @@ -9205,12 +8717,10 @@ be called more than once for the same key/value pair. An opaque structure representing a HMAC operation. To create a new GHmac, use g_hmac_new(). To free a GHmac, use g_hmac_unref(). - Copies a #GHmac. If @hmac has been closed, by calling g_hmac_get_string() or g_hmac_get_digest(), the copied HMAC will be closed as well. - the copy of the passed #GHmac. Use g_hmac_unref() when finished using it. @@ -9229,7 +8739,6 @@ into @buffer. The size of the digest depends on the type of checksum. Once this function has been called, the #GHmac is closed and can no longer be updated with g_checksum_update(). - @@ -9258,7 +8767,6 @@ Once this function has been called the #GHmac can no longer be updated with g_hmac_update(). The hexadecimal characters will be lower case. - the hexadecimal representation of the HMAC. The returned string is owned by the HMAC and should not be modified @@ -9276,7 +8784,6 @@ The hexadecimal characters will be lower case. Atomically increments the reference count of @hmac by one. This function is MT-safe and may be called from any thread. - the passed in #GHmac. @@ -9295,7 +8802,6 @@ If the reference count drops to 0, all keys and values will be destroyed, and all memory allocated by the hash table is released. This function is MT-safe and may be called from any thread. Frees the memory allocated for @hmac. - @@ -9311,7 +8817,6 @@ Frees the memory allocated for @hmac. The HMAC must still be open, that is g_hmac_get_string() or g_hmac_get_digest() must not have been called on @hmac. - @@ -9349,7 +8854,6 @@ on it anymore. Support for digests of type %G_CHECKSUM_SHA512 has been added in GLib 2.42. Support for %G_CHECKSUM_SHA384 was added in GLib 2.52. - the newly created #GHmac, or %NULL. Use g_hmac_unref() to free the memory allocated by it. @@ -9375,7 +8879,6 @@ Support for %G_CHECKSUM_SHA384 was added in GLib 2.52. The #GHook struct represents a single hook function in a #GHookList. - data which is passed to func when this hook is invoked @@ -9414,7 +8917,6 @@ Support for %G_CHECKSUM_SHA384 was added in GLib 2.52. Compares the ids of two #GHook elements, returning a negative value if the second id is greater than the first. - a value <= 0 if the id of @sibling is >= the id of @new_hook @@ -9432,7 +8934,6 @@ if the second id is greater than the first. Allocates space for a #GHook and initializes it. - a new #GHook @@ -9446,7 +8947,6 @@ if the second id is greater than the first. Destroys a #GHook, given its ID. - %TRUE if the #GHook was found in the #GHookList and destroyed @@ -9465,7 +8965,6 @@ if the second id is greater than the first. Removes one #GHook from a #GHookList, marking it inactive and calling g_hook_unref() on it. - @@ -9483,7 +8982,6 @@ inactive and calling g_hook_unref() on it. Finds a #GHook in a #GHookList using the given function to test for a match. - the found #GHook or %NULL if no matching #GHook is found @@ -9511,7 +9009,6 @@ test for a match. Finds a #GHook in a #GHookList with the given data. - the #GHook with the given @data or %NULL if no matching #GHook is found @@ -9535,7 +9032,6 @@ test for a match. Finds a #GHook in a #GHookList with the given function. - the #GHook with the given @func or %NULL if no matching #GHook is found @@ -9559,7 +9055,6 @@ test for a match. Finds a #GHook in a #GHookList with the given function and data. - the #GHook with the given @func and @data or %NULL if no matching #GHook is found @@ -9590,7 +9085,6 @@ test for a match. The reference count for the #GHook is incremented, so you must call g_hook_unref() to restore it when no longer needed. (Or call g_hook_next_valid() if you are stepping through the #GHookList.) - the first valid #GHook, or %NULL if none are valid @@ -9611,7 +9105,6 @@ g_hook_next_valid() if you are stepping through the #GHookList.) Calls the #GHookList @finalize_hook function if it exists, and frees the memory allocated for the #GHook. - @@ -9628,7 +9121,6 @@ and frees the memory allocated for the #GHook. Returns the #GHook with the given id, or %NULL if it is not found. - the #GHook with the given id, or %NULL if it is not found @@ -9646,7 +9138,6 @@ and frees the memory allocated for the #GHook. Inserts a #GHook into a #GHookList, before a given #GHook. - @@ -9667,7 +9158,6 @@ and frees the memory allocated for the #GHook. Inserts a #GHook into a #GHookList, sorted by the given function. - @@ -9691,7 +9181,6 @@ and frees the memory allocated for the #GHook. The reference count for the #GHook is incremented, so you must call g_hook_unref() to restore it when no longer needed. (Or continue to call g_hook_next_valid() until %NULL is returned.) - the next valid #GHook, or %NULL if none are valid @@ -9715,7 +9204,6 @@ g_hook_next_valid() until %NULL is returned.) Prepends a #GHook on the start of a #GHookList. - @@ -9732,7 +9220,6 @@ g_hook_next_valid() until %NULL is returned.) Increments the reference count for a #GHook. - the @hook that was passed in (since 2.6) @@ -9752,7 +9239,6 @@ g_hook_next_valid() until %NULL is returned.) Decrements the reference count of a #GHook. If the reference count falls to 0, the #GHook is removed from the #GHookList and g_hook_free() is called to free it. - @@ -9771,7 +9257,6 @@ from the #GHookList and g_hook_free() is called to free it. Defines the type of a hook function that can be invoked by g_hook_list_invoke_check(). - %FALSE if the #GHook should be destroyed @@ -9785,7 +9270,6 @@ by g_hook_list_invoke_check(). Defines the type of function used by g_hook_list_marshal_check(). - %FALSE if @hook should be destroyed @@ -9804,7 +9288,6 @@ by g_hook_list_invoke_check(). Defines the type of function used to compare #GHook elements in g_hook_insert_sorted(). - a value <= 0 if @new_hook should be before @sibling @@ -9823,7 +9306,6 @@ g_hook_insert_sorted(). Defines the type of function to be called when a hook in a list of hooks gets finalized. - @@ -9840,7 +9322,6 @@ list of hooks gets finalized. Defines the type of the function passed to g_hook_find(). - %TRUE if the required #GHook has been found @@ -9858,7 +9339,6 @@ list of hooks gets finalized. Flags used internally in the #GHook implementation. - set if the hook has not been destroyed @@ -9873,7 +9353,6 @@ list of hooks gets finalized. Defines the type of a hook function that can be invoked by g_hook_list_invoke(). - @@ -9886,7 +9365,6 @@ by g_hook_list_invoke(). The #GHookList struct represents a list of hook functions. - the next free #GHook id @@ -9920,7 +9398,6 @@ by g_hook_list_invoke(). Removes all the #GHook elements from a #GHookList. - @@ -9934,7 +9411,6 @@ by g_hook_list_invoke(). Initializes a #GHookList. This must be called before the #GHookList is used. - @@ -9952,7 +9428,6 @@ This must be called before the #GHookList is used. Calls all of the #GHook functions in a #GHookList. - @@ -9972,7 +9447,6 @@ This must be called before the #GHookList is used. Calls all of the #GHook functions in a #GHookList. Any function which returns %FALSE is removed from the #GHookList. - @@ -9991,7 +9465,6 @@ Any function which returns %FALSE is removed from the #GHookList. Calls a function on each valid #GHook. - @@ -10019,7 +9492,6 @@ Any function which returns %FALSE is removed from the #GHookList. Calls a function on each valid #GHook and destroys it if the function returns %FALSE. - @@ -10047,7 +9519,6 @@ function returns %FALSE. Defines the type of function used by g_hook_list_marshal(). - @@ -10065,7 +9536,6 @@ function returns %FALSE. The GIConv struct wraps an iconv() conversion descriptor. It contains private data and should only be accessed using the following functions. - Same as the standard UNIX routine iconv(), but may be implemented via libiconv on UNIX flavors that lack @@ -10080,7 +9550,6 @@ set, is implementation defined. This function may return success (with a positive number of non-reversible conversions as replacement characters were used), or it may return -1 and set an error such as %EILSEQ, in such a situation. - count of non-reversible conversions, or -1 on error @@ -10117,7 +9586,6 @@ you are done converting things. GLib provides g_convert() and g_locale_to_utf8() which are likely more convenient than the raw iconv wrappers. - -1 on error, 0 on success @@ -10136,7 +9604,6 @@ a native implementation. GLib provides g_convert() and g_locale_to_utf8() which are likely more convenient than the raw iconv wrappers. - a "conversion descriptor", or (GIConv)-1 if opening the converter failed. @@ -10156,19 +9623,16 @@ more convenient than the raw iconv wrappers. The bias by which exponents in double-precision floats are offset. - The bias by which exponents in single-precision floats are offset. - A data structure representing an IO Channel. The fields should be considered private and should only be accessed with the following functions. - @@ -10237,7 +9701,6 @@ channel will be closed when the last reference to it is dropped, so there is no need to call g_io_channel_close() (though doing so will not cause problems, as long as no attempt is made to access the channel after it is closed). - A #GIOChannel on success, %NULL on failure. @@ -10277,7 +9740,6 @@ sockets overlap. There is no way for GLib to know which one you mean in case the argument you pass to this function happens to be both a valid file descriptor and socket. If that happens a warning is issued, and GLib assumes that it is the file descriptor you mean. - a new #GIOChannel. @@ -10294,7 +9756,6 @@ issued, and GLib assumes that it is the file descriptor you mean. flushed, ignoring errors. The channel will not be freed until the last reference is dropped using g_io_channel_unref(). Use g_io_channel_shutdown() instead. - @@ -10307,7 +9768,6 @@ last reference is dropped using g_io_channel_unref(). Flushes the write buffer for the GIOChannel. - the status of the operation: One of #G_IO_STATUS_NORMAL, #G_IO_STATUS_AGAIN, or @@ -10325,7 +9785,6 @@ last reference is dropped using g_io_channel_unref(). This function returns a #GIOCondition depending on whether there is data to be read/space to write data in the internal buffers in the #GIOChannel. Only the flags %G_IO_IN and %G_IO_OUT may be set. - A #GIOCondition @@ -10339,7 +9798,6 @@ the #GIOChannel. Only the flags %G_IO_IN and %G_IO_OUT may be set. Gets the buffer size. - the size of the buffer. @@ -10353,7 +9811,6 @@ the #GIOChannel. Only the flags %G_IO_IN and %G_IO_OUT may be set. Returns whether @channel is buffered. - %TRUE if the @channel is buffered. @@ -10370,7 +9827,6 @@ the #GIOChannel. Only the flags %G_IO_IN and %G_IO_OUT may be set. will be closed when @channel receives its final unref and is destroyed. The default value of this is %TRUE for channels created by g_io_channel_new_file (), and %FALSE for all other channels. - %TRUE if the channel will be closed, %FALSE otherwise. @@ -10386,7 +9842,6 @@ by g_io_channel_new_file (), and %FALSE for all other channels. Gets the encoding for the input/output of the channel. The internal encoding is always UTF-8. The encoding %NULL makes the channel safe for binary data. - A string containing the encoding, this string is owned by GLib and must not be freed. @@ -10409,7 +9864,6 @@ If they should change at some later point (e.g. partial shutdown of a socket with the UNIX shutdown() function), the user should immediately call g_io_channel_get_flags() to update the internal values of these flags. - the flags which are set on the channel @@ -10425,7 +9879,6 @@ the internal values of these flags. This returns the string that #GIOChannel uses to determine where in the file a line break occurs. A value of %NULL indicates autodetection. - The line termination string. This value is owned by GLib and must not be freed. @@ -10448,7 +9901,6 @@ indicates autodetection. This is called by each of the above functions when creating a #GIOChannel, and so is not often needed by the application programmer (unless you are creating a new type of #GIOChannel). - @@ -10462,7 +9914,6 @@ programmer (unless you are creating a new type of #GIOChannel). Reads data from a #GIOChannel. Use g_io_channel_read_chars() instead. - %G_IO_ERROR_NONE if the operation was successful. @@ -10489,7 +9940,6 @@ programmer (unless you are creating a new type of #GIOChannel). Replacement for g_io_channel_read() with the new API. - the status of the operation. @@ -10526,7 +9976,6 @@ programmer (unless you are creating a new type of #GIOChannel). from a #GIOChannel into a newly-allocated string. @str_return will contain allocated memory if the return is %G_IO_STATUS_NORMAL. - the status of the operation. @@ -10555,7 +10004,6 @@ is %G_IO_STATUS_NORMAL. Reads a line from a #GIOChannel, using a #GString as a buffer. - the status of the operation. @@ -10579,7 +10027,6 @@ is %G_IO_STATUS_NORMAL. Reads all the remaining data from the file. - %G_IO_STATUS_NORMAL on success. This function never returns %G_IO_STATUS_EOF. @@ -10609,7 +10056,6 @@ is %G_IO_STATUS_NORMAL. Reads a Unicode character from @channel. This function cannot be called on a channel with %NULL encoding. - a #GIOStatus @@ -10627,7 +10073,6 @@ This function cannot be called on a channel with %NULL encoding. Increments the reference count of a #GIOChannel. - the @channel that was passed in (since 2.6) @@ -10643,7 +10088,6 @@ This function cannot be called on a channel with %NULL encoding. Sets the current position in the #GIOChannel, similar to the standard library function fseek(). Use g_io_channel_seek_position() instead. - %G_IO_ERROR_NONE if the operation was successful. @@ -10668,7 +10112,6 @@ library function fseek(). Replacement for g_io_channel_seek() with the new API. - the status of the operation. @@ -10693,7 +10136,6 @@ library function fseek(). Sets the buffer size. - @@ -10728,7 +10170,6 @@ calls from the new and old APIs, if this is necessary for maintaining old code. The default state of the channel is buffered. - @@ -10750,7 +10191,6 @@ created by g_io_channel_new_file (), and %FALSE for all other channels. Setting this flag to %TRUE for a channel you have already closed can cause problems when the final reference to the #GIOChannel is dropped. - @@ -10801,7 +10241,6 @@ Channels which do not meet one of the above conditions cannot call g_io_channel_seek_position() with an offset of %G_SEEK_CUR, and, if they are "seekable", cannot call g_io_channel_write_chars() after calling one of the API "read" functions. - %G_IO_STATUS_NORMAL if the encoding was successfully set @@ -10819,7 +10258,6 @@ calling one of the API "read" functions. Sets the (writeable) flags in @channel to (@flags & %G_IO_FLAG_SET_MASK). - the status of the operation. @@ -10838,7 +10276,6 @@ calling one of the API "read" functions. This sets the string that #GIOChannel uses to determine where in the file a line break occurs. - @@ -10866,7 +10303,6 @@ where in the file a line break occurs. Close an IO channel. Any pending data to be written will be flushed if @flush is %TRUE. The channel will not be freed until the last reference is dropped using g_io_channel_unref(). - the status of the operation. @@ -10887,7 +10323,6 @@ last reference is dropped using g_io_channel_unref(). On Windows this function returns the file descriptor or socket of the #GIOChannel. - the file descriptor of the #GIOChannel. @@ -10901,7 +10336,6 @@ the #GIOChannel. Decrements the reference count of a #GIOChannel. - @@ -10915,7 +10349,6 @@ the #GIOChannel. Writes data to a #GIOChannel. Use g_io_channel_write_chars() instead. - %G_IO_ERROR_NONE if the operation was successful. @@ -10946,7 +10379,6 @@ On seekable channels with encodings other than %NULL or UTF-8, generic mixing of reading and writing is not allowed. A call to g_io_channel_write_chars () may only be made on a channel from which data has been read in the cases described in the documentation for g_io_channel_set_encoding (). - the status of the operation. @@ -10980,7 +10412,6 @@ cases described in the documentation for g_io_channel_set_encoding (). Writes a Unicode character to @channel. This function cannot be called on a channel with %NULL encoding. - a #GIOStatus @@ -10998,7 +10429,6 @@ This function cannot be called on a channel with %NULL encoding. Converts an `errno` error number to a #GIOChannelError. - a #GIOChannelError error number, e.g. %G_IO_CHANNEL_ERROR_INVAL. @@ -11019,7 +10449,6 @@ This function cannot be called on a channel with %NULL encoding. Error codes returned by #GIOChannel operations. - File too large. @@ -11074,7 +10503,6 @@ event source. #GIOError is only used by the deprecated functions g_io_channel_read(), g_io_channel_write(), and g_io_channel_seek(). - no error @@ -11092,7 +10520,6 @@ g_io_channel_read(), g_io_channel_write(), and g_io_channel_seek(). Specifies properties of a #GIOChannel. Some of the flags can only be read with g_io_channel_get_flags(), but not changed with g_io_channel_set_flags(). - turns on append mode, corresponds to %O_APPEND (see the documentation of the UNIX open() syscall) @@ -11136,7 +10563,6 @@ g_io_channel_set_flags(). Specifies the type of function passed to g_io_add_watch() or g_io_add_watch_full(), which is called when the requested condition on a #GIOChannel is satisfied. - the function should return %FALSE if the event source should be removed @@ -11160,10 +10586,8 @@ on a #GIOChannel is satisfied. A table of functions used to handle different types of #GIOChannel in a generic way. - - @@ -11185,7 +10609,6 @@ in a generic way. - @@ -11207,7 +10630,6 @@ in a generic way. - @@ -11226,7 +10648,6 @@ in a generic way. - @@ -11239,7 +10660,6 @@ in a generic way. - @@ -11255,7 +10675,6 @@ in a generic way. - @@ -11268,7 +10687,6 @@ in a generic way. - @@ -11284,7 +10702,6 @@ in a generic way. - @@ -11298,7 +10715,6 @@ in a generic way. Statuses returned by most of the #GIOFuncs functions. - An error occurred. @@ -11316,7 +10732,6 @@ in a generic way. Checks whether a character is a directory separator. It returns %TRUE for '/' on UNIX machines and for '\' or '/' under Windows. - a character @@ -11328,104 +10743,88 @@ machines and for '\' or '/' under Windows. [Desktop Entry Specification](http://freedesktop.org/Standards/desktop-entry-spec). Consult the specification for more details about the meanings of the keys below. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string list giving the available application actions. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a list of strings giving the categories in which the desktop entry should be shown in a menu. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the tooltip for the desktop entry. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a boolean set to true if the application is D-Bus activatable. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string giving the command line to execute. It is only valid for desktop entries with the `Application` type. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the generic name of the desktop entry. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the desktop entry has been deleted by the user. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the name of the icon to be displayed for the desktop entry. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a list of strings giving the MIME types supported by this desktop entry. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a localized string giving the specific name of the desktop entry. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a list of strings identifying the environments that should not display the desktop entry. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the desktop entry should be shown in menus. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a list of strings identifying the environments that should display the desktop entry. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string containing the working directory to run the program in. It is only valid for desktop entries with the `Application` type. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a boolean stating whether the application supports the [Startup Notification Protocol Specification](http://www.freedesktop.org/Standards/startup-notification-spec). - @@ -11433,7 +10832,6 @@ stating whether the application supports the identifying the WM class or name hint of a window that the application will create, which can be used to emulate Startup Notification with older applications. - @@ -11441,7 +10839,6 @@ older applications. stating whether the program should be run in a terminal window. It is only valid for desktop entries with the `Application` type. - @@ -11449,7 +10846,6 @@ It is only valid for desktop entries with the giving the file name of a binary on disk used to determine if the program is actually installed. It is only valid for desktop entries with the `Application` type. - @@ -11458,51 +10854,43 @@ giving the type of the desktop entry. Usually #G_KEY_FILE_DESKTOP_TYPE_APPLICATION, #G_KEY_FILE_DESKTOP_TYPE_LINK, or #G_KEY_FILE_DESKTOP_TYPE_DIRECTORY. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string giving the URL to access. It is only valid for desktop entries with the `Link` type. - A key under #G_KEY_FILE_DESKTOP_GROUP, whose value is a string giving the version of the Desktop Entry Specification used for the desktop entry file. - The value of the #G_KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing applications. - The value of the #G_KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing directories. - The value of the #G_KEY_FILE_DESKTOP_KEY_TYPE, key for desktop entries representing links to documents. - The GKeyFile struct contains only private data and should not be accessed directly. - Creates a new empty #GKeyFile object. Use g_key_file_load_from_file(), g_key_file_load_from_data(), g_key_file_load_from_dirs() or g_key_file_load_from_data_dirs() to read an existing key file. - an empty #GKeyFile. @@ -11512,7 +10900,6 @@ read an existing key file. Clears all keys and groups from @key_file, and decreases the reference count by 1. If the reference count reaches zero, frees the key file and all its allocated memory. - @@ -11531,7 +10918,6 @@ If @key cannot be found then %FALSE is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the value associated with @key cannot be interpreted as a boolean then %FALSE is returned and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. - the value associated with the key as a boolean, or %FALSE if the key was not found or could not be parsed. @@ -11560,7 +10946,6 @@ If @key cannot be found then %NULL is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the values associated with @key cannot be interpreted as booleans then %NULL is returned and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. - the values associated with the key as a list of booleans, or %NULL if the @@ -11598,7 +10983,6 @@ If @key is %NULL then @comment will be read from above Note that the returned string does not include the '#' comment markers, but does include any whitespace after them (on each line). It includes the line breaks between lines, but does not include the final line break. - a comment that should be freed with g_free() @@ -11626,7 +11010,6 @@ If @key cannot be found then 0.0 is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the value associated with @key cannot be interpreted as a double then 0.0 is returned and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. - the value associated with the key as a double, or 0.0 if the key was not found or could not be parsed. @@ -11655,7 +11038,6 @@ If @key cannot be found then %NULL is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the values associated with @key cannot be interpreted as doubles then %NULL is returned and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. - the values associated with the key as a list of doubles, or %NULL if the @@ -11688,7 +11070,6 @@ and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. Returns all groups in the key file loaded with @key_file. The array of returned groups will be %NULL-terminated, so @length may optionally be %NULL. - a newly-allocated %NULL-terminated array of strings. Use g_strfreev() to free it. @@ -11711,7 +11092,6 @@ The array of returned groups will be %NULL-terminated, so Returns the value associated with @key under @group_name as a signed 64-bit integer. This is similar to g_key_file_get_integer() but can return 64-bit results without truncation. - the value associated with the key as a signed 64-bit integer, or 0 if the key was not found or could not be parsed. @@ -11741,7 +11121,6 @@ If @key cannot be found then 0 is returned and @error is set to with @key cannot be interpreted as an integer, or is out of range for a #gint, then 0 is returned and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. - the value associated with the key as an integer, or 0 if the key was not found or could not be parsed. @@ -11771,7 +11150,6 @@ If @key cannot be found then %NULL is returned and @error is set to with @key cannot be interpreted as integers, or are out of range for #gint, then %NULL is returned and @error is set to #G_KEY_FILE_ERROR_INVALID_VALUE. - the values associated with the key as a list of integers, or %NULL if @@ -11806,7 +11184,6 @@ returned keys will be %NULL-terminated, so @length may optionally be %NULL. In the event that the @group_name cannot be found, %NULL is returned and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. - a newly-allocated %NULL-terminated array of strings. Use g_strfreev() to free it. @@ -11839,7 +11216,6 @@ g_key_file_get_locale_string_list() with exactly the same @key_file, @group_name, @key and @locale, the result of those functions will have originally been tagged with the locale that is the result of this function. - the locale from the file, or %NULL if the key was not found or the entry in the file was was untranslated @@ -11877,7 +11253,6 @@ If @key cannot be found then %NULL is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. If the value associated with @key cannot be interpreted or no suitable translation can be found then the untranslated value is returned. - a newly allocated string or %NULL if the specified key cannot be found. @@ -11917,7 +11292,6 @@ with @key cannot be interpreted or no suitable translations can be found then the untranslated values are returned. The returned array is %NULL-terminated, so @length may optionally be %NULL. - a newly allocated %NULL-terminated string array or %NULL if the key isn't found. The string array should be freed @@ -11951,7 +11325,6 @@ be %NULL. Returns the name of the start group of the file. - The start group of the key file. @@ -11972,7 +11345,6 @@ In the event the key cannot be found, %NULL is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the event that the @group_name cannot be found, %NULL is returned and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. - a newly allocated string or %NULL if the specified key cannot be found. @@ -12000,7 +11372,6 @@ In the event the key cannot be found, %NULL is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the event that the @group_name cannot be found, %NULL is returned and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. - a %NULL-terminated string array or %NULL if the specified @@ -12032,7 +11403,6 @@ and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. Returns the value associated with @key under @group_name as an unsigned 64-bit integer. This is similar to g_key_file_get_integer() but can return large positive results without truncation. - the value associated with the key as an unsigned 64-bit integer, or 0 if the key was not found or could not be parsed. @@ -12061,7 +11431,6 @@ In the event the key cannot be found, %NULL is returned and @error is set to #G_KEY_FILE_ERROR_KEY_NOT_FOUND. In the event that the @group_name cannot be found, %NULL is returned and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. - a newly allocated string or %NULL if the specified key cannot be found. @@ -12084,7 +11453,6 @@ and @error is set to #G_KEY_FILE_ERROR_GROUP_NOT_FOUND. Looks whether the key file has the group @group_name. - %TRUE if @group_name is a part of @key_file, %FALSE otherwise. @@ -12112,7 +11480,6 @@ whether it is not %NULL to see if an error occurred. Language bindings should use g_key_file_get_value() to test whether or not a key exists. - %TRUE if @key is a part of @group_name, %FALSE otherwise @@ -12135,7 +11502,6 @@ or not a key exists. Loads a key file from the data in @bytes into an empty #GKeyFile structure. If the object cannot be created then %error is set to a #GKeyFileError. - %TRUE if a key file could be loaded, %FALSE otherwise @@ -12158,7 +11524,6 @@ If the object cannot be created then %error is set to a #GKeyFileError. Loads a key file from memory into an empty #GKeyFile structure. If the object cannot be created then %error is set to a #GKeyFileError. - %TRUE if a key file could be loaded, %FALSE otherwise @@ -12188,7 +11553,6 @@ returned from g_get_user_data_dir() and g_get_system_data_dirs(), loads the file into @key_file and returns the file's full path in @full_path. If the file could not be loaded then an %error is set to either a #GFileError or #GKeyFileError. - %TRUE if a key file could be loaded, %FALSE otherwise @@ -12223,7 +11587,6 @@ If the file could not be found in any of the @search_dirs, the file is found but the OS returns an error when opening or reading the file, a %G_FILE_ERROR is returned. If there is a problem parsing the file, a %G_KEY_FILE_ERROR is returned. - %TRUE if a key file could be loaded, %FALSE otherwise @@ -12263,7 +11626,6 @@ If the OS returns an error when opening or reading the file, a This function will never return a %G_KEY_FILE_ERROR_NOT_FOUND error. If the @file is not found, %G_FILE_ERROR_NOENT is returned. - %TRUE if a key file could be loaded, %FALSE otherwise @@ -12285,7 +11647,6 @@ This function will never return a %G_KEY_FILE_ERROR_NOT_FOUND error. If the Increases the reference count of @key_file. - the same @key_file. @@ -12302,7 +11663,6 @@ This function will never return a %G_KEY_FILE_ERROR_NOT_FOUND error. If the If @key is %NULL then @comment will be removed above @group_name. If both @key and @group_name are %NULL, then @comment will be removed above the first group in the file. - %TRUE if the comment was removed, %FALSE otherwise @@ -12325,7 +11685,6 @@ be removed above the first group in the file. Removes the specified group, @group_name, from the key file. - %TRUE if the group was removed, %FALSE otherwise @@ -12343,7 +11702,6 @@ from the key file. Removes @key in @group_name from the key file. - %TRUE if the key was removed, %FALSE otherwise @@ -12371,7 +11729,6 @@ g_file_set_contents_full() with the return value of g_key_file_to_data(). This function can fail for any of the reasons that g_file_set_contents() may fail. - %TRUE if successful, else %FALSE with @error set @@ -12390,7 +11747,6 @@ g_file_set_contents() may fail. Associates a new boolean value with @key under @group_name. If @key cannot be found then it is created. - @@ -12417,7 +11773,6 @@ If @key cannot be found then it is created. Associates a list of boolean values with @key under @group_name. If @key cannot be found then it is created. If @group_name is %NULL, the start_group is used. - @@ -12455,7 +11810,6 @@ written above the first group in the file. Note that this function prepends a '#' comment marker to each line of @comment. - %TRUE if the comment was written, %FALSE otherwise @@ -12482,7 +11836,6 @@ each line of @comment. Associates a new double value with @key under @group_name. If @key cannot be found then it is created. - @@ -12508,7 +11861,6 @@ If @key cannot be found then it is created. Associates a list of double values with @key under @group_name. If @key cannot be found then it is created. - @@ -12540,7 +11892,6 @@ If @key cannot be found then it is created. Associates a new integer value with @key under @group_name. If @key cannot be found then it is created. - @@ -12566,7 +11917,6 @@ If @key cannot be found then it is created. Associates a new integer value with @key under @group_name. If @key cannot be found then it is created. - @@ -12592,7 +11942,6 @@ If @key cannot be found then it is created. Associates a list of integer values with @key under @group_name. If @key cannot be found then it is created. - @@ -12625,7 +11974,6 @@ If @key cannot be found then it is created. Sets the character which is used to separate values in lists. Typically ';' or ',' are used as separators. The default list separator is ';'. - @@ -12643,7 +11991,6 @@ as separators. The default list separator is ';'. Associates a string value for @key and @locale under @group_name. If the translation for @key cannot be found then it is created. - @@ -12674,7 +12021,6 @@ If the translation for @key cannot be found then it is created. Associates a list of string values for @key and @locale under @group_name. If the translation for @key cannot be found then it is created. - @@ -12713,7 +12059,6 @@ If @key cannot be found then it is created. If @group_name cannot be found then it is created. Unlike g_key_file_set_value(), this function handles characters that need escaping, such as newlines. - @@ -12740,7 +12085,6 @@ that need escaping, such as newlines. Associates a list of string values for @key under @group_name. If @key cannot be found then it is created. If @group_name cannot be found then it is created. - @@ -12772,7 +12116,6 @@ If @group_name cannot be found then it is created. Associates a new integer value with @key under @group_name. If @key cannot be found then it is created. - @@ -12802,7 +12145,6 @@ If @key cannot be found then it is created. If @group_name cannot be found then it is created. To set an UTF-8 string which may contain characters that need escaping (such as newlines or spaces), use g_key_file_set_string(). - @@ -12830,7 +12172,6 @@ g_key_file_set_string(). Note that this function never reports an error, so it is safe to pass %NULL as @error. - a newly allocated string holding the contents of the #GKeyFile @@ -12851,7 +12192,6 @@ so it is safe to pass %NULL as @error. Decreases the reference count of @key_file by 1. If the reference count reaches zero, frees the key file and all its allocated memory. - @@ -12870,7 +12210,6 @@ reaches zero, frees the key file and all its allocated memory. Error codes returned by key file parsing. - the text being parsed was in an unknown encoding @@ -12893,7 +12232,6 @@ reaches zero, frees the key file and all its allocated memory. Flags which influence the parsing. - No flags, default behaviour @@ -12918,7 +12256,6 @@ a true value. The compiler may use this information for optimizations. if (G_LIKELY (random () != 1)) g_print ("not one"); ]| - the expression @@ -12928,23 +12265,19 @@ if (G_LIKELY (random () != 1)) Specifies one of the possible types of byte order. See #G_BYTE_ORDER. - The natural logarithm of 10. - The natural logarithm of 2. - Works like g_mutex_lock(), but for a lock defined with #G_LOCK_DEFINE. - the name of the lock @@ -12978,7 +12311,6 @@ Here is an example for using the #G_LOCK convenience macros: return ret_val; } ]| - the name of the lock @@ -12987,7 +12319,6 @@ Here is an example for using the #G_LOCK convenience macros: This works like #G_LOCK_DEFINE, but it creates a static object. - the name of the lock @@ -12997,7 +12328,6 @@ Here is an example for using the #G_LOCK convenience macros: This declares a lock, that is defined with #G_LOCK_DEFINE in another module. - the name of the lock @@ -13005,7 +12335,6 @@ module. - @@ -13013,7 +12342,6 @@ module. Multiplying the base 2 exponent by this number yields the base 10 exponent. - @@ -13040,7 +12368,6 @@ AM_CPPFLAGS = -DG_LOG_DOMAIN=\"Gtk\" Applications can choose to leave it as the default %NULL (or `""`) domain. However, defining the domain offers the same advantages as above. - @@ -13048,18 +12375,15 @@ above. This is not used if structured logging is enabled; see [Using Structured Logging][using-structured-logging]. - Log levels below 1<<G_LOG_LEVEL_USER_SHIFT are used by GLib. Higher bits can be used for user-defined log levels. - The #GList struct is used for each element in a doubly-linked list. - holds the element's data, which can be a pointer to any kind of data, or any integer value using the @@ -13082,7 +12406,6 @@ Higher bits can be used for user-defined log levels. Allocates space for one #GList element. It is called by g_list_append(), g_list_prepend(), g_list_insert() and g_list_insert_sorted() and so is rarely used on its own. - a pointer to the newly-allocated #GList element @@ -13113,7 +12436,6 @@ string_list = g_list_append (string_list, "second"); number_list = g_list_append (number_list, GINT_TO_POINTER (27)); number_list = g_list_append (number_list, GINT_TO_POINTER (14)); ]| - either @list or the new start of the #GList if @list was %NULL @@ -13144,7 +12466,6 @@ The following example moves an element to the top of the list: list = g_list_remove_link (list, llink); list = g_list_concat (llink, list); ]| - the start of the new #GList, which equals @list1 if not %NULL @@ -13174,7 +12495,6 @@ Note that this is a "shallow" copy. If the list elements consist of pointers to data, the pointers are copied but the actual data is not. See g_list_copy_deep() if you need to copy the data as well. - the start of the new list that holds the same data as @list @@ -13212,7 +12532,6 @@ And, to entirely free the new list, you could do: |[<!-- language="C" --> g_list_free_full (another_list, g_object_unref); ]| - the start of the new list that holds a full copy of @list, use g_list_free_full() to free it @@ -13241,7 +12560,6 @@ g_list_free_full (another_list, g_object_unref); Removes the node link_ from the list and frees it. Compare this to g_list_remove_link() which removes the node without freeing it. - the (possibly changed) start of the #GList @@ -13265,7 +12583,6 @@ without freeing it. Finds the element in a #GList which contains the given data. - the found #GList element, or %NULL if it is not found @@ -13292,7 +12609,6 @@ the given function which should return 0 when the desired element is found. The function takes two #gconstpointer arguments, the #GList element's data as the first argument and the given user data. - the found #GList element, or %NULL if it is not found @@ -13319,7 +12635,6 @@ given user data. Gets the first element in a #GList. - the first element in the #GList, or %NULL if the #GList has no elements @@ -13341,7 +12656,6 @@ given user data. It is safe for @func to remove the element from @list, but it must not modify any part of the list after that element. - @@ -13375,7 +12689,6 @@ is not left dangling: GList *list_of_borrowed_things = …; /<!-- -->* (transfer container) *<!-- -->/ g_list_free (g_steal_pointer (&list_of_borrowed_things)); ]| - @@ -13394,7 +12707,6 @@ previous elements in the list, so you should not call this function on an element that is currently part of a list. It is usually used after g_list_remove_link(). - @@ -13422,7 +12734,6 @@ from @free_func: GList *list_of_owned_things = …; /<!-- -->* (transfer full) (element-type GObject) *<!-- -->/ g_list_free_full (g_steal_pointer (&list_of_owned_things), g_object_unref); ]| - @@ -13442,7 +12753,6 @@ g_list_free_full (g_steal_pointer (&list_of_owned_things), g_object_unref); Gets the position of the element containing the given data (starting from 0). - the index of the element containing the data, or -1 if the data is not found @@ -13463,7 +12773,6 @@ the given data (starting from 0). Inserts a new element into the list at the given position. - the (possibly changed) start of the #GList @@ -13491,7 +12800,6 @@ the given data (starting from 0). Inserts a new element into the list before the given position. - the (possibly changed) start of the #GList @@ -13520,7 +12828,6 @@ the given data (starting from 0). Inserts @link_ into the list before the given position. - the (possibly changed) start of the #GList @@ -13558,7 +12865,6 @@ If you are adding many new elements to a list, and the number of new elements is much larger than the length of the list, use g_list_prepend() to add the new items and sort the list afterwards with g_list_sort(). - the (possibly changed) start of the #GList @@ -13593,7 +12899,6 @@ If you are adding many new elements to a list, and the number of new elements is much larger than the length of the list, use g_list_prepend() to add the new items and sort the list afterwards with g_list_sort(). - the (possibly changed) start of the #GList @@ -13626,7 +12931,6 @@ with g_list_sort(). Gets the last element in a #GList. - the last element in the #GList, or %NULL if the #GList has no elements @@ -13650,7 +12954,6 @@ This function iterates over the whole list to count its elements. Use a #GQueue instead of a GList if you regularly need the number of items. To check whether the list is non-empty, it is faster to check @list against %NULL. - the number of elements in the #GList @@ -13670,7 +12973,6 @@ of items. To check whether the list is non-empty, it is faster to check This iterates over the list until it reaches the @n-th position. If you intend to iterate over every element, it is better to use a for-loop as described in the #GList introduction. - the element, or %NULL if the position is off the end of the #GList @@ -13697,7 +12999,6 @@ described in the #GList introduction. This iterates over the list until it reaches the @n-th position. If you intend to iterate over every element, it is better to use a for-loop as described in the #GList introduction. - the element's data, or %NULL if the position is off the end of the #GList @@ -13718,7 +13019,6 @@ described in the #GList introduction. Gets the element @n places before @list. - the element, or %NULL if the position is off the end of the #GList @@ -13742,7 +13042,6 @@ described in the #GList introduction. Gets the position of the given element in the #GList (starting from 0). - the position of the element in the #GList, or -1 if the element is not found @@ -13779,7 +13078,6 @@ list = g_list_prepend (list, "first"); Do not use this function to prepend a new element to a different element than the start of the list. Use g_list_insert_before() instead. - a pointer to the newly prepended element, which is the new start of the #GList @@ -13804,7 +13102,6 @@ element than the start of the list. Use g_list_insert_before() instead. Removes an element from a #GList. If two elements contain the same data, only the first is removed. If none of the elements contain the data, the #GList is unchanged. - the (possibly changed) start of the #GList @@ -13829,7 +13126,6 @@ If none of the elements contain the data, the #GList is unchanged. Returns the new head of the list. Contrast with g_list_remove() which removes only the first node matching the given data. - the (possibly changed) start of the #GList @@ -13862,7 +13158,6 @@ list = g_list_remove_link (list, llink); free_some_data_that_may_access_the_list_again (llink->data); g_list_free (llink); ]| - the (possibly changed) start of the #GList @@ -13887,7 +13182,6 @@ g_list_free (llink); Reverses a #GList. It simply switches the next and prev pointers of each element. - the start of the reversed #GList @@ -13906,7 +13200,6 @@ It simply switches the next and prev pointers of each element. Sorts a #GList using the given comparison function. The algorithm used is a stable sort. - the (possibly changed) start of the #GList @@ -13933,7 +13226,6 @@ used is a stable sort. Like g_list_sort(), but the comparison function accepts a user data argument. - the (possibly changed) start of the #GList @@ -13966,7 +13258,6 @@ Log fields may contain arbitrary values, including binary with embedded nul bytes. If the field contains a string, the string must be UTF-8 encoded and have a trailing nul byte. Otherwise, @length must be set to a non-negative value. - field name (UTF-8 string) @@ -13991,7 +13282,6 @@ log handler is changed. This is not used if structured logging is enabled; see [Using Structured Logging][using-structured-logging]. - @@ -14020,7 +13310,6 @@ This is not used if structured logging is enabled; see It is possible to change how GLib treats messages of the various levels using g_log_set_handler() and g_log_set_fatal_mask(). - internal flag @@ -14072,7 +13361,6 @@ error handling the message (for example, if the writer function is meant to send messages to a remote logging server and there is a network error), it should return %G_LOG_WRITER_UNHANDLED. This allows writer functions to be chained and fall back to simpler handlers in case of failure. - %G_LOG_WRITER_HANDLED if the log entry was handled successfully; %G_LOG_WRITER_UNHANDLED otherwise @@ -14106,7 +13394,6 @@ handling it (and hence a fallback writer should be used). If a #GLogWriterFunc ignores a log entry, it should return %G_LOG_WRITER_HANDLED. - Log writer has handled the log entry. @@ -14120,47 +13407,38 @@ If a #GLogWriterFunc ignores a log entry, it should return Like #glib_major_version, but from the headers used at application compile time, rather than from the library linked against at application run time. - The maximum value which can be held in a #gint16. - The maximum value which can be held in a #gint32. - The maximum value which can be held in a #gint64. - The maximum value which can be held in a #gint8. - The maximum value which can be held in a #guint16. - The maximum value which can be held in a #guint32. - The maximum value which can be held in a #guint64. - The maximum value which can be held in a #guint8. - @@ -14169,27 +13447,22 @@ linked against at application run time. Like #gtk_micro_version, but from the headers used at application compile time, rather than from the library linked against at application run time. - The minimum value which can be held in a #gint16. - The minimum value which can be held in a #gint32. - The minimum value which can be held in a #gint64. - The minimum value which can be held in a #gint8. - @@ -14198,20 +13471,16 @@ linked against at application run time. Like #gtk_minor_version, but from the headers used at application compile time, rather than from the library linked against at application run time. - - The `GMainContext` struct is an opaque data type representing a set of sources to be handled in a main loop. - Creates a new #GMainContext structure. - the new #GMainContext @@ -14228,7 +13497,6 @@ is called as many times as g_main_context_acquire(). You must be the owner of a context before you can call g_main_context_prepare(), g_main_context_query(), g_main_context_check(), g_main_context_dispatch(). - %TRUE if the operation succeeded, and this thread is now the owner of @context. @@ -14245,7 +13513,6 @@ g_main_context_check(), g_main_context_dispatch(). Adds a file descriptor to the set of file descriptors polled for this context. This will very seldom be used directly. Instead a typical event source will use g_source_add_unix_fd() instead. - @@ -14272,7 +13539,6 @@ a typical event source will use g_source_add_unix_fd() instead. You must have successfully acquired the context with g_main_context_acquire() before you may call this function. - %TRUE if some sources are ready to be dispatched. @@ -14304,7 +13570,6 @@ g_main_context_acquire() before you may call this function. You must have successfully acquired the context with g_main_context_acquire() before you may call this function. - @@ -14319,7 +13584,6 @@ g_main_context_acquire() before you may call this function. Finds a source with the given source functions and user data. If multiple sources exist with the same source function and user data, the first one found will be returned. - the source, if one was found, otherwise %NULL @@ -14352,7 +13616,6 @@ idle may already have run and been removed by the time this function is called on its (now invalid) source ID. This source ID may have been reissued, leading to the operation being performed against the wrong source. - the #GSource @@ -14372,7 +13635,6 @@ wrong source. Finds a source with the given user data for the callback. If multiple sources exist with the same user data, the first one found will be returned. - the source, if one was found, otherwise %NULL @@ -14390,7 +13652,6 @@ one found will be returned. Gets the poll function set by g_main_context_set_poll_func(). - the poll function @@ -14424,7 +13685,6 @@ g_main_context_invoke_full(). Note that, as with normal idle functions, @function should probably return %FALSE. If it returns %TRUE, it will be continuously run in a loop (and may prevent this call from returning). - @@ -14453,7 +13713,6 @@ scheduled as an idle and also lets you give a #GDestroyNotify for @data. @notify should not assume that it is called from any particular thread or with any particular context acquired. - @@ -14485,7 +13744,6 @@ thread or with any particular context acquired. ownership of this #GMainContext. This is useful to know before waiting on another thread that may be blocking to get ownership of @context. - %TRUE if current thread is owner of @context. @@ -14510,7 +13768,6 @@ given moment without further waiting. Note that even when @may_block is %TRUE, it is still possible for g_main_context_iteration() to return %FALSE, since the wait may be interrupted for other reasons than an event source becoming ready. - %TRUE if events were dispatched. @@ -14528,7 +13785,6 @@ be interrupted for other reasons than an event source becoming ready. Checks if any sources have pending events for the given context. - %TRUE if events are pending. @@ -14543,7 +13799,6 @@ be interrupted for other reasons than an event source becoming ready. Pops @context off the thread-default context stack (verifying that it was on the top of the stack). - @@ -14560,7 +13815,6 @@ for polling is determined by calling g_main_context_query (). You must have successfully acquired the context with g_main_context_acquire() before you may call this function. - %TRUE if some source is ready to be dispatched prior to polling. @@ -14617,7 +13871,6 @@ started while the non-default context is active. Beware that libraries that predate this function may not correctly handle being used from a thread with a thread-default context. Eg, see g_file_supports_thread_contexts(). - @@ -14633,7 +13886,6 @@ see g_file_supports_thread_contexts(). You must have successfully acquired the context with g_main_context_acquire() before you may call this function. - the number of records actually stored in @fds, or, if more than @n_fds records need to be stored, the number @@ -14668,7 +13920,6 @@ g_main_context_acquire() before you may call this function. Increases the reference count on a #GMainContext object by one. - the @context that was passed in (since 2.6) @@ -14685,7 +13936,6 @@ g_main_context_acquire() before you may call this function. with g_main_context_acquire(). If the context was acquired multiple times, the ownership will be released only when g_main_context_release() is called as many times as it was acquired. - @@ -14699,7 +13949,6 @@ is called as many times as it was acquired. Removes file descriptor from the set of file descriptors to be polled for a particular context. - @@ -14722,7 +13971,6 @@ poll() isn't available). This function could possibly be used to integrate the GLib event loop with an external event loop. - @@ -14740,7 +13988,6 @@ loop with an external event loop. Decreases the reference count on a #GMainContext object by one. If the result is zero, free the context and free all associated memory. - @@ -14758,7 +14005,6 @@ is the owner, atomically drop @mutex and wait on @cond until that owner releases ownership or until @cond is signaled, then try again (once) to become the owner. Use g_main_context_is_owner() and separate locking instead. - %TRUE if the operation succeeded, and this thread is now the owner of @context. @@ -14808,7 +14054,6 @@ Then in a thread: if (g_atomic_int_dec_and_test (&tasks_remaining)) g_main_context_wakeup (NULL); ]| - @@ -14824,7 +14069,6 @@ Then in a thread: used for main loop functions when a main loop is not explicitly specified, and corresponds to the "main" main loop. See also g_main_context_get_thread_default(). - the global default main context. @@ -14842,7 +14086,6 @@ always return %NULL if you are running in the default thread.) If you need to hold a reference on the context, use g_main_context_ref_thread_default() instead. - the thread-default #GMainContext, or %NULL if the thread-default context is the global default context. @@ -14856,7 +14099,6 @@ it with g_main_context_ref(). In addition, unlike g_main_context_get_thread_default(), if the thread-default context is the global default context, this will return that #GMainContext (with a ref added to it) rather than returning %NULL. - the thread-default #GMainContext. Unref with g_main_context_unref() when you are done with it. @@ -14867,10 +14109,8 @@ is the global default context, this will return that #GMainContext The `GMainLoop` struct is an opaque data type representing the main event loop of a GLib or GTK+ application. - Creates a new #GMainLoop structure. - a new #GMainLoop. @@ -14890,7 +14130,6 @@ is not very important since calling g_main_loop_run() will set this to Returns the #GMainContext of @loop. - the #GMainContext of @loop @@ -14904,7 +14143,6 @@ is not very important since calling g_main_loop_run() will set this to Checks to see if the main loop is currently being run via g_main_loop_run(). - %TRUE if the mainloop is currently being run. @@ -14922,7 +14160,6 @@ for the loop will return. Note that sources that have already been dispatched when g_main_loop_quit() is called will still be executed. - @@ -14935,7 +14172,6 @@ g_main_loop_quit() is called will still be executed. Increases the reference count on a #GMainLoop object by one. - @loop @@ -14952,7 +14188,6 @@ g_main_loop_quit() is called will still be executed. If this is called for the thread of the loop's #GMainContext, it will process events from the loop, otherwise it will simply wait. - @@ -14966,7 +14201,6 @@ simply wait. Decreases the reference count on a #GMainLoop object by one. If the result is zero, free the loop and free all associated memory. - @@ -14982,7 +14216,6 @@ the result is zero, free the loop and free all associated memory. The #GMappedFile represents a file mapping created with g_mapped_file_new(). It has only private members and should not be accessed directly. - Maps a file into memory. On UNIX, this is using the mmap() function. @@ -15000,7 +14233,6 @@ If @filename is the name of an empty, regular file, the function will successfully return an empty #GMappedFile. In other cases of size 0 (e.g. device files such as /dev/null), @error will be set to the #GFileError value #G_FILE_ERROR_INVAL. - a newly allocated #GMappedFile which must be unref'd with g_mapped_file_unref(), or %NULL if the mapping failed. @@ -15030,7 +14262,6 @@ Note that modifications of the underlying file might affect the contents of the #GMappedFile. Therefore, mapping should only be used if the file will not be modified, or if all modifications of the file are done atomically (e.g. using g_file_set_contents()). - a newly allocated #GMappedFile which must be unref'd with g_mapped_file_unref(), or %NULL if the mapping failed. @@ -15051,7 +14282,6 @@ atomically (e.g. using g_file_set_contents()). This call existed before #GMappedFile had refcounting and is currently exactly the same as g_mapped_file_unref(). Use g_mapped_file_unref() instead. - @@ -15066,7 +14296,6 @@ exactly the same as g_mapped_file_unref(). Creates a new #GBytes which references the data mapped from @file. The mapped contents of the file must not be modified after creating this bytes object, because a #GBytes should be immutable. - A newly allocated #GBytes referencing data from @file @@ -15086,7 +14315,6 @@ Note that the contents may not be zero-terminated, even if the #GMappedFile is backed by a text file. If the file is empty then %NULL is returned. - the contents of @file, or %NULL. @@ -15100,7 +14328,6 @@ If the file is empty then %NULL is returned. Returns the length of the contents of a #GMappedFile. - the length of the contents of @file. @@ -15115,7 +14342,6 @@ If the file is empty then %NULL is returned. Increments the reference count of @file by one. It is safe to call this function from any thread. - the passed in #GMappedFile. @@ -15134,7 +14360,6 @@ drops to 0, unmaps the buffer of @file and frees it. It is safe to call this function from any thread. Since 2.22 - @@ -15153,7 +14378,6 @@ bitwise OR the type with the flag %G_MARKUP_COLLECT_OPTIONAL. It is likely that this enum will be extended in the future to support other types. - used to terminate the list of attributes to collect @@ -15190,7 +14414,6 @@ support other types. Error codes returned by markup parsing. - text being parsed was not valid UTF-8 @@ -15223,14 +14446,12 @@ you expect to contain marked-up text. See g_markup_parse_context_new(), #GMarkupParser, and so on for more details. - Creates a new parse context. A parse context is used to parse marked-up documents. You can feed any number of documents into a context, as long as no errors occur; once an error occurs, the parse context can't continue to parse text (you have to free it and create a new parse context). - a new #GMarkupParseContext @@ -15261,7 +14482,6 @@ fed into the parse context with g_markup_parse_context_parse(). This function reports an error if the document isn't complete, for example if elements are still open. - %TRUE on success, %FALSE if an error was set @@ -15278,7 +14498,6 @@ for example if elements are still open. This function can't be called from inside one of the #GMarkupParser functions or while a subparser is pushed. - @@ -15295,7 +14514,6 @@ This function can't be called from inside one of the If called from the start_element or end_element handlers this will give the element_name as passed to those functions. For the parent elements, see g_markup_parse_context_get_element_stack(). - the name of the currently open element, or %NULL @@ -15319,7 +14537,6 @@ This function is intended to be used in the start_element and end_element handlers where g_markup_parse_context_get_element() would merely return the name of the element that is being processed. - the element stack, which must not be modified @@ -15338,7 +14555,6 @@ processed. that line. Intended for use in error messages; there are no strict semantics for what constitutes the "current" line number other than "the best number we could come up with for error messages." - @@ -15363,7 +14579,6 @@ semantics for what constitutes the "current" line number other than This will either be the user_data that was provided to g_markup_parse_context_new() or to the most recent call of g_markup_parse_context_push(). - the provided user_data. The returned data belongs to the markup context and will be freed when @@ -15388,7 +14603,6 @@ connection or file, you feed each received chunk of data into this function, aborting the process if an error occurs. Once an error is reported, no further data may be fed to the #GMarkupParseContext; all errors are fatal. - %FALSE if an error occurred, %TRUE on success @@ -15422,7 +14636,6 @@ This function is not intended to be directly called by users interested in invoking subparsers. Instead, it is intended to be used by the subparsers themselves to implement a higher-level interface. - the user data passed to g_markup_parse_context_push() @@ -15549,7 +14762,6 @@ static void end_element (context, element_name, ...) // else, handle other tags... } ]| - @@ -15570,7 +14782,6 @@ static void end_element (context, element_name, ...) Increases the reference count of @context. - the same @context @@ -15585,7 +14796,6 @@ static void end_element (context, element_name, ...) Decreases the reference count of @context. When its reference count drops to 0, it is freed. - @@ -15599,7 +14809,6 @@ drops to 0, it is freed. Flags that affect the behaviour of the parser. - flag you should not use @@ -15632,10 +14841,8 @@ can set an error; in particular the %G_MARKUP_ERROR_UNKNOWN_ELEMENT, errors are intended to be set from these callbacks. If you set an error from a callback, g_markup_parse_context_parse() will report that error back to its caller. - - @@ -15660,7 +14867,6 @@ back to its caller. - @@ -15679,7 +14885,6 @@ back to its caller. - @@ -15701,7 +14906,6 @@ back to its caller. - @@ -15723,7 +14927,6 @@ back to its caller. - @@ -15744,7 +14947,6 @@ back to its caller. A GMatchInfo is an opaque struct used to return information about matches. - Returns a new string containing the text in @string_to_expand with references and escape sequences expanded. References refer to the last @@ -15763,7 +14965,6 @@ pattern and '\n' merely will be replaced with \n character, while to expand "\0" (whole match) one needs the result of a match. Use g_regex_check_replacement() to find out whether @string_to_expand contains references. - the expanded string, or %NULL if an error occurred @@ -15796,7 +14997,6 @@ substring. Substrings are matched in reverse order of length, so The string is fetched from the string passed to the match function, so you cannot call this function after freeing the string. - The matched substring, or %NULL if an error occurred. You have to free the string yourself @@ -15830,7 +15030,6 @@ so the first one is the longest match. The strings are fetched from the string passed to the match function, so you cannot call this function after freeing the string. - a %NULL-terminated array of gchar * pointers. It must be freed using g_strfreev(). If the previous @@ -15855,7 +15054,6 @@ then an empty string is returned. The string is fetched from the string passed to the match function, so you cannot call this function after freeing the string. - The matched substring, or %NULL if an error occurred. You have to free the string yourself @@ -15878,7 +15076,6 @@ so you cannot call this function after freeing the string. If @name is a valid sub pattern name but it didn't match anything (e.g. sub pattern "X", matching "b" against "(?P<X>a)?b") then @start_pos and @end_pos are set to -1 and %TRUE is returned. - %TRUE if the position was fetched, %FALSE otherwise. If the position cannot be fetched, @start_pos and @end_pos @@ -15920,7 +15117,6 @@ g_regex_match_all() or g_regex_match_all_full(), the retrieved position is not that of a set of parentheses but that of a matched substring. Substrings are matched in reverse order of length, so 0 is the longest match. - %TRUE if the position was fetched, %FALSE otherwise. If the position cannot be fetched, @start_pos and @end_pos are left @@ -15951,7 +15147,6 @@ substring. Substrings are matched in reverse order of length, so If @match_info is not %NULL, calls g_match_info_unref(); otherwise does nothing. - @@ -15971,7 +15166,6 @@ If the last match was obtained using the DFA algorithm, that is using g_regex_match_all() or g_regex_match_all_full(), the retrieved count is not that of the number of capturing parentheses but that of the number of matched substrings. - Number of matched substrings, or -1 if an error occurred @@ -15987,7 +15181,6 @@ the number of matched substrings. Returns #GRegex object used in @match_info. It belongs to Glib and must not be freed. Use g_regex_ref() if you need to keep it after you free @match_info object. - #GRegex object used in @match_info @@ -16003,7 +15196,6 @@ after you free @match_info object. Returns the string searched with @match_info. This is the string passed to g_regex_match() or g_regex_replace() so you may not free it before calling this function. - the string searched with @match_info @@ -16049,7 +15241,6 @@ There were formerly some restrictions on the pattern for partial matching. The restrictions no longer apply. See pcrepartial(3) for more information on partial matching. - %TRUE if the match was partial, %FALSE otherwise @@ -16063,7 +15254,6 @@ See pcrepartial(3) for more information on partial matching. Returns whether the previous match operation succeeded. - %TRUE if the previous match operation succeeded, %FALSE otherwise @@ -16083,7 +15273,6 @@ call to g_regex_match_full() or g_regex_match() that returned The match is done on the string passed to the match function, so you cannot free it before calling this function. - %TRUE is the string matched, %FALSE otherwise @@ -16097,7 +15286,6 @@ cannot free it before calling this function. Increases reference count of @match_info by 1. - @match_info @@ -16112,7 +15300,6 @@ cannot free it before calling this function. Decreases reference count of @match_info by 1. When reference count drops to zero, it frees all the memory associated with the match_info structure. - @@ -16130,10 +15317,8 @@ be used for all allocations in the same program; a call to g_mem_set_vtable(), if it exists, should be prior to any use of GLib. This functions related to this has been deprecated in 2.46, and no longer work. - - @@ -16146,7 +15331,6 @@ This functions related to this has been deprecated in 2.46, and no longer work.< - @@ -16162,7 +15346,6 @@ This functions related to this has been deprecated in 2.46, and no longer work.< - @@ -16175,7 +15358,6 @@ This functions related to this has been deprecated in 2.46, and no longer work.< - @@ -16191,7 +15373,6 @@ This functions related to this has been deprecated in 2.46, and no longer work.< - @@ -16204,7 +15385,6 @@ This functions related to this has been deprecated in 2.46, and no longer work.< - @@ -16264,7 +15444,6 @@ If a #GMutex is placed in other contexts (eg: embedded in a struct) then it must be explicitly initialised using g_mutex_init(). A #GMutex should only be accessed via g_mutex_ functions. - @@ -16283,7 +15462,6 @@ Calling g_mutex_clear() on a locked mutex leads to undefined behaviour. Sine: 2.32 - @@ -16319,7 +15497,6 @@ needed, use g_mutex_clear(). Calling g_mutex_init() on an already initialized #GMutex leads to undefined behaviour. - @@ -16339,7 +15516,6 @@ thread. non-recursive. As such, calling g_mutex_lock() on a #GMutex that has already been locked by the same thread results in undefined behaviour (including but not limited to deadlocks). - @@ -16359,7 +15535,6 @@ it immediately returns %FALSE. Otherwise it locks @mutex and returns non-recursive. As such, calling g_mutex_lock() on a #GMutex that has already been locked by the same thread results in undefined behaviour (including but not limited to deadlocks or arbitrary return values). - %TRUE if @mutex could be locked @@ -16377,7 +15552,6 @@ call for @mutex, it will become unblocked and can lock @mutex itself. Calling g_mutex_unlock() on a mutex that is not locked by the current thread leads to undefined behaviour. - @@ -16391,7 +15565,6 @@ current thread leads to undefined behaviour. Returns %TRUE if a #GNode is a leaf node. - a #GNode @@ -16400,7 +15573,6 @@ current thread leads to undefined behaviour. Returns %TRUE if a #GNode is the root of a tree. - a #GNode @@ -16412,7 +15584,6 @@ current thread leads to undefined behaviour. declared so the compiler knows its size at compile-time; this macro will not work on an array allocated on the heap, only static arrays or arrays on the stack. - the array @@ -16421,7 +15592,6 @@ arrays or arrays on the stack. The #GNode struct represents one node in a [n-ary tree][glib-N-ary-Trees]. - contains the actual data of the node. @@ -16449,7 +15619,6 @@ arrays or arrays on the stack. Gets the position of the first child of a #GNode which contains the given data. - the index of the child of @node which contains @data, or -1 if the data is not found @@ -16470,7 +15639,6 @@ which contains the given data. Gets the position of a #GNode with respect to its siblings. @child must be a child of @node. The first child is numbered 0, the second 1, and so on. - the position of @child with respect to its siblings @@ -16490,7 +15658,6 @@ the second 1, and so on. Calls a function for each of the children of a #GNode. Note that it doesn't descend beneath the child nodes. @func must not do anything that would modify the structure of the tree. - @@ -16517,7 +15684,6 @@ that would modify the structure of the tree. Recursively copies a #GNode (but does not deep-copy the data inside the nodes, see g_node_copy_deep() if you need that). - a new #GNode containing the same data pointers @@ -16531,7 +15697,6 @@ nodes, see g_node_copy_deep() if you need that). Recursively copies a #GNode and its data. - a new #GNode containing copies of the data in @node. @@ -16557,7 +15722,6 @@ nodes, see g_node_copy_deep() if you need that). If @node is %NULL the depth is 0. The root node has a depth of 1. For the children of the root node the depth is 2. And so on. - the depth of the #GNode @@ -16572,7 +15736,6 @@ For the children of the root node the depth is 2. And so on. Removes @root and its children from the tree, freeing any memory allocated. - @@ -16585,7 +15748,6 @@ allocated. Finds a #GNode in a tree. - the found #GNode, or %NULL if the data is not found @@ -16613,7 +15775,6 @@ allocated. Finds the first child of a #GNode with the given data. - the found child #GNode, or %NULL if the data is not found @@ -16637,7 +15798,6 @@ allocated. Gets the first sibling of a #GNode. This could possibly be the node itself. - the first sibling of @node @@ -16651,7 +15811,6 @@ This could possibly be the node itself. Gets the root of a tree. - the root of the tree @@ -16665,7 +15824,6 @@ This could possibly be the node itself. Inserts a #GNode beneath the parent at the given position. - the inserted #GNode @@ -16688,7 +15846,6 @@ This could possibly be the node itself. Inserts a #GNode beneath the parent after the given sibling. - the inserted #GNode @@ -16711,7 +15868,6 @@ This could possibly be the node itself. Inserts a #GNode beneath the parent before the given sibling. - the inserted #GNode @@ -16736,7 +15892,6 @@ This could possibly be the node itself. Returns %TRUE if @node is an ancestor of @descendant. This is true if node is the parent of @descendant, or if node is the grandparent of @descendant etc. - %TRUE if @node is an ancestor of @descendant @@ -16754,7 +15909,6 @@ or if node is the grandparent of @descendant etc. Gets the last child of a #GNode. - the last child of @node, or %NULL if @node has no children @@ -16769,7 +15923,6 @@ or if node is the grandparent of @descendant etc. Gets the last sibling of a #GNode. This could possibly be the node itself. - the last sibling of @node @@ -16787,7 +15940,6 @@ This is the maximum distance from the #GNode to all leaf nodes. If @root is %NULL, 0 is returned. If @root has no children, 1 is returned. If @root has children, 2 is returned. And so on. - the maximum height of the tree beneath @root @@ -16801,7 +15953,6 @@ If @root is %NULL, 0 is returned. If @root has no children, Gets the number of children of a #GNode. - the number of children of @node @@ -16815,7 +15966,6 @@ If @root is %NULL, 0 is returned. If @root has no children, Gets the number of nodes in a tree. - the number of nodes in the tree @@ -16836,7 +15986,6 @@ If @root is %NULL, 0 is returned. If @root has no children, Gets a child of a #GNode, using the given index. The first child is at index 0. If the index is too big, %NULL is returned. - the child of @node at index @n @@ -16854,7 +16003,6 @@ too big, %NULL is returned. Inserts a #GNode as the first child of the given parent. - the inserted #GNode @@ -16873,7 +16021,6 @@ too big, %NULL is returned. Reverses the order of the children of a #GNode. (It doesn't change the order of the grandchildren.) - @@ -16889,7 +16036,6 @@ too big, %NULL is returned. It calls the given function for each node visited. The traversal can be halted at any point by returning %TRUE from @func. @func must not do anything that would modify the structure of the tree. - @@ -16927,7 +16073,6 @@ The traversal can be halted at any point by returning %TRUE from @func. Unlinks a #GNode from a tree, resulting in two separate trees. - @@ -16941,7 +16086,6 @@ The traversal can be halted at any point by returning %TRUE from @func. Creates a new #GNode containing the given data. Used to create the first node in a tree. - a new #GNode @@ -16958,7 +16102,6 @@ Used to create the first node in a tree. Specifies the type of function passed to g_node_children_foreach(). The function is called with each child node, together with the user data passed to g_node_children_foreach(). - @@ -16978,7 +16121,6 @@ data passed to g_node_children_foreach(). function is called with each of the nodes visited, together with the user data passed to g_node_traverse(). If the function returns %TRUE, then the traversal is stopped. - %TRUE to stop the traversal. @@ -17000,7 +16142,6 @@ form, standardizing such issues as whether a character with an accent is represented as a base character and combining accent or as a single precomposed character. Unicode strings should generally be normalized before comparing them. - standardize differences that do not affect the text content, such as the above-mentioned accent representation @@ -17035,7 +16176,6 @@ should generally be normalized before comparing them. Error codes returned by functions converting a string to a number. - String was not a valid number. @@ -17054,14 +16194,12 @@ or %G_OPTION_ARG_FILENAME_ARRAY. Using #G_OPTION_REMAINING instead of simply scanning `argv` for leftover arguments has the advantage that GOption takes care of necessary encoding conversions for strings or filenames. - A #GOnce struct controls a one-time initialization function. Any one-time initialization function must have its own unique #GOnce struct. - the status of the #GOnce @@ -17072,7 +16210,6 @@ struct. - @@ -17111,7 +16248,6 @@ like this: // use initialization_value here ]| - %TRUE if the initialization section should be entered, %FALSE and blocks otherwise @@ -17131,7 +16267,6 @@ like this: other than 0. Sets the variable to the initialization value, and releases concurrent threads blocking in g_once_init_enter() on this initialization variable. - @@ -17151,7 +16286,6 @@ initialization variable. The possible statuses of a one-time initialization function controlled by a #GOnce struct. - the function has not been called yet. @@ -17167,7 +16301,6 @@ controlled by a #GOnce struct. options expect to find. If an option expects an extra argument, it can be specified in several ways; with a short option: `-x arg`, with a long option: `--name arg` or combined in a single argument: `--name=arg`. - No extra argument. This is useful for simple flags. @@ -17208,7 +16341,6 @@ option: `--name arg` or combined in a single argument: `--name=arg`. The type of function to be passed as callback for %G_OPTION_ARG_CALLBACK options. - %TRUE if the option was successfully parsed, %FALSE if an error occurred, in which case @error should be set with g_set_error() @@ -17236,12 +16368,10 @@ options. A `GOptionContext` struct defines which options are accepted by the commandline option parser. The struct has only private fields and should not be directly accessed. - Adds a #GOptionGroup to the @context, so that parsing with @context will recognize the options in the group. Note that this will take ownership of the @group and thus the @group should not be freed. - @@ -17259,7 +16389,6 @@ ownership of the @group and thus the @group should not be freed. A convenience function which creates a main group if it doesn't exist, adds the @entries to it and sets the translation domain. - @@ -17288,7 +16417,6 @@ added to it. Please note that parsed arguments need to be freed separately (see #GOptionEntry). - @@ -17301,7 +16429,6 @@ Please note that parsed arguments need to be freed separately (see Returns the description. See g_option_context_set_description(). - the description @@ -17321,7 +16448,6 @@ To obtain the text produced by `--help-all`, call `g_option_context_get_help (context, FALSE, NULL)`. To obtain the help text for an option group, call `g_option_context_get_help (context, FALSE, group)`. - A newly allocated string containing the help text @@ -17344,7 +16470,6 @@ To obtain the help text for an option group, call Returns whether automatic `--help` generation is turned on for @context. See g_option_context_set_help_enabled(). - %TRUE if automatic help generation is turned on. @@ -17359,7 +16484,6 @@ is turned on for @context. See g_option_context_set_help_enabled(). Returns whether unknown options are ignored or not. See g_option_context_set_ignore_unknown_options(). - %TRUE if unknown options are ignored. @@ -17373,7 +16497,6 @@ g_option_context_set_ignore_unknown_options(). Returns a pointer to the main group of @context. - the main group of @context, or %NULL if @context doesn't have a main group. Note that group belongs to @@ -17391,7 +16514,6 @@ g_option_context_set_ignore_unknown_options(). Returns whether strict POSIX code is enabled. See g_option_context_set_strict_posix() for more information. - %TRUE if strict POSIX is enabled, %FALSE otherwise. @@ -17405,7 +16527,6 @@ See g_option_context_set_strict_posix() for more information. Returns the summary. See g_option_context_set_summary(). - the summary @@ -17439,7 +16560,6 @@ call `exit (0)`. Note that function depends on the [current locale][setlocale] for automatic character set conversion of string and filename arguments. - %TRUE if the parsing was successful, %FALSE if an error occurred @@ -17479,7 +16599,6 @@ See g_win32_get_command_line() for a solution. This function is useful if you are trying to use #GOptionContext with #GApplication. - %TRUE if the parsing was successful, %FALSE if an error occurred @@ -17507,7 +16626,6 @@ of options. This text often includes a bug reporting address. Note that the summary is translated (see g_option_context_set_translate_func()). - @@ -17528,7 +16646,6 @@ g_option_context_set_translate_func()). By default, g_option_context_parse() recognizes `--help`, `-h`, `-?`, `--help-all` and `--help-groupname` and creates suitable output to stdout. - @@ -17551,7 +16668,6 @@ g_option_context_parse() treats unknown options as error. This setting does not affect non-option arguments (i.e. arguments which don't start with a dash). But note that GOption cannot reliably determine whether a non-option belongs to a preceding unknown option. - @@ -17572,7 +16688,6 @@ determine whether a non-option belongs to a preceding unknown option. This has the same effect as calling g_option_context_add_group(), the only difference is that the options in the main group are treated differently when generating `--help` output. - @@ -17612,7 +16727,6 @@ options up to the verb name while leaving the remaining options to be parsed by the relevant subcommand (which can be determined by examining the verb name, which should be present in argv[1] after parsing). - @@ -17634,7 +16748,6 @@ of options. This is typically a summary of the program functionality. Note that the summary is translated (see g_option_context_set_translate_func() and g_option_context_set_translation_domain()). - @@ -17662,7 +16775,6 @@ the summary (see g_option_context_set_summary()) and the description If you are using gettext(), you only need to set the translation domain, see g_option_context_set_translation_domain(). - @@ -17688,7 +16800,6 @@ domain, see g_option_context_set_translation_domain(). A convenience function to use gettext() for translating user-visible strings. - @@ -17723,7 +16834,6 @@ below the usage line, use g_option_context_set_summary(). Note that the @parameter_string is translated using the function set with g_option_context_set_translate_func(), so it should normally be passed untranslated. - a newly created #GOptionContext, which must be freed with g_option_context_free() after use. @@ -17743,7 +16853,6 @@ it should normally be passed untranslated. A GOptionEntry struct defines a single option. To have an effect, they must be added to a #GOptionGroup with g_option_context_add_main_entries() or g_option_group_add_entries(). - The long name of an option can be used to specify it in a commandline as `--long_name`. Every option must have a @@ -17803,7 +16912,6 @@ or g_option_group_add_entries(). Error codes returned by option parsing. - An option was not known to the parser. This error will only be reported, if the parser hasn't been instructed @@ -17818,7 +16926,6 @@ or g_option_group_add_entries(). The type of function to be used as callback when a parse error occurs. - @@ -17840,7 +16947,6 @@ or g_option_group_add_entries(). Flags which modify individual options. - No flags. Since: 2.42. @@ -17888,10 +16994,8 @@ All options in a group share the same translation function. Libraries which need to parse commandline options are expected to provide a function for getting a `GOptionGroup` holding their options, which the application can then add to its #GOptionContext. - Creates a new #GOptionGroup. - a newly created option group. It should be added to a #GOptionContext or freed with g_option_group_unref(). @@ -17928,7 +17032,6 @@ the application can then add to its #GOptionContext. Adds the options specified in @entries to @group. - @@ -17949,7 +17052,6 @@ the application can then add to its #GOptionContext. Frees a #GOptionGroup. Note that you must not free groups which have been added to a #GOptionContext. Use g_option_group_unref() instead. - @@ -17962,7 +17064,6 @@ which have been added to a #GOptionContext. Increments the reference count of @group by one. - a #GOptionGroup @@ -17980,7 +17081,6 @@ from g_option_context_parse() when an error occurs. Note that the user data to be passed to @error_func can be specified when constructing the group with g_option_group_new(). - @@ -18003,7 +17103,6 @@ and after the last option has been parsed, respectively. Note that the user data to be passed to @pre_parse_func and @post_parse_func can be specified when constructing the group with g_option_group_new(). - @@ -18029,7 +17128,6 @@ for `--help` output. Different groups can use different If you are using gettext(), you only need to set the translation domain, see g_option_group_set_translation_domain(). - @@ -18055,7 +17153,6 @@ domain, see g_option_group_set_translation_domain(). A convenience function to use gettext() for translating user-visible strings. - @@ -18074,7 +17171,6 @@ user-visible strings. Decrements the reference count of @group by one. If the reference count drops to 0, the @group will be freed. and all memory allocated by the @group is released. - @@ -18088,7 +17184,6 @@ and all memory allocated by the @group is released. The type of function that can be called before and after parsing. - %TRUE if the function completed successfully, %FALSE if an error occurred, in which case @error should be set with g_set_error() @@ -18113,34 +17208,28 @@ and all memory allocated by the @group is released. Specifies one of the possible types of byte order (currently unused). See #G_BYTE_ORDER. - The value of pi (ratio of circle's circumference to its diameter). - A format specifier that can be used in printf()-style format strings when printing a #GPid. - Pi divided by 2. - Pi divided by 4. - A format specifier that can be used in printf()-style format strings when printing the @fd member of a #GPollFD. - @@ -18149,7 +17238,6 @@ when printing the @fd member of a #GPollFD. In GLib this priority is used when adding timeout functions with g_timeout_add(). In GDK this priority is used for events from the X server. - @@ -18157,14 +17245,12 @@ from the X server. In GLib this priority is used when adding idle functions with g_idle_add(). - Use this for high priority event sources. It is not used within GLib or GTK+. - @@ -18174,14 +17260,12 @@ GTK+ uses #G_PRIORITY_HIGH_IDLE + 10 for resizing operations, and #G_PRIORITY_HIGH_IDLE + 20 for redrawing operations. (This is done to ensure that any pending resizes are processed before any pending redraws, so that widgets are not redrawn twice unnecessarily.) - Use this for very low priority background tasks. It is not used within GLib or GTK+. - @@ -18231,7 +17315,6 @@ set_local_count (gint count) g_private_set (&count_key, GINT_TO_POINTER (count)); } ]| - a #GDestroyNotify @@ -18241,11 +17324,9 @@ set_local_count (gint count) A GPatternSpec struct is the 'compiled' form of a pattern. This structure is opaque and its fields cannot be accessed directly. - Compares two compiled pattern specs and returns whether they will match the same set of strings. - Whether the compiled patterns are equal @@ -18263,7 +17344,6 @@ match the same set of strings. Frees the memory allocated for the #GPatternSpec. - @@ -18276,7 +17356,6 @@ match the same set of strings. Compiles a pattern to a #GPatternSpec. - a newly-allocated #GPatternSpec @@ -18292,7 +17371,6 @@ match the same set of strings. Represents a file descriptor, which events to poll for, and which events occurred. - the file descriptor to poll (or a HANDLE on Win32) @@ -18313,7 +17391,6 @@ occurred. Specifies the type of function passed to g_main_context_set_poll_func(). The semantics of the function should match those of the poll() system call. - the number of #GPollFD elements which have events or errors reported, or -1 if an error occurred. @@ -18338,7 +17415,6 @@ The semantics of the function should match those of the poll() system call. Specifies the type of the print handler functions. These are called with the complete formatted string to output. - @@ -18367,7 +17443,6 @@ See G_PRIVATE_INIT() for a couple of examples. The #GPrivate structure should be considered opaque. It should only be accessed via the g_private_ functions. - @@ -18385,7 +17460,6 @@ be accessed via the g_private_ functions. If the value has not yet been set in this thread, %NULL is returned. Values are never copied between threads (when a new thread is created, for example). - the thread-local value @@ -18404,7 +17478,6 @@ current thread. This function differs from g_private_set() in the following way: if the previous value was non-%NULL then the #GDestroyNotify handler for @key is run on it. - @@ -18425,7 +17498,6 @@ current thread. This function differs from g_private_replace() in the following way: the #GDestroyNotify for @key is not called on the old value. - @@ -18443,7 +17515,6 @@ the #GDestroyNotify for @key is not called on the old value. Contains the public fields of a pointer array. - points to the array of pointers, which may be moved when the array grows @@ -18456,7 +17527,6 @@ the #GDestroyNotify for @key is not called on the old value. Adds a pointer to the end of the pointer array. The array will grow in size automatically if necessary. - @@ -18487,7 +17557,6 @@ pointing to) are copied to the new #GPtrArray. The copy of @array will have the same #GDestroyNotify for its elements as @array. - a deep copy of the initial #GPtrArray. @@ -18524,7 +17593,6 @@ may get compiler warnings from this though if compiling with GCC’s If @func is %NULL, then only the pointers (and not what they are pointing to) are copied to the new #GPtrArray. - @@ -18559,7 +17627,6 @@ ownership of each element from @array to @array_to_extend and modifying As with g_ptr_array_free(), @array will be destroyed if its reference count is 1. If its reference count is higher, it will be decremented and the length of @array set to zero. - @@ -18587,7 +17654,6 @@ multiple times in @haystack, the index of the first instance is returned. This does pointer comparisons only. If you want to use more complex equality checks, such as string comparisons, use g_ptr_array_find_with_equal_func(). - %TRUE if @needle is one of the elements of @haystack @@ -18620,7 +17686,6 @@ the first instance is returned. @equal_func is called with the element from the array as its first parameter, and @needle as its second parameter. If @equal_func is %NULL, pointer equality is used. - %TRUE if @needle is one of the elements of @haystack @@ -18652,7 +17717,6 @@ equality is used. Calls a function for each element of a #GPtrArray. @func must not add elements to or remove elements from the array. - @@ -18688,7 +17752,6 @@ function has been set for @array. This function is not thread-safe. If using a #GPtrArray from multiple threads, use only the atomic g_ptr_array_ref() and g_ptr_array_unref() functions. - the pointer array if @free_seg is %FALSE, otherwise %NULL. The pointer array should be freed using g_free(). @@ -18710,7 +17773,6 @@ functions. Inserts an element into the pointer array at the given index. The array will grow in size automatically if necessary. - @@ -18733,7 +17795,6 @@ array will grow in size automatically if necessary. Creates a new #GPtrArray with a reference count of 1. - the new #GPtrArray @@ -18749,7 +17810,6 @@ the size of the array is still 0. It also set @element_free_func for freeing each element when the array is destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called with @free_segment set to %TRUE or when removing elements. - A new #GPtrArray @@ -18773,7 +17833,6 @@ g_ptr_array_unref(), when g_ptr_array_free() is called with @element_free_func for freeing each element when the array is destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called with @free_segment set to %TRUE or when removing elements. - A new #GPtrArray @@ -18791,7 +17850,6 @@ either via g_ptr_array_unref(), when g_ptr_array_free() is called with Atomically increments the reference count of @array by one. This function is thread-safe and may be called from any thread. - The passed in #GPtrArray @@ -18815,7 +17873,6 @@ removed element. It returns %TRUE if the pointer was removed, or %FALSE if the pointer was not found. - %TRUE if the pointer is removed, %FALSE if the pointer is not found in the array @@ -18843,7 +17900,6 @@ is faster than g_ptr_array_remove(). If @array has a non-%NULL It returns %TRUE if the pointer was removed, or %FALSE if the pointer was not found. - %TRUE if the pointer was found in the array @@ -18867,7 +17923,6 @@ The following elements are moved down one place. If @array has a non-%NULL #GDestroyNotify function it is called for the removed element. If so, the return value from this function will potentially point to freed memory (depending on the #GDestroyNotify implementation). - the pointer which was removed @@ -18893,7 +17948,6 @@ is faster than g_ptr_array_remove_index(). If @array has a non-%NULL #GDestroyNotify function it is called for the removed element. If so, the return value from this function will potentially point to freed memory (depending on the #GDestroyNotify implementation). - the pointer which was removed @@ -18916,7 +17970,6 @@ return value from this function will potentially point to freed memory from a #GPtrArray. The following elements are moved to close the gap. If @array has a non-%NULL #GDestroyNotify function it is called for the removed elements. - the @array @@ -18944,7 +17997,6 @@ called for the removed elements. Sets a function for freeing each element when @array is destroyed either via g_ptr_array_unref(), when g_ptr_array_free() is called with @free_segment set to %TRUE or when removing elements. - @@ -18967,7 +18019,6 @@ with @free_segment set to %TRUE or when removing elements. newly-added elements will be set to %NULL. When making it smaller, if @array has a non-%NULL #GDestroyNotify function then it will be called for the removed elements. - @@ -18989,7 +18040,6 @@ called for the removed elements. and a reference count of 1. This avoids frequent reallocation, if you are going to add many pointers to the array. Note however that the size of the array is still 0. - the new #GPtrArray @@ -19039,7 +18089,6 @@ g_ptr_array_sort (file_list, sort_filelist); ]| This is guaranteed to be a stable sort since version 2.32. - @@ -19110,7 +18159,6 @@ g_ptr_array_sort_with_data (file_list, ]| This is guaranteed to be a stable sort since version 2.32. - @@ -19172,7 +18220,6 @@ g_free (chunks); // next set of chunks. g_assert (chunk_buffer->len == 0); ]| - the element data, which should be freed using g_free(). @@ -19197,7 +18244,6 @@ g_assert (chunk_buffer->len == 0); The following elements are moved down one place. The #GDestroyNotify for @array is *not* called on the removed element; ownership is transferred to the caller of this function. - the pointer which was removed @@ -19222,7 +18268,6 @@ this function does not preserve the order of the array. But it is faster than g_ptr_array_steal_index(). The #GDestroyNotify for @array is *not* called on the removed element; ownership is transferred to the caller of this function. - the pointer which was removed @@ -19245,7 +18290,6 @@ of this function. reference count drops to 0, the effect is the same as calling g_ptr_array_free() with @free_segment set to %TRUE. This function is thread-safe and may be called from any thread. - @@ -19262,7 +18306,6 @@ is thread-safe and may be called from any thread. Contains the public fields of a [Queue][glib-Double-ended-Queues]. - a pointer to the first element of the queue @@ -19282,7 +18325,6 @@ is thread-safe and may be called from any thread. Removes all the elements in @queue. If queue elements contain dynamically-allocated memory, they should be freed first. - @@ -19296,7 +18338,6 @@ dynamically-allocated memory, they should be freed first. Convenience method, which frees all the memory used by a #GQueue, and calls the provided @free_func on each item in the #GQueue. - @@ -19315,7 +18356,6 @@ and calls the provided @free_func on each item in the #GQueue. Copies a @queue. Note that is a shallow copy. If the elements in the queue consist of pointers to data, the pointers are copied, but the actual data is not. - a copy of @queue @@ -19331,7 +18371,6 @@ actual data is not. Removes @link_ from @queue and frees it. @link_ must be part of @queue. - @@ -19350,7 +18389,6 @@ actual data is not. Finds the first link in @queue which contains @data. - the first link in @queue which contains @data @@ -19374,7 +18412,6 @@ desired element. It iterates over the queue, calling the given function which should return 0 when the desired element is found. The function takes two gconstpointer arguments, the #GQueue element's data as the first argument and the given user data as the second argument. - the found link, or %NULL if it wasn't found @@ -19403,7 +18440,6 @@ function. It is safe for @func to remove the element from @queue, but it must not modify any part of the queue after that element. - @@ -19429,7 +18465,6 @@ dynamically-allocated memory, they should be freed first. If queue elements contain dynamically-allocated memory, you should either use g_queue_free_full() or free them manually first. - @@ -19446,7 +18481,6 @@ and calls the specified destroy function on every element's data. @free_func should not modify the queue (eg, by removing the freed element from it). - @@ -19463,7 +18497,6 @@ element from it). Returns the number of items in @queue. - the number of items in @queue @@ -19477,7 +18510,6 @@ element from it). Returns the position of the first element in @queue which contains @data. - the position of the first element in @queue which contains @data, or -1 if no element in @queue contains @data @@ -19499,7 +18531,6 @@ element from it). before it can be used. Alternatively you can initialize it with #G_QUEUE_INIT. It is not necessary to initialize queues created with g_queue_new(). - @@ -19515,7 +18546,6 @@ g_queue_new(). @sibling must be part of @queue. Since GLib 2.44 a %NULL sibling pushes the data at the head of the queue. - @@ -19541,7 +18571,6 @@ data at the head of the queue. Inserts @link_ into @queue after @sibling. @sibling must be part of @queue. - @@ -19570,7 +18599,6 @@ data at the head of the queue. @sibling must be part of @queue. Since GLib 2.44 a %NULL sibling pushes the data at the tail of the queue. - @@ -19596,7 +18624,6 @@ data at the tail of the queue. Inserts @link_ into @queue before @sibling. @sibling must be part of @queue. - @@ -19622,7 +18649,6 @@ data at the tail of the queue. Inserts @data into @queue using @func to determine the new position. - @@ -19651,7 +18677,6 @@ data at the tail of the queue. Returns %TRUE if the queue is empty. - %TRUE if the queue is empty @@ -19665,7 +18690,6 @@ data at the tail of the queue. Returns the position of @link_ in @queue. - the position of @link_, or -1 if the link is not part of @queue @@ -19686,7 +18710,6 @@ data at the tail of the queue. Returns the first element of the queue. - the data of the first element in the queue, or %NULL if the queue is empty @@ -19701,7 +18724,6 @@ data at the tail of the queue. Returns the first link in @queue. - the first link in @queue, or %NULL if @queue is empty @@ -19717,7 +18739,6 @@ data at the tail of the queue. Returns the @n'th element of @queue. - the data for the @n'th element of @queue, or %NULL if @n is off the end of @queue @@ -19736,7 +18757,6 @@ data at the tail of the queue. Returns the link at the given position - the link at the @n'th position, or %NULL if @n is off the end of the list @@ -19757,7 +18777,6 @@ data at the tail of the queue. Returns the last element of the queue. - the data of the last element in the queue, or %NULL if the queue is empty @@ -19772,7 +18791,6 @@ data at the tail of the queue. Returns the last link in @queue. - the last link in @queue, or %NULL if @queue is empty @@ -19788,7 +18806,6 @@ data at the tail of the queue. Removes the first element of the queue and returns its data. - the data of the first element in the queue, or %NULL if the queue is empty @@ -19803,7 +18820,6 @@ data at the tail of the queue. Removes and returns the first element of the queue. - the #GList element at the head of the queue, or %NULL if the queue is empty @@ -19820,7 +18836,6 @@ data at the tail of the queue. Removes the @n'th element of @queue and returns its data. - the element's data, or %NULL if @n is off the end of @queue @@ -19838,7 +18853,6 @@ data at the tail of the queue. Removes and returns the link at the given position. - the @n'th link, or %NULL if @n is off the end of @queue @@ -19858,7 +18872,6 @@ data at the tail of the queue. Removes the last element of the queue and returns its data. - the data of the last element in the queue, or %NULL if the queue is empty @@ -19873,7 +18886,6 @@ data at the tail of the queue. Removes and returns the last element of the queue. - the #GList element at the tail of the queue, or %NULL if the queue is empty @@ -19890,7 +18902,6 @@ data at the tail of the queue. Adds a new element at the head of the queue. - @@ -19907,7 +18918,6 @@ data at the tail of the queue. Adds a new element at the head of the queue. - @@ -19926,7 +18936,6 @@ data at the tail of the queue. Inserts a new element into @queue at the given position. - @@ -19949,7 +18958,6 @@ data at the tail of the queue. Inserts @link into @queue at the given position. - @@ -19974,7 +18982,6 @@ data at the tail of the queue. Adds a new element at the tail of the queue. - @@ -19991,7 +18998,6 @@ data at the tail of the queue. Adds a new element at the tail of the queue. - @@ -20010,7 +19016,6 @@ data at the tail of the queue. Removes the first element in @queue that contains @data. - %TRUE if @data was found and removed from @queue @@ -20028,7 +19033,6 @@ data at the tail of the queue. Remove all elements whose data equals @data from @queue. - the number of elements removed from @queue @@ -20046,7 +19050,6 @@ data at the tail of the queue. Reverses the order of the items in @queue. - @@ -20059,7 +19062,6 @@ data at the tail of the queue. Sorts @queue using @compare_func. - @@ -20086,7 +19088,6 @@ data at the tail of the queue. The link is not freed. @link_ must be part of @queue. - @@ -20105,7 +19106,6 @@ The link is not freed. Creates a new #GQueue. - a newly allocated #GQueue @@ -20176,7 +19176,6 @@ without initialisation. Otherwise, you should call g_rw_lock_init() on it and g_rw_lock_clear() when done. A GRWLock should only be accessed with the g_rw_lock_ functions. - @@ -20195,7 +19194,6 @@ Calling g_rw_lock_clear() when any thread holds the lock leads to undefined behaviour. Sine: 2.32 - @@ -20231,7 +19229,6 @@ needed, use g_rw_lock_clear(). Calling g_rw_lock_init() on an already initialized #GRWLock leads to undefined behaviour. - @@ -20252,7 +19249,6 @@ recursively. It is implementation-defined how many threads are allowed to hold read locks on the same lock simultaneously. If the limit is hit, or if a deadlock is detected, a critical warning will be emitted. - @@ -20267,7 +19263,6 @@ or if a deadlock is detected, a critical warning will be emitted. Tries to obtain a read lock on @rw_lock and returns %TRUE if the read lock was successfully obtained. Otherwise it returns %FALSE. - %TRUE if @rw_lock could be locked @@ -20284,7 +19279,6 @@ returns %FALSE. Calling g_rw_lock_reader_unlock() on a lock that is not held by the current thread leads to undefined behaviour. - @@ -20299,7 +19293,6 @@ by the current thread leads to undefined behaviour. Obtain a write lock on @rw_lock. If any thread already holds a read or write lock on @rw_lock, the current thread will block until all other threads have dropped their locks on @rw_lock. - @@ -20314,7 +19307,6 @@ until all other threads have dropped their locks on @rw_lock. Tries to obtain a write lock on @rw_lock. If any other thread holds a read or write lock on @rw_lock, it immediately returns %FALSE. Otherwise it locks @rw_lock and returns %TRUE. - %TRUE if @rw_lock could be locked @@ -20331,7 +19323,6 @@ Otherwise it locks @rw_lock and returns %TRUE. Calling g_rw_lock_writer_unlock() on a lock that is not held by the current thread leads to undefined behaviour. - @@ -20346,12 +19337,10 @@ by the current thread leads to undefined behaviour. The GRand struct is an opaque data structure. It should only be accessed through the g_rand_* functions. - Copies a #GRand into a new one with the same exact state as before. This way you can take a snapshot of the random number generator for replaying later. - the new #GRand @@ -20366,7 +19355,6 @@ replaying later. Returns the next random #gdouble from @rand_ equally distributed over the range [0..1). - a random number @@ -20381,7 +19369,6 @@ the range [0..1). Returns the next random #gdouble from @rand_ equally distributed over the range [@begin..@end). - a random number @@ -20403,7 +19390,6 @@ the range [@begin..@end). Frees the memory allocated for the #GRand. - @@ -20417,7 +19403,6 @@ the range [@begin..@end). Returns the next random #guint32 from @rand_ equally distributed over the range [0..2^32-1]. - a random number @@ -20432,7 +19417,6 @@ the range [0..2^32-1]. Returns the next random #gint32 from @rand_ equally distributed over the range [@begin..@end-1]. - a random number @@ -20454,7 +19438,6 @@ the range [@begin..@end-1]. Sets the seed for the random number generator #GRand to @seed. - @@ -20475,7 +19458,6 @@ Array can be of arbitrary size, though only the first 624 values are taken. This function is useful if you have many low entropy seeds, or if you require more then 32 bits of actual entropy for your application. - @@ -20500,7 +19482,6 @@ either from `/dev/urandom` (if existing) or from the current time (as a fallback). On Windows, the seed is taken from rand_s(). - the new #GRand @@ -20508,7 +19489,6 @@ On Windows, the seed is taken from rand_s(). Creates a new random number generator initialized with @seed. - the new #GRand @@ -20522,7 +19502,6 @@ On Windows, the seed is taken from rand_s(). Creates a new random number generator initialized with @seed. - the new #GRand @@ -20553,7 +19532,6 @@ g_rec_mutex_init() on it and g_rec_mutex_clear() when done. A GRecMutex should only be accessed with the g_rec_mutex_ functions. - @@ -20573,7 +19551,6 @@ Calling g_rec_mutex_clear() on a locked recursive mutex leads to undefined behaviour. Sine: 2.32 - @@ -20611,7 +19588,6 @@ leads to undefined behaviour. To undo the effect of g_rec_mutex_init() when a recursive mutex is no longer needed, use g_rec_mutex_clear(). - @@ -20629,7 +19605,6 @@ unlocked by the other thread. If @rec_mutex is already locked by the current thread, the 'lock count' of @rec_mutex is increased. The mutex will only become available again when it is unlocked as many times as it has been locked. - @@ -20644,7 +19619,6 @@ as many times as it has been locked. Tries to lock @rec_mutex. If @rec_mutex is already locked by another thread, it immediately returns %FALSE. Otherwise it locks @rec_mutex and returns %TRUE. - %TRUE if @rec_mutex could be locked @@ -20663,7 +19637,6 @@ and can lock @rec_mutex itself. Calling g_rec_mutex_unlock() on a recursive mutex that is not locked by the current thread leads to undefined behaviour. - @@ -20741,11 +19714,9 @@ The regular expressions low-level functionalities are obtained through the excellent [PCRE](http://www.pcre.org/) library written by Philip Hazel. - Compiles the regular expression to an internal form, and does the initial setup of the #GRegex structure. - a #GRegex structure or %NULL if an error occurred. Call g_regex_unref() when you are done with it @@ -20768,7 +19739,6 @@ the initial setup of the #GRegex structure. Returns the number of capturing subpatterns in the pattern. - the number of capturing subpatterns @@ -20786,7 +19756,6 @@ the initial setup of the #GRegex structure. Depending on the version of PCRE that is used, this may or may not include flags set by option expressions such as `(?i)` found at the top-level within the compiled pattern. - flags from #GRegexCompileFlags @@ -20800,7 +19769,6 @@ top-level within the compiled pattern. Checks whether the pattern contains explicit CR or LF references. - %TRUE if the pattern contains explicit CR or LF references @@ -20814,7 +19782,6 @@ top-level within the compiled pattern. Returns the match options that @regex was created with. - flags from #GRegexMatchFlags @@ -20830,7 +19797,6 @@ top-level within the compiled pattern. Returns the number of the highest back reference in the pattern, or 0 if the pattern does not contain back references. - the number of the highest back reference @@ -20846,7 +19812,6 @@ back references. Gets the number of characters in the longest lookbehind assertion in the pattern. This information is useful when doing multi-segment matching using the partial matching facilities. - the number of characters in the longest lookbehind assertion. @@ -20861,7 +19826,6 @@ the partial matching facilities. Gets the pattern string associated with @regex, i.e. a copy of the string passed to g_regex_new(). - the pattern of @regex @@ -20875,7 +19839,6 @@ the string passed to g_regex_new(). Retrieves the number of the subexpression named @name. - The number of the subexpression or -1 if @name does not exists @@ -20933,7 +19896,6 @@ print_uppercase_words (const gchar *string) @string is not copied and is used in #GMatchInfo internally. If you use any #GMatchInfo method (except g_match_info_free()) after freeing or modifying @string then the behaviour is undefined. - %TRUE is the string matched, %FALSE otherwise @@ -20973,7 +19935,6 @@ matched. @string is not copied and is used in #GMatchInfo internally. If you use any #GMatchInfo method (except g_match_info_free()) after freeing or modifying @string then the behaviour is undefined. - %TRUE is the string matched, %FALSE otherwise @@ -21037,7 +19998,6 @@ matched. @string is not copied and is used in #GMatchInfo internally. If you use any #GMatchInfo method (except g_match_info_free()) after freeing or modifying @string then the behaviour is undefined. - %TRUE is the string matched, %FALSE otherwise @@ -21124,7 +20084,6 @@ print_uppercase_words (const gchar *string) } } ]| - %TRUE is the string matched, %FALSE otherwise @@ -21161,7 +20120,6 @@ print_uppercase_words (const gchar *string) Increases reference count of @regex by 1. - @regex @@ -21200,7 +20158,6 @@ you can use g_regex_replace_literal(). Setting @start_position differs from just passing over a shortened string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern that begins with any kind of lookbehind assertion, such as "\b". - a newly allocated string containing the replacements @@ -21280,7 +20237,6 @@ g_hash_table_destroy (h); ... ]| - a newly allocated string containing the replacements @@ -21327,7 +20283,6 @@ Setting @start_position differs from just passing over a shortened string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern that begins with any kind of lookbehind assertion, such as "\b". - a newly allocated string containing the replacements @@ -21379,7 +20334,6 @@ A pattern that can match empty strings splits @string into separate characters wherever it matches the empty string between characters. For example splitting "ab c" using as a separator "\s*", you will get "a", "b" and "c". - a %NULL-terminated gchar ** array. Free it using g_strfreev() @@ -21424,7 +20378,6 @@ For example splitting "ab c" using as a separator "\s*", you will get Setting @start_position differs from just passing over a shortened string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern that begins with any kind of lookbehind assertion, such as "\b". - a %NULL-terminated gchar ** array. Free it using g_strfreev() @@ -21465,7 +20418,6 @@ it using g_strfreev() Decreases reference count of @regex by 1. When reference count drops to zero, it frees all the memory associated with the regex structure. - @@ -21486,7 +20438,6 @@ for pattern references. For instance, replacement text 'foo\n' does not contain references and may be evaluated without information about actual match, but '\0\1' (whole match followed by first subpattern) requires valid #GMatchInfo object. - whether @replacement is a valid replacement string @@ -21514,7 +20465,6 @@ to compile a regex with embedded nul characters. For completeness, @length can be -1 for a nul-terminated string. In this case the output string will be of course equal to @string. - a newly-allocated escaped string @@ -21538,7 +20488,6 @@ function is useful to dynamically generate regular expressions. @string can contain nul characters that are replaced with "\0", in this case remember to specify the correct length of @string in @length. - a newly-allocated escaped string @@ -21567,7 +20516,6 @@ substrings, capture counts, and so on. If this function is to be called on the same @pattern more than once, it's more efficient to compile the pattern once with g_regex_new() and then use g_regex_match(). - %TRUE if the string matched, %FALSE otherwise @@ -21619,7 +20567,6 @@ A pattern that can match empty strings splits @string into separate characters wherever it matches the empty string between characters. For example splitting "ab c" using as a separator "\s*", you will get "a", "b" and "c". - a %NULL-terminated array of strings. Free it using g_strfreev() @@ -21649,7 +20596,6 @@ it using g_strfreev() Flags specifying compile-time options. - Letters in the pattern match both upper- and lowercase letters. This option can be changed within a pattern @@ -21758,7 +20704,6 @@ it using g_strfreev() Error codes returned by regular expressions functions. - Compilation of the regular expression failed. @@ -21979,7 +20924,6 @@ it using g_strfreev() It is called for each occurrence of the pattern in the string passed to g_regex_replace_eval(), and it should append the replacement to @result. - %FALSE to continue the replacement process, %TRUE to stop it @@ -22003,7 +20947,6 @@ to g_regex_replace_eval(), and it should append the replacement to Flags specifying match-time options. - The pattern is forced to be "anchored", that is, it is constrained to match only at the first matching point in the @@ -22097,23 +21040,19 @@ to g_regex_replace_eval(), and it should append the replacement to The search path separator character. This is ':' on UNIX machines and ';' under Windows. - The search path separator as a string. This is ":" on UNIX machines and ";" under Windows. - - Returns the size of @member in the struct definition without having a declared instance of @struct_type. - a structure type, e.g. #GOutputVector @@ -22124,21 +21063,17 @@ declared instance of @struct_type. - - - The #GSList struct is used for each element in the singly-linked list. - holds the element's data, which can be a pointer to any kind of data, or any integer value using the @@ -22155,7 +21090,6 @@ list. Allocates space for one #GSList element. It is called by the g_slist_append(), g_slist_prepend(), g_slist_insert() and g_slist_insert_sorted() functions and so is rarely used on its own. - a pointer to the newly-allocated #GSList element. @@ -22186,7 +21120,6 @@ list = g_slist_append (list, "second"); number_list = g_slist_append (number_list, GINT_TO_POINTER (27)); number_list = g_slist_append (number_list, GINT_TO_POINTER (14)); ]| - the new start of the #GSList @@ -22210,7 +21143,6 @@ number_list = g_slist_append (number_list, GINT_TO_POINTER (14)); Adds the second #GSList onto the end of the first #GSList. Note that the elements of the second #GSList are not copied. They are used directly. - the start of the new #GSList @@ -22239,7 +21171,6 @@ Note that this is a "shallow" copy. If the list elements consist of pointers to data, the pointers are copied but the actual data isn't. See g_slist_copy_deep() if you need to copy the data as well. - a copy of @list @@ -22276,7 +21207,6 @@ And, to entirely free the new list, you could do: |[<!-- language="C" --> g_slist_free_full (another_list, g_object_unref); ]| - a full copy of @list, use g_slist_free_full() to free it @@ -22310,7 +21240,6 @@ that is proportional to the length of the list (ie. O(n)). If you find yourself using g_slist_delete_link() frequently, you should consider a different data structure, such as the doubly-linked #GList. - the new head of @list @@ -22335,7 +21264,6 @@ consider a different data structure, such as the doubly-linked Finds the element in a #GSList which contains the given data. - the found #GSList element, or %NULL if it is not found @@ -22363,7 +21291,6 @@ the given function which should return 0 when the desired element is found. The function takes two #gconstpointer arguments, the #GSList element's data as the first argument and the given user data. - the found #GSList element, or %NULL if it is not found @@ -22393,7 +21320,6 @@ given user data. It is safe for @func to remove the element from @list, but it must not modify any part of the list after that element. - @@ -22428,7 +21354,6 @@ is not left dangling: GSList *list_of_borrowed_things = …; /<!-- -->* (transfer container) *<!-- -->/ g_slist_free (g_steal_pointer (&list_of_borrowed_things)); ]| - @@ -22444,7 +21369,6 @@ g_slist_free (g_steal_pointer (&list_of_borrowed_things)); Frees one #GSList element. It is usually used after g_slist_remove_link(). - @@ -22472,7 +21396,6 @@ from @free_func: GSList *list_of_owned_things = …; /<!-- -->* (transfer full) (element-type GObject) *<!-- -->/ g_slist_free_full (g_steal_pointer (&list_of_owned_things), g_object_unref); ]| - @@ -22492,7 +21415,6 @@ g_slist_free_full (g_steal_pointer (&list_of_owned_things), g_object_unref); Gets the position of the element containing the given data (starting from 0). - the index of the element containing the data, or -1 if the data is not found @@ -22513,7 +21435,6 @@ the given data (starting from 0). Inserts a new element into the list at the given position. - the new start of the #GSList @@ -22542,7 +21463,6 @@ the given data (starting from 0). Inserts a node before @sibling containing @data. - the new head of the list. @@ -22571,7 +21491,6 @@ the given data (starting from 0). Inserts a new element into the list, using the given comparison function to determine its position. - the new start of the #GSList @@ -22600,7 +21519,6 @@ comparison function to determine its position. Inserts a new element into the list, using the given comparison function to determine its position. - the new start of the #GSList @@ -22634,7 +21552,6 @@ comparison function to determine its position. Gets the last element in a #GSList. This function iterates over the whole list. - the last element in the #GSList, or %NULL if the #GSList has no elements @@ -22657,7 +21574,6 @@ This function iterates over the whole list. This function iterates over the whole list to count its elements. To check whether the list is non-empty, it is faster to check @list against %NULL. - the number of elements in the #GSList @@ -22673,7 +21589,6 @@ check @list against %NULL. Gets the element at the given position in a #GSList. - the element, or %NULL if the position is off the end of the #GSList @@ -22696,7 +21611,6 @@ check @list against %NULL. Gets the data of the element at the given position. - the element's data, or %NULL if the position is off the end of the #GSList @@ -22718,7 +21632,6 @@ check @list against %NULL. Gets the position of the given element in the #GSList (starting from 0). - the position of the element in the #GSList, or -1 if the element is not found @@ -22751,7 +21664,6 @@ GSList *list = NULL; list = g_slist_prepend (list, "last"); list = g_slist_prepend (list, "first"); ]| - the new start of the #GSList @@ -22775,7 +21687,6 @@ list = g_slist_prepend (list, "first"); Removes an element from a #GSList. If two elements contain the same data, only the first is removed. If none of the elements contain the data, the #GSList is unchanged. - the new start of the #GSList @@ -22800,7 +21711,6 @@ If none of the elements contain the data, the #GSList is unchanged. Returns the new head of the list. Contrast with g_slist_remove() which removes only the first node matching the given data. - new head of @list @@ -22831,7 +21741,6 @@ requires time that is proportional to the length of the list (ie. O(n)). If you find yourself using g_slist_remove_link() frequently, you should consider a different data structure, such as the doubly-linked #GList. - the new start of the #GSList, without the element @@ -22855,7 +21764,6 @@ such as the doubly-linked #GList. Reverses a #GSList. - the start of the reversed #GSList @@ -22874,7 +21782,6 @@ such as the doubly-linked #GList. Sorts a #GSList using the given comparison function. The algorithm used is a stable sort. - the start of the sorted #GSList @@ -22900,7 +21807,6 @@ used is a stable sort. Like g_slist_sort(), but the sort function accepts a user data argument. - new head of the list @@ -22928,7 +21834,6 @@ used is a stable sort. Use this macro as the return value of a #GSourceFunc to leave the #GSource in the main loop. - @@ -22941,7 +21846,6 @@ g_child_watch_source_new() is #GChildWatchFunc, which accepts more arguments than #GSourceFunc. Casting the function with `(GSourceFunc)` to call g_source_set_callback() will trigger a warning, even though it will be cast back to the correct type before it is called by the source. - a function pointer. @@ -22951,12 +21855,10 @@ back to the correct type before it is called by the source. Use this macro as the return value of a #GSourceFunc to remove the #GSource from the main loop. - The square root of two. - @@ -22973,7 +21875,6 @@ is transformed by the preprocessor into (code equivalent to): |[<!-- language="C" --> const gchar *greeting = "27 today!"; ]| - a macro or a string @@ -22981,7 +21882,6 @@ const gchar *greeting = "27 today!"; - @@ -22989,7 +21889,6 @@ const gchar *greeting = "27 today!"; Returns a member of a structure at a given offset, using the given type. - the type of the struct field @@ -23005,7 +21904,6 @@ const gchar *greeting = "27 today!"; Returns an untyped pointer to a given offset of a struct. - a pointer to a struct @@ -23017,7 +21915,6 @@ const gchar *greeting = "27 today!"; Returns the offset, in bytes, of a member of a struct. - a structure type, e.g. #GtkWidget @@ -23029,31 +21926,24 @@ const gchar *greeting = "27 today!"; The standard delimiters, used in g_strdelimit(). - - - - - - - @@ -23071,7 +21961,6 @@ can place them here. If you want to use your own message handler you can set the @msg_handler field. The type of the message handler function is declared by #GScannerMsgFunc. - unused @@ -23157,7 +22046,6 @@ is declared by #GScannerMsgFunc. Returns the current line in the input stream (counting from 1). This is the line of the last token parsed via g_scanner_get_next_token(). - the current line @@ -23173,7 +22061,6 @@ g_scanner_get_next_token(). Returns the current position in the current line (counting from 0). This is the position of the last token parsed via g_scanner_get_next_token(). - the current position on the line @@ -23188,7 +22075,6 @@ g_scanner_get_next_token(). Gets the current token type. This is simply the @token field in the #GScanner structure. - the current token type @@ -23203,7 +22089,6 @@ field in the #GScanner structure. Gets the current token value. This is simply the @value field in the #GScanner structure. - the current token value @@ -23217,7 +22102,6 @@ field in the #GScanner structure. Frees all memory used by the #GScanner. - @@ -23231,7 +22115,6 @@ field in the #GScanner structure. Returns %TRUE if the scanner has reached the end of the file or text buffer. - %TRUE if the scanner has reached the end of the file or text buffer @@ -23246,7 +22129,6 @@ the file or text buffer. Outputs an error message, via the #GScanner message handler. - @@ -23270,7 +22152,6 @@ the file or text buffer. and also removes it from the input stream. The token data is placed in the @token, @value, @line, and @position fields of the #GScanner structure. - the type of the token @@ -23284,7 +22165,6 @@ the #GScanner structure. Prepares to scan a file. - @@ -23301,7 +22181,6 @@ the #GScanner structure. Prepares to scan a text buffer. - @@ -23324,7 +22203,6 @@ the #GScanner structure. Looks up a symbol in the current scope and return its value. If the symbol is not bound in the current scope, %NULL is returned. - the value of @symbol in the current scope, or %NULL if @symbol is not bound in the current scope @@ -23353,7 +22231,6 @@ results when changing scope or the scanner configuration after peeking the next token. Getting the next token after switching the scope or configuration will return whatever was peeked before, regardless of any symbols that may have been added or removed in the new scope. - the type of the token @@ -23367,7 +22244,6 @@ any symbols that may have been added or removed in the new scope. Adds a symbol to the given scope. - @@ -23395,7 +22271,6 @@ any symbols that may have been added or removed in the new scope. in the given scope of the #GScanner. The function is passed the symbol and value of each pair, and the given @user_data parameter. - @@ -23421,7 +22296,6 @@ parameter. Looks up a symbol in a scope and return its value. If the symbol is not bound in the scope, %NULL is returned. - the value of @symbol in the given scope, or %NULL if @symbol is not bound in the given scope. @@ -23444,7 +22318,6 @@ symbol is not bound in the scope, %NULL is returned. Removes a symbol from a scope. - @@ -23465,7 +22338,6 @@ symbol is not bound in the scope, %NULL is returned. Sets the current scope. - the old scope id @@ -23486,7 +22358,6 @@ symbol is not bound in the scope, %NULL is returned. and blows the file read ahead buffer. This is useful for third party uses of the scanners filedescriptor, which hooks onto the current scanning position. - @@ -23505,7 +22376,6 @@ followed by g_scanner_unexp_token() without an intermediate call to g_scanner_get_next_token(), as g_scanner_unexp_token() evaluates the scanner's current token (not the peeked token) to construct part of the message. - @@ -23551,7 +22421,6 @@ to construct part of the message. Outputs a warning message, via the #GScanner message handler. - @@ -23577,7 +22446,6 @@ The @config_templ structure specifies the initial settings of the scanner, which are copied into the #GScanner @config field. If you pass %NULL then the default settings are used. - the new #GScanner @@ -23594,7 +22462,6 @@ are used. Specifies the #GScanner parser configuration. Most settings can be changed during the parsing phase and will affect the lexical parsing of the next unpeeked token. - specifies which characters should be skipped by the scanner (the default is the whitespace characters: space, @@ -23735,7 +22602,6 @@ parsing of the next unpeeked token. Specifies the type of the message handler function. - @@ -23758,7 +22624,6 @@ parsing of the next unpeeked token. An enumeration specifying the base position for a g_io_channel_seek_position() operation. - the current position in the file. @@ -23772,10 +22637,8 @@ g_io_channel_seek_position() operation. The #GSequence struct is an opaque data type representing a [sequence][glib-Sequences] data type. - Adds a new item to the end of @seq. - an iterator pointing to the new item @@ -23794,7 +22657,6 @@ g_io_channel_seek_position() operation. Calls @func for each item in the sequence passing @user_data to the function. @func must not modify the sequence itself. - @@ -23817,7 +22679,6 @@ to the function. @func must not modify the sequence itself. Frees the memory allocated for @seq. If @seq has a data destroy function associated with it, that function is called on all items in @seq. - @@ -23830,7 +22691,6 @@ in @seq. Returns the begin iterator for @seq. - the begin iterator for @seq. @@ -23844,7 +22704,6 @@ in @seq. Returns the end iterator for @seg - the end iterator for @seq @@ -23859,7 +22718,6 @@ in @seq. Returns the iterator at position @pos. If @pos is negative or larger than the number of items in @seq, the end iterator is returned. - The #GSequenceIter at position @pos @@ -23879,7 +22737,6 @@ than the number of items in @seq, the end iterator is returned. Returns the length of @seq. Note that this method is O(h) where `h' is the height of the tree. It is thus more efficient to use g_sequence_is_empty() when comparing the length to zero. - the length of @seq @@ -23904,7 +22761,6 @@ if the second item comes before the first. Note that when adding a large amount of data to a #GSequence, it is more efficient to do unsorted insertions and then call g_sequence_sort() or g_sequence_sort_iter(). - a #GSequenceIter pointing to the new item. @@ -23941,7 +22797,6 @@ positive value if the second iterator comes before the first. Note that when adding a large amount of data to a #GSequence, it is more efficient to do unsorted insertions and then call g_sequence_sort() or g_sequence_sort_iter(). - a #GSequenceIter pointing to the new item @@ -23971,7 +22826,6 @@ g_sequence_sort() or g_sequence_sort_iter(). This function is functionally identical to checking the result of g_sequence_get_length() being equal to zero. However this function is implemented in O(1) running time. - %TRUE if the sequence is empty, otherwise %FALSE. @@ -23997,7 +22851,6 @@ the second item comes before the first. This function will fail if the data contained in the sequence is unsorted. - an #GSequenceIter pointing to the position of the first item found equal to @data according to @cmp_func and @@ -24034,7 +22887,6 @@ value if the second iterator comes before the first. This function will fail if the data contained in the sequence is unsorted. - an #GSequenceIter pointing to the position of the first item found equal to @data according to @iter_cmp @@ -24062,7 +22914,6 @@ unsorted. Adds a new item to the front of @seq - an iterator pointing to the new item @@ -24092,7 +22943,6 @@ consider using g_sequence_lookup(). This function will fail if the data contained in the sequence is unsorted. - an #GSequenceIter pointing to the position where @data would have been inserted according to @cmp_func and @cmp_data @@ -24131,7 +22981,6 @@ consider using g_sequence_lookup_iter(). This function will fail if the data contained in the sequence is unsorted. - a #GSequenceIter pointing to the position in @seq where @data would have been inserted according to @iter_cmp @@ -24164,7 +23013,6 @@ unsorted. return 0 if they are equal, a negative value if the first comes before the second, and a positive value if the second comes before the first. - @@ -24191,7 +23039,6 @@ of a #GCompareDataFunc as the compare function return 0 if the iterators are equal, a negative value if the first iterator comes before the second, and a positive value if the second iterator comes before the first. - @@ -24214,7 +23061,6 @@ iterator comes before the first. Calls @func for each item in the range (@begin, @end) passing @user_data to the function. @func must not modify the sequence itself. - @@ -24239,7 +23085,6 @@ itself. Returns the data that @iter points to. - the data that @iter points to @@ -24253,7 +23098,6 @@ itself. Inserts a new item just before the item pointed to by @iter. - an iterator pointing to the new item @@ -24274,7 +23118,6 @@ itself. After calling this function @dest will point to the position immediately after @src. It is allowed for @src and @dest to point into different sequences. - @@ -24299,7 +23142,6 @@ into by @begin and @end. If @dest is %NULL, the range indicated by @begin and @end is removed from the sequence. If @dest points to a place within the (@begin, @end) range, the range does not move. - @@ -24322,7 +23164,6 @@ the (@begin, @end) range, the range does not move. Creates a new GSequence. The @data_destroy function, if non-%NULL will be called on all items when the sequence is destroyed and on items that are removed from the sequence. - a new #GSequence @@ -24341,7 +23182,6 @@ guaranteed to be exactly in the middle. The @begin and @end iterators must both point to the same sequence and @begin must come before or be equal to @end in the sequence. - a #GSequenceIter pointing somewhere in the (@begin, @end) range @@ -24364,7 +23204,6 @@ end iterator to this function. If the sequence has a data destroy function associated with it, this function is called on the data for the removed item. - @@ -24380,7 +23219,6 @@ function is called on the data for the removed item. If the sequence has a data destroy function associated with it, this function is called on the data for the removed items. - @@ -24399,7 +23237,6 @@ function is called on the data for the removed items. Changes the data for the item pointed to by @iter to be @data. If the sequence has a data destroy function associated with it, that function is called on the existing data that @iter pointed to. - @@ -24425,7 +23262,6 @@ may return different values for that item. It should return 0 if the items are equal, a negative value if the first item comes before the second, and a positive value if the second item comes before the first. - @@ -24454,7 +23290,6 @@ the compare function. return 0 if the iterators are equal, a negative value if the first iterator comes before the second, and a positive value if the second iterator comes before the first. - @@ -24476,7 +23311,6 @@ iterator comes before the first. Swaps the items pointed to by @a and @b. It is allowed for @a and @b to point into difference sequences. - @@ -24495,13 +23329,11 @@ to point into difference sequences. The #GSequenceIter struct is an opaque data type representing an iterator pointing into a #GSequence. - Returns a negative number if @a comes before @b, 0 if they are equal, and a positive number if @a comes after @b. The @a and @b iterators must point into the same sequence. - a negative number if @a comes before @b, 0 if they are equal, and a positive number if @a comes after @b @@ -24520,7 +23352,6 @@ The @a and @b iterators must point into the same sequence. Returns the position of @iter - the position of @iter @@ -24534,7 +23365,6 @@ The @a and @b iterators must point into the same sequence. Returns the #GSequence that @iter points into. - the #GSequence that @iter points into @@ -24548,7 +23378,6 @@ The @a and @b iterators must point into the same sequence. Returns whether @iter is the begin iterator - whether @iter is the begin iterator @@ -24562,7 +23391,6 @@ The @a and @b iterators must point into the same sequence. Returns whether @iter is the end iterator - Whether @iter is the end iterator @@ -24579,7 +23407,6 @@ The @a and @b iterators must point into the same sequence. If @iter is closer than -@delta positions to the beginning of the sequence, the begin iterator is returned. If @iter is closer than @delta positions to the end of the sequence, the end iterator is returned. - a #GSequenceIter which is @delta positions away from @iter @@ -24599,7 +23426,6 @@ to the end of the sequence, the end iterator is returned. Returns an iterator pointing to the next position after @iter. If @iter is the end iterator, the end iterator is returned. - a #GSequenceIter pointing to the next position after @iter @@ -24614,7 +23440,6 @@ If @iter is the end iterator, the end iterator is returned. Returns an iterator pointing to the previous position before @iter. If @iter is the begin iterator, the begin iterator is returned. - a #GSequenceIter pointing to the previous position before @iter @@ -24632,7 +23457,6 @@ If @iter is the begin iterator, the begin iterator is returned. A #GSequenceIterCompareFunc is a function used to compare iterators. It must return zero if the iterators compare equal, a negative value if @a comes before @b, and a positive value if @b comes before @a. - zero if the iterators are equal, a negative value if @a comes before @b, and a positive value if @b comes before @a. @@ -24655,7 +23479,6 @@ if @a comes before @b, and a positive value if @b comes before @a. Error codes returned by shell functions. - Mismatched or otherwise mangled quoting. @@ -24667,7 +23490,6 @@ if @a comes before @b, and a positive value if @b comes before @a. - @@ -24684,7 +23506,6 @@ if @a comes before @b, and a positive value if @b comes before @a. The `GSource` struct is an opaque data type representing an event source. - @@ -24735,7 +23556,6 @@ additional data. The size passed in must be at least The source will not initially be associated with any #GMainContext and must be added to one with g_source_attach() before it will be executed. - the newly-created #GSource. @@ -24770,7 +23590,6 @@ is attached to it. This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. - @@ -24798,7 +23617,6 @@ Do not call this API on a #GSource that you did not create. Using this API forces the linear scanning of event sources on each main loop iteration. Newly-written event sources should try to use g_source_add_unix_fd() instead of this API. - @@ -24828,7 +23646,6 @@ This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. As the name suggests, this function is not available on Windows. - an opaque tag @@ -24854,7 +23671,6 @@ that context. Remove it by calling g_source_destroy(). This function is safe to call from any thread, regardless of which thread the @context is running in. - the ID (greater than 0) for the source within the #GMainContext. @@ -24882,7 +23698,6 @@ g_source_unref() to drop it. This function is safe to call from any thread, regardless of which thread the #GMainContext is running in. - @@ -24896,7 +23711,6 @@ the #GMainContext is running in. Checks whether a source is allowed to be called recursively. see g_source_set_can_recurse(). - whether recursion is allowed. @@ -24917,7 +23731,6 @@ case it will return that #GMainContext). In particular, you can always call this function on the source returned from g_main_current_source(). But calling this function on a source whose #GMainContext has been destroyed is an error. - the #GMainContext with which the source is associated, or %NULL if the context has not @@ -24935,7 +23748,6 @@ whose #GMainContext has been destroyed is an error. This function ignores @source and is otherwise the same as g_get_current_time(). use g_source_get_time() instead - @@ -24960,7 +23772,6 @@ You can only call this function while the source is associated to a #GMainContext instance; calling this function before g_source_attach() or after g_source_destroy() yields undefined behavior. The ID returned is unique within the #GMainContext instance passed to g_source_attach(). - the ID (greater than 0) for the source @@ -24975,7 +23786,6 @@ is unique within the #GMainContext instance passed to g_source_attach(). Gets a name for the source, used in debugging and profiling. The name may be #NULL if it has never been set with g_source_set_name(). - the name of the source @@ -24989,7 +23799,6 @@ name may be #NULL if it has never been set with g_source_set_name(). Gets the priority of a source. - the priority of the source @@ -25007,7 +23816,6 @@ g_source_set_ready_time(). Any time before the current monotonic time (including 0) is an indication that the source will fire immediately. - the monotonic ready time, -1 for "never" @@ -25027,7 +23835,6 @@ instead of having to repeatedly get the system monotonic time. The time here is the system monotonic time, if available, or some other reasonable alternative otherwise. See g_get_monotonic_time(). - the monotonic time in microseconds @@ -25106,7 +23913,6 @@ Calls to this function from a thread other than the one acquired by the source could be destroyed immediately after this function returns. However, once a source is destroyed it cannot be un-destroyed, so this function can be used for opportunistic checks from any thread. - %TRUE if the source has been destroyed @@ -25130,7 +23936,6 @@ This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. As the name suggests, this function is not available on Windows. - @@ -25160,7 +23965,6 @@ This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. As the name suggests, this function is not available on Windows. - the conditions reported on the fd @@ -25178,7 +23982,6 @@ As the name suggests, this function is not available on Windows. Increases the reference count on a source by one. - @source @@ -25195,7 +23998,6 @@ As the name suggests, this function is not available on Windows. This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. - @@ -25217,7 +24019,6 @@ this source. This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. - @@ -25243,7 +24044,6 @@ This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. As the name suggests, this function is not available on Windows. - @@ -25276,7 +24076,6 @@ to the type of source you are using, such as g_idle_add() or g_timeout_add(). It is safe to call this function multiple times on a source which has already been attached to a context. The changes will take effect for the next time the source is dispatched after this call returns. - @@ -25310,7 +24109,6 @@ than @callback_funcs->ref. It is safe to call this function multiple times on a source which has already been attached to a context. The changes will take effect for the next time the source is dispatched after this call returns. - @@ -25335,7 +24133,6 @@ the source is dispatched after this call returns. %TRUE, then while the source is being dispatched then this source will be processed normally. Otherwise, all processing of this source is blocked until the dispatch function returns. - @@ -25367,7 +24164,6 @@ The finalize function can not be used for this purpose as at that point @source is already partially freed and not valid anymore. This should only ever be called from #GSource implementations. - @@ -25385,7 +24181,6 @@ This should only ever be called from #GSource implementations. Sets the source functions (can be used to override default implementations) of an unattached source. - @@ -25417,7 +24212,6 @@ Use caution if changing the name while another thread may be accessing it with g_source_get_name(); that function does not copy the value, and changing the value will free it while the other thread may be attempting to use it. - @@ -25441,7 +24235,6 @@ dispatched. A child source always has the same priority as its parent. It is not permitted to change the priority of a source once it has been added as a child of another source. - @@ -25479,7 +24272,6 @@ destroyed with g_source_destroy(). This API is only intended to be used by implementations of #GSource. Do not call this API on a #GSource that you did not create. - @@ -25499,7 +24291,6 @@ Do not call this API on a #GSource that you did not create. Decreases the reference count of a source by one. If the resulting reference count is zero the source and associated memory will be destroyed. - @@ -25530,7 +24321,6 @@ idle may already have run and been removed by the time this function is called on its (now invalid) source ID. This source ID may have been reissued, leading to the operation being performed against the wrong source. - For historical reasons, this function always returns %TRUE @@ -25546,7 +24336,6 @@ wrong source. Removes a source from the default main loop context given the source functions and user data. If multiple sources exist with the same source functions and user data, only one will be destroyed. - %TRUE if a source was found and removed. @@ -25566,7 +24355,6 @@ same source functions and user data, only one will be destroyed. Removes a source from the default main loop context given the user data for the callback. If multiple sources exist with the same user data, only one will be destroyed. - %TRUE if a source was found and removed. @@ -25595,7 +24383,6 @@ idle may already have run and been removed by the time this function is called on its (now invalid) source ID. This source ID may have been reissued, leading to the operation being performed against the wrong source. - @@ -25614,10 +24401,8 @@ wrong source. The `GSourceCallbackFuncs` struct contains functions for managing callback objects. - - @@ -25630,7 +24415,6 @@ functions for managing callback objects. - @@ -25643,7 +24427,6 @@ functions for managing callback objects. - @@ -25667,7 +24450,6 @@ functions for managing callback objects. Dispose function for @source. See g_source_set_dispose_function() for details. - @@ -25681,7 +24463,6 @@ details. This is just a placeholder for #GClosureMarshal, which cannot be used here for dependency reasons. - @@ -25693,7 +24474,6 @@ g_timeout_add_full(), g_idle_add(), and g_idle_add_full(). When calling g_source_set_callback(), you may need to cast a function of a different type to this type. Use G_SOURCE_FUNC() to avoid warnings about incompatible function types. - %FALSE if the source should be removed. #G_SOURCE_CONTINUE and #G_SOURCE_REMOVE are more memorable names for the return value. @@ -25728,10 +24508,8 @@ any events need to be processed. It sets the returned timeout to -1 to indicate that it doesn't mind how long the poll() call blocks. In the check function, it tests the results of the poll() call to see if the required condition has been met, and returns %TRUE if so. - - @@ -25747,7 +24525,6 @@ required condition has been met, and returns %TRUE if so. - @@ -25760,7 +24537,6 @@ required condition has been met, and returns %TRUE if so. - @@ -25779,7 +24555,6 @@ required condition has been met, and returns %TRUE if so. - @@ -25831,7 +24606,6 @@ If you need to set up the child environment differently from the parent, you should use g_get_environ(), g_environ_setenv(), and g_environ_unsetenv(), and then pass the complete environment list to the `g_spawn...` function. - @@ -25844,7 +24618,6 @@ list to the `g_spawn...` function. Error codes returned by spawning processes. - Fork failed due to lack of memory. @@ -25912,7 +24685,6 @@ list to the `g_spawn...` function. Flags passed to g_spawn_sync(), g_spawn_async() and g_spawn_async_with_pipes(). - no flags, default behaviour @@ -25962,11 +24734,9 @@ list to the `g_spawn...` function. system call, depending on the platform and/or compiler being used. See g_stat() for more information. - The GString struct contains the public fields of a GString. - points to the character data. It may move as text is added. The @str field is null-terminated and so @@ -25986,7 +24756,6 @@ See g_stat() for more information. Adds a string onto the end of a #GString, expanding it if necessary. - @string @@ -26005,7 +24774,6 @@ it if necessary. Adds a byte onto the end of a #GString, expanding it if necessary. - @string @@ -26031,7 +24799,6 @@ ensure that @val has at least @len addressable bytes. If @len is negative, @val must be nul-terminated and @len is considered to request the entire string length. This makes g_string_append_len() equivalent to g_string_append(). - @string @@ -26055,7 +24822,6 @@ makes g_string_append_len() equivalent to g_string_append(). Appends a formatted string onto the end of a #GString. This function is similar to g_string_printf() except that the text is appended to the #GString. - @@ -26077,7 +24843,6 @@ that the text is appended to the #GString. Converts a Unicode character into UTF-8, and appends it to the string. - @string @@ -26096,7 +24861,6 @@ to the string. Appends @unescaped to @string, escaping any characters that are reserved in URIs using URI-style escape sequences. - @string @@ -26126,7 +24890,6 @@ are reserved in URIs using URI-style escape sequences. This function is similar to g_string_append_printf() except that the arguments to the format string are passed as a va_list. - @@ -26147,7 +24910,6 @@ as a va_list. Converts all uppercase ASCII letters to lowercase ASCII letters. - passed-in @string pointer, with all the uppercase characters converted to lowercase in place, @@ -26163,7 +24925,6 @@ as a va_list. Converts all lowercase ASCII letters to uppercase ASCII letters. - passed-in @string pointer, with all the lowercase characters converted to uppercase in place, @@ -26182,7 +24943,6 @@ as a va_list. destroying any previous contents. It is rather like the standard strcpy() function, except that you do not have to worry about having enough space to copy the string. - @string @@ -26204,7 +24964,6 @@ have to worry about having enough space to copy the string. This function uses the locale-specific tolower() function, which is almost never the right thing. Use g_string_ascii_down() or g_utf8_strdown() instead. - the #GString @@ -26219,7 +24978,6 @@ have to worry about having enough space to copy the string. Compares two strings for equality, returning %TRUE if they are equal. For use with #GHashTable. - %TRUE if the strings are the same length and contain the same bytes @@ -26239,7 +24997,6 @@ For use with #GHashTable. Removes @len bytes from a #GString, starting at position @pos. The rest of the #GString is shifted down to fill the gap. - @string @@ -26265,7 +25022,6 @@ The rest of the #GString is shifted down to fill the gap. If @free_segment is %TRUE it also frees the character data. If it's %FALSE, the caller gains ownership of the buffer and must free it after use with g_free(). - the character data of @string (i.e. %NULL if @free_segment is %TRUE) @@ -26291,7 +25047,6 @@ Note that while #GString ensures that its buffer always has a trailing nul character (not reflected in its "len"), the returned #GBytes does not include this extra nul; i.e. it has length exactly equal to the "len" member. - A newly allocated #GBytes containing contents of @string; @string itself is freed @@ -26305,7 +25060,6 @@ equal to the "len" member. Creates a hash code for @str; for use with #GHashTable. - hash code for @str @@ -26320,7 +25074,6 @@ equal to the "len" member. Inserts a copy of a string into a #GString, expanding it if necessary. - @string @@ -26342,7 +25095,6 @@ expanding it if necessary. Inserts a byte into a #GString, expanding it if necessary. - @string @@ -26373,7 +25125,6 @@ If @len is negative, @val must be nul-terminated and @len is considered to request the entire string length. If @pos is -1, bytes are inserted at the end of the string. - @string @@ -26401,7 +25152,6 @@ If @pos is -1, bytes are inserted at the end of the string. Converts a Unicode character into UTF-8, and insert it into the string at the given position. - @string @@ -26424,7 +25174,6 @@ into the string at the given position. Overwrites part of a string, lengthening it if necessary. - @string @@ -26447,7 +25196,6 @@ into the string at the given position. Overwrites part of a string, lengthening it if necessary. This function will work with embedded nuls. - @string @@ -26474,7 +25222,6 @@ This function will work with embedded nuls. Adds a string on to the start of a #GString, expanding it if necessary. - @string @@ -26493,7 +25240,6 @@ expanding it if necessary. Adds a byte onto the start of a #GString, expanding it if necessary. - @string @@ -26519,7 +25265,6 @@ ensure that @val has at least @len addressable bytes. If @len is negative, @val must be nul-terminated and @len is considered to request the entire string length. This makes g_string_prepend_len() equivalent to g_string_prepend(). - @string @@ -26542,7 +25287,6 @@ makes g_string_prepend_len() equivalent to g_string_prepend(). Converts a Unicode character into UTF-8, and prepends it to the string. - @string @@ -26564,7 +25308,6 @@ This is similar to the standard sprintf() function, except that the #GString buffer automatically expands to contain the results. The previous contents of the #GString are destroyed. - @@ -26589,7 +25332,6 @@ the current length, the string will be truncated. If the length is greater than the current length, the contents of the newly added area are undefined. (However, as always, string->str[string->len] will be a nul byte.) - @string @@ -26607,7 +25349,6 @@ always, string->str[string->len] will be a nul byte.) Cuts off the end of the GString, leaving the first @len bytes. - @string @@ -26628,7 +25369,6 @@ always, string->str[string->len] will be a nul byte.) This function uses the locale-specific toupper() function, which is almost never the right thing. Use g_string_ascii_up() or g_utf8_strup() instead. - @string @@ -26644,7 +25384,6 @@ always, string->str[string->len] will be a nul byte.) Writes a formatted string into a #GString. This function is similar to g_string_printf() except that the arguments to the format string are passed as a va_list. - @@ -26667,12 +25406,10 @@ the arguments to the format string are passed as a va_list. An opaque data structure representing String Chunks. It should only be accessed by using the following functions. - Frees all strings contained within the #GStringChunk. After calling g_string_chunk_clear() it is not safe to access any of the strings which were contained within it. - @@ -26687,7 +25424,6 @@ access any of the strings which were contained within it. Frees all memory allocated by the #GStringChunk. After calling g_string_chunk_free() it is not safe to access any of the strings which were contained within it. - @@ -26710,7 +25446,6 @@ does not check for duplicates. Also strings added with g_string_chunk_insert() will not be searched by g_string_chunk_insert_const() when looking for duplicates. - a pointer to the copy of @string within the #GStringChunk @@ -26741,7 +25476,6 @@ should be done very carefully. Note that g_string_chunk_insert_const() will not return a pointer to a string added with g_string_chunk_insert(), even if they do match. - a pointer to the new or existing copy of @string within the #GStringChunk @@ -26768,7 +25502,6 @@ bytes. The characters in the returned string can be changed, if necessary, though you should not change anything after the end of the string. - a pointer to the copy of @string within the #GStringChunk @@ -26791,7 +25524,6 @@ though you should not change anything after the end of the string. Creates a new #GStringChunk. - a new #GStringChunk @@ -26830,38 +25562,31 @@ guaranteed to be stable API — always use a getter function to retrieve th The subdirectories may not be created by the test harness; as with normal calls to functions like g_get_user_cache_dir(), the caller must be prepared to create the directory if it doesn’t exist. - Evaluates to a time span of one day. - Evaluates to a time span of one hour. - Evaluates to a time span of one millisecond. - Evaluates to a time span of one minute. - Evaluates to a time span of one second. - Works like g_mutex_trylock(), but for a lock defined with #G_LOCK_DEFINE. - the name of the lock @@ -26870,10 +25595,8 @@ to create the directory if it doesn’t exist. An opaque structure representing a test case. - - @@ -26896,7 +25619,6 @@ to create the directory if it doesn’t exist. The type used for test case functions that take an extra pointer argument. - @@ -26924,7 +25646,6 @@ Note: as a general rule of automake, files that are generated only as part of the build-from-git process (but then are distributed with the tarball) always go in srcdir (even if doing a srcdir != builddir build from git) and are considered as distributed files. - a file that was included in the distribution tarball @@ -26943,7 +25664,6 @@ the test case. @fixture will be a pointer to the area of memory allocated by the test framework, of the size requested. If the requested size was zero then @fixture will be equal to @user_data. - @@ -26960,13 +25680,11 @@ zero then @fixture will be equal to @user_data. The type used for test case functions. - - @@ -26977,7 +25695,6 @@ zero then @fixture will be equal to @user_data. Internal function for gtester to free test log messages, no ABI guarantees provided. - @@ -26989,7 +25706,6 @@ zero then @fixture will be equal to @user_data. Internal function for gtester to retrieve test log messages, no ABI guarantees provided. - @@ -27001,7 +25717,6 @@ zero then @fixture will be equal to @user_data. Internal function for gtester to decode test log messages, no ABI guarantees provided. - @@ -27019,7 +25734,6 @@ zero then @fixture will be equal to @user_data. Internal function for gtester to decode test log messages, no ABI guarantees provided. - @@ -27027,7 +25741,6 @@ zero then @fixture will be equal to @user_data. Specifies the prototype of fatal log handler functions. - %TRUE if the program should abort, %FALSE otherwise @@ -27052,7 +25765,6 @@ zero then @fixture will be equal to @user_data. - @@ -27070,7 +25782,6 @@ zero then @fixture will be equal to @user_data. Internal function for gtester to free test log messages, no ABI guarantees provided. - @@ -27082,7 +25793,6 @@ zero then @fixture will be equal to @user_data. - @@ -27109,7 +25819,6 @@ zero then @fixture will be equal to @user_data. - @@ -27124,7 +25833,6 @@ zero then @fixture will be equal to @user_data. Note that in contrast with g_test_trap_fork(), the default is to not show stdout and stderr. - If this flag is given, the child process will inherit the parent's stdin. Otherwise, the child's @@ -27145,10 +25853,8 @@ not show stdout and stderr. An opaque structure representing a test suite. - Adds @test_case to @suite. - @@ -27165,7 +25871,6 @@ not show stdout and stderr. Adds @nestedsuite to @suite. - @@ -27187,7 +25892,6 @@ These flags determine what traps to set. #GTestTrapFlags is used only with g_test_trap_fork(), which is deprecated. g_test_trap_subprocess() uses #GTestSubprocessFlags. - Redirect stdout of the test child to `/dev/null` so it cannot be observed on the console during test @@ -27220,7 +25924,6 @@ explicitly. The structure is opaque -- none of its fields may be directly accessed. - This function creates a new thread. The new thread starts by invoking @func with the argument data. The thread will run until @func returns @@ -27249,7 +25952,6 @@ This behaviour changed in GLib 2.64: before threads on Windows were not inheriting the thread priority but were spawned with the default priority. Starting with GLib 2.64 the behaviour is now consistent between Windows and POSIX and all threads inherit their parent thread's priority. - the new #GThread @@ -27275,7 +25977,6 @@ it allows for the possibility of failure. If a thread can not be created (due to resource limits), @error is set and %NULL is returned. - the new #GThread, or %NULL if an error occurred @@ -27312,7 +26013,6 @@ g_thread_join() consumes the reference to the passed-in @thread. This will usually cause the #GThread struct and associated resources to be freed. Use g_thread_ref() to obtain an extra reference if you want to keep the GThread alive beyond the g_thread_join() call. - the return value of the thread @@ -27326,7 +26026,6 @@ want to keep the GThread alive beyond the g_thread_join() call. Increase the reference count on @thread. - a new reference to @thread @@ -27345,7 +26044,6 @@ resources associated with it. Note that each thread holds a reference to its #GThread while it is running, so it is safe to drop your own reference to it if you don't need it anymore. - @@ -27375,7 +26073,6 @@ You must only call g_thread_exit() from a thread that you created yourself with g_thread_new() or related APIs. You must not call this function from a thread created with another threading library or or from within a #GThreadPool. - @@ -27396,7 +26093,6 @@ were not created by GLib (i.e. those created by other threading APIs). This may be useful for thread identification purposes (i.e. comparisons) but you must not use GLib functions (such as g_thread_join()) on these threads. - the #GThread representing the current thread @@ -27407,7 +26103,6 @@ as g_thread_join()) on these threads. that other threads can run. This function is often used as a method to make busy wait less evil. - @@ -27415,7 +26110,6 @@ This function is often used as a method to make busy wait less evil. Possible errors of thread related functions. - a thread couldn't be created due to resource shortage. Try again later. @@ -27424,7 +26118,6 @@ This function is often used as a method to make busy wait less evil. Specifies the type of the @func functions passed to g_thread_new() or g_thread_try_new(). - the return value of the thread @@ -27440,7 +26133,6 @@ or g_thread_try_new(). The #GThreadPool struct represents a thread pool. It has three public read-only members, but the underlying struct is bigger, so you must not copy this struct. - the function to execute in the threads of this pool @@ -27468,7 +26160,6 @@ or only the currently running) are ready. Otherwise this function returns immediately. After calling this function @pool must not be used anymore. - @@ -27489,7 +26180,6 @@ After calling this function @pool must not be used anymore. Returns the maximal number of threads for @pool. - the maximal number of threads @@ -27503,7 +26193,6 @@ After calling this function @pool must not be used anymore. Returns the number of threads currently running in @pool. - the number of threads currently running @@ -27518,7 +26207,6 @@ After calling this function @pool must not be used anymore. Moves the item to the front of the queue of unprocessed items, so that it will be processed next. - %TRUE if the item was found and moved @@ -27549,7 +26237,6 @@ created. In that case @data is simply appended to the queue of work to do. Before version 2.32, this function did not return a success status. - %TRUE on success, %FALSE if an error occurred @@ -27586,7 +26273,6 @@ errors. An error can only occur when a new thread couldn't be created. Before version 2.32, this function did not return a success status. - %TRUE on success, %FALSE if an error occurred @@ -27613,7 +26299,6 @@ that threads are executed cannot be guaranteed 100%. Threads are scheduled by the operating system and are executed at random. It cannot be assumed that threads are executed in the order they are created. - @@ -27639,7 +26324,6 @@ created. Returns the number of tasks still unprocessed in @pool. - the number of unprocessed tasks @@ -27658,7 +26342,6 @@ being stopped. If this function returns 0, threads waiting in the thread pool for new work are not stopped. - the maximum @interval (milliseconds) to wait for new tasks in the thread pool before stopping the @@ -27668,7 +26351,6 @@ pool for new work are not stopped. Returns the maximal allowed number of unused threads. - the maximal number of unused threads @@ -27676,7 +26358,6 @@ pool for new work are not stopped. Returns the number of currently unused threads. - the number of currently unused threads @@ -27714,7 +26395,6 @@ errors. An error can only occur when @exclusive is set to %TRUE and not all @max_threads threads could be created. See #GThreadError for possible errors that may occur. Note, even in case of error a valid #GThreadPool is returned. - the new #GThreadPool @@ -27750,7 +26430,6 @@ except this is done on a per thread basis. By setting @interval to 0, idle threads will not be stopped. The default value is 15000 (15 seconds). - @@ -27768,7 +26447,6 @@ If @max_threads is -1, no limit is imposed on the number of unused threads. The default value is 2. - @@ -27783,7 +26461,6 @@ The default value is 2. Stops all currently unused threads. This does not change the maximal number of unused threads. This function can be used to regularly stop all unused threads e.g. from g_timeout_add(). - @@ -27798,7 +26475,6 @@ Second, if the time is in local time, specifies if it is local standard time or local daylight time. This is important for the case where the same local time occurs twice (during daylight savings time transitions, for example). - the time is in local standard time @@ -27820,7 +26496,6 @@ removed from a future version of GLib. A consequence of using `glong` for `tv_sec` is that on 32-bit systems `GTimeVal` is subject to the year 2038 problem. Use #GDateTime or #guint64 instead. - seconds @@ -27834,7 +26509,6 @@ problem. also be negative to decrease the value of @time_. #GTimeVal is not year-2038-safe. Use `guint64` for representing microseconds since the epoch, or use #GDateTime. - @@ -27886,7 +26560,6 @@ The return value of g_time_val_to_iso8601() has been nullable since GLib 2.54; before then, GLib would crash under the same conditions. #GTimeVal is not year-2038-safe. Use g_date_time_format_iso8601(dt) instead. - a newly allocated string containing an ISO 8601 date, or %NULL if @time_ was too large @@ -27919,7 +26592,6 @@ g_date_time_unref (dt); ]| #GTimeVal is not year-2038-safe. Use g_date_time_new_from_iso8601() instead. - %TRUE if the conversion was successful. @@ -27939,7 +26611,6 @@ g_date_time_unref (dt); #GTimeZone is an opaque structure whose members cannot be accessed directly. - Creates a #GTimeZone corresponding to @identifier. @@ -28005,7 +26676,6 @@ for the list of time zones on Windows. You should release the return value by calling g_time_zone_unref() when you are done with it. - the requested timezone @@ -28027,7 +26697,6 @@ the `TZ` environment variable (including the possibility of %NULL). You should release the return value by calling g_time_zone_unref() when you are done with it. - the local timezone @@ -28039,7 +26708,6 @@ in seconds. This is equivalent to calling g_time_zone_new() with a string in the form `[+|-]hh[:mm[:ss]]`. - a timezone at the given offset from UTC @@ -28059,7 +26727,6 @@ This is equivalent to calling g_time_zone_new() with a value like You should release the return value by calling g_time_zone_unref() when you are done with it. - the universal timezone @@ -28082,7 +26749,6 @@ non-existent times. If the non-existent local @time_ of 02:30 were requested on March 14th 2010 in Toronto then this function would adjust @time_ to be 03:00 and return the interval containing the adjusted time. - the interval containing @time_, never -1 @@ -28121,7 +26787,6 @@ It is still possible for this function to fail. In Toronto, for example, 02:00 on March 14th 2010 does not exist (due to the leap forward to begin daylight savings time). -1 is returned in that case. - the interval containing @time_, or -1 in case of failure @@ -28148,7 +26813,6 @@ case. For example, in Toronto this is currently "EST" during the winter months and "EDT" during the summer months when daylight savings time is in effect. - the time zone abbreviation, which belongs to @tz @@ -28173,7 +26837,6 @@ construction time will be returned. The identifier will be returned in the same format as provided at construction time: if provided as a time offset, that will be returned by this function. - identifier for this timezone @@ -28192,7 +26855,6 @@ of time in the time zone @tz. The offset is the number of seconds that you add to UTC time to arrive at local time for @tz (ie: negative numbers for time zones west of GMT, positive numbers for east). - the number of seconds that should be added to UTC to get the local time in @tz @@ -28212,7 +26874,6 @@ west of GMT, positive numbers for east). Determines if daylight savings time is in effect during a particular @interval of time in the time zone @tz. - %TRUE if daylight savings time is in effect @@ -28230,7 +26891,6 @@ west of GMT, positive numbers for east). Increases the reference count on @tz. - a new reference to @tz. @@ -28244,7 +26904,6 @@ west of GMT, positive numbers for east). Decreases the reference count on @tz. - @@ -28258,12 +26917,10 @@ west of GMT, positive numbers for east). Opaque datatype that records a start time. - Resumes a timer that has previously been stopped with g_timer_stop(). g_timer_stop() must be called before using this function. - @@ -28276,7 +26933,6 @@ function. Destroys a timer, freeing associated resources. - @@ -28294,7 +26950,6 @@ elapsed time between the time it was started and the time it was stopped. The return value is the number of seconds elapsed, including any fractional part. The @microseconds out parameter is essentially useless. - seconds elapsed as a floating point value, including any fractional part. @@ -28315,7 +26970,6 @@ essentially useless. Exposes whether the timer is currently active. - %TRUE if the timer is running, %FALSE otherwise @@ -28331,7 +26985,6 @@ essentially useless. This function is useless; it's fine to call g_timer_start() on an already-started timer to reset the start time, so g_timer_reset() serves no purpose. - @@ -28347,7 +27000,6 @@ serves no purpose. report the time since g_timer_start() was called. g_timer_new() automatically marks the start time, so no need to call g_timer_start() immediately after creating the timer. - @@ -28361,7 +27013,6 @@ g_timer_start() immediately after creating the timer. Marks an end time, so calls to g_timer_elapsed() will return the difference between this end time and the start time. - @@ -28375,7 +27026,6 @@ difference between this end time and the start time. Creates a new timer, and starts timing (i.e. g_timer_start() is implicitly called for you). - a new #GTimer. @@ -28385,7 +27035,6 @@ implicitly called for you). The possible types of token returned from each g_scanner_get_next_token() call. - the end of the file @@ -28458,7 +27107,6 @@ g_scanner_get_next_token() call. A union holding the value of the token. - token symbol value @@ -28511,7 +27159,6 @@ g_scanner_get_next_token() call. The type of functions which are used to translate user-visible strings, for <option>--help</option> output. - a translation of the string for the current locale. The returned string is owned by GLib and must not be freed. @@ -28533,7 +27180,6 @@ strings, for <option>--help</option> output. Each piece of memory that is pushed onto the stack is cast to a GTrashStack*. #GTrashStack is deprecated without replacement - pointer to the previous element of the stack, gets stored in the first `sizeof (gpointer)` @@ -28546,7 +27192,6 @@ is cast to a GTrashStack*. Note that execution of this function is of O(N) complexity where N denotes the number of items on the stack. #GTrashStack is deprecated without replacement - the height of the stack @@ -28562,7 +27207,6 @@ where N denotes the number of items on the stack. Returns the element at the top of a #GTrashStack which may be %NULL. #GTrashStack is deprecated without replacement - the element at the top of the stack @@ -28577,7 +27221,6 @@ which may be %NULL. Pops a piece of memory off a #GTrashStack. #GTrashStack is deprecated without replacement - the element at the top of the stack @@ -28592,7 +27235,6 @@ which may be %NULL. Pushes a piece of memory onto a #GTrashStack. #GTrashStack is deprecated without replacement - @@ -28611,7 +27253,6 @@ which may be %NULL. Specifies which nodes are visited during several of the tree functions, including g_node_traverse() and g_node_find(). - only leaf nodes should be visited. This name has been introduced in 2.6, for older version use @@ -28640,7 +27281,6 @@ functions, including g_node_traverse() and g_node_find(). passed the key and value of each node, together with the @user_data parameter passed to g_tree_traverse(). If the function returns %TRUE, the traversal is stopped. - %TRUE to stop the traversal @@ -28672,7 +27312,6 @@ illustrated here: ![](Sorted_binary_tree_postorder.svg) - Level order: F, B, G, A, D, I, C, E, H ![](Sorted_binary_tree_breadth-first_traversal.svg) - vists a node's left child first, then the node itself, then its right child. This is the one to use if you @@ -28698,7 +27337,6 @@ illustrated here: The GTree struct is an opaque data structure representing a [balanced binary tree][glib-Balanced-Binary-Trees]. It should be accessed only by using the following functions. - Removes all keys and values from the #GTree and decreases its reference count by one. If keys and/or values are dynamically @@ -28706,7 +27344,6 @@ allocated, you should either free them first or create the #GTree using g_tree_new_full(). In the latter case the destroy functions you supplied will be called on all keys and values before destroying the #GTree. - @@ -28726,7 +27363,6 @@ The tree may not be modified while iterating over it (you can't add/remove items). To remove all items matching a predicate, you need to add each item to a list in your #GTraverseFunc as you walk over the tree, then walk the list and remove each item. - @@ -28752,7 +27388,6 @@ the tree, then walk the list and remove each item. If the #GTree contains no nodes, the height is 0. If the #GTree contains only one root node the height is 1. If the root node has children the height is 2, etc. - the height of @tree @@ -28778,7 +27413,6 @@ so that the distance from the root to every leaf is as small as possible. The cost of maintaining a balanced tree while inserting new key/value result in a O(n log(n)) operation where most of the other operations are O(log(n)). - @@ -28801,7 +27435,6 @@ are O(log(n)). Gets the value corresponding to the given key. Since a #GTree is automatically balanced as key/value pairs are added, key lookup is O(log n) (where n is the number of key/value pairs in the tree). - the value corresponding to the key, or %NULL if the key was not found @@ -28823,7 +27456,6 @@ is O(log n) (where n is the number of key/value pairs in the tree). associated value. This is useful if you need to free the memory allocated for the original key, for example before calling g_tree_remove(). - %TRUE if the key was found in the #GTree @@ -28849,7 +27481,6 @@ g_tree_remove(). Gets the number of nodes in a #GTree. - the number of nodes in @tree @@ -28865,7 +27496,6 @@ g_tree_remove(). Increments the reference count of @tree by one. It is safe to call this function from any thread. - the passed in #GTree @@ -28888,7 +27518,6 @@ If the key does not exist in the #GTree, the function does nothing. The cost of maintaining a balanced tree while removing a key/value result in a O(n log(n)) operation where most of the other operations are O(log(n)). - %TRUE if the key was found (prior to 2.8, this function returned nothing) @@ -28915,7 +27544,6 @@ freed using that function. The tree is automatically 'balanced' as new key/value pairs are added, so that the distance from the root to every leaf is as small as possible. - @@ -28944,7 +27572,6 @@ the result of g_tree_search(). If @search_func returns -1, searching will proceed among the key/value pairs that have a smaller key; if @search_func returns 1, searching will proceed among the key/value pairs that have a larger key. - the value corresponding to the found key, or %NULL if the key was not found @@ -28970,7 +27597,6 @@ pairs that have a larger key. the key and value destroy functions. If the key does not exist in the #GTree, the function does nothing. - %TRUE if the key was found (prior to 2.8, this function returned nothing) @@ -28993,7 +27619,6 @@ If the key does not exist in the #GTree, the function does nothing. If you just want to visit all nodes in sorted order, use g_tree_foreach() instead. If you really need to visit nodes in a different order, consider using an [n-ary tree][glib-N-ary-Trees]. - @@ -29025,7 +27650,6 @@ be destroyed (if destroy functions were specified) and all memory allocated by @tree will be released. It is safe to call this function from any thread. - @@ -29038,7 +27662,6 @@ It is safe to call this function from any thread. Creates a new #GTree. - a newly allocated #GTree @@ -29058,7 +27681,6 @@ It is safe to call this function from any thread. Creates a new #GTree like g_tree_new() and allows to specify functions to free the memory allocated for the key and value that get called when removing the entry from the #GTree. - a newly allocated #GTree @@ -29089,7 +27711,6 @@ removing the entry from the #GTree. Creates a new #GTree with a comparison function that accepts user data. See g_tree_new() for more details. - a newly allocated #GTree @@ -29110,7 +27731,6 @@ See g_tree_new() for more details. This macro can be used to mark a function declaration as unavailable. It must be placed before the function declaration. Use of a function that has been annotated with this macros will produce a compiler warning. - the major version that introduced the symbol @@ -29121,7 +27741,6 @@ that has been annotated with this macros will produce a compiler warning. - @@ -29130,7 +27749,6 @@ that has been annotated with this macros will produce a compiler warning. - @@ -29139,7 +27757,6 @@ that has been annotated with this macros will produce a compiler warning. - @@ -29148,7 +27765,6 @@ that has been annotated with this macros will produce a compiler warning. - @@ -29161,7 +27777,6 @@ that has been annotated with this macros will produce a compiler warning. decomposition of a single Unicode character. This is as defined by Unicode 6.1. - @@ -29172,7 +27787,6 @@ a true value. The compiler may use this information for optimizations. if (G_UNLIKELY (random () == 1)) g_print ("a random one"); ]| - the expression @@ -29182,7 +27796,6 @@ if (G_UNLIKELY (random () == 1)) Works like g_mutex_unlock(), but for a lock defined with #G_LOCK_DEFINE. - the name of the lock @@ -29192,19 +27805,16 @@ if (G_UNLIKELY (random () == 1)) Generic delimiters characters as defined in [RFC 3986](https://tools.ietf.org/html/rfc3986). Includes `:/?#[]@`. - Subcomponent delimiter characters as defined in [RFC 3986](https://tools.ietf.org/html/rfc3986). Includes `!$&'()*+,;=`. - Number of microseconds in one second (1 million). This macro is provided for code readability. - @@ -29214,7 +27824,6 @@ Since new unicode versions may add new types here, applications should be ready to handle unknown values. They may be regarded as %G_UNICODE_BREAK_UNKNOWN. See [Unicode Line Breaking Algorithm](http://www.unicode.org/unicode/reports/tr14/). - Mandatory Break (BK) @@ -29354,7 +27963,6 @@ and is interchangeable with #PangoScript. Note that new types may be added in the future. Applications should be ready to handle unknown values. See [Unicode Standard Annex #24: Script names](http://www.unicode.org/reports/tr24/). - a value never returned from g_unichar_get_script() @@ -29835,7 +28443,6 @@ See [Unicode Standard Annex #24: Script names](http://www.unicode.org/reports/tr These are the possible character classifications from the Unicode specification. See [Unicode Character Database](http://www.unicode.org/reports/tr44/#General_Category_Values). - General category "Other, Control" (Cc) @@ -29930,7 +28537,6 @@ See [Unicode Character Database](http://www.unicode.org/reports/tr44/#General_Ca The type of functions to be called when a UNIX fd watch source triggers. - %FALSE if the source should be removed @@ -30058,7 +28664,6 @@ not have. For example, `http://example.com/` and to the HTTP specification, and `data:,foo` and `data:;base64,Zm9v` resolve to the same thing according to the `data:` URI specification. - Gets @uri's authentication parameters, which may contain `%`-encoding, depending on the flags with which @uri was created. @@ -30067,7 +28672,6 @@ be %NULL.) Depending on the URI scheme, g_uri_parse_params() may be useful for further parsing this information. - @uri's authentication parameters. @@ -30081,7 +28685,6 @@ further parsing this information. Gets @uri's flags set upon construction. - @uri's flags. @@ -30096,7 +28699,6 @@ further parsing this information. Gets @uri's fragment, which may contain `%`-encoding, depending on the flags with which @uri was created. - @uri's fragment. @@ -30118,7 +28720,6 @@ that address, without the brackets around it that are necessary in the string form of the URI. Note that in this case there may also be a scope ID attached to the address. Eg, `fe80::1234%``em1` (or `fe80::1234%``25em1` if the string is still encoded). - @uri's host. @@ -30134,7 +28735,6 @@ be a scope ID attached to the address. Eg, `fe80::1234%``em1` (or Gets @uri's password, which may contain `%`-encoding, depending on the flags with which @uri was created. (If @uri was not created with %G_URI_FLAGS_HAS_PASSWORD then this will be %NULL.) - @uri's password. @@ -30149,7 +28749,6 @@ with %G_URI_FLAGS_HAS_PASSWORD then this will be %NULL.) Gets @uri's path, which may contain `%`-encoding, depending on the flags with which @uri was created. - @uri's path. @@ -30163,7 +28762,6 @@ flags with which @uri was created. Gets @uri's port. - @uri's port, or `-1` if no port was specified. @@ -30181,7 +28779,6 @@ flags with which @uri was created. For queries consisting of a series of `name=value` parameters, #GUriParamsIter or g_uri_parse_params() may be useful. - @uri's query. @@ -30196,7 +28793,6 @@ For queries consisting of a series of `name=value` parameters, Gets @uri's scheme. Note that this will always be all-lowercase, regardless of the string or strings that @uri was created from. - @uri's scheme. @@ -30213,7 +28809,6 @@ regardless of the string or strings that @uri was created from. `%`-encoding, depending on the flags with which @uri was created. If @uri was not created with %G_URI_FLAGS_HAS_PASSWORD or %G_URI_FLAGS_HAS_AUTH_PARAMS, this is the same as g_uri_get_userinfo(). - @uri's user. @@ -30228,7 +28823,6 @@ If @uri was not created with %G_URI_FLAGS_HAS_PASSWORD or Gets @uri's userinfo, which may contain `%`-encoding, depending on the flags with which @uri was created. - @uri's userinfo. @@ -30245,7 +28839,6 @@ the flags with which @uri was created. [relative URI][relative-absolute-uris], resolves it relative to @base_uri. If the result is not a valid absolute URI, it will be discarded, and an error returned. - a new #GUri. @@ -30267,7 +28860,6 @@ returned. Increments the reference count of @uri by one. - @uri @@ -30292,7 +28884,6 @@ URI (according to RFC 3986). If @uri might contain sensitive details, such as authentication parameters, or private data in its query string, and the returned string is going to be logged, then consider using g_uri_to_string_partial() to redact parts. - a string representing @uri, which the caller must free. @@ -30308,7 +28899,6 @@ logged, then consider using g_uri_to_string_partial() to redact parts. Returns a string representing @uri, subject to the options in @flags. See g_uri_to_string() and #GUriHideFlags for more details. - a string representing @uri, which the caller must free. @@ -30330,7 +28920,6 @@ logged, then consider using g_uri_to_string_partial() to redact parts. When the reference count reaches zero, the resources allocated by @uri are freed - @@ -30346,7 +28935,6 @@ When the reference count reaches zero, the resources allocated by See also g_uri_build_with_user(), which allows specifying the components of the "userinfo" separately. - a new #GUri @@ -30395,7 +28983,6 @@ coherent with the passed values, in particular use `%`-encoded values with In contrast to g_uri_build(), this allows specifying the components of the ‘userinfo’ field separately. Note that @user must be non-%NULL if either @password or @auth_params is non-%NULL. - a new #GUri @@ -30460,7 +29047,6 @@ portions of a URI. Though technically incorrect, this will also allow escaping nul bytes as `%``00`. - an escaped version of @unescaped. The returned string should be freed when no longer needed. @@ -30493,7 +29079,6 @@ escaped. But if you specify characters in @reserved_chars_allowed they are not escaped. This is useful for the "reserved" characters in the URI specification, since those are allowed unescaped in some portions of a URI. - an escaped version of @unescaped. The returned string should be freed when no longer needed. @@ -30524,7 +29109,6 @@ If it’s not a valid URI, an error is returned explaining how it’s See g_uri_split(), and the definition of #GUriFlags, for more information on the effect of @flags. - %TRUE if @uri_string is a valid absolute URI, %FALSE on error. @@ -30555,7 +29139,6 @@ components of the ‘userinfo’ separately. %G_URI_FLAGS_HAS_PASSWORD and %G_URI_FLAGS_HAS_AUTH_PARAMS are ignored if set in @flags. - an absolute URI string @@ -30605,7 +29188,6 @@ of the ‘userinfo’ separately. It otherwise behaves the same. %G_URI_FLAGS_HAS_PASSWORD and %G_URI_FLAGS_HAS_AUTH_PARAMS are ignored if set in @flags. - an absolute URI string @@ -30659,7 +29241,6 @@ in @flags. Splits an URI list conforming to the text/uri-list mime type defined in RFC 2483 into individual URIs, discarding any comments. The URIs are not validated. - a newly allocated %NULL-terminated list of strings holding the individual URIs. The array should be freed @@ -30679,7 +29260,6 @@ discarding any comments. The URIs are not validated. Parses @uri_string according to @flags. If the result is not a valid [absolute URI][relative-absolute-uris], it will be discarded, and an error returned. - a new #GUri. @@ -30720,7 +29300,6 @@ the returned attributes. If @params cannot be parsed (for example, it contains two @separators characters in a row), then @error is set and %NULL is returned. - A hash table of attribute/value pairs, with both names and values fully-decoded; or %NULL @@ -30762,7 +29341,6 @@ as: URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] ]| Common schemes include `file`, `https`, `svn+ssh`, etc. - The ‘scheme’ component of the URI, or %NULL on error. The returned string should be freed when no longer needed. @@ -30786,7 +29364,6 @@ Common schemes include `file`, `https`, `svn+ssh`, etc. Unlike g_uri_parse_scheme(), the returned scheme is normalized to all-lowercase and does not need to be freed. - The ‘scheme’ component of the URI, or %NULL on error. The returned string is normalized to all-lowercase, and @@ -30808,7 +29385,6 @@ discarded, and an error returned. (If @base_uri_string is %NULL, this just returns @uri_ref, or %NULL if @uri_ref is invalid or not absolute.) - the resolved URI string. @@ -30845,7 +29421,6 @@ Note that the %G_URI_FLAGS_HAS_PASSWORD and %G_URI_FLAGS_HAS_AUTH_PARAMS @flags are ignored by g_uri_split(), since it always returns only the full userinfo; use g_uri_split_with_user() if you want it split up. - %TRUE if @uri_ref parsed successfully, %FALSE on error. @@ -30904,7 +29479,6 @@ See the documentation for g_uri_split() for more details; this is mostly a wrapper around that function with simpler arguments. However, it will return an error if @uri_string is a relative URI, or does not contain a hostname component. - %TRUE if @uri_string parsed successfully, %FALSE on error. @@ -30948,7 +29522,6 @@ information on the effect of @flags. Note that @password will only be parsed out if @flags contains %G_URI_FLAGS_HAS_PASSWORD, and @auth_params will only be parsed out if @flags contains %G_URI_FLAGS_HAS_AUTH_PARAMS. - %TRUE if @uri_ref parsed successfully, %FALSE on error. @@ -31021,7 +29594,6 @@ character in @escaped_string, then that is an error and %NULL will be returned. This is useful if you want to avoid for instance having a slash being expanded in an escaped path element, which might confuse pathname handling. - an unescaped version of @escaped_string or %NULL on error (if decoding failed, using %G_URI_ERROR_FAILED error code). The @@ -31056,7 +29628,6 @@ escaped path element, which might confuse pathname handling. Note: `NUL` byte is not accepted in the output, in contrast to g_uri_unescape_bytes(). - an unescaped version of @escaped_string or %NULL on error. The returned string should be freed when no longer needed. As a @@ -31089,7 +29660,6 @@ character appears as an escaped character in @escaped_string, then that is an error and %NULL will be returned. This is useful if you want to avoid for instance having a slash being expanded in an escaped path element, which might confuse pathname handling. - an unescaped version of @escaped_string. The returned string should be freed when no longer needed. @@ -31110,7 +29680,6 @@ should be freed when no longer needed. Error codes returned by #GUri methods. - Generic error if no more specific error is available. See the error message for details. @@ -31150,7 +29719,6 @@ When parsing a URI, if you need to choose different flags based on the type of URI, you can use g_uri_peek_scheme() on the URI string to check the scheme first, and use that to decide what flags to parse it with. - No flags set. @@ -31200,7 +29768,6 @@ parse it with. g_uri_to_string_partial(). Note that %G_URI_HIDE_PASSWORD and %G_URI_HIDE_AUTH_PARAMS will only work if the #GUri was parsed with the corresponding flags. - No flags set. @@ -31223,7 +29790,6 @@ the corresponding flags. Flags modifying the way parameters are handled by g_uri_parse_params() and #GUriParamsIter. - No flags set. @@ -31248,7 +29814,6 @@ iterate over the attribute/value pairs of a URI query string. #GUriParamsIter structures are typically allocated on the stack and then initialized with g_uri_params_iter_init(). See the documentation for g_uri_params_iter_init() for a usage example. - @@ -31297,7 +29862,6 @@ while (g_uri_params_iter_next (&iter, &unowned_attr, &unowned_value, if (error) // handle parsing error ]| - @@ -31339,7 +29903,6 @@ attribute/value pair. Note that the same @attribute may be returned multiple times, since URIs allow repeated attributes. - %FALSE if the end of the parameters has been reached or an error was encountered. %TRUE otherwise. @@ -31371,7 +29934,6 @@ to retrieve the full path associated to the logical id. The #GUserDirectory enumeration can be extended at later date. Not every platform has a directory for every logical id in this enumeration. - the user's Desktop directory @@ -31416,7 +29978,6 @@ make sure that #GVariantBuilder is valid. |[ g_auto(GVariantBuilder) builder = G_VARIANT_BUILDER_INIT (G_VARIANT_TYPE_BYTESTRING); ]| - a const GVariantType* @@ -31444,7 +30005,6 @@ initialized with G_VARIANT_DICT_INIT(). g_autoptr(GVariant) variant = get_asv_variant (); g_auto(GVariantDict) dict = G_VARIANT_DICT_INIT (variant); ]| - a GVariant* @@ -31461,7 +30021,6 @@ type string. If in doubt, use g_variant_type_string_is_valid() to check if the string is valid. Since 2.24 - a well-formed #GVariantType type string @@ -31474,7 +30033,6 @@ Since 2.24 In order to use this function, you must include string.h yourself, because this macro may use memmove() and GLib does not include string.h for you. - the va_list variable to place a copy of @ap2 in @@ -31485,7 +30043,6 @@ string.h for you. - @@ -31501,7 +30058,6 @@ If the compiler is configured to warn about the use of deprecated functions, then using functions that were deprecated in version %GLIB_VERSION_MIN_REQUIRED or earlier will cause warnings (but using functions deprecated in later releases will not). - @@ -31747,7 +30303,6 @@ bytes. If we were to have other dictionaries of the same type, we would use more memory for the serialised data and buffer management for those dictionaries, but the type information would be shared. - Creates a new #GVariant instance. @@ -31777,7 +30332,6 @@ new_variant = g_variant_new ("(t^as)", (guint64) some_flags, some_strings); ]| - a new floating #GVariant instance @@ -31809,7 +30363,6 @@ same as @child_type, if given. If the @children are floating references (see g_variant_ref_sink()), the new instance takes ownership of them as if via g_variant_ref_sink(). - a floating reference to a new #GVariant array @@ -31834,7 +30387,6 @@ new instance takes ownership of them as if via g_variant_ref_sink(). Creates a new boolean #GVariant instance -- either %TRUE or %FALSE. - a floating reference to a new boolean #GVariant instance @@ -31848,7 +30400,6 @@ new instance takes ownership of them as if via g_variant_ref_sink(). Creates a new byte #GVariant instance. - a floating reference to a new byte #GVariant instance @@ -31867,7 +30418,6 @@ string need not be valid UTF-8. The nul terminator character at the end of the string is stored in the array. - a floating reference to a new bytestring #GVariant instance @@ -31887,7 +30437,6 @@ the array. strings. If @length is -1 then @strv is %NULL-terminated. - a new floating #GVariant instance @@ -31911,7 +30460,6 @@ non-%NULL. @key must be a value of a basic type (ie: not a container). If the @key or @value are floating references (see g_variant_ref_sink()), the new instance takes ownership of them as if via g_variant_ref_sink(). - a floating reference to a new dictionary entry #GVariant @@ -31929,7 +30477,6 @@ the new instance takes ownership of them as if via g_variant_ref_sink(). Creates a new double #GVariant instance. - a floating reference to a new double #GVariant instance @@ -31955,7 +30502,6 @@ of a double-check that the form of the serialised data matches the caller's expectation. @n_elements must be the length of the @elements array. - a floating reference to a new array #GVariant instance @@ -31989,7 +30535,6 @@ A reference is taken on @bytes. The data in @bytes must be aligned appropriately for the @type being loaded. Otherwise this function will internally create a copy of the memory (since GLib 2.60) or (in older versions) fail and exit the process. - a new #GVariant with a floating reference @@ -32039,7 +30584,6 @@ Note: @data must be backed by memory that is aligned appropriately for the @type being loaded. Otherwise this function will internally create a copy of the memory (since GLib 2.60) or (in older versions) fail and exit the process. - a new floating #GVariant of type @type @@ -32079,7 +30623,6 @@ process. By convention, handles are indexes into an array of file descriptors that are sent alongside a D-Bus message. If you're not interacting with D-Bus, you probably don't need them. - a floating reference to a new handle #GVariant instance @@ -32093,7 +30636,6 @@ with D-Bus, you probably don't need them. Creates a new int16 #GVariant instance. - a floating reference to a new int16 #GVariant instance @@ -32107,7 +30649,6 @@ with D-Bus, you probably don't need them. Creates a new int32 #GVariant instance. - a floating reference to a new int32 #GVariant instance @@ -32121,7 +30662,6 @@ with D-Bus, you probably don't need them. Creates a new int64 #GVariant instance. - a floating reference to a new int64 #GVariant instance @@ -32144,7 +30684,6 @@ of @child. If @child is a floating reference (see g_variant_ref_sink()), the new instance takes ownership of @child. - a floating reference to a new #GVariant maybe instance @@ -32164,7 +30703,6 @@ instance takes ownership of @child. Creates a D-Bus object path #GVariant with the contents of @string. @string must be a valid D-Bus object path. Use g_variant_is_object_path() if you're not sure. - a floating reference to a new object path #GVariant instance @@ -32184,7 +30722,6 @@ Each string must be a valid #GVariant object path; see g_variant_is_object_path(). If @length is -1 then @strv is %NULL-terminated. - a new floating #GVariant instance @@ -32235,7 +30772,6 @@ You may not use this function to return, unmodified, a single #GVariant pointer from the argument list. ie: @format may not solely be anything along the lines of "%*", "%?", "\%r", or anything starting with "%@". - a new floating #GVariant instance @@ -32273,7 +30809,6 @@ returning control to the user that originally provided the pointer. At this point, the caller will have their own full reference to the result. This can also be done by adding the result to a container, or by passing it to another g_variant_new() call. - a new, usually floating, #GVariant @@ -32295,7 +30830,6 @@ or by passing it to another g_variant_new() call. This is similar to calling g_strdup_printf() and then g_variant_new_string() but it saves a temporary variable and an unnecessary copy. - a floating reference to a new string #GVariant instance @@ -32316,7 +30850,6 @@ unnecessary copy. Creates a D-Bus type signature #GVariant with the contents of @string. @string must be a valid D-Bus type signature. Use g_variant_is_signature() if you're not sure. - a floating reference to a new signature #GVariant instance @@ -32334,7 +30867,6 @@ g_variant_is_signature() if you're not sure. @string must be valid UTF-8, and must not be %NULL. To encode potentially-%NULL strings, use g_variant_new() with `ms` as the [format string][gvariant-format-strings-maybe-types]. - a floating reference to a new string #GVariant instance @@ -32351,7 +30883,6 @@ potentially-%NULL strings, use g_variant_new() with `ms` as the strings. If @length is -1 then @strv is %NULL-terminated. - a new floating #GVariant instance @@ -32381,7 +30912,6 @@ when it is no longer required. You must not modify or access @string in any other way after passing it to this function. It is even possible that @string is immediately freed. - a floating reference to a new string #GVariant instance @@ -32403,7 +30933,6 @@ If @n_children is 0 then the unit tuple is constructed. If the @children are floating references (see g_variant_ref_sink()), the new instance takes ownership of them as if via g_variant_ref_sink(). - a floating reference to a new #GVariant tuple @@ -32423,7 +30952,6 @@ new instance takes ownership of them as if via g_variant_ref_sink(). Creates a new uint16 #GVariant instance. - a floating reference to a new uint16 #GVariant instance @@ -32437,7 +30965,6 @@ new instance takes ownership of them as if via g_variant_ref_sink(). Creates a new uint32 #GVariant instance. - a floating reference to a new uint32 #GVariant instance @@ -32451,7 +30978,6 @@ new instance takes ownership of them as if via g_variant_ref_sink(). Creates a new uint64 #GVariant instance. - a floating reference to a new uint64 #GVariant instance @@ -32500,7 +31026,6 @@ returning control to the user that originally provided the pointer. At this point, the caller will have their own full reference to the result. This can also be done by adding the result to a container, or by passing it to another g_variant_new() call. - a new, usually floating, #GVariant @@ -32527,7 +31052,6 @@ variant containing the original value. If @child is a floating reference (see g_variant_ref_sink()), the new instance takes ownership of @child. - a floating reference to a new variant #GVariant instance @@ -32551,7 +31075,6 @@ contain multi-byte numeric data. That include strings, booleans, bytes and containers containing only these things (recursively). The returned value is always in normal form and is marked as trusted. - the byteswapped form of @value @@ -32578,7 +31101,6 @@ check fails then a g_critical() is printed and %FALSE is returned. This function is meant to be used by functions that wish to provide varargs accessors to #GVariant values of uncertain values (eg: g_variant_lookup() or g_menu_model_get_item_attribute()). - %TRUE if @format_string is safe to use @@ -32600,7 +31122,6 @@ g_variant_lookup() or g_menu_model_get_item_attribute()). Classifies @value according to its top-level type. - the #GVariantClass of @value @@ -32632,7 +31153,6 @@ the handling of incomparable values (ie: NaN) is undefined. If you only require an equality comparison, g_variant_equal() is more general. - negative value if a < b; zero if a = b; @@ -32655,7 +31175,6 @@ general. returning a constant string, the string is duplicated. The return value must be freed using g_free(). - a newly allocated string @@ -32686,7 +31205,6 @@ stored there. In any case, the resulting array will be For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. - an array of strings @@ -32715,7 +31233,6 @@ is stored there. In any case, the resulting array will be For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. - an array of strings @@ -32740,7 +31257,6 @@ a constant string, the string is duplicated. The string will always be UTF-8 encoded. The return value must be freed using g_free(). - a newly allocated string, UTF-8 encoded @@ -32767,7 +31283,6 @@ is stored there. In any case, the resulting array will be For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. - an array of strings @@ -32790,7 +31305,6 @@ For an empty array, @length will be set to 0 and a pointer to a The types of @one and @two are #gconstpointer only to allow use of this function with #GHashTable. They must each be a #GVariant. - %TRUE if @one and @two are equal @@ -32823,7 +31337,6 @@ extended in the future. the values and also determines if the values are copied or borrowed, see the section on [GVariant format strings][gvariant-format-strings-pointers]. - @@ -32847,7 +31360,6 @@ see the section on It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_BOOLEAN. - %TRUE or %FALSE @@ -32864,7 +31376,6 @@ other than %G_VARIANT_TYPE_BOOLEAN. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_BYTE. - a #guint8 @@ -32895,7 +31406,6 @@ It is an error to call this function with a @value that is not an array of bytes. The return value remains valid as long as @value exists. - the constant string @@ -32921,7 +31431,6 @@ stored there. In any case, the resulting array will be For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. - an array of constant strings @@ -32949,7 +31458,6 @@ g_variant_get(). the values and also determines if the values are copied or borrowed, see the section on [GVariant format strings][gvariant-format-strings-pointers]. - @@ -32996,7 +31504,6 @@ instead of further nested children. #GVariant is guaranteed to handle nesting up to at least 64 levels. This function is O(1). - the child at the specified index @@ -33038,7 +31545,6 @@ implicitly (for instance "the file always contains a %G_VARIANT_TYPE_VARIANT and it is always in little-endian order") or explicitly (by storing the type and/or endianness in addition to the serialised data). - the serialised form of @value, or %NULL @@ -33055,7 +31561,6 @@ serialised data). The semantics of this function are exactly the same as g_variant_get_data(), except that the returned #GBytes holds a reference to the variant data. - A new #GBytes representing the variant data @@ -33072,7 +31577,6 @@ a reference to the variant data. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_DOUBLE. - a #gdouble @@ -33111,7 +31615,6 @@ expectation. @n_elements, which must be non-%NULL, is set equal to the number of items in the array. - a pointer to the fixed array @@ -33143,7 +31646,6 @@ than %G_VARIANT_TYPE_HANDLE. By convention, handles are indexes into an array of file descriptors that are sent alongside a D-Bus message. If you're not interacting with D-Bus, you probably don't need them. - a #gint32 @@ -33160,7 +31662,6 @@ with D-Bus, you probably don't need them. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_INT16. - a #gint16 @@ -33177,7 +31678,6 @@ other than %G_VARIANT_TYPE_INT16. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_INT32. - a #gint32 @@ -33194,7 +31694,6 @@ other than %G_VARIANT_TYPE_INT32. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_INT64. - a #gint64 @@ -33209,7 +31708,6 @@ other than %G_VARIANT_TYPE_INT64. Given a maybe-typed #GVariant instance, extract its value. If the value is Nothing, then this function returns %NULL. - the contents of @value, or %NULL @@ -33245,7 +31743,6 @@ the newly created #GVariant will be returned with a single non-floating reference. Typically, g_variant_take_ref() should be called on the return value from this function to guarantee ownership of a single non-floating reference to it. - a trusted #GVariant @@ -33268,7 +31765,6 @@ is stored there. In any case, the resulting array will be For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. - an array of constant strings @@ -33298,7 +31794,6 @@ already been calculated (ie: this function has been called before) then this function is O(1). Otherwise, the size is calculated, an operation which is approximately O(n) in the number of values involved. - the serialised size of @value @@ -33329,7 +31824,6 @@ It is an error to call this function with a @value of any type other than those three. The return value remains valid as long as @value exists. - the constant string, UTF-8 encoded @@ -33357,7 +31851,6 @@ is stored there. In any case, the resulting array will be For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. - an array of constant strings @@ -33380,7 +31873,6 @@ For an empty array, @length will be set to 0 and a pointer to a The return value is valid for the lifetime of @value and must not be freed. - a #GVariantType @@ -33396,7 +31888,6 @@ be freed. Returns the type string of @value. Unlike the result of calling g_variant_type_peek_string(), this string is nul-terminated. This string belongs to #GVariant and must not be freed. - the type string for the type of @value @@ -33413,7 +31904,6 @@ string belongs to #GVariant and must not be freed. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_UINT16. - a #guint16 @@ -33430,7 +31920,6 @@ other than %G_VARIANT_TYPE_UINT16. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_UINT32. - a #guint32 @@ -33447,7 +31936,6 @@ other than %G_VARIANT_TYPE_UINT32. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_UINT64. - a #guint64 @@ -33484,7 +31972,6 @@ varargs call by the user. the values and also determines if the values are copied or borrowed, see the section on [GVariant format strings][gvariant-format-strings-pointers]. - @@ -33511,7 +31998,6 @@ see the section on Unboxes @value. The result is the #GVariant instance that was contained in @value. - the item contained in the variant @@ -33533,7 +32019,6 @@ function as a basis for building protocols or file formats. The type of @value is #gconstpointer only to allow use of this function with #GHashTable. @value must be a #GVariant. - a hash value corresponding to @value @@ -33547,7 +32032,6 @@ function with #GHashTable. @value must be a #GVariant. Checks if @value is a container. - %TRUE if @value is a container @@ -33569,7 +32053,6 @@ or g_variant_take_ref(). See g_variant_ref_sink() for more information about floating reference counts. - whether @value is floating @@ -33595,7 +32078,6 @@ this function will immediately return %TRUE. There may be implementation specific restrictions on deeply nested values. GVariant is guaranteed to handle nesting up to at least 64 levels. - %TRUE if @value is in normal form @@ -33609,7 +32091,6 @@ GVariant is guaranteed to handle nesting up to at least 64 levels. Checks if a value has a type matching the provided type. - %TRUE if the type of @value matches @type @@ -33634,7 +32115,6 @@ need it. A reference is taken to @value and will be released only when g_variant_iter_free() is called. - a new heap-allocated #GVariantIter @@ -33661,7 +32141,6 @@ see the section on This function is currently implemented with a linear scan. If you plan to do many lookups then #GVariantDict may be more efficient. - %TRUE if a value was unpacked @@ -33707,7 +32186,6 @@ value will have this type. This function is currently implemented with a linear scan. If you plan to do many lookups then #GVariantDict may be more efficient. - the value of the dictionary key, or %NULL @@ -33739,7 +32217,6 @@ array. For tuples it is the number of tuple items (which depends only on the type). For dictionary entries, it is always 2 This function is O(1). - the number of children in the container @@ -33758,7 +32235,6 @@ The format is described [here][gvariant-text]. If @type_annotate is %TRUE, then type information is included in the output. - a newly-allocated string holding the result. @@ -33780,7 +32256,6 @@ the output. If @string is non-%NULL then it is appended to and returned. Else, a new empty #GString is allocated and it is returned. - a #GString containing the string @@ -33803,7 +32278,6 @@ a new empty #GString is allocated and it is returned. Increases the reference count of @value. - the same @value @@ -33838,7 +32312,6 @@ at that point and the caller will not need to unreference it. This makes certain common styles of programming much easier while still maintaining normal refcounting semantics in situations where values are not floating. - the same @value @@ -33863,7 +32336,6 @@ serialised variant successfully, its type and (if the destination machine might be different) its endianness must also be available. This function is approximately O(n) in the size of @data. - @@ -33911,7 +32383,6 @@ reference. If g_variant_take_ref() runs first then the result will be that the floating reference is converted to a hard reference and an additional reference on top of that one is added. It is best to avoid this situation. - the same @value @@ -33926,7 +32397,6 @@ avoid this situation. Decreases the reference count of @value. When its reference count drops to 0, the memory used by the variant is freed. - @@ -33946,7 +32416,6 @@ A valid object path starts with `/` followed by zero or more sequences of characters separated by `/` characters. Each sequence must contain only the characters `[A-Z][a-z][0-9]_`. No sequence (including the one following the final `/` character) may be empty. - %TRUE if @string is a D-Bus object path @@ -33965,7 +32434,6 @@ passing it to g_variant_new_signature(). D-Bus type signatures consist of zero or more definite #GVariantType strings in sequence. - %TRUE if @string is a D-Bus type signature @@ -34013,7 +32481,6 @@ produced by g_variant_print()". There may be implementation specific restrictions on deeply nested values, which would result in a %G_VARIANT_PARSE_ERROR_RECURSION error. #GVariant is guaranteed to handle nesting up to at least 64 levels. - a non-floating reference to a #GVariant, or %NULL @@ -34067,7 +32534,6 @@ The format of the message may change in a future version. If @source_str was not nul-terminated when you passed it to g_variant_parse() then you must add nul termination before using this function. - the printed message @@ -34104,11 +32570,8 @@ following functions. #GVariantBuilder is not threadsafe in any way. Do not attempt to access it from more than one thread. - - - @@ -34137,7 +32600,6 @@ any other call. In most cases it is easier to place a #GVariantBuilder directly on the stack of the calling function and initialise it with g_variant_builder_init(). - a #GVariantBuilder @@ -34180,7 +32642,6 @@ make_pointless_dictionary (void) return g_variant_builder_end (&builder); } ]| - @@ -34226,7 +32687,6 @@ make_pointless_dictionary (void) return g_variant_builder_end (&builder); } ]| - @@ -34256,7 +32716,6 @@ a variant, etc. If @value is a floating reference (see g_variant_ref_sink()), the @builder instance takes ownership of @value. - @@ -34286,7 +32745,6 @@ This function leaves the #GVariantBuilder structure set to all-zeros. It is valid to call this function on either an initialised #GVariantBuilder or one that is set to all-zeros but it is not valid to call this function on uninitialised memory. - @@ -34304,7 +32762,6 @@ the most recent call to g_variant_builder_open(). It is an error to call this function in any way that would create an inconsistent value to be constructed (ie: too few values added to the subcontainer). - @@ -34333,7 +32790,6 @@ required). It is also an error to call this function if the builder was created with an indefinite array or maybe type and no children have been added; in this case it is impossible to infer the type of the empty array. - a new, floating, #GVariant @@ -34375,7 +32831,6 @@ with this function. If you ever pass a reference to a should assume that the person receiving that reference may try to use reference counting; you should use g_variant_builder_new() instead of this function. - @@ -34427,7 +32882,6 @@ g_variant_builder_close (&builder); output = g_variant_builder_end (&builder); ]| - @@ -34447,7 +32901,6 @@ output = g_variant_builder_end (&builder); Don't call this on stack-allocated #GVariantBuilder instances or bad things will happen. - a new reference to @builder @@ -34467,7 +32920,6 @@ associated with the #GVariantBuilder. Don't call this on stack-allocated #GVariantBuilder instances or bad things will happen. - @@ -34481,7 +32933,6 @@ things will happen. The range of possible top-level types of #GVariant instances. - The #GVariant is a boolean. @@ -34629,11 +33080,8 @@ key is not found. Each returns the new dictionary as a floating return result; } ]| - - - @@ -34663,7 +33111,6 @@ In some cases it may be easier to place a #GVariantDict directly on the stack of the calling function and initialise it with g_variant_dict_init(). This is particularly useful when you are using #GVariantDict to construct a #GVariant. - a #GVariantDict @@ -34691,7 +33138,6 @@ It is valid to call this function on either an initialised #GVariantDict or one that was previously cleared by an earlier call to g_variant_dict_clear() but it is not valid to call this function on uninitialised memory. - @@ -34704,7 +33150,6 @@ on uninitialised memory. Checks if @key exists in @dict. - %TRUE if @key is in @dict @@ -34728,7 +33173,6 @@ It is not permissible to use @dict in any way after this call except for reference counting operations (in the case of a heap-allocated #GVariantDict) or by reinitialising it with g_variant_dict_init() (in the case of stack-allocated). - a new, floating, #GVariant @@ -34757,7 +33201,6 @@ pass a reference to a #GVariantDict outside of the control of your own code then you should assume that the person receiving that reference may try to use reference counting; you should use g_variant_dict_new() instead of this function. - @@ -34777,7 +33220,6 @@ g_variant_dict_new() instead of this function. This call is a convenience wrapper that is exactly equivalent to calling g_variant_new() followed by g_variant_dict_insert_value(). - @@ -34804,7 +33246,6 @@ calling g_variant_new() followed by g_variant_dict_insert_value(). Inserts (or replaces) a key in a #GVariantDict. @value is consumed if it is floating. - @@ -34834,7 +33275,6 @@ value and returns %TRUE. @format_string determines the C types that are used for unpacking the values and also determines if the values are copied or borrowed, see the section on [GVariant format strings][gvariant-format-strings-pointers]. - %TRUE if a value was unpacked @@ -34870,7 +33310,6 @@ returned. If the key is found and the value has the correct type, it is returned. If @expected_type was specified then any non-%NULL return value will have this type. - the value of the dictionary key, or %NULL @@ -34895,7 +33334,6 @@ value will have this type. Don't call this on stack-allocated #GVariantDict instances or bad things will happen. - a new reference to @dict @@ -34909,7 +33347,6 @@ things will happen. Removes a key and its associated value from a #GVariantDict. - %TRUE if the key was found and removed @@ -34933,7 +33370,6 @@ associated with the #GVariantDict. Don't call this on stack-allocated #GVariantDict instances or bad things will happen. - @@ -34948,7 +33384,6 @@ things will happen. #GVariantIter is an opaque data structure and can only be accessed using the following functions. - @@ -34965,7 +33400,6 @@ need it. A reference is taken to the container that @iter is iterating over and will be related only when g_variant_iter_free() is called. - a new heap-allocated #GVariantIter @@ -34981,7 +33415,6 @@ and will be related only when g_variant_iter_free() is called. Frees a heap-allocated #GVariantIter. Only call this function on iterators that were returned by g_variant_iter_new() or g_variant_iter_copy(). - @@ -34999,7 +33432,6 @@ ignored. The iterator remains valid for as long as @value exists, and need not be freed in any way. - the number of items in @value @@ -35078,7 +33510,6 @@ the values and also determines if the values are copied or borrowed. See the section on [GVariant format strings][gvariant-format-strings-pointers]. - %TRUE if a value was unpacked, or %FALSE if there was no value @@ -35105,7 +33536,6 @@ iterating over. This is the total number of items -- not the number of items remaining. This function might be useful for preallocation of arrays. - the number of children in the container @@ -35159,7 +33589,6 @@ the values and also determines if the values are copied or borrowed. See the section on [GVariant format strings][gvariant-format-strings-pointers]. - %TRUE if a value was unpacked, or %FALSE if there as no value @@ -35207,7 +33636,6 @@ Here is an example for iterating with g_variant_iter_next_value(): } } ]| - a #GVariant, or %NULL @@ -35222,7 +33650,6 @@ Here is an example for iterating with g_variant_iter_next_value(): Error codes returned by parsing text-format GVariants. - generic error (unused) @@ -35429,7 +33856,6 @@ the value is any type at all. This is, by definition, a dictionary, so this type string corresponds to %G_VARIANT_TYPE_DICTIONARY. Note that, due to the restriction that the key of a dictionary entry must be a basic type, "{**}" is not a valid type string. - Creates a new #GVariantType corresponding to the type string given by @type_string. It is appropriate to call g_variant_type_free() on @@ -35437,7 +33863,6 @@ the return value. It is a programmer error to call this function with an invalid type string. Use g_variant_type_string_is_valid() if you are unsure. - a new #GVariantType @@ -35454,7 +33879,6 @@ string. Use g_variant_type_string_is_valid() if you are unsure. type @type. It is appropriate to call g_variant_type_free() on the return value. - a new array #GVariantType @@ -35473,7 +33897,6 @@ Since 2.24 of type @key and a value of type @value. It is appropriate to call g_variant_type_free() on the return value. - a new dictionary entry #GVariantType @@ -35496,7 +33919,6 @@ Since 2.24 type @type or Nothing. It is appropriate to call g_variant_type_free() on the return value. - a new maybe #GVariantType @@ -35517,7 +33939,6 @@ Since 2.24 @items is %NULL-terminated. It is appropriate to call g_variant_type_free() on the return value. - a new tuple #GVariantType @@ -35540,7 +33961,6 @@ Since 2.24 Makes a copy of a #GVariantType. It is appropriate to call g_variant_type_free() on the return value. @type may not be %NULL. - a new #GVariantType @@ -35558,7 +33978,6 @@ Since 2.24 Returns a newly-allocated copy of the type string corresponding to @type. The returned string is nul-terminated. It is appropriate to call g_free() on the return value. - the corresponding type string @@ -35576,7 +33995,6 @@ Since 2.24 Determines the element type of an array or maybe type. This function may only be used with array or maybe types. - the element type of @type @@ -35601,7 +34019,6 @@ subtypes, use g_variant_type_is_subtype_of(). The argument types of @type1 and @type2 are only #gconstpointer to allow use with #GHashTable without function pointer casting. For both arguments, a valid #GVariantType must be provided. - %TRUE if @type1 and @type2 are exactly equal @@ -35634,7 +34051,6 @@ the key. This call, together with g_variant_type_next() provides an iterator interface over tuple and dictionary entry types. - the first item type of @type, or %NULL @@ -35656,7 +34072,6 @@ type constructor functions. In the case that @type is %NULL, this function does nothing. Since 2.24 - @@ -35671,7 +34086,6 @@ Since 2.24 Returns the length of the type string corresponding to the given @type. This function must be used to determine the valid extent of the memory region returned by g_variant_type_peek_string(). - the length of the corresponding type string @@ -35691,7 +34105,6 @@ Since 2.24 The argument type of @type is only #gconstpointer to allow use with #GHashTable without function pointer casting. A valid #GVariantType must be provided. - the hash value @@ -35712,7 +34125,6 @@ type string for @type starts with an 'a'. This function returns %TRUE for any indefinite type for which every definite subtype is an array type -- %G_VARIANT_TYPE_ARRAY, for example. - %TRUE if @type is an array type @@ -35736,7 +34148,6 @@ Only a basic type may be used as the key of a dictionary entry. This function returns %FALSE for all indefinite types except %G_VARIANT_TYPE_BASIC. - %TRUE if @type is a basic type @@ -35759,7 +34170,6 @@ entry types plus the variant type. This function returns %TRUE for any indefinite type for which every definite subtype is a container -- %G_VARIANT_TYPE_ARRAY, for example. - %TRUE if @type is a container type @@ -35784,7 +34194,6 @@ this function on the result of g_variant_get_type() will always result in %TRUE being returned. Calling this function on an indefinite type like %G_VARIANT_TYPE_ARRAY, however, will result in %FALSE being returned. - %TRUE if @type is definite @@ -35805,7 +34214,6 @@ true if the type string for @type starts with a '{'. This function returns %TRUE for any indefinite type for which every definite subtype is a dictionary entry type -- %G_VARIANT_TYPE_DICT_ENTRY, for example. - %TRUE if @type is a dictionary entry type @@ -35826,7 +34234,6 @@ type string for @type starts with an 'm'. This function returns %TRUE for any indefinite type for which every definite subtype is a maybe type -- %G_VARIANT_TYPE_MAYBE, for example. - %TRUE if @type is a maybe type @@ -35846,7 +34253,6 @@ Since 2.24 This function returns %TRUE if @type is a subtype of @supertype. All types are considered to be subtypes of themselves. Aside from that, only indefinite types can have subtypes. - %TRUE if @type is a subtype of @supertype @@ -35872,7 +34278,6 @@ type string for @type starts with a '(' or if @type is This function returns %TRUE for any indefinite type for which every definite subtype is a tuple type -- %G_VARIANT_TYPE_TUPLE, for example. - %TRUE if @type is a tuple type @@ -35888,7 +34293,6 @@ Since 2.24 Determines if the given @type is the variant type. - %TRUE if @type is the variant type @@ -35908,7 +34312,6 @@ Since 2.24 This function may only be used with a dictionary entry type. Other than the additional restriction, this call is equivalent to g_variant_type_first(). - the key type of the dictionary entry @@ -35932,7 +34335,6 @@ but must not be used with the generic tuple type In the case of a dictionary entry type, this function will always return 2. - the number of items in @type @@ -35958,7 +34360,6 @@ returns the value type. If called on the value type of a dictionary entry then this call returns %NULL. For tuples, %NULL is returned when @type is the last item in a tuple. - the next #GVariantType after @type, or %NULL @@ -35978,7 +34379,6 @@ result is not nul-terminated; in order to determine its length you must call g_variant_type_get_string_length(). To get a nul-terminated string, see g_variant_type_dup_string(). - the corresponding type string (not nul-terminated) @@ -35996,7 +34396,6 @@ Since 2.24 Determines the value type of a dictionary entry type. This function may only be used with a dictionary entry type. - the value type of the dictionary entry @@ -36011,7 +34410,6 @@ Since 2.24 - @@ -36022,7 +34420,6 @@ Since 2.24 - @@ -36036,7 +34433,6 @@ Since 2.24 Checks if @type_string is a valid GVariant type string. This call is equivalent to calling g_variant_type_string_scan() and confirming that the following character is a nul terminator. - %TRUE if @type_string is exactly one valid type string @@ -36064,7 +34460,6 @@ string does not end before @limit then %FALSE is returned. For the simple case of checking if a string is a valid type string, see g_variant_type_string_is_valid(). - %TRUE if a valid type string was found @@ -36089,7 +34484,6 @@ see g_variant_type_string_is_valid(). Declares a type of function which takes no arguments and has no return value. It is used to specify the type function passed to g_atexit(). - @@ -36099,7 +34493,6 @@ function passed to g_atexit(). the actual DLL name that the code being compiled will be included in. On non-Windows platforms, expands to nothing. - empty or "static" @@ -36113,7 +34506,6 @@ On non-Windows platforms, expands to nothing. - @@ -36129,7 +34521,6 @@ Windows. Software that needs to handle file permissions on Windows more exactly should use the Win32 API. See your C library manual for more details about access(). - zero if the pathname refers to an existing file system object that has all the tested permissions, or -1 otherwise @@ -36173,7 +34564,6 @@ Thus it provides the same advantages and pitfalls as alloca(): Stack space allocated with alloca() in the same scope as a variable sized array will be freed together with the variable sized array upon exit of that scope, and not upon exit of the enclosing function scope. - number of bytes to allocate. @@ -36305,7 +34695,6 @@ size automatically if necessary. g_array_append_val() is a macro which uses a reference to the value parameter @v. This means that you cannot use it with literal values such as "27". You must use variables. - a #GArray @@ -36341,7 +34730,6 @@ This example reads from and writes to an array of integers: g_print ("Int at index 1 is %u; decrementing it\n", *my_int); *my_int = *my_int - 1; ]| - a #GArray @@ -36360,7 +34748,6 @@ This example reads from and writes to an array of integers: g_array_insert_val() is a macro which uses a reference to the value parameter @v. This means that you cannot use it with literal values such as "27". You must use variables. - a #GArray @@ -36384,7 +34771,6 @@ the new element. g_array_prepend_val() is a macro which uses a reference to the value parameter @v. This means that you cannot use it with literal values such as "27". You must use variables. - a #GArray @@ -36515,7 +34901,6 @@ An example using a #GPtrArray: Determines the numeric value of a character as a decimal digit. Differs from g_unichar_digit_value() because it takes a char, so there's no worry about sign extension if characters are signed. - If @c is a decimal digit (according to g_ascii_isdigit()), its numeric value. Otherwise, -1. @@ -36538,7 +34923,6 @@ the string back using g_ascii_strtod() gives the same machine-number guaranteed that the size of the resulting string will never be larger than @G_ASCII_DTOSTR_BUF_SIZE bytes, including the terminating nul character, which is always added. - The pointer to the buffer with the converted string. @@ -36568,7 +34952,6 @@ The returned buffer is guaranteed to be nul-terminated. If you just want to want to serialize the value into a string, use g_ascii_dtostr(). - The pointer to the buffer with the converted string. @@ -36602,7 +34985,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36618,7 +35000,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36634,7 +35015,6 @@ locale, returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36647,7 +35027,6 @@ before passing a possibly non-ASCII character in. Unlike the standard C library isdigit() function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36663,7 +35042,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36679,7 +35057,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to worry about casting to #guchar before passing a possibly non-ASCII character in. - any character @@ -36695,7 +35072,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36711,7 +35087,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36727,7 +35102,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36743,7 +35117,6 @@ returning %FALSE for all non-ASCII characters. Also, unlike the standard library function, this takes a char, not an int, so don't call it on %EOF, but no need to worry about casting to #guchar before passing a possibly non-ASCII character in. - any character @@ -36756,7 +35129,6 @@ to #guchar before passing a possibly non-ASCII character in. Unlike the standard C library isxdigit() function, this takes a char, not an int, so don't call it on %EOF, but no need to cast to #guchar before passing a possibly non-ASCII character in. - any character @@ -36779,7 +35151,6 @@ characters include all ASCII letters. If you compare two CP932 strings using this function, you will get false matches. Both @s1 and @s2 must be non-%NULL. - 0 if the strings match, a negative value if @s1 < @s2, or a positive value if @s1 > @s2. @@ -36798,7 +35169,6 @@ Both @s1 and @s2 must be non-%NULL. Converts all upper case ASCII letters to lower case ASCII letters. - a newly-allocated string, with all the upper case characters in @str converted to lower case, with semantics that @@ -36839,7 +35209,6 @@ bounds - %G_NUMBER_PARSER_ERROR_OUT_OF_BOUNDS. See g_ascii_strtoll() if you have more complex needs such as parsing a string which starts with a number, but then has other characters. - %TRUE if @str was a number, otherwise %FALSE. @@ -36890,7 +35259,6 @@ bounds - %G_NUMBER_PARSER_ERROR_OUT_OF_BOUNDS. See g_ascii_strtoull() if you have more complex needs such as parsing a string which starts with a number, but then has other characters. - %TRUE if @str was a number, otherwise %FALSE. @@ -36929,7 +35297,6 @@ characters as if they are not letters. The same warning as in g_ascii_strcasecmp() applies: Use this function only on strings known to be in encodings where bytes corresponding to ASCII letters always represent themselves. - 0 if the strings match, a negative value if @s1 < @s2, or a positive value if @s1 > @s2. @@ -36974,7 +35341,6 @@ zero is returned and %ERANGE is stored in %errno. This function resets %errno before calling strtod() so that you can reliably detect overflow and underflow. - the #gdouble value. @@ -37009,7 +35375,6 @@ If the base is outside the valid range, zero is returned, and `EINVAL` is stored in `errno`. If the string conversion fails, zero is returned, and @endptr returns @nptr (if @endptr is non-%NULL). - the #gint64 value or zero on error. @@ -37053,7 +35418,6 @@ If the base is outside the valid range, zero is returned, and `EINVAL` is stored in `errno`. If the string conversion fails, zero is returned, and @endptr returns @nptr (if @endptr is non-%NULL). - the #guint64 value or zero on error. @@ -37076,7 +35440,6 @@ If the string conversion fails, zero is returned, and @endptr returns Converts all lower case ASCII letters to upper case ASCII letters. - a newly allocated string, with all the lower case characters in @str converted to upper case, with semantics that @@ -37105,7 +35468,6 @@ letters in a particular character set. Also unlike the standard library function, this takes and returns a char, not an int, so don't call it on %EOF but no need to worry about casting to #guchar before passing a possibly non-ASCII character in. - the result of converting @c to lower case. If @c is not an ASCII upper case letter, @c is returned unchanged. @@ -37128,7 +35490,6 @@ letters in a particular character set. Also unlike the standard library function, this takes and returns a char, not an int, so don't call it on %EOF but no need to worry about casting to #guchar before passing a possibly non-ASCII character in. - the result of converting @c to upper case. If @c is not an ASCII lower case letter, @c is returned unchanged. @@ -37146,7 +35507,6 @@ before passing a possibly non-ASCII character in. digit. Differs from g_unichar_xdigit_value() because it takes a char, so there's no worry about sign extension if characters are signed. - If @c is a hex digit (according to g_ascii_isxdigit()), its numeric value. Otherwise, -1. @@ -37170,7 +35530,6 @@ not depend on any side effects from @expr. Similarly, it must not be used in unit tests, otherwise the unit tests will be ineffective if compiled with `G_DISABLE_ASSERT`. Use g_assert_true() and related macros in unit tests instead. - the expression to check @@ -37184,7 +35543,6 @@ The effect of `g_assert_cmpfloat (n1, op, n2)` is the same as `g_assert_true (n1 op n2)`. The advantage of this macro is that it can produce a message that includes the actual values of @n1 and @n2. - a floating point number @@ -37205,7 +35563,6 @@ The effect of `g_assert_cmpfloat_with_epsilon (n1, n2, epsilon)` is the same as `g_assert_true (abs (n1 - n2) < epsilon)`. The advantage of this macro is that it can produce a message that includes the actual values of @n1 and @n2. - a floating point number @@ -37224,7 +35581,6 @@ actual values of @n1 and @n2. This is a variant of g_assert_cmpuint() that displays the numbers in hexadecimal notation in the message. - an unsigned integer @@ -37245,7 +35601,6 @@ The effect of `g_assert_cmpint (n1, op, n2)` is the same as `g_assert_true (n1 op n2)`. The advantage of this macro is that it can produce a message that includes the actual values of @n1 and @n2. - an integer @@ -37274,7 +35629,6 @@ includes the actual values of @l1 and @l2. |[<!-- language="C" --> g_assert_cmpmem (buf->data, buf->len, expected, sizeof (expected)); ]| - pointer to a buffer @@ -37304,7 +35658,6 @@ includes the actual values of @s1 and @s2. |[<!-- language="C" --> g_assert_cmpstr (mystring, ==, "fubar"); ]| - a string (may be %NULL) @@ -37325,7 +35678,6 @@ The effect of `g_assert_cmpuint (n1, op, n2)` is the same as `g_assert_true (n1 op n2)`. The advantage of this macro is that it can produce a message that includes the actual values of @n1 and @n2. - an unsigned integer @@ -37348,7 +35700,6 @@ g_variant_equal(). The effect of `g_assert_cmpvariant (v1, v2)` is the same as `g_assert_true (g_variant_equal (v1, v2))`. The advantage of this macro is that it can produce a message that includes the actual values of @v1 and @v2. - pointer to a #GVariant @@ -37371,7 +35722,6 @@ error message and code. This can only be used to test for a specific error. If you want to test that @err is set, but don't care what it's set to, just use `g_assert_nonnull (err)`. - a #GError, possibly %NULL @@ -37396,7 +35746,6 @@ Note that unlike g_assert(), this macro is unaffected by whether conversely, g_assert() should not be used in tests. See g_test_set_nonfatal_assertions(). - the expression to check @@ -37414,7 +35763,6 @@ will contain the value of `errno` and its human-readable message from g_strerror(). This macro will clear the value of `errno` before executing @expr. - the expression to check @@ -37428,7 +35776,6 @@ The effect of `g_assert_no_error (err)` is the same as `g_assert_true (err == NULL)`. The advantage of this macro is that it can produce a message that includes the error message and code. - a #GError, possibly %NULL @@ -37447,7 +35794,6 @@ Note that unlike g_assert(), this macro is unaffected by whether conversely, g_assert() should not be used in tests. See g_test_set_nonfatal_assertions(). - the expression to check @@ -37466,7 +35812,6 @@ Note that unlike g_assert(), this macro is unaffected by whether conversely, g_assert() should not be used in tests. See g_test_set_nonfatal_assertions(). - the expression to check @@ -37485,7 +35830,6 @@ Note that unlike g_assert(), this macro is unaffected by whether conversely, g_assert() should not be used in tests. See g_test_set_nonfatal_assertions(). - the expression to check @@ -37493,7 +35837,6 @@ See g_test_set_nonfatal_assertions(). - @@ -37516,7 +35859,6 @@ See g_test_set_nonfatal_assertions(). - @@ -37539,7 +35881,6 @@ See g_test_set_nonfatal_assertions(). - @@ -37574,7 +35915,6 @@ See g_test_set_nonfatal_assertions(). - @@ -37606,7 +35946,6 @@ See g_test_set_nonfatal_assertions(). - @@ -37640,7 +35979,6 @@ See g_test_set_nonfatal_assertions(). Internal function used to print messages from the public g_assert() and g_assert_not_reached() macros. - @@ -37742,7 +36080,6 @@ As can be seen from the above, for portability it's best to avoid calling g_atexit() (or atexit()) except in the main executable of a program. It is best to avoid g_atexit(). - @@ -37763,7 +36100,6 @@ This call acts as a full compiler and hardware memory barrier. Before version 2.30, this function did not return a value (but g_atomic_int_exchange_and_add() did, and had the same meaning). - the value of @atomic before the add, signed @@ -37787,7 +36123,6 @@ This call acts as a full compiler and hardware memory barrier. Think of this operation as an atomic version of `{ tmp = *atomic; *atomic &= val; return tmp; }`. - the value of @atomic before the operation, unsigned @@ -37813,7 +36148,6 @@ Think of this operation as an atomic version of `{ if (*atomic == oldval) { *atomic = newval; return TRUE; } else return FALSE; }`. This call acts as a full compiler and hardware memory barrier. - %TRUE if the exchange took place @@ -37840,7 +36174,6 @@ Think of this operation as an atomic version of `{ *atomic -= 1; return (*atomic == 0); }`. This call acts as a full compiler and hardware memory barrier. - %TRUE if the resultant value is zero @@ -37857,7 +36190,6 @@ This call acts as a full compiler and hardware memory barrier. value of the integer (which it now does). It is retained only for compatibility reasons. Don't use this function in new code. Use g_atomic_int_add() instead. - the value of @atomic before the add, signed @@ -37878,7 +36210,6 @@ compatibility reasons. Don't use this function in new code. This call acts as a full compiler and hardware memory barrier (before the get). - the value of the integer @@ -37896,7 +36227,6 @@ memory barrier (before the get). Think of this operation as an atomic version of `{ *atomic += 1; }`. This call acts as a full compiler and hardware memory barrier. - @@ -37915,7 +36245,6 @@ Think of this operation as an atomic version of `{ tmp = *atomic; *atomic |= val; return tmp; }`. This call acts as a full compiler and hardware memory barrier. - the value of @atomic before the operation, unsigned @@ -37936,7 +36265,6 @@ This call acts as a full compiler and hardware memory barrier. This call acts as a full compiler and hardware memory barrier (after the set). - @@ -37959,7 +36287,6 @@ Think of this operation as an atomic version of `{ tmp = *atomic; *atomic ^= val; return tmp; }`. This call acts as a full compiler and hardware memory barrier. - the value of @atomic before the operation, unsigned @@ -38019,7 +36346,6 @@ Think of this operation as an atomic version of `{ tmp = *atomic; *atomic += val; return tmp; }`. This call acts as a full compiler and hardware memory barrier. - the value of @atomic before the add, signed @@ -38043,7 +36369,6 @@ Think of this operation as an atomic version of `{ tmp = *atomic; *atomic &= val; return tmp; }`. This call acts as a full compiler and hardware memory barrier. - the value of @atomic before the operation, unsigned @@ -38069,7 +36394,6 @@ Think of this operation as an atomic version of `{ if (*atomic == oldval) { *atomic = newval; return TRUE; } else return FALSE; }`. This call acts as a full compiler and hardware memory barrier. - %TRUE if the exchange took place @@ -38094,7 +36418,6 @@ This call acts as a full compiler and hardware memory barrier. This call acts as a full compiler and hardware memory barrier (before the get). - the value of the pointer @@ -38114,7 +36437,6 @@ Think of this operation as an atomic version of `{ tmp = *atomic; *atomic |= val; return tmp; }`. This call acts as a full compiler and hardware memory barrier. - the value of @atomic before the operation, unsigned @@ -38135,7 +36457,6 @@ This call acts as a full compiler and hardware memory barrier. This call acts as a full compiler and hardware memory barrier (after the set). - @@ -38158,7 +36479,6 @@ Think of this operation as an atomic version of `{ tmp = *atomic; *atomic ^= val; return tmp; }`. This call acts as a full compiler and hardware memory barrier. - the value of @atomic before the operation, unsigned @@ -38176,7 +36496,6 @@ This call acts as a full compiler and hardware memory barrier. Atomically acquires a reference on the data pointed by @mem_block. - a pointer to the data, with its reference count increased @@ -38198,7 +36517,6 @@ zero. The allocated data is guaranteed to be suitably aligned for any built-in type. - a pointer to the allocated memory @@ -38221,7 +36539,6 @@ zero. The allocated data is guaranteed to be suitably aligned for any built-in type. - a pointer to the allocated memory @@ -38237,7 +36554,6 @@ built-in type. Allocates a new block of data with atomic reference counting semantics, and copies @block_size bytes of @mem_block into it. - a pointer to the allocated memory @@ -38256,7 +36572,6 @@ into it. Retrieves the size of the reference counted data pointed by @mem_block. - the size of the data, in bytes @@ -38275,7 +36590,6 @@ data with the size of the given @type. This macro calls g_atomic_rc_box_alloc() with `sizeof (@type)` and casts the returned pointer to a pointer of the given @type, avoiding a type cast in the source code. - the type to allocate, typically a structure name @@ -38290,7 +36604,6 @@ to zero. This macro calls g_atomic_rc_box_alloc0() with `sizeof (@type)` and casts the returned pointer to a pointer of the given @type, avoiding a type cast in the source code. - the type to allocate, typically a structure name @@ -38302,7 +36615,6 @@ avoiding a type cast in the source code. If the reference was the last one, it will free the resources allocated for @mem_block. - @@ -38319,7 +36631,6 @@ resources allocated for @mem_block. If the reference was the last one, it will call @clear_func to clear the contents of @mem_block, and then will free the resources allocated for @mem_block. - @@ -38336,7 +36647,6 @@ resources allocated for @mem_block. Atomically compares the current value of @arc with @val. - %TRUE if the reference count is the same as the given value @@ -38355,7 +36665,6 @@ resources allocated for @mem_block. Atomically decreases the reference count. - %TRUE if the reference count reached 0, and %FALSE otherwise @@ -38369,7 +36678,6 @@ resources allocated for @mem_block. Atomically increases the reference count. - @@ -38382,7 +36690,6 @@ resources allocated for @mem_block. Initializes a reference count variable. - @@ -38415,7 +36722,6 @@ Support for Base64 encoding has been added in GLib 2.12. Decode a sequence of Base-64 encoded text into binary data. Note that the returned binary data is not necessarily zero-terminated, so it should not be used as a character string. - newly allocated buffer containing the binary data @@ -38439,7 +36745,6 @@ so it should not be used as a character string. Decode a sequence of Base-64 encoded text into binary data by overwriting the input data. - The binary data that @text responds. This pointer is the same as the input @text. @@ -38468,7 +36773,6 @@ The output buffer must be large enough to fit all the data that will be written to it. Since base64 encodes 3 bytes in 4 chars you need at least: (@len / 4) * 3 + 3 bytes (+ 3 may be needed in case of non-zero state). - The number of bytes of output that was written @@ -38503,7 +36807,6 @@ state). Encode a sequence of binary data into its Base-64 stringified representation. - a newly allocated, zero-terminated Base-64 encoded string representing @data. The returned string must @@ -38531,7 +36834,6 @@ be written to it. It will need up to 4 bytes, or up to 5 bytes if line-breaking is enabled. The @out array will not be automatically nul-terminated. - The number of bytes of output that was written @@ -38577,7 +36879,6 @@ the same line. This avoids problems with long lines in the email system. Note however that it breaks the lines with `LF` characters, not `CR LF` sequences, so the result cannot be passed directly to SMTP or certain other protocols. - The number of bytes of output that was written @@ -38621,7 +36922,6 @@ string. that g_path_get_basename() allocates new memory for the returned string, unlike this function which returns a pointer into the argument. - the name of the file without any leading directory components @@ -38648,7 +36948,6 @@ between 0 and 31 then the result is undefined. This function accesses @address atomically. All other accesses to @address must be atomic in order for this function to work reliably. - @@ -38668,7 +36967,6 @@ reliably. from (but not including) @nth_bit upwards. Bits are numbered from 0 (least significant) to sizeof(#gulong) * 8 - 1 (31 or 63, usually). To start searching from the 0th bit, set @nth_bit to -1. - the index of the first bit set which is higher than @nth_bit, or -1 if no higher bits are set @@ -38691,7 +36989,6 @@ from (but not including) @nth_bit downwards. Bits are numbered from 0 (least significant) to sizeof(#gulong) * 8 - 1 (31 or 63, usually). To start searching from the last bit, set @nth_bit to -1 or GLIB_SIZEOF_LONG * 8. - the index of the first bit set which is lower than @nth_bit, or -1 if no lower bits are set @@ -38711,7 +37008,6 @@ usually). To start searching from the last bit, set @nth_bit to Gets the number of bits used to hold @number, e.g. if @number is 4, 3 bits are needed. - the number of bits used to hold @number @@ -38736,7 +37032,6 @@ between 0 and 31 then the result is undefined. This function accesses @address atomically. All other accesses to @address must be atomic in order for this function to work reliably. - %TRUE if the lock was acquired @@ -38760,7 +37055,6 @@ woken up. This function accesses @address atomically. All other accesses to @address must be atomic in order for this function to work reliably. - @@ -38836,7 +37130,6 @@ parameters (reading from left to right) is used. No attempt is made to force the resulting filename to be an absolute path. If the first element is a relative path, the result will be a relative path. - a newly-allocated string that must be freed with g_free(). @@ -38856,7 +37149,6 @@ be a relative path. Behaves exactly like g_build_filename(), but takes the path elements as a va_list. This function is mainly meant for language bindings. - a newly-allocated string that must be freed with g_free(). @@ -38877,7 +37169,6 @@ as a va_list. This function is mainly meant for language bindings. Behaves exactly like g_build_filename(), but takes the path elements as a string array, instead of varargs. This function is mainly meant for language bindings. - a newly-allocated string that must be freed with g_free(). @@ -38920,7 +37211,6 @@ of that element. Other than for determination of the number of leading and trailing copies of the separator, elements consisting only of copies of the separator are ignored. - a newly-allocated string that must be freed with g_free(). @@ -38945,7 +37235,6 @@ of the separator are ignored. Behaves exactly like g_build_path(), but takes the path elements as a string array, instead of varargs. This function is mainly meant for language bindings. - a newly-allocated string that must be freed with g_free(). @@ -38970,7 +37259,6 @@ meant for language bindings. %TRUE it frees the actual byte data. If the reference count of @array is greater than one, the #GByteArray wrapper is preserved but the size of @array will be set to zero. - the element data if @free_segment is %FALSE, otherwise %NULL. The element data should be freed using g_free(). @@ -38998,7 +37286,6 @@ will be set to zero. This is identical to using g_bytes_new_take() and g_byte_array_free() together. - a new immutable #GBytes representing same byte data that was in the array @@ -39015,7 +37302,6 @@ together. Creates a new #GByteArray with a reference count of 1. - the new #GByteArray @@ -39026,7 +37312,6 @@ together. Create byte array containing the data. The data will be owned by the array and will be freed with g_free(), i.e. it could be allocated using g_strdup(). - a new #GByteArray @@ -39050,7 +37335,6 @@ and will be freed with g_free(), i.e. it could be allocated using g_strdup().Frees the data in the array and resets the size to zero, while the underlying array is preserved for use elsewhere and returned to the caller. - the element data, which should be freed using g_free(). @@ -39075,7 +37359,6 @@ to the caller. reference count drops to 0, all memory allocated by the array is released. This function is thread-safe and may be called from any thread. - @@ -39133,7 +37416,6 @@ This function never fails, and will canonicalize file paths even if they don't exist. No file system I/O is done. - a newly allocated string with the canonical file path @@ -39156,7 +37438,6 @@ to use the current working directory current directory of the process to @path. See your C library manual for more details about chdir(). - 0 on success, -1 if an error occurred. @@ -39184,7 +37465,6 @@ of the running library is newer than the version the running library must be binary compatible with the version @required_major.required_minor.@required_micro (same major version.) - %NULL if the GLib library is compatible with the given version, or a string describing the version mismatch. @@ -39241,7 +37521,6 @@ Support for checksums has been added in GLib 2.16 Gets the length in bytes of digests of type @checksum_type - the checksum length, or -1 if @checksum_type is not supported. @@ -39275,7 +37554,6 @@ This internally creates a main loop source using g_child_watch_source_new() and attaches it to the main loop context using g_source_attach(). You can do these steps manually if you need greater control. - the ID (greater than 0) of the event source. @@ -39322,7 +37600,6 @@ This internally creates a main loop source using g_child_watch_source_new() and attaches it to the main loop context using g_source_attach(). You can do these steps manually if you need greater control. - the ID (greater than 0) of the event source. @@ -39385,7 +37662,6 @@ stating that `ECHILD` was received by `waitpid`. Calling `waitpid` for specific processes other than @pid remains a valid thing to do. - the newly-created child watch source @@ -39401,7 +37677,6 @@ Windows a handle for a process (which doesn't have to be a child). If @err or *@err is %NULL, does nothing. Otherwise, calls g_error_free() on *@err and sets *@err to %NULL. - @@ -39417,7 +37692,6 @@ set to zero. A macro is also included that allows this function to be used without pointer casts. - @@ -39436,7 +37710,6 @@ pointer casts. Clears a pointer to a #GList, freeing it and, optionally, freeing its elements using @destroy. @list_ptr must be a valid pointer. If @list_ptr points to a null #GList, this does nothing. - @@ -39468,7 +37741,6 @@ or calling conventions, so you must ensure that your @destroy function is compatible with being called as `GDestroyNotify` using the standard calling convention for the platform that GLib was compiled for; otherwise the program will experience undefined behaviour. - @@ -39488,7 +37760,6 @@ will experience undefined behaviour. Clears a pointer to a #GSList, freeing it and, optionally, freeing its elements using @destroy. @slist_ptr must be a valid pointer. If @slist_ptr points to a null #GSList, this does nothing. - @@ -39513,7 +37784,6 @@ Besides using #GError, there is another major reason to prefer this function over the call provided by the system; on Unix, it will attempt to correctly handle %EINTR, which has platform-specific semantics. - %TRUE on success, %FALSE if there was an error. @@ -39531,7 +37801,6 @@ convenience wrapper for g_checksum_new(), g_checksum_get_string() and g_checksum_free(). The hexadecimal string returned will be in lower case. - the digest of the binary data as a string in hexadecimal. The returned string should be freed with g_free() when done using it. @@ -39554,7 +37823,6 @@ convenience wrapper for g_checksum_new(), g_checksum_get_string() and g_checksum_free(). The hexadecimal string returned will be in lower case. - the digest of the binary data as a string in hexadecimal. The returned string should be freed with g_free() when done using it. @@ -39581,7 +37849,6 @@ The hexadecimal string returned will be in lower case. Computes the checksum of a string. The hexadecimal string returned will be in lower case. - the checksum as a hexadecimal string. The returned string should be freed with g_free() when done using it. @@ -39608,7 +37875,6 @@ convenience wrapper for g_hmac_new(), g_hmac_get_string() and g_hmac_unref(). The hexadecimal string returned will be in lower case. - the HMAC of the binary data as a string in hexadecimal. The returned string should be freed with g_free() when done using it. @@ -39635,7 +37901,6 @@ convenience wrapper for g_hmac_new(), g_hmac_get_string() and g_hmac_unref(). The hexadecimal string returned will be in lower case. - the HMAC of the binary data as a string in hexadecimal. The returned string should be freed with g_free() when done using it. @@ -39672,7 +37937,6 @@ The hexadecimal string returned will be in lower case. Computes the HMAC for a string. The hexadecimal string returned will be in lower case. - the HMAC as a hexadecimal string. The returned string should be freed with g_free() @@ -39813,7 +38077,6 @@ could combine with the base character.) Using extensions such as "//TRANSLIT" may not work (or may not work well) on many platforms. Consider using g_str_to_ascii() instead. - If the conversion was successful, a newly allocated buffer @@ -39887,7 +38150,6 @@ g_convert_with_iconv() or g_convert_with_fallback(). (An example of this is the GNU C converter for CP1255 which does not emit a base character until it knows that the next character is not a mark that could combine with the base character.) - If the conversion was successful, a newly allocated buffer @@ -39963,7 +38225,6 @@ specification, which leaves this behaviour implementation defined. Note that this is the same error code as is returned for an invalid byte sequence in the input character set. To get defined behaviour for conversion of unrepresentable characters, use g_convert_with_fallback(). - If the conversion was successful, a newly allocated buffer @@ -40042,7 +38303,6 @@ To remove all data elements from a datalist, use g_datalist_clear(). Frees all the data elements of the datalist. The data elements' destroy functions are called if they have been set. - @@ -40064,7 +38324,6 @@ not be called. @func can make changes to @datalist, but the iteration will not reflect changes made during the g_datalist_foreach() call, other than skipping over elements that are removed. - @@ -40086,7 +38345,6 @@ than skipping over elements that are removed. Gets a data element, using its string identifier. This is slower than g_datalist_id_get_data() because it compares strings. - the data element, or %NULL if it is not found. @@ -40106,7 +38364,6 @@ g_datalist_id_get_data() because it compares strings. Gets flags values packed in together with the datalist. See g_datalist_set_flags(). - the flags of the datalist @@ -40132,7 +38389,6 @@ is not allowed to read or modify the datalist. This function can be useful to avoid races when multiple threads are using the same datalist and the same key. - the result of calling @dup_func on the value associated with @key_id in @datalist, or %NULL if not set. @@ -40160,7 +38416,6 @@ threads are using the same datalist and the same key. Retrieves the data element corresponding to @key_id. - the data element, or %NULL if it is not found. @@ -40179,7 +38434,6 @@ threads are using the same datalist and the same key. Removes an element, using its #GQuark identifier. - a datalist. @@ -40192,7 +38446,6 @@ threads are using the same datalist and the same key. Removes an element, without calling its destroy notification function. - the data previously stored at @key_id, or %NULL if none. @@ -40223,7 +38476,6 @@ the registered destroy notify for it (passed out in @old_destroy). Its up to the caller to free this as he wishes, which may or may not include using @old_destroy as sometimes replacement should not destroy the object in the normal way. - %TRUE if the existing value for @key_id was replaced by @newval, %FALSE otherwise. @@ -40260,7 +38512,6 @@ should not destroy the object in the normal way. Sets the data corresponding to the given #GQuark id. Any previous data with the same key is removed, and its destroy function is called. - a datalist. @@ -40279,7 +38530,6 @@ called. function to be called when the element is removed from the datalist. Any previous data with the same key is removed, and its destroy function is called. - @@ -40310,7 +38560,6 @@ function is called. Resets the datalist to %NULL. It does not free any memory or call any destroy functions. - @@ -40324,7 +38573,6 @@ any destroy functions. Removes an element using its string identifier. The data element's destroy function is called if it has been set. - a datalist. @@ -40336,7 +38584,6 @@ destroy function is called if it has been set. Removes an element, without calling its destroy notifier. - a datalist. @@ -40348,7 +38595,6 @@ destroy function is called if it has been set. Sets the data element corresponding to the given string identifier. - a datalist. @@ -40365,7 +38611,6 @@ destroy function is called if it has been set. Sets the data element corresponding to the given string identifier, and the function to be called when the data element is removed. - a datalist. @@ -40392,7 +38637,6 @@ a data list without using any additional space. It is not generally useful except in circumstances where space is very tight. (It is used in the base #GObject type, for example.) - @@ -40413,7 +38657,6 @@ example.) Turns off flag values for a data list. See g_datalist_unset_flags() - @@ -40435,7 +38678,6 @@ example.) Destroys the dataset, freeing all memory allocated, and calling any destroy functions set for data elements. - @@ -40455,7 +38697,6 @@ during invocation of this function, it should not be called. @func can make changes to the dataset, but the iteration will not reflect changes made during the g_dataset_foreach() call, other than skipping over elements that are removed. - @@ -40476,7 +38717,6 @@ than skipping over elements that are removed. Gets the data element corresponding to a string. - the location identifying the dataset. @@ -40488,7 +38728,6 @@ than skipping over elements that are removed. Gets the data element corresponding to a #GQuark. - the data element corresponding to the #GQuark, or %NULL if it is not found. @@ -40508,7 +38747,6 @@ than skipping over elements that are removed. Removes a data element from a dataset. The data element's destroy function is called if it has been set. - the location identifying the dataset. @@ -40521,7 +38759,6 @@ function is called if it has been set. Removes an element, without calling its destroy notification function. - the data previously stored at @key_id, or %NULL if none. @@ -40542,7 +38779,6 @@ function. Sets the data element associated with the given #GQuark id. Any previous data with the same key is removed, and its destroy function is called. - the location identifying the dataset. @@ -40560,7 +38796,6 @@ is called. the function to call when the data element is destroyed. Any previous data with the same key is removed, and its destroy function is called. - @@ -40589,7 +38824,6 @@ is called. Removes a data element corresponding to a string. Its destroy function is called if it has been set. - the location identifying the dataset. @@ -40601,7 +38835,6 @@ function is called if it has been set. Removes an element, without calling its destroy notifier. - the location identifying the dataset. @@ -40613,7 +38846,6 @@ function is called if it has been set. Sets the data corresponding to the given string identifier. - the location identifying the dataset. @@ -40629,7 +38861,6 @@ function is called if it has been set. Sets the data corresponding to the given string identifier, and the function to call when the data element is destroyed. - the location identifying the dataset. @@ -40724,7 +38955,6 @@ GLib also features #GDateTime which represents a precise time. Returns the number of days in a month, taking leap years into account. - number of days in @month during the @year @@ -40748,7 +38978,6 @@ plus 1 or 2 extra days depending on whether it's a leap year. This function is basically telling you how many Mondays are in the year, i.e. there are 53 Mondays if one of the extra days happens to be a Monday.) - number of Mondays in the year @@ -40768,7 +38997,6 @@ plus 1 or 2 extra days depending on whether it's a leap year. This function is basically telling you how many Sundays are in the year, i.e. there are 53 Sundays if one of the extra days happens to be a Sunday.) - the number of weeks in @year @@ -40787,7 +39015,6 @@ For the purposes of this function, leap year is every year divisible by 4 unless that year is divisible by 100. If it is divisible by 100 it would be a leap year only if that year is also divisible by 400. - %TRUE if the year is a leap year @@ -40813,7 +39040,6 @@ addition to those implemented by the platform's C library. For example, don't expect that using g_date_strftime() would make the \%F provided by the C99 strftime() work on Windows where the C library only complies to C89. - number of characters written to the buffer, or 0 the buffer was too small @@ -40840,7 +39066,6 @@ where the C library only complies to C89. A comparison function for #GDateTimes that is suitable as a #GCompareFunc. Both #GDateTimes must be non-%NULL. - -1, 0 or 1 if @dt1 is less than, equal to or greater than @dt2. @@ -40862,7 +39087,6 @@ as a #GCompareFunc. Both #GDateTimes must be non-%NULL. Equal here means that they represent the same moment after converting them to the same time zone. - %TRUE if @dt1 and @dt2 are equal @@ -40880,7 +39104,6 @@ them to the same time zone. Hashes @datetime into a #guint, suitable for use within #GHashTable. - a #guint containing the hash @@ -40895,7 +39118,6 @@ them to the same time zone. Returns %TRUE if the day of the month is valid (a day is valid if it's between 1 and 31 inclusive). - %TRUE if the day is valid @@ -40911,7 +39133,6 @@ between 1 and 31 inclusive). Returns %TRUE if the day-month-year triplet forms a valid, existing day in the range of days #GDate understands (Year 1 or later, no more than a few thousand years in the future). - %TRUE if the date is a valid one @@ -40934,7 +39155,6 @@ a few thousand years in the future). Returns %TRUE if the Julian day is valid. Anything greater than zero is basically a valid Julian, though there is a 32-bit limit. - %TRUE if the Julian day is valid @@ -40949,7 +39169,6 @@ is basically a valid Julian, though there is a 32-bit limit. Returns %TRUE if the month value is valid. The 12 #GDateMonth enumeration values are the only valid months. - %TRUE if the month is valid @@ -40964,7 +39183,6 @@ enumeration values are the only valid months. Returns %TRUE if the weekday is valid. The seven #GDateWeekday enumeration values are the only valid weekdays. - %TRUE if the weekday is valid @@ -40979,7 +39197,6 @@ values are the only valid weekdays. Returns %TRUE if the year is valid. Any year greater than 0 is valid, though there is a 16-bit limit to what #GDate will understand. - %TRUE if the year is valid @@ -41023,7 +39240,6 @@ savings time transitions are either 23 or 25 hours in length). category instead of always using `LC_MESSAGES`. See g_dgettext() for more information about how this functions differs from calling dcgettext() directly. - the translated string for the given locale category @@ -41077,7 +39293,6 @@ cases the application should call textdomain() after initializing GTK+. Applications should normally not use this function directly, but use the _() macro for translations. - The translated string @@ -41106,7 +39321,6 @@ basename, no directory components are allowed. If template is Note that in contrast to g_mkdtemp() (and mkdtemp()) @tmpl is not modified, and might thus be a read-only literal string. - The actual name used. This string should be freed with g_free() when not needed any longer and is @@ -41130,7 +39344,6 @@ keys in a #GHashTable. This equality function is also appropriate for keys that are integers stored in pointers, such as `GINT_TO_POINTER (n)`. - %TRUE if the two keys match. @@ -41154,7 +39367,6 @@ when using opaque pointers compared by pointer value as keys in a This hash function is also appropriate for keys that are integers stored in pointers, such as `GINT_TO_POINTER (n)`. - a hash value corresponding to the key. @@ -41173,7 +39385,6 @@ translations for the current locale. See g_dgettext() for details of how this differs from dngettext() proper. - The translated string @@ -41204,7 +39415,6 @@ proper. It can be passed to g_hash_table_new() as the @key_equal_func parameter, when using non-%NULL pointers to doubles as keys in a #GHashTable. - %TRUE if the two keys match. @@ -41225,7 +39435,6 @@ parameter, when using non-%NULL pointers to doubles as keys in a It can be passed to g_hash_table_new() as the @hash_func parameter, It can be passed to g_hash_table_new() as the @hash_func parameter, when using non-%NULL pointers to doubles as keys in a #GHashTable. - a hash value corresponding to the key. @@ -41251,7 +39460,6 @@ with dgettext() proper. Applications should normally not use this function directly, but use the C_() macro for translations with context. - The translated string @@ -41284,7 +39492,6 @@ with dgettext() proper. This function differs from C_() in that it is not a macro and thus you may use non-string-literals as context and msgid arguments. - The translated string @@ -41308,7 +39515,6 @@ thus you may use non-string-literals as context and msgid arguments. Returns the value of the environment variable @variable in the provided list @envp. - the value of the environment variable, or %NULL if the environment variable is not set in @envp. The returned @@ -41334,7 +39540,6 @@ provided list @envp. Sets the environment variable @variable in the provided list @envp to @value. - the updated environment list. Free it using g_strfreev(). @@ -41370,7 +39575,6 @@ provided list @envp. Removes the environment variable @variable from the provided environment @envp. - the updated environment list. Free it using g_strfreev(). @@ -41750,7 +39954,6 @@ assume that all #GFileError values will exist. Normally a #GFileError value goes into a #GError returned from a function that manipulates files. So you would use g_file_error_from_errno() when constructing a #GError. - #GFileError corresponding to the given @errno @@ -41778,7 +39981,6 @@ stored in @contents will be nul-terminated, so for text files you can pass %FALSE and sets @error. The error domain is #G_FILE_ERROR. Possible error codes are those in the #GFileError enumeration. In the error case, @contents is set to %NULL and @length is set to zero. - %TRUE on success, %FALSE if an error occurred @@ -41818,7 +40020,6 @@ Upon success, and if @name_used is non-%NULL, the actual name used is returned in @name_used. This string should be freed with g_free() when not needed any longer. The returned name is in the GLib file name encoding. - A file handle (as from open()) to the file opened for reading and writing. The file is opened in binary mode on platforms @@ -41843,7 +40044,6 @@ name encoding. Reads the contents of the symbolic link @filename like the POSIX readlink() function. The returned string is in the encoding used for filenames. Use g_filename_to_utf8() to convert it to UTF-8. - A newly-allocated string with the contents of the symbolic link, or %NULL if an error occurred. @@ -41861,7 +40061,6 @@ for filenames. Use g_filename_to_utf8() to convert it to UTF-8. wrapper around calling g_file_set_contents() with `flags` set to `G_FILE_SET_CONTENTS_CONSISTENT | G_FILE_SET_CONTENTS_ONLY_EXISTING` and `mode` set to `0666`. - %TRUE on success, %FALSE if an error occurred @@ -41939,7 +40138,6 @@ to 7 characters to @filename. If the file didn’t exist before and is created, it will be given the permissions from @mode. Otherwise, the permissions of the existing file may be changed to @mode depending on @flags, or they may remain unchanged. - %TRUE on success, %FALSE if an error occurred @@ -42012,7 +40210,6 @@ On Windows, there are no symlinks, so testing for %G_FILE_TEST_IS_EXECUTABLE will just check that the file exists and its name indicates that it is executable, checking for well-known extensions and those listed in the `PATHEXT` environment variable. - whether a test was %TRUE @@ -42046,7 +40243,6 @@ translation of well known locations can be done. This function is preferred over g_filename_display_name() if you know the whole path, as it allows translation. - a newly allocated string containing a rendition of the basename of the filename in valid UTF-8 @@ -42076,7 +40272,6 @@ encoding. If you know the whole pathname of the file you should use g_filename_display_basename(), since that allows location-based translation of filenames. - a newly allocated string containing a rendition of the filename in valid UTF-8 @@ -42093,7 +40288,6 @@ translation of filenames. Converts an escaped ASCII-encoded URI to a local filename in the encoding used for filenames. - a newly-allocated string holding the resulting filename, or %NULL on an error. @@ -42123,7 +40317,6 @@ argument is positive. A nul character found inside the string will result in error %G_CONVERT_ERROR_ILLEGAL_SEQUENCE. If the filename encoding is not UTF-8 and the conversion output contains a nul character, the error %G_CONVERT_ERROR_EMBEDDED_NUL is set and the function returns %NULL. - The converted string, or %NULL on an error. @@ -42160,7 +40353,6 @@ not UTF-8 and the conversion output contains a nul character, the error Converts an absolute filename to an escaped ASCII-encoded URI, with the path component following Section 3.3. of RFC 2396. - a newly-allocated string holding the resulting URI, or %NULL on an error. @@ -42192,7 +40384,6 @@ If the source encoding is not UTF-8 and the conversion output contains a nul character, the error %G_CONVERT_ERROR_EMBEDDED_NUL is set and the function returns %NULL. Use g_convert() to produce output that may contain embedded nul characters. - The converted string, or %NULL on an error. @@ -42277,7 +40468,6 @@ Windows 32-bit system directory, then in the Windows directory, and finally in the directories in the `PATH` environment variable. If the program is found, the return value contains the full name including the type suffix. - a newly-allocated string with the absolute path, or %NULL @@ -42304,7 +40494,6 @@ This string should be freed with g_free() when not needed any longer. See g_format_size_full() for more options about how the size might be formatted. - a newly-allocated formatted string containing a human readable file size @@ -42329,7 +40518,6 @@ The prefix units base is 1024 (i.e. 1 KB is 1024 bytes). This string should be freed with g_free() when not needed any longer. This function is broken due to its use of SI suffixes to denote IEC units. Use g_format_size() instead. - a newly-allocated formatted string containing a human readable file size @@ -42347,7 +40535,6 @@ This string should be freed with g_free() when not needed any longer. This function is similar to g_format_size() but allows for flags that modify the output. See #GFormatSizeFlags. - a newly-allocated formatted string containing a human readable file size @@ -42369,7 +40556,6 @@ that modify the output. See #GFormatSizeFlags. positional parameters, as specified in the Single Unix Specification. `glib/gprintf.h` must be explicitly included in order to use this function. - the number of bytes printed. @@ -42395,7 +40581,6 @@ positional parameters, as specified in the Single Unix Specification. If @mem is %NULL it simply returns, so there is no need to check @mem against %NULL before calling this function. - @@ -42414,7 +40599,6 @@ g_get_prgname(), which gets a non-localized name. If g_set_application_name() has not been called, returns the result of g_get_prgname() (which may be %NULL if g_set_prgname() has also not been called). - human-readable application name. May return %NULL @@ -42442,7 +40626,6 @@ case you can perhaps avoid calling g_convert(). The string returned in @charset is not allocated, and should not be freed. - %TRUE if the returned charset is UTF-8 @@ -42457,7 +40640,6 @@ freed. Gets the character set for the current locale. - a newly allocated string containing the name of the character set. This string must be freed with g_free(). @@ -42482,7 +40664,6 @@ case you can perhaps avoid calling g_convert(). The string returned in @charset is not allocated, and should not be freed. - %TRUE if the returned charset is UTF-8 @@ -42506,7 +40687,6 @@ Since GLib 2.40, this function will return the value of the "PWD" environment variable if it is set and it happens to be the same as the current directory. This can make a difference in the case that the current directory is the target of a symbolic link. - the current directory @@ -42518,7 +40698,6 @@ the current directory is the target of a symbolic link. You may find g_get_real_time() to be more convenient. #GTimeVal is not year-2038-safe. Use g_get_real_time() instead. - @@ -42540,7 +40719,6 @@ except portable. The return value is freshly allocated and it should be freed with g_strfreev() when it is no longer needed. - the list of environment variables @@ -42574,7 +40752,6 @@ The returned @charsets belong to GLib and must not be freed. Note that on Unix, regardless of the locale character set or `G_FILENAME_ENCODING` value, the actual file names present on a system might be in any random encoding or just gibberish. - %TRUE if the filename encoding is UTF-8. @@ -42610,7 +40787,6 @@ old behaviour (and if you don't wish to increase your GLib dependency to ensure that the new behaviour is in effect) then you should either directly check the `HOME` environment variable yourself or unset it before calling any functions in GLib. - the current user's home directory @@ -42631,7 +40807,6 @@ name can be determined, a default fixed string "localhost" is returned. The encoding of the returned string is UTF-8. - the host name of the machine. @@ -42649,7 +40824,6 @@ For example, if LANGUAGE=de:en_US, then the returned list is This function consults the environment variables `LANGUAGE`, `LC_ALL`, `LC_MESSAGES` and `LANG` to find the list of locales specified by the user. - a %NULL-terminated array of strings owned by GLib that must not be modified or freed. @@ -42669,7 +40843,6 @@ This function consults the environment variables `LANGUAGE`, `LC_ALL`, user. g_get_language_names() returns g_get_language_names_with_category("LC_MESSAGES"). - a %NULL-terminated array of strings owned by the thread g_get_language_names_with_category was called from. @@ -42701,7 +40874,6 @@ is `en_GB.UTF-8@euro`, `en_GB.UTF-8`, `en_GB@euro`, `en_GB`, `en.UTF-8@euro`, If you need the list of variants for the current locale, use g_get_language_names(). - a newly allocated array of newly allocated strings with the locale variants. Free with @@ -42728,7 +40900,6 @@ suspended. We try to use the clock that corresponds as closely as possible to the passage of time as measured by system calls such as poll() but it may not always be possible to do this. - the monotonic time, in microseconds @@ -42739,7 +40910,6 @@ may not always be possible to do this. schedule simultaneously for this process. This is intended to be used as a parameter to g_thread_pool_new() for CPU bound tasks and similar cases. - Number of schedulable threads, always greater than 0 @@ -42754,7 +40924,6 @@ like %G_OS_INFO_KEY_NAME or pass any UTF-8 string key name. For example, `/etc/os-release` provides a number of other less commonly used values that may be useful. No key is guaranteed to be provided, so the caller should always check if the result is %NULL. - The associated value for the requested key or %NULL if this information is not provided. @@ -42776,7 +40945,6 @@ g_application_run(). In case of GDK or GTK+ it is set in gdk_init(), which is called by gtk_init() and the #GtkApplication::startup handler. The program name is found by taking the last component of @argv[0]. - the name of the program, or %NULL if it has not been set yet. The returned string belongs @@ -42790,7 +40958,6 @@ entry in the `passwd` file. The encoding of the returned string is system-defined. (On Windows, it is, however, always UTF-8.) If the real user name cannot be determined, the string "Unknown" is returned. - the user's real name. @@ -42806,7 +40973,6 @@ that the return value is often more convenient than dealing with a You should only use this call if you are actually interested in the real wall-clock time. g_get_monotonic_time() is probably more useful for measuring intervals. - the number of microseconds since January 1, 1970 UTC. @@ -42830,7 +40996,6 @@ that is not user specific. For example, an application can store a spell-check dictionary, a database of clip art, or a log file in the CSIDL_COMMON_APPDATA folder. This information will not roam and is available to anyone using the computer. - a %NULL-terminated array of strings owned by GLib that must not be @@ -42872,7 +41037,6 @@ itself. Note that on Windows the returned list can vary depending on where this function is called. - a %NULL-terminated array of strings owned by GLib that must not be @@ -42897,7 +41061,6 @@ as a default. The encoding of the returned string is system-defined. On Windows, it is always UTF-8. The return value is never %NULL or the empty string. - the directory to use for temporary files. @@ -42917,7 +41080,6 @@ If `XDG_CACHE_HOME` is undefined, the directory that serves as a common repository for temporary Internet files is used instead. A typical path is `C:\Documents and Settings\username\Local Settings\Temporary Internet Files`. See the [documentation for `CSIDL_INTERNET_CACHE`](https://msdn.microsoft.com/en-us/library/windows/desktop/bb762494%28v=vs.85%29.aspx#csidl_internet_cache). - a string owned by GLib that must not be modified or freed. @@ -42939,7 +41101,6 @@ to roaming) application data is used instead. See the [documentation for `CSIDL_LOCAL_APPDATA`](https://msdn.microsoft.com/en-us/library/windows/desktop/bb762494%28v=vs.85%29.aspx#csidl_local_appdata). Note that in this case on Windows it will be the same as what g_get_user_data_dir() returns. - a string owned by GLib that must not be modified or freed. @@ -42961,7 +41122,6 @@ opposed to roaming) application data is used instead. See the [documentation for `CSIDL_LOCAL_APPDATA`](https://msdn.microsoft.com/en-us/library/windows/desktop/bb762494%28v=vs.85%29.aspx#csidl_local_appdata). Note that in this case on Windows it will be the same as what g_get_user_config_dir() returns. - a string owned by GLib that must not be modified or freed. @@ -42973,7 +41133,6 @@ as what g_get_user_config_dir() returns. string is system-defined. On UNIX, it might be the preferred file name encoding, or something else, and there is no guarantee that it is even consistent on a machine. On Windows, it is always UTF-8. - the user name of the current user. @@ -42990,7 +41149,6 @@ This is the directory specified in the `XDG_RUNTIME_DIR` environment variable. In the case that this variable is not set, we return the value of g_get_user_cache_dir(), after verifying that it exists. - a string owned by GLib that must not be modified or freed. @@ -43008,7 +41166,6 @@ not been set up. Depending on the platform, the user might be able to change the path of the special directory without requiring the session to restart; GLib will not reflect any change once the special directories are loaded. - the path to the specified special directory, or %NULL if the logical id was not found. The returned string is owned by @@ -43030,7 +41187,6 @@ be in some consistent character set and encoding. On Windows, they are in UTF-8. On Windows, in case the environment variable's value contains references to other environment variables, they are expanded. - the value of the environment variable, or %NULL if the environment variable is not found. The returned string @@ -43084,7 +41240,6 @@ the discussion in the section description. Starting from GLib 2.40, this function returns a boolean value to indicate whether the newly added value was already in the hash table or not. - %TRUE if the key did not exist yet @@ -43105,7 +41260,6 @@ or not. Checks if @key is in @hash_table. - %TRUE if @key is in @hash_table, %FALSE otherwise. @@ -43131,7 +41285,6 @@ you should either free them first or create the #GHashTable with destroy notifiers using g_hash_table_new_full(). In the latter case the destroy functions you supplied will be called on all keys and values during the destruction phase. - @@ -43148,7 +41301,6 @@ destruction phase. This function is deprecated and will be removed in the next major release of GLib. It does nothing. - a #GHashTable @@ -43168,7 +41320,6 @@ key is freed using that function. Starting from GLib 2.40, this function returns a boolean value to indicate whether the newly added value was already in the hash table or not. - %TRUE if the key did not exist yet @@ -43196,7 +41347,6 @@ or not. distinguish between a key that is not present and one which is present and has the value %NULL. If you need this distinction, use g_hash_table_lookup_extended(). - the associated value, or %NULL if the key is not found @@ -43224,7 +41374,6 @@ for example before calling g_hash_table_remove(). You can actually pass %NULL for @lookup_key to test whether the %NULL key exists, provided the hash and equal functions of @hash_table are %NULL-safe. - %TRUE if the key was found in the #GHashTable @@ -43259,7 +41408,6 @@ If the #GHashTable was created using g_hash_table_new_full(), the key and value are freed using the supplied destroy functions, otherwise you have to make sure that any dynamically allocated values are freed yourself. - %TRUE if the key was found and removed from the #GHashTable @@ -43285,7 +41433,6 @@ If the #GHashTable was created using g_hash_table_new_full(), the keys and values are freed using the supplied destroy functions, otherwise you have to make sure that any dynamically allocated values are freed yourself. - @@ -43311,7 +41458,6 @@ If you supplied a @key_destroy_func when creating the Starting from GLib 2.40, this function returns a boolean value to indicate whether the newly added value was already in the hash table or not. - %TRUE if the key did not exist yet @@ -43336,7 +41482,6 @@ or not. Returns the number of elements contained in the #GHashTable. - the number of key/value pairs in the #GHashTable. @@ -43354,7 +41499,6 @@ or not. Removes a key and its associated value from a #GHashTable without calling the key and value destroy functions. - %TRUE if the key was found and removed from the #GHashTable @@ -43376,7 +41520,6 @@ calling the key and value destroy functions. Removes all keys and their associated values from a #GHashTable without calling the key and value destroy functions. - @@ -43401,7 +41544,6 @@ the caller of this method; as with g_hash_table_steal(). You can pass %NULL for @lookup_key, provided the hash and equal functions of @hash_table are %NULL-safe. - %TRUE if the key was found in the #GHashTable @@ -43433,7 +41575,6 @@ of @hash_table are %NULL-safe. This function is deprecated and will be removed in the next major release of GLib. It does nothing. - a #GHashTable @@ -43445,7 +41586,6 @@ release of GLib. It does nothing. If the reference count drops to 0, all keys and values will be destroyed, and all memory allocated by the hash table is released. This function is MT-safe and may be called from any thread. - @@ -43528,7 +41668,6 @@ in GLib 2.42. Support for SHA-384 was added in GLib 2.52. Appends a #GHook onto the end of a #GHookList. - a #GHookList @@ -43540,7 +41679,6 @@ in GLib 2.42. Support for SHA-384 was added in GLib 2.52. Destroys a #GHook, given its ID. - %TRUE if the #GHook was found in the #GHookList and destroyed @@ -43559,7 +41697,6 @@ in GLib 2.42. Support for SHA-384 was added in GLib 2.52. Removes one #GHook from a #GHookList, marking it inactive and calling g_hook_unref() on it. - @@ -43577,7 +41714,6 @@ inactive and calling g_hook_unref() on it. Calls the #GHookList @finalize_hook function if it exists, and frees the memory allocated for the #GHook. - @@ -43594,7 +41730,6 @@ and frees the memory allocated for the #GHook. Inserts a #GHook into a #GHookList, before a given #GHook. - @@ -43615,7 +41750,6 @@ and frees the memory allocated for the #GHook. Prepends a #GHook on the start of a #GHookList. - @@ -43634,7 +41768,6 @@ and frees the memory allocated for the #GHook. Decrements the reference count of a #GHook. If the reference count falls to 0, the #GHook is removed from the #GHookList and g_hook_free() is called to free it. - @@ -43663,7 +41796,6 @@ before displaying it to the user. Note that a hostname might contain a mix of encoded and unencoded segments, and so it is possible for g_hostname_is_non_ascii() and g_hostname_is_ascii_encoded() to both return %TRUE for a name. - %TRUE if @hostname contains any ASCII-encoded segments. @@ -43681,7 +41813,6 @@ segments. (Eg, "192.168.0.1".) Since 2.66, IPv6 addresses with a zone-id are accepted (RFC6874). - %TRUE if @hostname is an IP address @@ -43701,7 +41832,6 @@ before using it in non-IDN-aware contexts. Note that a hostname might contain a mix of encoded and unencoded segments, and so it is possible for g_hostname_is_non_ascii() and g_hostname_is_ascii_encoded() to both return %TRUE for a name. - %TRUE if @hostname contains any non-ASCII characters @@ -43717,7 +41847,6 @@ g_hostname_is_ascii_encoded() to both return %TRUE for a name. Converts @hostname to its canonical ASCII form; an ASCII-only string containing no uppercase letters and not ending with a trailing dot. - an ASCII hostname, which must be freed, or %NULL if @hostname is in some way invalid. @@ -43738,7 +41867,6 @@ and not ending with a trailing dot. Of course if @hostname is not an internationalized hostname, then the canonical presentation form will be entirely ASCII. - a UTF-8 hostname, which must be freed, or %NULL if @hostname is in some way invalid. @@ -43753,7 +41881,6 @@ the canonical presentation form will be entirely ASCII. Converts a 32-bit integer value from host to network byte order. - a 32-bit integer value in host byte order @@ -43762,7 +41889,6 @@ the canonical presentation form will be entirely ASCII. Converts a 16-bit integer value from host to network byte order. - a 16-bit integer value in host byte order @@ -43827,7 +41953,6 @@ set, is implementation defined. This function may return success (with a positive number of non-reversible conversions as replacement characters were used), or it may return -1 and set an error such as %EILSEQ, in such a situation. - count of non-reversible conversions, or -1 on error @@ -43862,7 +41987,6 @@ a native implementation. GLib provides g_convert() and g_locale_to_utf8() which are likely more convenient than the raw iconv wrappers. - a "conversion descriptor", or (GIConv)-1 if opening the converter failed. @@ -43894,7 +42018,6 @@ and attaches it to the global #GMainContext using g_source_attach(), so the callback will be invoked in whichever thread is running that main context. You can do these steps manually if you need greater control or to use a custom main context. - the ID (greater than 0) of the event source. @@ -43923,7 +42046,6 @@ and attaches it to the global #GMainContext using g_source_attach(), so the callback will be invoked in whichever thread is running that main context. You can do these steps manually if you need greater control or to use a custom main context. - the ID (greater than 0) of the event source. @@ -43950,7 +42072,6 @@ use a custom main context. Removes the idle function with the given data. - %TRUE if an idle source was found and removed. @@ -43970,7 +42091,6 @@ and must be added to one with g_source_attach() before it will be executed. Note that the default priority for idle sources is %G_PRIORITY_DEFAULT_IDLE, as compared to other sources which have a default priority of %G_PRIORITY_DEFAULT. - the newly-created idle source @@ -43982,7 +42102,6 @@ have a default priority of %G_PRIORITY_DEFAULT. It can be passed to g_hash_table_new() as the @key_equal_func parameter, when using non-%NULL pointers to 64-bit integers as keys in a #GHashTable. - %TRUE if the two keys match. @@ -44004,7 +42123,6 @@ parameter, when using non-%NULL pointers to 64-bit integers as keys in a It can be passed to g_hash_table_new() as the @hash_func parameter, when using non-%NULL pointers to 64-bit integer values as keys in a #GHashTable. - a hash value corresponding to the key. @@ -44026,7 +42144,6 @@ parameter, when using non-%NULL pointers to integers as keys in a Note that this function acts on pointers to #gint, not on #gint directly: if your hash table's keys are of the form `GINT_TO_POINTER (n)`, use g_direct_equal() instead. - %TRUE if the two keys match. @@ -44050,7 +42167,6 @@ when using non-%NULL pointers to integer values as keys in a #GHashTable. Note that this function acts on pointers to #gint, not on #gint directly: if your hash table's keys are of the form `GINT_TO_POINTER (n)`, use g_direct_hash() instead. - a hash value corresponding to the key. @@ -44071,7 +42187,6 @@ therefore @string must not be freed or modified. This function must not be used before library constructors have finished running. In particular, this means it cannot be used to initialize global variables in C++. - a canonical representation for the string @@ -44091,7 +42206,6 @@ using strcmp(). This function must not be used before library constructors have finished running. In particular, this means it cannot be used to initialize global variables in C++. - a canonical representation for the string @@ -44106,7 +42220,6 @@ variables in C++. Adds the #GIOChannel into the default main loop context with the default priority. - the event source id @@ -44137,7 +42250,6 @@ with the given priority. This internally creates a main loop source using g_io_create_watch() and attaches it to the main loop context with g_source_attach(). You can do these steps manually if you need greater control. - the event source id @@ -44171,7 +42283,6 @@ You can do these steps manually if you need greater control. Converts an `errno` error number to a #GIOChannelError. - a #GIOChannelError error number, e.g. %G_IO_CHANNEL_ERROR_INVAL. @@ -44204,7 +42315,6 @@ at the default priority. On Windows, polling a #GSource created to watch a channel for a socket puts the socket in non-blocking mode. This is a side-effect of the implementation and unavoidable. - a new #GSource @@ -44525,7 +42635,6 @@ To free the entire list, use g_slist_free(). A convenience macro to get the next element in a #GList. Note that it is considered perfectly acceptable to access @list->next directly. - an element in a #GList @@ -44536,7 +42645,6 @@ Note that it is considered perfectly acceptable to access A convenience macro to get the previous element in a #GList. Note that it is considered perfectly acceptable to access @list->prev directly. - an element in a #GList @@ -44552,7 +42660,6 @@ from the C library directly. On Windows, the strings in the environ array are in system codepage encoding, while in most of the typical use cases for environment variables in GLib-using programs you want the UTF-8 encoding that this function and g_getenv() provide. - a %NULL-terminated list of strings which must be freed with @@ -44572,7 +42679,6 @@ The input string shall not contain nul characters even if the @len argument is positive. A nul character found inside the string will result in error %G_CONVERT_ERROR_ILLEGAL_SEQUENCE. Use g_convert() to convert input that may contain embedded nul characters. - A newly-allocated buffer containing the converted string, @@ -44621,7 +42727,6 @@ If the source encoding is UTF-8, an embedded nul character is treated with the %G_CONVERT_ERROR_ILLEGAL_SEQUENCE error for backward compatibility with earlier versions of this library. Use g_convert() to produce output that may contain embedded nul characters. - The converted string, or %NULL on an error. @@ -44673,7 +42778,6 @@ manually. If [structured logging is enabled][using-structured-logging] this will output via the structured log writer function (see g_log_set_writer_func()). - @@ -44724,7 +42828,6 @@ the rest. This has no effect if structured logging is enabled; see [Using Structured Logging][using-structured-logging]. - @@ -44753,7 +42856,6 @@ default "" application domain This has no effect if structured logging is enabled; see [Using Structured Logging][using-structured-logging]. - @@ -44786,7 +42888,6 @@ Structured log messages (using g_log_structured() and g_log_structured_array()) are fatal only if the default log writer is used; otherwise it is up to the writer function to determine which log messages are fatal. See [Using Structured Logging][using-structured-logging]. - the old fatal mask @@ -44807,7 +42908,6 @@ g_log_default_handler() as default log handler. This has no effect if structured logging is enabled; see [Using Structured Logging][using-structured-logging]. - the previous default log handler @@ -44837,7 +42937,6 @@ This function is mostly intended to be used with %G_LOG_LEVEL_CRITICAL. You should typically not set %G_LOG_LEVEL_WARNING, %G_LOG_LEVEL_MESSAGE, %G_LOG_LEVEL_INFO or %G_LOG_LEVEL_DEBUG as fatal except inside of test programs. - the old fatal mask for the log domain @@ -44884,7 +42983,6 @@ This example adds a log handler for all messages from GLib: g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL | G_LOG_FLAG_RECURSION, my_log_handler, NULL); ]| - the id of the new handler @@ -44917,7 +43015,6 @@ g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL This has no effect if structured logging is enabled; see [Using Structured Logging][using-structured-logging]. - the id of the new handler @@ -44959,7 +43056,6 @@ install a writer function, as there must be a single, central point where log messages are formatted and outputted. There can only be one writer function. It is an error to set more than one. - @@ -45058,7 +43154,6 @@ field for which printf()-style formatting is supported. The default writer function for `stdout` and `stderr` will automatically append a new-line character after the message, so you should not add one manually to the format string. - @@ -45090,7 +43185,6 @@ See g_log_structured() for more documentation. This assumes that @log_level is already present in @fields (typically as the `PRIORITY` field). - @@ -45114,7 +43208,6 @@ This assumes that @log_level is already present in @fields (typically as the - @@ -45157,7 +43250,6 @@ to the log writer as such. The size of the array should not be higher than g_variant_print() will be used to convert the value into a string. For more details on its usage and about the parameters, see g_log_structured(). - @@ -45194,7 +43286,6 @@ if no other is set using g_log_set_writer_func(). As with g_log_default_handler(), this function drops debug and informational messages unless their log domain (or `all`) is listed in the space-separated `G_MESSAGES_DEBUG` environment variable. - %G_LOG_WRITER_HANDLED on success, %G_LOG_WRITER_UNHANDLED otherwise @@ -45232,7 +43323,6 @@ unknown fields. The returned string does **not** have a trailing new-line character. It is encoded in the character set of the current locale, which is not necessarily UTF-8. - string containing the formatted log message, in the character set of the current locale @@ -45272,7 +43362,6 @@ the following construct without needing any additional error handling: |[<!-- language="C" --> is_journald = g_log_writer_is_journald (fileno (stderr)); ]| - %TRUE if @output_fd points to the journal, %FALSE otherwise @@ -45294,7 +43383,6 @@ This is suitable for use as a #GLogWriterFunc. If GLib has been compiled without systemd support, this function is still defined, but will always return %G_LOG_WRITER_UNHANDLED. - %G_LOG_WRITER_HANDLED on success, %G_LOG_WRITER_UNHANDLED otherwise @@ -45335,7 +43423,6 @@ in the output. A trailing new-line character is added to the log message when it is printed. This is suitable for use as a #GLogWriterFunc. - %G_LOG_WRITER_HANDLED on success, %G_LOG_WRITER_UNHANDLED otherwise @@ -45367,7 +43454,6 @@ This is suitable for use as a #GLogWriterFunc. Check whether the given @output_fd file descriptor supports ANSI color escape sequences. If so, they can safely be used when formatting log messages. - %TRUE if ANSI color escapes are supported, %FALSE otherwise @@ -45392,7 +43478,6 @@ manually. If [structured logging is enabled][using-structured-logging] this will output via the structured log writer function (see g_log_set_writer_func()). - @@ -45417,21 +43502,18 @@ application domain - - - @@ -45559,7 +43641,6 @@ invoked, which may be undesirable. used for main loop functions when a main loop is not explicitly specified, and corresponds to the "main" main loop. See also g_main_context_get_thread_default(). - the global default main context. @@ -45577,7 +43658,6 @@ always return %NULL if you are running in the default thread.) If you need to hold a reference on the context, use g_main_context_ref_thread_default() instead. - the thread-default #GMainContext, or %NULL if the thread-default context is the global default context. @@ -45591,7 +43671,6 @@ it with g_main_context_ref(). In addition, unlike g_main_context_get_thread_default(), if the thread-default context is the global default context, this will return that #GMainContext (with a ref added to it) rather than returning %NULL. - the thread-default #GMainContext. Unref with g_main_context_unref() when you are done with it. @@ -45600,7 +43679,6 @@ is the global default context, this will return that #GMainContext Returns the currently firing source for this thread. - The currently firing source or %NULL. @@ -45708,7 +43786,6 @@ following techniques: arbitrary callbacks. Instead, structure your code so that you simply return to the main loop and then get called again when there is more work to do. - The main loop recursion level in the current thread @@ -45717,7 +43794,6 @@ following techniques: Allocates @n_bytes bytes of memory. If @n_bytes is 0 it returns %NULL. - a pointer to the allocated memory @@ -45732,7 +43808,6 @@ If @n_bytes is 0 it returns %NULL. Allocates @n_bytes bytes of memory, initialized to 0's. If @n_bytes is 0 it returns %NULL. - a pointer to the allocated memory @@ -45747,7 +43822,6 @@ If @n_bytes is 0 it returns %NULL. This function is similar to g_malloc0(), allocating (@n_blocks * @n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. - a pointer to the allocated memory @@ -45766,7 +43840,6 @@ but care is taken to detect possible overflow during multiplication. This function is similar to g_malloc(), allocating (@n_blocks * @n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. - a pointer to the allocated memory @@ -45858,7 +43931,6 @@ attributes (of type %G_MARKUP_ERROR_INVALID_CONTENT) as well as parse errors for boolean-valued attributes (again of type %G_MARKUP_ERROR_INVALID_CONTENT). In all of these cases %FALSE will be returned and @error will be set as appropriate. - %TRUE if successful @@ -45916,7 +43988,6 @@ the range of &#x1; ... &#x1f; for all control sequences except for tabstop, newline and carriage return. The character references in this range are not valid XML 1.0, but they are valid XML 1.1 and will be accepted by the GMarkup parser. - a newly allocated string with the escaped text @@ -45951,7 +44022,6 @@ output = g_markup_printf_escaped ("<purchase>" "</purchase>", store, item); ]| - newly allocated result from formatting operation. Free with g_free(). @@ -45972,7 +44042,6 @@ output = g_markup_printf_escaped ("<purchase>" Formats the data in @args according to @format, escaping all string and character arguments in the fashion of g_markup_escape_text(). See g_markup_printf_escaped(). - newly allocated result from formatting operation. Free with g_free(). @@ -45997,7 +44066,6 @@ This function is useful for avoiding an extra copy of allocated memory returned by a non-GLib-based API. GLib always uses the system malloc, so this function always returns %TRUE. - if %TRUE, malloc() and g_malloc() can be mixed. @@ -46008,7 +44076,6 @@ returns %TRUE. no longer works. There are many other useful tools for memory profiling these days which can be used instead. Use other memory profiling tools instead - @@ -46020,7 +44087,6 @@ in GLib and GIO, because those use the GLib allocators before main is reached. Therefore this function is now deprecated and is just a stub. This function now does nothing. Use other memory profiling tools instead - @@ -46034,7 +44100,6 @@ profiling tools instead Allocates @byte_size bytes of memory, and copies @byte_size bytes into it from @mem. If @mem is %NULL it returns %NULL. - a pointer to the newly-allocated copy of the memory, or %NULL if @mem is %NULL. @@ -46055,7 +44120,6 @@ from @mem. If @mem is %NULL it returns %NULL. Copies a block of memory @len bytes long, from @src to @dest. The source and destination areas may overlap. Just use memmove(). - the destination address to copy the bytes to. @@ -46306,7 +44370,6 @@ than the one under test). Create a directory if it doesn't already exist. Create intermediate parent directories as needed, too. - 0 if the directory already exists, or was successfully created. Returns -1 if an error occurred, with errno set. @@ -46339,7 +44402,6 @@ on Windows it should be in UTF-8. If you are going to be creating a temporary directory inside the directory returned by g_get_tmp_dir(), you might want to use g_dir_make_tmp() instead. - A pointer to @tmpl, which has been modified to hold the directory name. In case of errors, %NULL is @@ -46369,7 +44431,6 @@ should be in UTF-8. If you are going to be creating a temporary directory inside the directory returned by g_get_tmp_dir(), you might want to use g_dir_make_tmp() instead. - A pointer to @tmpl, which has been modified to hold the directory name. In case of errors, %NULL is @@ -46398,7 +44459,6 @@ sequence does not have to occur at the very end of the template. The X string will be modified to form the name of a file that didn't exist. The string should be in the GLib file name encoding. Most importantly, on Windows it should be in UTF-8. - A file handle (as from open()) to the file opened for reading and writing. The file is opened in binary @@ -46426,7 +44486,6 @@ template and you can pass a @mode and additional @flags. The X string will be modified to form the name of a file that didn't exist. The string should be in the GLib file name encoding. Most importantly, on Windows it should be in UTF-8. - A file handle (as from open()) to the file opened for reading and writing. The file handle should be @@ -46459,7 +44518,6 @@ Care is taken to avoid overflow when calculating the size of the allocated block Since the returned pointer is already casted to the right type, it is normally unnecessary to cast it explicitly, and doing so might hide memory allocation errors. - the type of the elements to allocate @@ -46478,7 +44536,6 @@ Care is taken to avoid overflow when calculating the size of the allocated block Since the returned pointer is already casted to the right type, it is normally unnecessary to cast it explicitly, and doing so might hide memory allocation errors. - the type of the elements to allocate. @@ -46490,7 +44547,6 @@ so might hide memory allocation errors. Wraps g_alloca() in a more typesafe manner. - Type of memory chunks to be allocated @@ -46502,7 +44558,6 @@ so might hide memory allocation errors. Inserts a #GNode as the last child of the given parent. - the #GNode to place the new #GNode under @@ -46514,7 +44569,6 @@ so might hide memory allocation errors. Inserts a new #GNode as the last child of the given parent. - the #GNode to place the new #GNode under @@ -46526,7 +44580,6 @@ so might hide memory allocation errors. Gets the first child of a #GNode. - a #GNode @@ -46535,7 +44588,6 @@ so might hide memory allocation errors. Inserts a new #GNode at the given position. - the #GNode to place the new #GNode under @@ -46551,7 +44603,6 @@ so might hide memory allocation errors. Inserts a new #GNode after the given sibling. - the #GNode to place the new #GNode under @@ -46566,7 +44617,6 @@ so might hide memory allocation errors. Inserts a new #GNode before the given sibling. - the #GNode to place the new #GNode under @@ -46581,7 +44631,6 @@ so might hide memory allocation errors. Gets the next sibling of a #GNode. - a #GNode @@ -46590,7 +44639,6 @@ so might hide memory allocation errors. Inserts a new #GNode as the first child of the given parent. - the #GNode to place the new #GNode under @@ -46602,7 +44650,6 @@ so might hide memory allocation errors. Gets the previous sibling of a #GNode. - a #GNode @@ -46611,7 +44658,6 @@ so might hide memory allocation errors. Converts a 32-bit integer value from network to host byte order. - a 32-bit integer value in network byte order @@ -46620,7 +44666,6 @@ so might hide memory allocation errors. Converts a 16-bit integer value from network to host byte order. - a 16-bit integer value in network byte order @@ -46629,7 +44674,6 @@ so might hide memory allocation errors. Set the pointer at the specified location to %NULL. - @@ -46704,7 +44748,6 @@ This function may cause different actions on non-UNIX platforms. On Windows consider using the `G_DEBUGGER` environment variable (see [Running GLib Applications](glib-running.html)) and calling g_on_error_stack_trace() instead. - @@ -46732,7 +44775,6 @@ g_on_error_query(). If called directly, it will raise an exception, which will crash the program. If the `G_DEBUGGER` environment variable is set, a debugger will be invoked to attach and handle that exception (see [Running GLib Applications](glib-running.html)). - @@ -46769,7 +44811,6 @@ Calling g_once() recursively on the same #GOnce struct in return my_once.retval; } ]| - a #GOnce structure @@ -46807,7 +44848,6 @@ like this: // use initialization_value here ]| - %TRUE if the initialization section should be entered, %FALSE and blocks otherwise @@ -46827,7 +44867,6 @@ like this: other than 0. Sets the variable to the initialization value, and releases concurrent threads blocking in g_once_init_enter() on this initialization variable. - @@ -47016,7 +45055,6 @@ corresponding to "foo" and "bar". If @string is equal to "help", all the available keys in @keys are printed out to standard error. - the combined set of bit flags. @@ -47047,7 +45085,6 @@ If @file_name ends with a directory separator it gets the component before the last slash. If @file_name consists only of directory separators (and on Windows, possibly a drive letter), a single separator is returned. If @file_name is empty, it gets ".". - a newly allocated string containing the last component of the filename @@ -47067,7 +45104,6 @@ is `/`. If the file name has no directory components "." is returned. The returned string should be freed when no longer needed. - the directory components of the file @@ -47104,7 +45140,6 @@ function, but they obviously are not relative to the normal current directory as returned by getcwd() or g_get_current_dir() either. Such paths should be avoided, or need to be handled using Windows-specific code. - %TRUE if @file_name is absolute @@ -47120,7 +45155,6 @@ Windows-specific code. Returns a pointer into @file_name after the root component, i.e. after the "/" in UNIX or "C:\" under Windows. If @file_name is not an absolute path it returns %NULL. - a pointer into @file_name after the root component @@ -47151,7 +45185,6 @@ Note also that the reverse of a UTF-8 encoded string can in general not be obtained by g_strreverse(). This works only if the string does not contain any multibyte characters. GLib offers the g_utf8_strreverse() function to reverse UTF-8 encoded strings. - %TRUE if @string matches @pspec @@ -47181,7 +45214,6 @@ g_utf8_strreverse() function to reverse UTF-8 encoded strings. function is to be called in a loop, it's more efficient to compile the pattern once with g_pattern_spec_new() and call g_pattern_match_string() repeatedly. - %TRUE if @string matches @pspec @@ -47201,7 +45233,6 @@ g_pattern_match_string() repeatedly. Matches a string against a compiled pattern. If the string is to be matched against more than one pattern, consider using g_pattern_match() instead while supplying the reversed string. - %TRUE if @string matches @pspec @@ -47239,7 +45270,6 @@ pointer-sized values). For portability reasons, you may only lock on the bottom 32 bits of the pointer. - @@ -47260,7 +45290,6 @@ other pointer-sized values). For portability reasons, you may only lock on the bottom 32 bits of the pointer. - %TRUE if the lock was acquired @@ -47282,7 +45311,6 @@ pointer-sized values). For portability reasons, you may only lock on the bottom 32 bits of the pointer. - @@ -47315,7 +45343,6 @@ file descriptor, but the situation is much more complicated on Windows. If you need to use g_poll() in code that has to run on Windows, the easiest solution is to construct all of your #GPollFDs with g_io_channel_win32_make_pollfd(). - the number of entries in @fds whose @revents fields were filled in, or 0 if the operation timed out, or -1 on error or @@ -47344,7 +45371,6 @@ nothing. If *@err is %NULL (ie: an error variable is present but there is no error condition) then also do nothing. - @@ -47374,7 +45400,6 @@ messages, since it may be redirected by applications to special purpose message windows or even files. Instead, libraries should use g_log(), g_log_structured(), or the convenience macros g_message(), g_warning() and g_error(). - @@ -47398,7 +45423,6 @@ new-line character. g_printerr() should not be used from within libraries. Instead g_log() or g_log_structured() should be used, or the convenience macros g_message(), g_warning() and g_error(). - @@ -47422,7 +45446,6 @@ new-line character to the message, so typically @format should end with its own new-line character. `glib/gprintf.h` must be explicitly included in order to use this function. - the number of bytes printed. @@ -47442,7 +45465,6 @@ own new-line character. Calculates the maximum space needed to store the output of the sprintf() function. - the maximum space needed to store the formatted string @@ -47467,7 +45489,6 @@ The error variable @dest points to must be %NULL. Note that @src is no longer valid after this call. If you want to keep using the same GError*, you need to set it to %NULL after calling this function on it. - @@ -47486,7 +45507,6 @@ after calling this function on it. If @dest is %NULL, free @src; otherwise, moves @src into *@dest. *@dest must be %NULL. After the move, add a prefix as with g_prefix_error(). - @@ -47517,7 +45537,6 @@ multiple times in @haystack, the index of the first instance is returned. This does pointer comparisons only. If you want to use more complex equality checks, such as string comparisons, use g_ptr_array_find_with_equal_func(). - %TRUE if @needle is one of the elements of @haystack @@ -47550,7 +45569,6 @@ the first instance is returned. @equal_func is called with the element from the array as its first parameter, and @needle as its second parameter. If @equal_func is %NULL, pointer equality is used. - %TRUE if @needle is one of the elements of @haystack @@ -47584,7 +45602,6 @@ equality is used. This does not perform bounds checking on the given @index_, so you are responsible for checking it against the array length. - a #GPtrArray @@ -47599,7 +45616,6 @@ so you are responsible for checking it against the array length. the comparison routine accepts a user data argument. This is guaranteed to be a stable sort since version 2.32. - @@ -47643,7 +45659,6 @@ function in GTK+ theme engines). This function must not be used before library constructors have finished running. In particular, this means it cannot be used to initialize global variables in C++. - the #GQuark identifying the string, or 0 if @string is %NULL @@ -47663,7 +45678,6 @@ using a copy of the string. This function must not be used before library constructors have finished running. In particular, this means it cannot be used to initialize global variables in C++. - the #GQuark identifying the string, or 0 if @string is %NULL @@ -47677,7 +45691,6 @@ variables in C++. Gets the string associated with the given #GQuark. - the string associated with the #GQuark @@ -47698,7 +45711,6 @@ use g_quark_from_string() or g_quark_from_static_string(). This function must not be used before library constructors have finished running. - the #GQuark associated with the string, or 0 if @string is %NULL or there is no #GQuark associated with it @@ -47763,7 +45775,6 @@ To free the entire queue, use g_queue_free(). Returns a random #gboolean from @rand_. This corresponds to an unbiased coin toss. - a #GRand @@ -47772,7 +45783,6 @@ This corresponds to an unbiased coin toss. Returns a random #gdouble equally distributed over the range [0..1). - a random number @@ -47781,7 +45791,6 @@ This corresponds to an unbiased coin toss. Returns a random #gdouble equally distributed over the range [@begin..@end). - a random number @@ -47800,7 +45809,6 @@ This corresponds to an unbiased coin toss. Return a random #guint32 equally distributed over the range [0..2^32-1]. - a random number @@ -47809,7 +45817,6 @@ This corresponds to an unbiased coin toss. Returns a random #gint32 equally distributed over the range [@begin..@end-1]. - a random number @@ -47874,7 +45881,6 @@ generated with Glib-2.0 that you need to reproduce exactly. Sets the seed for the global random number generator, which is used by the g_random_* functions, to @seed. - @@ -47887,7 +45893,6 @@ by the g_random_* functions, to @seed. Acquires a reference on the data pointed by @mem_block. - a pointer to the data, with its reference count increased @@ -47909,7 +45914,6 @@ zero. The allocated data is guaranteed to be suitably aligned for any built-in type. - a pointer to the allocated memory @@ -47932,7 +45936,6 @@ zero. The allocated data is guaranteed to be suitably aligned for any built-in type. - a pointer to the allocated memory @@ -47948,7 +45951,6 @@ built-in type. Allocates a new block of data with reference counting semantics, and copies @block_size bytes of @mem_block into it. - a pointer to the allocated memory @@ -47967,7 +45969,6 @@ into it. Retrieves the size of the reference counted data pointed by @mem_block. - the size of the data, in bytes @@ -47986,7 +45987,6 @@ the size of the given @type. This macro calls g_rc_box_alloc() with `sizeof (@type)` and casts the returned pointer to a pointer of the given @type, avoiding a type cast in the source code. - the type to allocate, typically a structure name @@ -48000,7 +46000,6 @@ the size of the given @type, and set its contents to zero. This macro calls g_rc_box_alloc0() with `sizeof (@type)` and casts the returned pointer to a pointer of the given @type, avoiding a type cast in the source code. - the type to allocate, typically a structure name @@ -48012,7 +46011,6 @@ avoiding a type cast in the source code. If the reference was the last one, it will free the resources allocated for @mem_block. - @@ -48029,7 +46027,6 @@ resources allocated for @mem_block. If the reference was the last one, it will call @clear_func to clear the contents of @mem_block, and then will free the resources allocated for @mem_block. - @@ -48173,7 +46170,6 @@ G_DEFINE_AUTOPTR_CLEANUP_FUNC (MyDataStruct, my_data_struct_release) have been moved. @mem may be %NULL, in which case it's considered to have zero-length. @n_bytes may be 0, in which case %NULL will be returned and @mem will be freed unless it is %NULL. - the new address of the allocated memory @@ -48192,7 +46188,6 @@ and @mem will be freed unless it is %NULL. This function is similar to g_realloc(), allocating (@n_blocks * @n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. - the new address of the allocated memory @@ -48214,7 +46209,6 @@ but care is taken to detect possible overflow during multiplication. Compares the current value of @rc with @val. - %TRUE if the reference count is the same as the given value @@ -48233,7 +46227,6 @@ but care is taken to detect possible overflow during multiplication. Decreases the reference count. - %TRUE if the reference count reached 0, and %FALSE otherwise @@ -48247,7 +46240,6 @@ but care is taken to detect possible overflow during multiplication. Increases the reference count. - @@ -48260,7 +46252,6 @@ but care is taken to detect possible overflow during multiplication. Initializes a reference count variable. - @@ -48273,7 +46264,6 @@ but care is taken to detect possible overflow during multiplication. Acquires a reference on a string. - the given string, with its reference count increased @@ -48287,7 +46277,6 @@ but care is taken to detect possible overflow during multiplication. Retrieves the length of @str. - the length of the given string, in bytes @@ -48302,7 +46291,6 @@ but care is taken to detect possible overflow during multiplication. Creates a new reference counted string and copies the contents of @str into it. - the newly created reference counted string @@ -48321,7 +46309,6 @@ into it. If you call this function multiple times with the same @str, or with the same contents of @str, it will return a new reference, instead of creating a new string. - the newly created reference counted string, or a new reference to an existing string @@ -48340,7 +46327,6 @@ into it, up to @len bytes. Since this function does not stop at nul bytes, it is the caller's responsibility to ensure that @str has at least @len addressable bytes. - the newly created reference counted string @@ -48359,7 +46345,6 @@ responsibility to ensure that @str has at least @len addressable bytes. Releases a reference on a string; if it was the last reference, the resources allocated by the string are freed as well. - @@ -48457,7 +46442,6 @@ for pattern references. For instance, replacement text 'foo\n' does not contain references and may be evaluated without information about actual match, but '\0\1' (whole match followed by first subpattern) requires valid #GMatchInfo object. - whether @replacement is a valid replacement string @@ -48485,7 +46469,6 @@ to compile a regex with embedded nul characters. For completeness, @length can be -1 for a nul-terminated string. In this case the output string will be of course equal to @string. - a newly-allocated escaped string @@ -48509,7 +46492,6 @@ function is useful to dynamically generate regular expressions. @string can contain nul characters that are replaced with "\0", in this case remember to specify the correct length of @string in @length. - a newly-allocated escaped string @@ -48538,7 +46520,6 @@ substrings, capture counts, and so on. If this function is to be called on the same @pattern more than once, it's more efficient to compile the pattern once with g_regex_new() and then use g_regex_match(). - %TRUE if the string matched, %FALSE otherwise @@ -48590,7 +46571,6 @@ A pattern that can match empty strings splits @string into separate characters wherever it matches the empty string between characters. For example splitting "ab c" using as a separator "\s*", you will get "a", "b" and "c". - a %NULL-terminated array of strings. Free it using g_strfreev() @@ -48626,7 +46606,6 @@ Due to thread safety issues this may cause leaking of strings that were previously returned from g_get_user_special_dir() that can't be freed. We ensure to only leak the data for the directories that actually changed value though. - @@ -48636,7 +46615,6 @@ the directories that actually changed value though. @n_structs elements of type @struct_type. It returns the new address of the memory, which may have been moved. Care is taken to avoid overflow when calculating the size of the allocated block. - the type of the elements to allocate @@ -48650,7 +46628,6 @@ Care is taken to avoid overflow when calculating the size of the allocated block - @@ -48659,7 +46636,6 @@ Care is taken to avoid overflow when calculating the size of the allocated block Internal function used to print messages from the public g_return_if_fail() and g_return_val_if_fail() macros. - @@ -48679,7 +46655,6 @@ and g_return_val_if_fail() macros. - @@ -48688,7 +46663,6 @@ and g_return_val_if_fail() macros. - @@ -48700,7 +46674,6 @@ deletes a directory from the filesystem. See your C library manual for more details about how rmdir() works on your system. - 0 if the directory was successfully removed, -1 if an error occurred @@ -48721,7 +46694,6 @@ general purpose lexical scanner. Adds a symbol to the default scope. Use g_scanner_scope_add_symbol() instead. - a #GScanner @@ -48737,7 +46709,6 @@ general purpose lexical scanner. Calls a function for each symbol in the default scope. Use g_scanner_scope_foreach_symbol() instead. - a #GScanner @@ -48753,7 +46724,6 @@ general purpose lexical scanner. There is no reason to use this macro, since it does nothing. This macro does nothing. - a #GScanner @@ -48763,7 +46733,6 @@ general purpose lexical scanner. Removes a symbol from the default scope. Use g_scanner_scope_remove_symbol() instead. - a #GScanner @@ -48776,7 +46745,6 @@ general purpose lexical scanner. There is no reason to use this macro, since it does nothing. This macro does nothing. - a #GScanner @@ -48829,7 +46797,6 @@ insertions. Returns the data that @iter points to. - the data that @iter points to @@ -48843,7 +46810,6 @@ insertions. Inserts a new item just before the item pointed to by @iter. - an iterator pointing to the new item @@ -48864,7 +46830,6 @@ insertions. After calling this function @dest will point to the position immediately after @src. It is allowed for @src and @dest to point into different sequences. - @@ -48889,7 +46854,6 @@ into by @begin and @end. If @dest is %NULL, the range indicated by @begin and @end is removed from the sequence. If @dest points to a place within the (@begin, @end) range, the range does not move. - @@ -48915,7 +46879,6 @@ guaranteed to be exactly in the middle. The @begin and @end iterators must both point to the same sequence and @begin must come before or be equal to @end in the sequence. - a #GSequenceIter pointing somewhere in the (@begin, @end) range @@ -48938,7 +46901,6 @@ end iterator to this function. If the sequence has a data destroy function associated with it, this function is called on the data for the removed item. - @@ -48954,7 +46916,6 @@ function is called on the data for the removed item. If the sequence has a data destroy function associated with it, this function is called on the data for the removed items. - @@ -48973,7 +46934,6 @@ function is called on the data for the removed items. Changes the data for the item pointed to by @iter to be @data. If the sequence has a data destroy function associated with it, that function is called on the existing data that @iter pointed to. - @@ -48991,7 +46951,6 @@ function is called on the existing data that @iter pointed to. Swaps the items pointed to by @a and @b. It is allowed for @a and @b to point into difference sequences. - @@ -49018,7 +46977,6 @@ be called once. The application name will be used in contexts such as error messages, or when displaying an application's name in the task list. - @@ -49032,7 +46990,6 @@ or when displaying an application's name in the task list. Does nothing if @err is %NULL; if @err is non-%NULL, then *@err must be %NULL. A new #GError is created and assigned to *@err. - @@ -49065,7 +47022,6 @@ must be %NULL. A new #GError is created and assigned to *@err. Unlike g_set_error(), @message is not a printf()-style format string. Use this function if @message contains text you don't have control over, that could include printf() escape sequences. - @@ -49099,7 +47055,6 @@ gdk_init(), which is called by gtk_init() and the taking the last component of @argv[0]. Note that for thread-safety reasons this function can only be called once. - @@ -49118,7 +47073,6 @@ the new handler. The default handler simply outputs the message to stdout. By providing your own handler you can redirect the output, to a GTK+ widget or a log file for example. - the old print handler @@ -49138,7 +47092,6 @@ the new handler. The default handler simply outputs the message to stderr. By providing your own handler you can redirect the output, to a GTK+ widget or a log file for example. - the old error message handler @@ -49170,7 +47123,6 @@ If you need to set up the environment for a child process, you can use g_get_environ() to get an environment array, modify that with g_environ_setenv() and g_environ_unsetenv(), and then pass that array directly to execvpe(), g_spawn_async(), or the like. - %FALSE if the environment variable couldn't be set. @@ -49215,7 +47167,6 @@ contains none of the unsupported shell expansions. If the input does contain such expansions, they are passed through literally. Possible errors are those from the #G_SHELL_ERROR domain. Free the returned vector with g_strfreev(). - %TRUE on success, %FALSE if error set @@ -49245,7 +47196,6 @@ the shell, for example, you should first quote it with this function. The return value must be freed with g_free(). The quoting style used is undefined (single or double quotes may be used). - quoted string @@ -49279,7 +47229,6 @@ literal string exactly. escape sequences are not allowed; not even like 'foo'\''bar'. Double quotes allow $, `, ", \, and newline to be escaped with backslash. Otherwise double quotes preserve things literally. - an unquoted string @@ -49298,7 +47247,6 @@ literally. If the operation is successful, %TRUE is returned. If the operation overflows then the state of @dest is undefined and %FALSE is returned. - a pointer to the #gsize destination @@ -49318,7 +47266,6 @@ returned. If the operation is successful, %TRUE is returned. If the operation overflows then the state of @dest is undefined and %FALSE is returned. - a pointer to the #gsize destination @@ -49341,7 +47288,6 @@ the alignment may be reduced in a libc dependent fashion. Note that the underlying slice allocation mechanism can be changed with the [`G_SLICE=always-malloc`][G_SLICE] environment variable. - a pointer to the allocated memory block, which will be %NULL if and only if @mem_size is 0 @@ -49359,7 +47305,6 @@ environment variable. the returned memory to 0. Note that the underlying slice allocation mechanism can be changed with the [`G_SLICE=always-malloc`][G_SLICE] environment variable. - a pointer to the allocated block, which will be %NULL if and only if @mem_size is 0 @@ -49377,7 +47322,6 @@ environment variable. and copies @block_size bytes into it from @mem_block. @mem_block must be non-%NULL if @block_size is non-zero. - a pointer to the allocated memory block, which will be %NULL if and only if @mem_size is 0 @@ -49406,7 +47350,6 @@ be changed with the [`G_SLICE=always-malloc`][G_SLICE] environment variable. This can never return %NULL. - the type to duplicate, typically a structure name @@ -49427,7 +47370,6 @@ Note that the exact release behaviour can be changed with the [`G_SLICE`][G_SLICE] for related debugging options. If @mem is %NULL, this macro does nothing. - the type of the block to free, typically a structure name @@ -49447,7 +47389,6 @@ can be changed with the [`G_DEBUG=gc-friendly`][G_DEBUG] environment variable, also see [`G_SLICE`][G_SLICE] for related debugging options. If @mem_block is %NULL, this function does nothing. - @@ -49473,7 +47414,6 @@ Note that the exact release behaviour can be changed with the [`G_SLICE`][G_SLICE] for related debugging options. If @mem_chain is %NULL, this function does nothing. - the type of the @mem_chain blocks @@ -49498,7 +47438,6 @@ Note that the exact release behaviour can be changed with the [`G_SLICE`][G_SLICE] for related debugging options. If @mem_chain is %NULL, this function does nothing. - @@ -49518,7 +47457,6 @@ If @mem_chain is %NULL, this function does nothing. - @@ -49529,7 +47467,6 @@ If @mem_chain is %NULL, this function does nothing. - @@ -49557,7 +47494,6 @@ environment variable. This can never return %NULL as the minimum allocation size from `sizeof (@type)` is 1 byte. - the type to allocate, typically a structure name @@ -49577,7 +47513,6 @@ environment variable. This can never return %NULL as the minimum allocation size from `sizeof (@type)` is 1 byte. - the type to allocate, typically a structure name @@ -49585,7 +47520,6 @@ This can never return %NULL as the minimum allocation size from - @@ -49602,7 +47536,6 @@ This can never return %NULL as the minimum allocation size from A convenience macro to get the next element in a #GSList. Note that it is considered perfectly acceptable to access @slist->next directly. - an element in a #GSList. @@ -49627,7 +47560,6 @@ traditional snprintf(), which returns the length of the output string. The format string may contain positional parameters, as specified in the Single Unix Specification. - the number of bytes which would be produced if the buffer was large enough. @@ -49674,7 +47606,6 @@ idle may already have run and been removed by the time this function is called on its (now invalid) source ID. This source ID may have been reissued, leading to the operation being performed against the wrong source. - For historical reasons, this function always returns %TRUE @@ -49690,7 +47621,6 @@ wrong source. Removes a source from the default main loop context given the source functions and user data. If multiple sources exist with the same source functions and user data, only one will be destroyed. - %TRUE if a source was found and removed. @@ -49710,7 +47640,6 @@ same source functions and user data, only one will be destroyed. Removes a source from the default main loop context given the user data for the callback. If multiple sources exist with the same user data, only one will be destroyed. - %TRUE if a source was found and removed. @@ -49739,7 +47668,6 @@ idle may already have run and been removed by the time this function is called on its (now invalid) source ID. This source ID may have been reissued, leading to the operation being performed against the wrong source. - @@ -49761,7 +47689,6 @@ size of a #GHashTable. The built-in array of primes ranges from 11 to 13845163 such that each prime is approximately 1.5-2 times the previous prime. - the smallest prime number from a built-in array of primes which is larger than @num @@ -49844,7 +47771,6 @@ windows on the right screen, you may want to use #GdkAppLaunchContext, Note that the returned @child_pid on Windows is a handle to the child process and not its identifier. Process handles and process identifiers are different concepts on Windows. - %TRUE on success, %FALSE if error is set @@ -49906,7 +47832,6 @@ standard input (by default, the child's standard input is attached to It is valid to pass the same fd in multiple parameters (e.g. you can pass a single fd for both stdout and stderr). - %TRUE on success, %FALSE if an error was set @@ -50125,7 +48050,6 @@ If you are writing a GTK+ application, and the program you are spawning is a graphical application too, then to ensure that the spawned program opens its windows on the right screen, you may want to use #GdkAppLaunchContext, #GAppLaunchContext, or set the %DISPLAY environment variable. - %TRUE on success, %FALSE if an error was set @@ -50218,7 +48142,6 @@ the available platform via a macro such as %G_OS_UNIX, and use WIFEXITED() and WEXITSTATUS() on @exit_status directly. Do not attempt to scan or parse the error message string; it may be translated and/or change in future versions of GLib. - %TRUE if child exited successfully, %FALSE otherwise (and @error will be set) @@ -50236,7 +48159,6 @@ change in future versions of GLib. which must be closed to prevent resource leaking. g_spawn_close_pid() is provided for this purpose. It should be used on all platforms, even though it doesn't do anything under UNIX. - @@ -50257,7 +48179,6 @@ consider using g_spawn_async() directly if appropriate. Possible errors are those from g_shell_parse_argv() and g_spawn_async(). The same concerns on Windows apply as for g_spawn_command_line_sync(). - %TRUE on success, %FALSE if error is set @@ -50292,7 +48213,6 @@ canonical Windows paths, like "c:\\program files\\app\\app.exe", as the backslashes will be eaten, and the space will act as a separator. You need to enclose such paths with single quotes, like "'c:\\program files\\app\\app.exe' 'e:\\folder\\argument.txt'". - %TRUE on success, %FALSE if an error was set @@ -50350,7 +48270,6 @@ If an error occurs, no data is returned in @standard_output, This function calls g_spawn_async_with_pipes() internally; see that function for full details on the other parameters and details on how these functions work on Windows. - %TRUE on success, %FALSE if an error was set @@ -50415,7 +48334,6 @@ risk of buffer overflow. `glib/gprintf.h` must be explicitly included in order to use this function. See also g_strdup_printf(). - the number of bytes printed. @@ -50487,7 +48405,6 @@ get_object (GObject **obj_out) In the above example, the object will be automatically freed in the early error case and also in the case that %NULL was given for @obj_out. - a pointer to a pointer @@ -50499,7 +48416,6 @@ early error case and also in the case that %NULL was given for trailing nul, and return a pointer to the trailing nul byte. This is useful for concatenating multiple strings together without having to repeatedly scan for the end. - a pointer to trailing nul byte. @@ -50524,7 +48440,6 @@ if they are equal. It can be passed to g_hash_table_new() as the This function is typically used for hash table comparisons, but can be used for general purpose comparisons of non-%NULL strings. For a %NULL-safe string comparison function, see g_strcmp0(). - %TRUE if the two keys match @@ -50542,7 +48457,6 @@ comparison function, see g_strcmp0(). Looks whether the string @str begins with @prefix. - %TRUE if @str begins with @prefix, %FALSE otherwise. @@ -50560,7 +48474,6 @@ comparison function, see g_strcmp0(). Looks whether the string @str ends with @suffix. - %TRUE if @str end with @suffix, %FALSE otherwise. @@ -50591,7 +48504,6 @@ when using non-%NULL strings as keys in a #GHashTable. Note that this function may not be a perfect fit for all use cases. For example, it produces some hash collisions with strings as short as 2. - a hash value corresponding to the key @@ -50606,7 +48518,6 @@ as 2. Determines if a string is pure ASCII. A string is pure ASCII if it contains no bytes with the high bit set. - %TRUE if @str is ASCII @@ -50641,7 +48552,6 @@ As some examples, searching for ‘fred’ would match the potential h ‘Frédéric’ but not ‘Frederic’ (due to the one-directional nature of accent matching). Searching ‘fo’ would match ‘Foo’ and ‘Bar Foo Baz’, but not ‘SFO’ (because no word has ‘fo’ as a prefix). - %TRUE if @potential_hit is a hit @@ -50680,7 +48590,6 @@ If @from_locale is %NULL then the current locale is used. If you want to do translation for no specific locale, and you want it to be done independently of the currently locale, specify `"C"` for @from_locale. - a string in plain ASCII @@ -50712,7 +48621,6 @@ The number of ASCII alternatives that are generated and the method for doing so is unspecified, but @translit_locale (if specified) may improve the transliteration if the language of the source string is known. - the folded tokens @@ -50753,7 +48661,6 @@ In order to modify a copy, you may use `g_strdup()`: ... g_free (reformatted); ]| - @string @@ -50778,7 +48685,6 @@ In order to modify a copy, you may use `g_strdup()`: strcasecmp() function on platforms which support it. See g_strncasecmp() for a discussion of why this function is deprecated and how to replace it. - 0 if the strings match, a negative value if @s1 < @s2, or a positive value if @s1 > @s2. @@ -50805,7 +48711,6 @@ on statically allocated strings. The pointer to @string is returned to allow the nesting of functions. Also see g_strchug() and g_strstrip(). - @string @@ -50828,7 +48733,6 @@ statically allocated strings. The pointer to @string is returned to allow the nesting of functions. Also see g_strchomp() and g_strstrip(). - @string @@ -50844,7 +48748,6 @@ Also see g_strchomp() and g_strstrip(). Compares @str1 and @str2 like strcmp(). Handles %NULL gracefully by sorting it before non-%NULL strings. Comparing two %NULL pointers returns 0. - an integer less than, equal to, or greater than zero, if @str1 is <, == or > than @str2. @@ -50864,7 +48767,6 @@ Comparing two %NULL pointers returns 0. Replaces all escaped characters with their one byte equivalent. This function does the reverse conversion of g_strescape(). - a newly-allocated copy of @source with all escaped character compressed @@ -50887,7 +48789,6 @@ g_strconcat() will start appending random memory junk to your string. Note that this function is usually not the right function to use to assemble a translated message from pieces, since proper translation often requires the pieces to be reordered. - a newly-allocated string containing all the string arguments @@ -50919,7 +48820,6 @@ In order to modify a copy, you may use `g_strdup()`: ... g_free (reformatted); ]| - @string @@ -50945,7 +48845,6 @@ In order to modify a copy, you may use `g_strdup()`: This function is totally broken for the reasons discussed in the g_strncasecmp() docs - use g_ascii_strdown() or g_utf8_strdown() instead. - the string @@ -50961,7 +48860,6 @@ instead. Duplicates a string. If @str is %NULL it returns %NULL. The returned string should be freed with g_free() when no longer needed. - a newly-allocated copy of @str @@ -50982,7 +48880,6 @@ longer needed. The returned string is guaranteed to be non-NULL, unless @format contains `%lc` or `%ls` conversions, which can fail if no multibyte representation is available for the given character. - a newly-allocated string holding the result @@ -51011,7 +48908,6 @@ representation is available for the given character. See also g_vasprintf(), which offers the same functionality, but additionally returns the length of the allocated string. - a newly-allocated string holding the result @@ -51033,7 +48929,6 @@ additionally returns the length of the allocated string. the new array should be freed by first freeing each string, then the array itself. g_strfreev() does this for you. If called on a %NULL value, g_strdupv() simply returns %NULL. - a new %NULL-terminated array of strings. @@ -51066,7 +48961,6 @@ as soon as the call returns: g_strerror (saved_errno); ]| - a UTF-8 string describing the error code. If the error code is unknown, it returns a string like "unknown error (<code>)". @@ -51089,7 +48983,6 @@ replaced with a '\' followed by their octal representation. Characters supplied in @exceptions are not escaped. g_strcompress() does the reverse conversion. - a newly-allocated copy of @source with certain characters escaped. See above. @@ -51111,7 +49004,6 @@ g_strcompress() does the reverse conversion. string it contains. If @str_array is %NULL, this function simply returns. - @@ -51148,7 +49040,6 @@ not possible to free individual strings. Creates a new #GString, initialized with the given string. - the new #GString @@ -51169,7 +49060,6 @@ and can contain embedded nul bytes. Since this function does not stop at nul bytes, it is the caller's responsibility to ensure that @init has at least @len addressable bytes. - a new #GString @@ -51190,7 +49080,6 @@ bytes. bytes. This is useful if you are going to add a lot of text to the string and don't want it to be reallocated too often. - the new #GString @@ -51251,7 +49140,6 @@ and a guaranteed nul terminator. An auxiliary function for gettext() support (see Q_()). - @msgval, unless @msgval is identical to @msgid and contains a '|' character, in which case a pointer to @@ -51273,7 +49161,6 @@ and a guaranteed nul terminator. Joins a number of strings together to form one long string, with the optional @separator inserted between each of them. The returned string should be freed with g_free(). - a newly-allocated string containing all of the strings joined together, with @separator between them @@ -51299,7 +49186,6 @@ should be freed with g_free(). If @str_array has no items, the return value will be an empty string. If @str_array contains a single item, @separator will not appear in the resulting string. - a newly-allocated string containing all of the strings joined together, with @separator between them @@ -51331,7 +49217,6 @@ characters of dest to start with). Caveat: this is supposedly a more secure alternative to strcat() or strncat(), but for real security g_strconcat() is harder to mess up. - size of attempted result, which is MIN (dest_size, strlen (original dest)) + strlen (src), so if retval >= dest_size, @@ -51369,7 +49254,6 @@ returns the size of the attempted result, strlen (src), so if Caveat: strlcpy() is supposedly more secure than strcpy() or strncpy(), but if you really want to avoid screwups, g_strdup() is an even better idea. - length of @src @@ -51408,7 +49292,6 @@ the strings. which only works on ASCII and is not locale-sensitive, and g_utf8_casefold() followed by strcmp() on the resulting strings, which is good for case-insensitive sorting of UTF-8. - 0 if the strings match, a negative value if @s1 < @s2, or a positive value if @s1 > @s2. @@ -51438,7 +49321,6 @@ needed. To copy a number of characters from a UTF-8 encoded string, use g_utf8_strncpy() instead. - a newly-allocated buffer containing the first @n bytes of @str, nul-terminated @@ -51458,7 +49340,6 @@ use g_utf8_strncpy() instead. Creates a new string @length bytes long filled with @fill_char. The returned string should be freed when no longer needed. - a newly-allocated string filled the @fill_char @@ -51481,7 +49362,6 @@ The returned string should be freed when no longer needed. Note that g_strreverse() doesn't work on UTF-8 strings containing multibyte characters. For that purpose, use g_utf8_strreverse(). - the same pointer passed in as @string @@ -51496,7 +49376,6 @@ g_utf8_strreverse(). Searches the string @haystack for the last occurrence of the string @needle. - a pointer to the found occurrence, or %NULL if not found. @@ -51517,7 +49396,6 @@ of the string @needle. Searches the string @haystack for the last occurrence of the string @needle, limiting the length of the search to @haystack_len. - a pointer to the found occurrence, or %NULL if not found. @@ -51543,7 +49421,6 @@ to @haystack_len. You should use this function in preference to strsignal(), because it returns a string in UTF-8 encoding, and since not all platforms support the strsignal() function. - a UTF-8 string describing the signal. If the signal is unknown, it returns "unknown signal (<signum>)". @@ -51571,7 +49448,6 @@ special case is that being able to represent an empty vector is typically more useful than consistent handling of empty elements. If you do need to represent empty elements, you'll need to check for the empty string before calling g_strsplit(). - a newly-allocated %NULL-terminated array of strings. Use g_strfreev() to free it. @@ -51619,7 +49495,6 @@ before calling g_strsplit_set(). Note that this function works on bytes not characters, so it can't be used to delimit UTF-8 strings for anything but ASCII characters. - a newly-allocated %NULL-terminated array of strings. Use g_strfreev() to free it. @@ -51649,7 +49524,6 @@ to delimit UTF-8 strings for anything but ASCII characters. Searches the string @haystack for the first occurrence of the string @needle, limiting the length of the search to @haystack_len. - a pointer to the found occurrence, or %NULL if not found. @@ -51675,7 +49549,6 @@ to @haystack_len. Removes leading and trailing whitespace from a string. See g_strchomp() and g_strchug(). - a string to remove the leading and trailing whitespace from @@ -51694,7 +49567,6 @@ you know that you must expect both locale formatted and C formatted numbers should you use this. Make sure that you don't pass strings such as comma separated lists of values, since the commas may be interpreted as a decimal point in some locales, causing unexpected results. - the #gdouble value. @@ -51716,7 +49588,6 @@ point in some locales, causing unexpected results. This function is totally broken for the reasons discussed in the g_strncasecmp() docs - use g_ascii_strup() or g_utf8_strup() instead. - the string @@ -51730,7 +49601,6 @@ point in some locales, causing unexpected results. Checks if @strv contains @str. @strv must not be %NULL. - %TRUE if @str is an element of @strv, according to g_str_equal(). @@ -51753,7 +49623,6 @@ of order, sort the arrays first (using g_qsort_with_data() or similar). Two empty arrays are considered equal. Neither @strv1 not @strv2 may be %NULL. - %TRUE if @strv1 and @strv2 are equal @@ -51770,7 +49639,6 @@ Two empty arrays are considered equal. Neither @strv1 not @strv2 may be - @@ -51778,7 +49646,6 @@ Two empty arrays are considered equal. Neither @strv1 not @strv2 may be Returns the length of the given %NULL-terminated string array @str_array. @str_array must not be %NULL. - length of @str_array. @@ -51798,7 +49665,6 @@ similar to g_test_create_case(). g_test_add() is implemented as a macro, so that the fsetup(), ftest() and fteardown() callbacks can expect a @Fixture pointer as their first argument in a type safe manner. They otherwise have type #GTestFixtureFunc. - The test path for a new test case. @@ -51834,7 +49700,6 @@ required via the `-p` command-line option or g_test_trap_subprocess(). No component of @testpath may start with a dot (`.`) if the %G_TEST_OPTION_ISOLATE_DIRS option is being used; and it is recommended to do so even if it isn’t. - @@ -51856,7 +49721,6 @@ do so even if it isn’t. Create a new test case, as with g_test_add_data_func(), but freeing @test_data after the test run is complete. - @@ -51892,7 +49756,6 @@ required via the `-p` command-line option or g_test_trap_subprocess(). No component of @testpath may start with a dot (`.`) if the %G_TEST_OPTION_ISOLATE_DIRS option is being used; and it is recommended to do so even if it isn’t. - @@ -51908,7 +49771,6 @@ do so even if it isn’t. - @@ -51934,7 +49796,6 @@ do so even if it isn’t. - @@ -51962,7 +49823,6 @@ assumed to be the empty string, so a full URI can be provided to g_test_bug() instead. See also: g_test_summary() - @@ -51988,7 +49848,6 @@ portion to @uri_pattern, or by replacing the special string If g_test_bug_base() is not called, bug URIs are formed solely from the value provided by g_test_bug(). - @@ -52022,7 +49881,6 @@ This allows for casual running of tests directly from the commandline in the srcdir == builddir case and should also support running of installed tests, assuming the data files have been installed in the same relative path as the test binary. - the path of the file, to be freed using g_free() @@ -52060,7 +49918,6 @@ fixture teardown is most useful if the same fixture type is used for multiple tests. In this cases, g_test_create_case() will be called with the same type of fixture (the @data_size argument), but varying @test_name and @data_test arguments. - a newly allocated #GTestCase. @@ -52094,7 +49951,6 @@ called with the same type of fixture (the @data_size argument), but varying Create a new test suite with the name @suite_name. - A newly allocated #GTestSuite instance. @@ -52141,7 +49997,6 @@ abort; use g_test_trap_subprocess() in this case. If messages at %G_LOG_LEVEL_DEBUG are emitted, but not explicitly expected via g_test_expect_message() then they will be ignored. - @@ -52174,7 +50029,6 @@ produce additional diagnostic messages or even continue running the test. If not called from inside a test, this function does nothing. - @@ -52190,7 +50044,6 @@ continuing after a failed assertion might be harmful. The return value of this function is only meaningful if it is called from inside a test function. - %TRUE if the test has failed @@ -52202,7 +50055,6 @@ specified by @file_type. This is approximately the same as calling g_test_build_filename("."), but you don't need to free the return value. - the path of the directory, owned by GLib @@ -52227,7 +50079,6 @@ It is safe to use this function from a thread inside of a testcase but you must ensure that all such uses occur before the main testcase function returns (ie: it is best to ensure that all threads have been joined). - the path, automatically freed at the end of the testcase @@ -52249,7 +50100,6 @@ joined). Get the toplevel test suite for the test path API. - the toplevel #GTestSuite @@ -52266,7 +50116,6 @@ produce additional diagnostic messages or even continue running the test. If not called from inside a test, this function does nothing. - @@ -52323,7 +50172,6 @@ g_test_init() will print an error and exit. This is to prevent no-op tests from being executed, as g_assert() is commonly (erroneously) used in unit tests, and is a no-op when compiled with `G_DISABLE_ASSERT`. Ensure your tests are compiled without `G_DISABLE_ASSERT` defined. - @@ -52366,7 +50214,6 @@ g_log_structured() or g_log_structured_array()). To change the fatal behaviour for specific log messages, programs must install a custom log writer function using g_log_set_writer_func().See [Using Structured Logging][using-structured-logging]. - @@ -52382,7 +50229,6 @@ writer function using g_log_set_writer_func().See - @@ -52398,7 +50244,6 @@ The test should generally strive to maximize the reported quantities (larger values are better than smaller ones), this and @maximized_quantity can determine sorting order for test result reports. - @@ -52419,7 +50264,6 @@ order for test result reports. Add a message to the test report. - @@ -52440,7 +50284,6 @@ The test should generally strive to minimize the reported quantities (smaller values are better than larger ones), this and @minimized_quantity can determine sorting order for test result reports. - @@ -52466,7 +50309,6 @@ to auto destruct allocated test resources at the end of a test run. Resources are released in reverse queue order, that means enqueueing callback A before callback B will cause B() to be called before A() during teardown. - @@ -52485,7 +50327,6 @@ A() during teardown. Enqueue a pointer to be released with g_free() during the next teardown phase. This is equivalent to calling g_test_queue_destroy() with a destroy callback of g_free(). - @@ -52500,7 +50341,6 @@ with a destroy callback of g_free(). Enqueue an object to be released with g_object_unref() during the next teardown phase. This is equivalent to calling g_test_queue_destroy() with a destroy callback of g_object_unref(). - the object to unref @@ -52510,7 +50350,6 @@ g_test_queue_destroy() with a destroy callback of g_object_unref(). Get a reproducible random floating point number, see g_test_rand_int() for details on test case random numbers. - a random number from the seeded random number generator. @@ -52519,7 +50358,6 @@ see g_test_rand_int() for details on test case random numbers. Get a reproducible random floating pointer number out of a specified range, see g_test_rand_int() for details on test case random numbers. - a number with @range_start <= number < @range_end. @@ -52545,7 +50383,6 @@ given when starting test programs. For individual test cases however, the random number generator is reseeded, to avoid dependencies between tests and to make --seed effective for all test cases. - a random number from the seeded random number generator. @@ -52554,7 +50391,6 @@ effective for all test cases. Get a reproducible random integer number out of a specified range, see g_test_rand_int() for details on test case random numbers. - a number with @begin <= number < @end. @@ -52603,7 +50439,6 @@ g_test_add(), which lets you specify setup and teardown functions. If all tests are skipped or marked as incomplete (expected failures), this function will return 0 if producing TAP output, or 77 (treated as "skip test" by Automake) otherwise. - 0 on success, 1 on failure (assuming it returns at all), 0 or 77 if all tests were skipped with g_test_skip() and/or @@ -52620,7 +50455,6 @@ information on the order that tests are run in. g_test_run_suite() or g_test_run() may only be called once in a program. - 0 on success @@ -52644,7 +50478,6 @@ Note that the g_assert_not_reached() and g_assert() macros are not affected by this. This function can only be called after g_test_init(). - @@ -52658,7 +50491,6 @@ produce additional diagnostic messages or even continue running the test. If not called from inside a test, this function does nothing. - @@ -52672,7 +50504,6 @@ If not called from inside a test, this function does nothing. Returns %TRUE (after g_test_init() has been called) if the test program is running under g_test_trap_subprocess(). - %TRUE if the test program is running under g_test_trap_subprocess(). @@ -52700,7 +50531,6 @@ test_array_sort (void) ]| See also: g_test_bug() - @@ -52714,7 +50544,6 @@ See also: g_test_bug() Get the time since the last start of the timer with g_test_timer_start(). - the time since the last start of the timer, as a double @@ -52722,7 +50551,6 @@ See also: g_test_bug() Report the last result of g_test_timer_elapsed(). - the last result of g_test_timer_elapsed(), as a double @@ -52731,7 +50559,6 @@ See also: g_test_bug() Start a timing test. Call g_test_timer_elapsed() when the task is supposed to be done. Call this function again to restart the timer. - @@ -52746,7 +50573,6 @@ g_assert() or g_error(). In these situations you should skip the entire test, including the call to g_test_trap_subprocess(), unless g_test_undefined() returns %TRUE to indicate that undefined behaviour may be tested. - a glob-style [pattern][glib-Glob-style-pattern-matching] @@ -52756,7 +50582,6 @@ behaviour may be tested. Assert that the stderr output of the last test subprocess does not match @serrpattern. See g_test_trap_subprocess(). - a glob-style [pattern][glib-Glob-style-pattern-matching] @@ -52766,7 +50591,6 @@ does not match @serrpattern. See g_test_trap_subprocess(). Assert that the stdout output of the last test subprocess matches @soutpattern. See g_test_trap_subprocess(). - a glob-style [pattern][glib-Glob-style-pattern-matching] @@ -52776,7 +50600,6 @@ does not match @serrpattern. See g_test_trap_subprocess(). Assert that the stdout output of the last test subprocess does not match @soutpattern. See g_test_trap_subprocess(). - a glob-style [pattern][glib-Glob-style-pattern-matching] @@ -52784,7 +50607,6 @@ does not match @soutpattern. See g_test_trap_subprocess(). - @@ -52841,7 +50663,6 @@ termination and validates child program outputs. This function is implemented only on Unix platforms, and is not always reliable due to problems inherent in fork-without-exec. Use g_test_trap_subprocess() instead. - %TRUE for the forked child and %FALSE for the executing parent process. @@ -52859,7 +50680,6 @@ fork-without-exec. Use g_test_trap_subprocess() instead. Check the result of the last g_test_trap_subprocess() call. - %TRUE if the last test subprocess terminated successfully. @@ -52867,7 +50687,6 @@ fork-without-exec. Use g_test_trap_subprocess() instead. Check the result of the last g_test_trap_subprocess() call. - %TRUE if the last test subprocess got killed due to a timeout. @@ -52935,7 +50754,6 @@ message. return g_test_run (); } ]| - @@ -53151,7 +50969,6 @@ You must only call g_thread_exit() from a thread that you created yourself with g_thread_new() or related APIs. You must not call this function from a thread created with another threading library or or from within a #GThreadPool. - @@ -53169,7 +50986,6 @@ being stopped. If this function returns 0, threads waiting in the thread pool for new work are not stopped. - the maximum @interval (milliseconds) to wait for new tasks in the thread pool before stopping the @@ -53179,7 +50995,6 @@ pool for new work are not stopped. Returns the maximal allowed number of unused threads. - the maximal number of unused threads @@ -53187,7 +51002,6 @@ pool for new work are not stopped. Returns the number of currently unused threads. - the number of currently unused threads @@ -53203,7 +51017,6 @@ except this is done on a per thread basis. By setting @interval to 0, idle threads will not be stopped. The default value is 15000 (15 seconds). - @@ -53221,7 +51034,6 @@ If @max_threads is -1, no limit is imposed on the number of unused threads. The default value is 2. - @@ -53236,7 +51048,6 @@ The default value is 2. Stops all currently unused threads. This does not change the maximal number of unused threads. This function can be used to regularly stop all unused threads e.g. from g_timeout_add(). - @@ -53282,7 +51093,6 @@ were not created by GLib (i.e. those created by other threading APIs). This may be useful for thread identification purposes (i.e. comparisons) but you must not use GLib functions (such as g_thread_join()) on these threads. - the #GThread representing the current thread @@ -53293,7 +51103,6 @@ as g_thread_join()) on these threads. that other threads can run. This function is often used as a method to make busy wait less evil. - @@ -53409,7 +51218,6 @@ g_date_time_unref (dt); ]| #GTimeVal is not year-2038-safe. Use g_date_time_new_from_iso8601() instead. - %TRUE if the conversion was successful. @@ -53456,7 +51264,6 @@ It is safe to call this function from any thread. The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). - the ID (greater than 0) of the event source. @@ -53502,7 +51309,6 @@ use a custom main context. The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). - the ID (greater than 0) of the event source. @@ -53554,7 +51360,6 @@ on how to handle the return value and memory management of @data. The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). - the ID (greater than 0) of the event source. @@ -53613,7 +51418,6 @@ It is safe to call this function from any thread. The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). - the ID (greater than 0) of the event source. @@ -53651,7 +51455,6 @@ executed. The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). - the newly-created timeout source @@ -53675,7 +51478,6 @@ in seconds. The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). - the newly-created timeout source @@ -53740,7 +51542,6 @@ extra pieces of memory, free() them and allocate them again later. Note that execution of this function is of O(N) complexity where N denotes the number of items on the stack. #GTrashStack is deprecated without replacement - the height of the stack @@ -53756,7 +51557,6 @@ where N denotes the number of items on the stack. Returns the element at the top of a #GTrashStack which may be %NULL. #GTrashStack is deprecated without replacement - the element at the top of the stack @@ -53771,7 +51571,6 @@ which may be %NULL. Pops a piece of memory off a #GTrashStack. #GTrashStack is deprecated without replacement - the element at the top of the stack @@ -53786,7 +51585,6 @@ which may be %NULL. Pushes a piece of memory onto a #GTrashStack. #GTrashStack is deprecated without replacement - @@ -53862,7 +51660,6 @@ g_node_destroy(). Attempts to allocate @n_bytes, and returns %NULL on failure. Contrast with g_malloc(), which aborts the program on failure. - the allocated memory, or %NULL. @@ -53877,7 +51674,6 @@ Contrast with g_malloc(), which aborts the program on failure. Attempts to allocate @n_bytes, initialized to 0's, and returns %NULL on failure. Contrast with g_malloc0(), which aborts the program on failure. - the allocated memory, or %NULL @@ -53892,7 +51688,6 @@ failure. Contrast with g_malloc0(), which aborts the program on failure. This function is similar to g_try_malloc0(), allocating (@n_blocks * @n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. - the allocated memory, or %NULL @@ -53911,7 +51706,6 @@ but care is taken to detect possible overflow during multiplication. This function is similar to g_try_malloc(), allocating (@n_blocks * @n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. - the allocated memory, or %NULL. @@ -53932,7 +51726,6 @@ but care is taken to detect possible overflow during multiplication. %NULL on failure. Contrast with g_new(), which aborts the program on failure. The returned pointer is cast to a pointer to the given type. The function returns %NULL when @n_structs is 0 of if an overflow occurs. - the type of the elements to allocate @@ -53948,7 +51741,6 @@ to 0's, and returns %NULL on failure. Contrast with g_new0(), which aborts the program on failure. The returned pointer is cast to a pointer to the given type. The function returns %NULL when @n_structs is 0 or if an overflow occurs. - the type of the elements to allocate @@ -53964,7 +51756,6 @@ on failure. Contrast with g_realloc(), which aborts the program on failure. If @mem is %NULL, behaves the same as g_try_malloc(). - the allocated memory, or %NULL. @@ -53983,7 +51774,6 @@ If @mem is %NULL, behaves the same as g_try_malloc(). This function is similar to g_try_realloc(), allocating (@n_blocks * @n_block_bytes) bytes, but care is taken to detect possible overflow during multiplication. - the allocated memory, or %NULL. @@ -54009,7 +51799,6 @@ space for @n_structs elements of type @struct_type, and returns %NULL on failure. Contrast with g_renew(), which aborts the program on failure. It returns the new address of the memory, which may have been moved. The function returns %NULL if an overflow occurs. - the type of the elements to allocate @@ -54089,7 +51878,6 @@ any C99 compatible printf() implementation. Convert a string from UCS-4 to UTF-16. A 0 character will be added to the result after the converted text. - a pointer to a newly allocated UTF-16 string. This value must be freed with g_free(). If an error occurs, @@ -54123,7 +51911,6 @@ added to the result after the converted text. Convert a string from a 32-bit fixed width representation as UCS-4. to UTF-8. The result will be terminated with a 0 byte. - a pointer to a newly allocated UTF-8 string. This value must be freed with g_free(). If an error occurs, @@ -54161,7 +51948,6 @@ to UTF-8. The result will be terminated with a 0 byte. If the operation is successful, %TRUE is returned. If the operation overflows then the state of @dest is undefined and %FALSE is returned. - a pointer to the #guint64 destination @@ -54181,7 +51967,6 @@ returned. If the operation is successful, %TRUE is returned. If the operation overflows then the state of @dest is undefined and %FALSE is returned. - a pointer to the #guint64 destination @@ -54201,7 +51986,6 @@ returned. If the operation is successful, %TRUE is returned. If the operation overflows then the state of @dest is undefined and %FALSE is returned. - a pointer to the #guint destination @@ -54221,7 +52005,6 @@ returned. If the operation is successful, %TRUE is returned. If the operation overflows then the state of @dest is undefined and %FALSE is returned. - a pointer to the #guint destination @@ -54241,7 +52024,6 @@ g_utf8_get_char()). The break type is used to find word and line breaks ("text boundaries"), Pango implements the Unicode boundary resolution algorithms and normally you would use a function such as pango_break() instead of caring about break types yourself. - the break type of @c @@ -54255,7 +52037,6 @@ as pango_break() instead of caring about break types yourself. Determines the canonical combining class of a Unicode character. - the combining class of the character @@ -54284,7 +52065,6 @@ If @a and @b do not compose a new character, @ch is set to zero. See [UAX#15](http://unicode.org/reports/tr15/) for details. - %TRUE if the characters could be composed @@ -54328,7 +52108,6 @@ g_unichar_fully_decompose(). See [UAX#15](http://unicode.org/reports/tr15/) for details. - %TRUE if the character could be decomposed @@ -54351,7 +52130,6 @@ for details. Determines the numeric value of a character as a decimal digit. - If @c is a decimal digit (according to g_unichar_isdigit()), its numeric value. Otherwise, -1. @@ -54384,7 +52162,6 @@ as %G_UNICHAR_MAX_DECOMPOSITION_LENGTH. See [UAX#15](http://unicode.org/reports/tr15/) for details. - the length of the full decomposition. @@ -54418,7 +52195,6 @@ If @ch has the Unicode mirrored property and there is another unicode character that typically has a glyph that is the mirror image of @ch's glyph and @mirrored_ch is set, it puts that character in the address pointed to by @mirrored_ch. Otherwise the original character is put. - %TRUE if @ch has a mirrored character, %FALSE otherwise @@ -54442,7 +52218,6 @@ result is undefined. This function is equivalent to pango_script_for_unichar() and the two are interchangeable. - the #GUnicodeScript for the character. @@ -54458,7 +52233,6 @@ two are interchangeable. Determines whether a character is alphanumeric. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is an alphanumeric character @@ -54474,7 +52248,6 @@ with g_utf8_get_char(). Determines whether a character is alphabetic (i.e. a letter). Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is an alphabetic character @@ -54490,7 +52263,6 @@ g_utf8_get_char(). Determines whether a character is a control character. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is a control character @@ -54505,7 +52277,6 @@ g_utf8_get_char(). Determines if a given character is assigned in the Unicode standard. - %TRUE if the character has an assigned value @@ -54521,7 +52292,6 @@ standard. Determines whether a character is numeric (i.e. a digit). This covers ASCII 0-9 and also digits in other languages/scripts. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is a digit @@ -54539,7 +52309,6 @@ some UTF-8 text, obtain a character value with g_utf8_get_char(). spaces). g_unichar_isprint() is similar, but returns %TRUE for spaces. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is printable unless it's a space @@ -54555,7 +52324,6 @@ g_utf8_get_char(). Determines whether a character is a lowercase letter. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is a lowercase letter @@ -54577,7 +52345,6 @@ Note: in most cases where isalpha characters are allowed, ismark characters should be allowed to as they are essential for writing most European languages as well as many non-Latin scripts. - %TRUE if @c is a mark character @@ -54594,7 +52361,6 @@ scripts. Unlike g_unichar_isgraph(), returns %TRUE for spaces. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is printable @@ -54610,7 +52376,6 @@ g_utf8_get_char(). Determines whether a character is punctuation or a symbol. Given some UTF-8 text, obtain a character value with g_utf8_get_char(). - %TRUE if @c is a punctuation or symbol character @@ -54630,7 +52395,6 @@ character value with g_utf8_get_char(). (Note: don't use this to do word breaking; you have to use Pango or equivalent to get word breaking right, the algorithm is fairly complex.) - %TRUE if @c is a space character @@ -54649,7 +52413,6 @@ have three case variants instead of just two. The titlecase form is used at the beginning of a word where only the first letter is capitalized. The titlecase form of the DZ digraph is U+01F2 LATIN CAPITAL LETTTER D WITH SMALL LETTER Z. - %TRUE if the character is titlecase @@ -54663,7 +52426,6 @@ digraph is U+01F2 LATIN CAPITAL LETTTER D WITH SMALL LETTER Z. Determines if a character is uppercase. - %TRUE if @c is an uppercase character @@ -54678,7 +52440,6 @@ digraph is U+01F2 LATIN CAPITAL LETTTER D WITH SMALL LETTER Z. Determines if a character is typically rendered in a double-width cell. - %TRUE if the character is wide @@ -54701,7 +52462,6 @@ for details. If a character passes the g_unichar_iswide() test then it will also pass this test, but not the other way around. Note that some characters may pass both this test and g_unichar_iszerowidth(). - %TRUE if the character is wide in legacy East Asian locales @@ -54715,7 +52475,6 @@ pass both this test and g_unichar_iszerowidth(). Determines if a character is a hexadecimal digit. - %TRUE if the character is a hexadecimal digit @@ -54737,7 +52496,6 @@ A typical use of this function is with one of g_unichar_iswide() or g_unichar_iswide_cjk() to determine the number of cells a string occupies when displayed on a grid display (terminals). However, note that not all terminals support zero-width rendering of zero-width marks. - %TRUE if the character has zero width @@ -54751,7 +52509,6 @@ terminals support zero-width rendering of zero-width marks. Converts a single character to UTF-8. - number of bytes written @@ -54771,7 +52528,6 @@ terminals support zero-width rendering of zero-width marks. Converts a character to lower case. - the result of converting @c to lower case. If @c is not an upperlower or titlecase character, @@ -54787,7 +52543,6 @@ terminals support zero-width rendering of zero-width marks. Converts a character to the titlecase. - the result of converting @c to titlecase. If @c is not an uppercase or lowercase character, @@ -54803,7 +52558,6 @@ terminals support zero-width rendering of zero-width marks. Converts a character to uppercase. - the result of converting @c to uppercase. If @c is not a lowercase or titlecase character, @@ -54819,7 +52573,6 @@ terminals support zero-width rendering of zero-width marks. Classifies a Unicode character by type. - the type of the character. @@ -54835,7 +52588,6 @@ terminals support zero-width rendering of zero-width marks. Checks whether @ch is a valid Unicode character. Some possible integer values of @ch will not be valid. 0 is considered a valid character, though it's normally a string terminator. - %TRUE if @ch is a valid Unicode character @@ -54850,7 +52602,6 @@ character, though it's normally a string terminator. Determines the numeric value of a character as a hexadecimal digit. - If @c is a hex digit (according to g_unichar_isxdigit()), its numeric value. Otherwise, -1. @@ -54897,7 +52648,6 @@ on the Unicode Character Data tables, which are available from Computes the canonical decomposition of a Unicode character. Use the more flexible g_unichar_fully_decompose() instead. - a newly allocated string of Unicode characters. @result_len is set to the resulting length of the string. @@ -54919,7 +52669,6 @@ on the Unicode Character Data tables, which are available from This rearranges decomposed characters in the string according to their combining classes. See the Unicode manual for more information. - @@ -54944,7 +52693,6 @@ big-endian fashion. That is, the code expected for Arabic is See [Codes for the representation of names of scripts](http://unicode.org/iso15924/codelists.html) for details. - the Unicode script for @iso15924, or of %G_UNICODE_SCRIPT_INVALID_CODE if @iso15924 is zero and @@ -54968,7 +52716,6 @@ big-endian fashion. That is, the code returned for Arabic is See [Codes for the representation of names of scripts](http://unicode.org/iso15924/codelists.html) for details. - the ISO 15924 code for @script, encoded as an integer, of zero if @script is %G_UNICODE_SCRIPT_INVALID_CODE or @@ -55001,7 +52748,6 @@ The return value of this function can be passed to g_source_remove() to cancel the watch at any time that it exists. The source will never close the fd -- you must do it yourself. - the ID (greater than 0) of the event source @@ -55032,7 +52778,6 @@ The source will never close the fd -- you must do it yourself. This is the same as g_unix_fd_add(), except that it allows you to specify a non-default priority and a provide a #GDestroyNotify for @user_data. - the ID (greater than 0) of the event source @@ -55069,7 +52814,6 @@ specify a non-default priority and a provide a #GDestroyNotify for descriptor. The source will never close the fd -- you must do it yourself. - the newly created #GSource @@ -55097,7 +52841,6 @@ freed. This function is safe to call from multiple threads concurrently. You will need to include `pwd.h` to get the definition of `struct passwd`. - passwd entry, or %NULL on error; free the returned value with g_free() @@ -55119,7 +52862,6 @@ must still be done separately with fcntl(). This function does not take %O_CLOEXEC, it takes %FD_CLOEXEC as if for fcntl(); these are different on Linux/glibc. - %TRUE on success, %FALSE if not (and errno will be set). @@ -55139,7 +52881,6 @@ for fcntl(); these are different on Linux/glibc. Control the non-blocking state of the given file descriptor, according to @nonblock. On most systems this uses %O_NONBLOCK, but on some older ones may use %O_NDELAY. - %TRUE if successful @@ -55159,7 +52900,6 @@ on some older ones may use %O_NDELAY. A convenience function for g_unix_signal_source_new(), which attaches to the default #GMainContext. You can remove the watch using g_source_remove(). - An ID (greater than 0) for the event source @@ -55183,7 +52923,6 @@ using g_source_remove(). A convenience function for g_unix_signal_source_new(), which attaches to the default #GMainContext. You can remove the watch using g_source_remove(). - An ID (greater than 0) for the event source @@ -55236,7 +52975,6 @@ functions like sigprocmask() is not defined. The source will not initially be associated with any #GMainContext and must be added to one with g_source_attach() before it will be executed. - A newly created #GSource @@ -55257,7 +52995,6 @@ file is freed. See your C library manual for more details about unlink(). Note that on Windows, it is in general not possible to delete files that are open to some process, or mapped into memory. - 0 if the name was successfully deleted, -1 if an error occurred @@ -55289,7 +53026,6 @@ If you need to set up the environment for a child process, you can use g_get_environ() to get an environment array, modify that with g_environ_setenv() and g_environ_unsetenv(), and then pass that array directly to execvpe(), g_spawn_async(), or the like. - @@ -55306,7 +53042,6 @@ array directly to execvpe(), g_spawn_async(), or the like. See also g_uri_build_with_user(), which allows specifying the components of the "userinfo" separately. - a new #GUri @@ -55355,7 +53090,6 @@ coherent with the passed values, in particular use `%`-encoded values with In contrast to g_uri_build(), this allows specifying the components of the ‘userinfo’ field separately. Note that @user must be non-%NULL if either @password or @auth_params is non-%NULL. - a new #GUri @@ -55420,7 +53154,6 @@ portions of a URI. Though technically incorrect, this will also allow escaping nul bytes as `%``00`. - an escaped version of @unescaped. The returned string should be freed when no longer needed. @@ -55453,7 +53186,6 @@ escaped. But if you specify characters in @reserved_chars_allowed they are not escaped. This is useful for the "reserved" characters in the URI specification, since those are allowed unescaped in some portions of a URI. - an escaped version of @unescaped. The returned string should be freed when no longer needed. @@ -55484,7 +53216,6 @@ If it’s not a valid URI, an error is returned explaining how it’s See g_uri_split(), and the definition of #GUriFlags, for more information on the effect of @flags. - %TRUE if @uri_string is a valid absolute URI, %FALSE on error. @@ -55515,7 +53246,6 @@ components of the ‘userinfo’ separately. %G_URI_FLAGS_HAS_PASSWORD and %G_URI_FLAGS_HAS_AUTH_PARAMS are ignored if set in @flags. - an absolute URI string @@ -55565,7 +53295,6 @@ of the ‘userinfo’ separately. It otherwise behaves the same. %G_URI_FLAGS_HAS_PASSWORD and %G_URI_FLAGS_HAS_AUTH_PARAMS are ignored if set in @flags. - an absolute URI string @@ -55619,7 +53348,6 @@ in @flags. Splits an URI list conforming to the text/uri-list mime type defined in RFC 2483 into individual URIs, discarding any comments. The URIs are not validated. - a newly allocated %NULL-terminated list of strings holding the individual URIs. The array should be freed @@ -55639,7 +53367,6 @@ discarding any comments. The URIs are not validated. Parses @uri_string according to @flags. If the result is not a valid [absolute URI][relative-absolute-uris], it will be discarded, and an error returned. - a new #GUri. @@ -55680,7 +53407,6 @@ the returned attributes. If @params cannot be parsed (for example, it contains two @separators characters in a row), then @error is set and %NULL is returned. - A hash table of attribute/value pairs, with both names and values fully-decoded; or %NULL @@ -55722,7 +53448,6 @@ as: URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] ]| Common schemes include `file`, `https`, `svn+ssh`, etc. - The ‘scheme’ component of the URI, or %NULL on error. The returned string should be freed when no longer needed. @@ -55746,7 +53471,6 @@ Common schemes include `file`, `https`, `svn+ssh`, etc. Unlike g_uri_parse_scheme(), the returned scheme is normalized to all-lowercase and does not need to be freed. - The ‘scheme’ component of the URI, or %NULL on error. The returned string is normalized to all-lowercase, and @@ -55768,7 +53492,6 @@ discarded, and an error returned. (If @base_uri_string is %NULL, this just returns @uri_ref, or %NULL if @uri_ref is invalid or not absolute.) - the resolved URI string. @@ -55805,7 +53528,6 @@ Note that the %G_URI_FLAGS_HAS_PASSWORD and %G_URI_FLAGS_HAS_AUTH_PARAMS @flags are ignored by g_uri_split(), since it always returns only the full userinfo; use g_uri_split_with_user() if you want it split up. - %TRUE if @uri_ref parsed successfully, %FALSE on error. @@ -55864,7 +53586,6 @@ See the documentation for g_uri_split() for more details; this is mostly a wrapper around that function with simpler arguments. However, it will return an error if @uri_string is a relative URI, or does not contain a hostname component. - %TRUE if @uri_string parsed successfully, %FALSE on error. @@ -55908,7 +53629,6 @@ information on the effect of @flags. Note that @password will only be parsed out if @flags contains %G_URI_FLAGS_HAS_PASSWORD, and @auth_params will only be parsed out if @flags contains %G_URI_FLAGS_HAS_AUTH_PARAMS. - %TRUE if @uri_ref parsed successfully, %FALSE on error. @@ -55981,7 +53701,6 @@ character in @escaped_string, then that is an error and %NULL will be returned. This is useful if you want to avoid for instance having a slash being expanded in an escaped path element, which might confuse pathname handling. - an unescaped version of @escaped_string or %NULL on error (if decoding failed, using %G_URI_ERROR_FAILED error code). The @@ -56016,7 +53735,6 @@ escaped path element, which might confuse pathname handling. Note: `NUL` byte is not accepted in the output, in contrast to g_uri_unescape_bytes(). - an unescaped version of @escaped_string or %NULL on error. The returned string should be freed when no longer needed. As a @@ -56049,7 +53767,6 @@ character appears as an escaped character in @escaped_string, then that is an error and %NULL will be returned. This is useful if you want to avoid for instance having a slash being expanded in an escaped path element, which might confuse pathname handling. - an unescaped version of @escaped_string. The returned string should be freed when no longer needed. @@ -56074,7 +53791,6 @@ There are 1 million microseconds per second (represented by the #G_USEC_PER_SEC macro). g_usleep() may have limited precision, depending on hardware and operating system; don't rely on the exact length of the sleep. - @@ -56088,7 +53804,6 @@ length of the sleep. Convert a string from UTF-16 to UCS-4. The result will be nul-terminated. - a pointer to a newly allocated UCS-4 string. This value must be freed with g_free(). If an error occurs, @@ -56134,7 +53849,6 @@ string; it may e.g. include embedded NUL characters. The only validation done by this function is to ensure that the input can be correctly interpreted as UTF-16, i.e. it doesn't contain things unpaired surrogates. - a pointer to a newly allocated UTF-8 string. This value must be freed with g_free(). If an error occurs, @@ -56178,7 +53892,6 @@ ordering, though it is a fairly good one. Getting this exactly right would require a more sophisticated collation function that takes case sensitivity into account. GLib does not currently provide such a function. - a newly allocated string, that is a case independent form of @str. @@ -56202,7 +53915,6 @@ When sorting a large number of strings, it will be significantly faster to obtain collation keys with g_utf8_collate_key() and compare the keys with strcmp() when sorting instead of sorting the original strings. - < 0 if @str1 compares before @str2, 0 if they compare equal, > 0 if @str1 compares after @str2. @@ -56229,7 +53941,6 @@ with strcmp() will always be the same as comparing the two original keys with g_utf8_collate(). Note that this function depends on the [current locale][setlocale]. - a newly allocated string. This string should be freed with g_free() when you are done with it. @@ -56258,7 +53969,6 @@ would like to treat numbers intelligently so that "file1" "file10" "file5" is sorted as "file1" "file5" "file10". Note that this function depends on the [current locale][setlocale]. - a newly allocated string. This string should be freed with g_free() when you are done with it. @@ -56286,7 +53996,6 @@ If @end is %NULL, the return value will never be %NULL: if the end of the string is reached, a pointer to the terminating nul byte is returned. If @end is non-%NULL, the return value will be %NULL if the end of the string is reached. - a pointer to the found character or %NULL if @end is set and is reached @@ -56312,7 +54021,6 @@ UTF-8 characters are present in @str before @p. @p does not have to be at the beginning of a UTF-8 character. No check is made to see if the character found is actually valid other than it starts with an appropriate byte. - a pointer to the found character or %NULL. @@ -56335,7 +54043,6 @@ If @p does not point to a valid UTF-8 encoded character, results are undefined. If you are not sure that the bytes are complete valid Unicode characters, you should use g_utf8_get_char_validated() instead. - the resulting character @@ -56356,7 +54063,6 @@ overlong encodings of valid characters. Note that g_utf8_get_char_validated() returns (gunichar)-2 if @max_len is positive and any of the bytes in the first UTF-8 character sequence are nul. - the resulting character. If @p points to a partial sequence at the end of a string that could begin a valid @@ -56386,7 +54092,6 @@ a string that was incorrectly declared to be UTF-8, and you need a valid UTF-8 version of it that can be logged or displayed to the user, with the assumption that it is close enough to ASCII or UTF-8 to be mostly readable as-is. - a valid UTF-8 string whose content resembles @str @@ -56410,7 +54115,6 @@ You would use this macro to iterate over a string character by character. The macro returns the start of the next UTF-8 character. Before using this macro, use g_utf8_validate() to validate strings that may contain invalid UTF-8. - Pointer to the start of a valid UTF-8 character @@ -56443,7 +54147,6 @@ than a maximally decomposed form. This is often useful if you intend to convert the string to a legacy encoding or pass it to a system with less capable Unicode handling. - a newly allocated string, that is the normalized form of @str, or %NULL if @str @@ -56479,7 +54182,6 @@ Therefore you should be sure that @offset is within string boundaries before calling that function. Call g_utf8_strlen() when unsure. This limitation exists as this function is called frequently during text rendering and therefore has to be as fast as possible. - the resulting pointer @@ -56501,7 +54203,6 @@ character offset. Since 2.10, this function allows @pos to be before @str, and returns a negative offset in this case. - the resulting character offset @@ -56524,7 +54225,6 @@ a negative offset in this case. is made to see if the character found is actually valid other than it starts with an appropriate byte. If @p might be the first character of the string, you must use g_utf8_find_prev_char() instead. - a pointer to the found character @@ -56540,7 +54240,6 @@ character of the string, you must use g_utf8_find_prev_char() instead. Finds the leftmost occurrence of the given Unicode character in a UTF-8 encoded string, while limiting the search to @len bytes. If @len is -1, allow unbounded search. - %NULL if the string does not contain the character, otherwise, a pointer to the start of the leftmost occurrence @@ -56567,7 +54266,6 @@ If @len is -1, allow unbounded search. to lowercase. The exact manner that this is done depends on the current locale, and may result in the number of characters in the string changing. - a newly allocated string, with all characters converted to lowercase. @@ -56588,7 +54286,6 @@ characters in the string changing. Computes the length of the string in characters, not including the terminating nul character. If the @max'th byte falls in the middle of a character, the last (partial) character is not counted. - the length of the string in characters @@ -56616,7 +54313,6 @@ text before trying to use UTF-8 utility functions with it.) Note you must ensure @dest is at least 4 * @n to fit the largest possible UTF-8 characters - @dest @@ -56640,7 +54336,6 @@ largest possible UTF-8 characters Find the rightmost occurrence of the given Unicode character in a UTF-8 encoded string, while limiting the search to @len bytes. If @len is -1, allow unbounded search. - %NULL if the string does not contain the character, otherwise, a pointer to the start of the rightmost occurrence @@ -56676,7 +54371,6 @@ for display purposes. Note that unlike g_strreverse(), this function returns newly-allocated memory, which should be freed with g_free() when no longer needed. - a newly-allocated string which is the reverse of @str @@ -56699,7 +54393,6 @@ to uppercase. The exact manner that this is done depends on the current locale, and may result in the number of characters in the string increasing. (For instance, the German ess-zet will be changed to SS.) - a newly allocated string, with all characters converted to uppercase. @@ -56719,7 +54412,6 @@ German ess-zet will be changed to SS.) Copies a substring out of a UTF-8 encoded string. The substring will contain @end_pos - @start_pos characters. - a newly allocated copy of the requested substring. Free with g_free() when no longer needed. @@ -56744,7 +54436,6 @@ The substring will contain @end_pos - @start_pos characters. Convert a string from UTF-8 to a 32-bit fixed width representation as UCS-4. A trailing 0 character will be added to the string after the converted text. - a pointer to a newly allocated UCS-4 string. This value must be freed with g_free(). If an error occurs, @@ -56784,7 +54475,6 @@ representation as UCS-4, assuming valid UTF-8 input. This function is roughly twice as fast as g_utf8_to_ucs4() but does no error checking on the input. A trailing 0 character will be added to the string after the converted text. - a pointer to a newly allocated UCS-4 string. This value must be freed with g_free(). @@ -56810,7 +54500,6 @@ will be added to the string after the converted text. Convert a string from UTF-8 to UTF-16. A 0 character will be added to the result after the converted text. - a pointer to a newly allocated UTF-16 string. This value must be freed with g_free(). If an error occurs, @@ -56858,7 +54547,6 @@ Returns %TRUE if all of @str was valid. Many GLib and GTK+ routines require valid UTF-8 as input; so data read from a file or the network should be checked with g_utf8_validate() before doing anything else with it. - %TRUE if the text was valid UTF-8 @@ -56885,7 +54573,6 @@ doing anything else with it. As with g_utf8_validate(), but @max_len must be set, and hence this function will always return %FALSE if any of the bytes of @str are nul. - %TRUE if the text was valid UTF-8 @@ -56931,7 +54618,6 @@ The function accepts the following syntax: Note that hyphens are required within the UUID string itself, as per the aforementioned RFC. - %TRUE if @str is a valid UUID, %FALSE otherwise. @@ -56947,14 +54633,12 @@ as per the aforementioned RFC. Generates a random UUID (RFC 4122 version 4) as a string. It has the same randomness guarantees as #GRand, so must not be used for cryptographic purposes such as key generation, nonces, salts or one-time pads. - A string that should be freed with g_free(). - @@ -56968,7 +54652,6 @@ A valid object path starts with `/` followed by zero or more sequences of characters separated by `/` characters. Each sequence must contain only the characters `[A-Z][a-z][0-9]_`. No sequence (including the one following the final `/` character) may be empty. - %TRUE if @string is a D-Bus object path @@ -56987,7 +54670,6 @@ passing it to g_variant_new_signature(). D-Bus type signatures consist of zero or more definite #GVariantType strings in sequence. - %TRUE if @string is a D-Bus type signature @@ -57035,7 +54717,6 @@ produced by g_variant_print()". There may be implementation specific restrictions on deeply nested values, which would result in a %G_VARIANT_PARSE_ERROR_RECURSION error. #GVariant is guaranteed to handle nesting up to at least 64 levels. - a non-floating reference to a #GVariant, or %NULL @@ -57089,7 +54770,6 @@ The format of the message may change in a future version. If @source_str was not nul-terminated when you passed it to g_variant_parse() then you must add nul termination before using this function. - the printed message @@ -57118,7 +54798,6 @@ function. - @@ -57129,7 +54808,6 @@ function. - @@ -57143,7 +54821,6 @@ function. Checks if @type_string is a valid GVariant type string. This call is equivalent to calling g_variant_type_string_scan() and confirming that the following character is a nul terminator. - %TRUE if @type_string is exactly one valid type string @@ -57171,7 +54848,6 @@ string does not end before @limit then %FALSE is returned. For the simple case of checking if a string is a valid type string, see g_variant_type_string_is_valid(). - %TRUE if a valid type string was found @@ -57203,7 +54879,6 @@ The returned value in @string is guaranteed to be non-NULL, unless multibyte representation is available for the given character. `glib/gprintf.h` must be explicitly included in order to use this function. - the number of bytes printed. @@ -57246,7 +54921,6 @@ GLib whose API you want to use. positional parameters, as specified in the Single Unix Specification. `glib/gprintf.h` must be explicitly included in order to use this function. - the number of bytes printed. @@ -57272,7 +54946,6 @@ positional parameters, as specified in the Single Unix Specification. positional parameters, as specified in the Single Unix Specification. `glib/gprintf.h` must be explicitly included in order to use this function. - the number of bytes printed. @@ -57307,7 +54980,6 @@ vsnprintf(), which returns the length of the output string. The format string may contain positional parameters, as specified in the Single Unix Specification. - the number of bytes which would be produced if the buffer was large enough. @@ -57339,7 +55011,6 @@ the Single Unix Specification. positional parameters, as specified in the Single Unix Specification. `glib/gprintf.h` must be explicitly included in order to use this function. - the number of bytes printed. @@ -57362,7 +55033,6 @@ positional parameters, as specified in the Single Unix Specification. Logs a warning if the expression is not true. - the expression to check @@ -57372,7 +55042,6 @@ positional parameters, as specified in the Single Unix Specification. Internal function used to print messages from the public g_warn_if_reached() and g_warn_if_fail() macros. - diff --git a/gir-files/GModule-2.0.gir b/gir-files/GModule-2.0.gir index 28d054622..1d85fab92 100644 --- a/gir-files/GModule-2.0.gir +++ b/gir-files/GModule-2.0.gir @@ -11,10 +11,8 @@ and/or use gtk-doc annotations. --> The #GModule struct is an opaque data structure to represent a [dynamically-loaded module][glib-Dynamic-Loading-of-Modules]. It should only be accessed via the following functions. - Closes a module. - %TRUE on success @@ -29,7 +27,6 @@ It should only be accessed via the following functions. Ensures that a module will never be unloaded. Any future g_module_close() calls on the module will be ignored. - @@ -44,7 +41,6 @@ Any future g_module_close() calls on the module will be ignored. Returns the filename that the module was opened with. If @module refers to the application itself, "main" is returned. - the filename of the module @@ -59,7 +55,6 @@ If @module refers to the application itself, "main" is returned. Gets a symbol pointer from a module, such as one exported by #G_MODULE_EXPORT. Note that a valid symbol can be %NULL. - %TRUE on success @@ -93,7 +88,6 @@ For example, calling g_module_build_path() on a Linux system with a @directory of `/lib` and a @module_name of "mylibrary" will return `/lib/libmylibrary.so`. On a Windows system, using `\Windows` as the directory it will return `\Windows\mylibrary.dll`. - the complete path of the module, including the standard library prefix and suffix. This should be freed when no longer needed @@ -114,7 +108,6 @@ directory it will return `\Windows\mylibrary.dll`. Gets a string describing the last module error. - a string describing the last module error @@ -133,7 +126,6 @@ module will be opened. If that fails and @file_name doesn't have the ".la"-suffix, this suffix is appended and g_module_open() tries to open the corresponding module. If eventually that fails as well, %NULL is returned. - a #GModule on success, or %NULL on failure @@ -153,7 +145,6 @@ returned. Checks if modules are supported on the current platform. - %TRUE if modules are supported @@ -166,7 +157,6 @@ If a module contains a function named g_module_check_init() it is called automatically when the module is loaded. It is passed the #GModule structure and should return %NULL on success or a string describing the initialization error. - %NULL on success, or a string describing the initialization error @@ -181,7 +171,6 @@ error. Flags passed to g_module_open(). Note that these flags are not supported on all platforms. - specifies that symbols are only resolved when needed. The default action is to bind all symbols when the module @@ -202,7 +191,6 @@ Note that these flags are not supported on all platforms. If a module contains a function named g_module_unload() it is called automatically when the module is unloaded. It is passed the #GModule structure. - @@ -227,7 +215,6 @@ For example, calling g_module_build_path() on a Linux system with a @directory of `/lib` and a @module_name of "mylibrary" will return `/lib/libmylibrary.so`. On a Windows system, using `\Windows` as the directory it will return `\Windows\mylibrary.dll`. - the complete path of the module, including the standard library prefix and suffix. This should be freed when no longer needed @@ -248,7 +235,6 @@ directory it will return `\Windows\mylibrary.dll`. Gets a string describing the last module error. - a string describing the last module error @@ -256,7 +242,6 @@ directory it will return `\Windows\mylibrary.dll`. Checks if modules are supported on the current platform. - %TRUE if modules are supported diff --git a/gir-files/GObject-2.0.gir b/gir-files/GObject-2.0.gir index c13b8bc9c..d11ba2c43 100644 --- a/gir-files/GObject-2.0.gir +++ b/gir-files/GObject-2.0.gir @@ -13,20 +13,17 @@ arrays of parameter values to signal emissions into C language callback invocations. It is merely an alias to #GClosureMarshal since the #GClosure mechanism takes over responsibility of actual function invocation for the signal system. - This is the signature of va_list marshaller functions, an optional marshaller that can be used in some situations to avoid marshalling the signal argument into GValues. - A numerical value which represents the unique identifier of a registered type. - @@ -89,7 +86,6 @@ name of the form `TypeNamePrivate`. It is safe to call the `_get_instance_private` function on %NULL or invalid objects since it's only adding an offset to the instance pointer. In that case the returned pointer must not be dereferenced. - the name of the type in CamelCase @@ -104,7 +100,6 @@ G_ADD_PRIVATE() for details, it is similar but for static types. Note that this macro can only be used together with the G_DEFINE_DYNAMIC_TYPE_EXTENDED macros, since it depends on variable names from that macro. - the name of the type in CamelCase @@ -112,7 +107,6 @@ names from that macro. - @@ -124,7 +118,6 @@ of a derived types class structure that were setup from the corresponding GBaseInitFunc() function. Class finalization basically works the inverse way in which class initialization is performed. See GClassInitFunc() for a discussion of the class initialization process. - @@ -144,7 +137,6 @@ For example, class members (such as strings) that are not sufficiently handled by a plain memory copy of the parent class into the derived class have to be altered. See GClassInitFunc() for a discussion of the class initialization process. - @@ -235,7 +227,6 @@ binding, source, and target instances to drop. #GBinding is available since GObject 2.26 Retrieves the flags passed when constructing the #GBinding. - the #GBindingFlags used by the #GBinding @@ -249,7 +240,6 @@ binding, source, and target instances to drop. Retrieves the #GObject instance used as the source of the binding. - the source #GObject @@ -264,7 +254,6 @@ binding, source, and target instances to drop. Retrieves the name of the property of #GBinding:source used as the source of the binding. - the name of the source property @@ -278,7 +267,6 @@ of the binding. Retrieves the #GObject instance used as the target of the binding. - the target #GObject @@ -293,7 +281,6 @@ of the binding. Retrieves the name of the property of #GBinding:target used as the target of the binding. - the name of the target property @@ -313,7 +300,6 @@ This function will release the reference that is being held on the @binding instance; if you want to hold on to the #GBinding instance after calling g_binding_unbind(), you will need to hold a reference to it. - @@ -387,7 +373,6 @@ is the @source_property on the @source object, and @to_value is the @target_property on the @target object. If this is the @transform_from function of a %G_BINDING_BIDIRECTIONAL binding, then those roles are reversed. - %TRUE if the transformation was successful, and %FALSE otherwise @@ -415,7 +400,6 @@ then those roles are reversed. This function is provided by the user and should produce a copy of the passed in boxed structure. - The newly created copy of the boxed structure. @@ -430,7 +414,6 @@ of the passed in boxed structure. This function is provided by the user and should free the boxed structure passed. - @@ -443,7 +426,6 @@ structure passed. Cast a function pointer to a #GCallback. - a function pointer. @@ -453,7 +435,6 @@ structure passed. Checks whether the user data of the #GCClosure should be passed as the first parameter to the callback. See g_cclosure_new_swap(). - a #GCClosure @@ -462,7 +443,6 @@ first parameter to the callback. See g_cclosure_new_swap(). A #GCClosure is a specialization of #GClosure for C function callbacks. - the #GClosure @@ -476,7 +456,6 @@ first parameter to the callback. See g_cclosure_new_swap(). take two boxed pointers as arguments and return a boolean. If you have such a signal, you will probably also need to use an accumulator, such as g_signal_accumulator_true_handled(). - @@ -514,7 +493,6 @@ accumulator, such as g_signal_accumulator_true_handled(). The #GVaClosureMarshal equivalent to g_cclosure_marshal_BOOLEAN__BOXED_BOXED(). - @@ -560,7 +538,6 @@ accumulator, such as g_signal_accumulator_true_handled(). A marshaller for a #GCClosure with a callback of type `gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type. - @@ -594,7 +571,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_BOOLEAN__FLAGS(). - @@ -639,7 +615,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `gchar* (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data)`. - @@ -673,7 +648,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_STRING__OBJECT_POINTER(). - @@ -718,7 +692,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)`. - @@ -752,7 +725,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__BOOLEAN(). - @@ -797,7 +769,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)`. - @@ -831,7 +802,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__BOXED(). - @@ -876,7 +846,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gchar arg1, gpointer user_data)`. - @@ -910,7 +879,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__CHAR(). - @@ -955,7 +923,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)`. - @@ -989,7 +956,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__DOUBLE(). - @@ -1034,7 +1000,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes an enumeration type.. - @@ -1068,7 +1033,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__ENUM(). - @@ -1113,7 +1077,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type. - @@ -1147,7 +1110,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__FLAGS(). - @@ -1192,7 +1154,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)`. - @@ -1226,7 +1187,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__FLOAT(). - @@ -1271,7 +1231,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gint arg1, gpointer user_data)`. - @@ -1305,7 +1264,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__INT(). - @@ -1350,7 +1308,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, glong arg1, gpointer user_data)`. - @@ -1384,7 +1341,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__LONG(). - @@ -1429,7 +1385,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)`. - @@ -1463,7 +1418,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__OBJECT(). - @@ -1508,7 +1462,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)`. - @@ -1542,7 +1495,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__PARAM(). - @@ -1587,7 +1539,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)`. - @@ -1621,7 +1572,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__POINTER(). - @@ -1666,7 +1616,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)`. - @@ -1700,7 +1649,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__STRING(). - @@ -1745,7 +1693,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, guchar arg1, gpointer user_data)`. - @@ -1779,7 +1726,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UCHAR(). - @@ -1824,7 +1770,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, guint arg1, gpointer user_data)`. - @@ -1859,7 +1804,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)`. - @@ -1893,7 +1837,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UINT_POINTER(). - @@ -1937,7 +1880,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__UINT(). - @@ -1982,7 +1924,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gulong arg1, gpointer user_data)`. - @@ -2016,7 +1957,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__ULONG(). - @@ -2061,7 +2001,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data)`. - @@ -2095,7 +2034,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__VARIANT(). - @@ -2140,7 +2078,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gpointer user_data)`. - @@ -2174,7 +2111,6 @@ denotes a flags type. The #GVaClosureMarshal equivalent to g_cclosure_marshal_VOID__VOID(). - @@ -2222,7 +2158,6 @@ denotes a flags type. Normally this function is not passed explicitly to g_signal_new(), but used automatically by GLib when specifying a %NULL marshaller. - @@ -2261,7 +2196,6 @@ but used automatically by GLib when specifying a %NULL marshaller. A generic #GVaClosureMarshal function implemented via [libffi](http://sourceware.org/libffi/). - @@ -2309,7 +2243,6 @@ but used automatically by GLib when specifying a %NULL marshaller. the last parameter. @destroy_data will be called as a finalize notifier on the #GClosure. - a floating reference to a new #GCClosure @@ -2335,7 +2268,6 @@ calls g_object_watch_closure() on @object and the created closure. This function is useful when you have a callback closely associated with a #GObject, and want the callback to no longer run after the object is is freed. - a new #GCClosure @@ -2357,7 +2289,6 @@ and calls g_object_watch_closure() on @object and the created closure. This function is useful when you have a callback closely associated with a #GObject, and want the callback to no longer run after the object is is freed. - a new #GCClosure @@ -2378,7 +2309,6 @@ after the object is is freed. the first parameter. @destroy_data will be called as a finalize notifier on the #GClosure. - a floating reference to a new #GCClosure @@ -2401,7 +2331,6 @@ the first parameter. Check if the closure still needs a marshaller. See g_closure_set_marshal(). - a #GClosure @@ -2414,7 +2343,6 @@ The count includes the meta marshaller, the finalize and invalidate notifiers and the marshal guards. Note that each guard counts as two notifiers. See g_closure_set_meta_marshal(), g_closure_add_finalize_notifier(), g_closure_add_invalidate_notifier() and g_closure_add_marshal_guards(). - a #GClosure @@ -2427,7 +2355,6 @@ signatures. This doesn't mean that all callback functions must take no parameters and return void. The required signature of a callback function is determined by the context in which is used (e.g. the signal to which it is connected). Use G_CALLBACK() to cast the callback function to a #GCallback. - @@ -2440,7 +2367,6 @@ Also, specification of a GClassFinalizeFunc() in the #GTypeInfo structure of a static type is invalid, because classes of static types will never be finalized (they are artificially kept alive when their reference count drops to zero). - @@ -2551,7 +2477,6 @@ is called to complete the initialization process with the static members Corresponding finalization counter parts to the GBaseInitFunc() functions have to be provided to release allocated resources at class finalization time. - @@ -2610,7 +2535,6 @@ callback function/data pointer combination: - g_closure_invalidate() and invalidation notifiers allow callbacks to be automatically removed when the objects they point to go away. - @@ -2647,7 +2571,6 @@ callback function/data pointer combination: - @@ -2684,7 +2607,6 @@ callback function/data pointer combination: @data field of the closure and calls g_object_watch_closure() on @object and the created closure. This function is mainly useful when implementing new types of closures. - a newly allocated #GClosure @@ -2739,7 +2661,6 @@ MyClosure *my_closure_new (gpointer data) return my_closure; } ]| - a floating reference to a new #GClosure @@ -2763,7 +2684,6 @@ notifiers on a single closure are invoked in unspecified order. If a single call to g_closure_unref() results in the closure being both invalidated and finalized, then the invalidate notifiers will be run before the finalize notifiers. - @@ -2787,7 +2707,6 @@ be run before the finalize notifiers. @closure is invalidated with g_closure_invalidate(). Invalidation notifiers are invoked before finalization notifiers, in an unspecified order. - @@ -2811,7 +2730,6 @@ unspecified order. closure callback, respectively. This is typically used to protect the extra arguments for the duration of the callback. See g_object_watch_closure() for an example of marshal guards. - @@ -2854,7 +2772,6 @@ that you've previously called g_closure_ref(). Note that g_closure_invalidate() will also be called when the reference count of a closure drops to zero (unless it has already been invalidated before). - @@ -2867,7 +2784,6 @@ been invalidated before). Invokes the closure, i.e. executes the callback represented by the @closure. - @@ -2903,7 +2819,6 @@ been invalidated before). Increments the reference count on a closure to force it staying alive while the caller holds a pointer to it. - The @closure passed in, for convenience @@ -2919,7 +2834,6 @@ alive while the caller holds a pointer to it. Removes a finalization notifier. Notice that notifiers are automatically removed after they are run. - @@ -2943,7 +2857,6 @@ Notice that notifiers are automatically removed after they are run. Removes an invalidation notifier. Notice that notifiers are automatically removed after they are run. - @@ -2970,7 +2883,6 @@ information to the marshaller. (See g_closure_set_meta_marshal().) For GObject's C predefined marshallers (the g_cclosure_marshal_*() functions), what it provides is a callback function to use instead of @closure->callback. - @@ -3000,7 +2912,6 @@ g_signal_type_cclosure_new()) retrieve the callback function from a fixed offset in the class structure. The meta marshaller retrieves the right callback and passes it to the marshaller as the @marshal_data argument. - @@ -3061,7 +2972,6 @@ foo_notify_set_closure (GClosure *closure) Because g_closure_sink() may decrement the reference count of a closure (if it hasn't been called on @closure yet) just like g_closure_unref(), g_closure_ref() should be called prior to this function. - @@ -3077,7 +2987,6 @@ g_closure_ref() should be called prior to this function. Decrements the reference count of a closure after it was previously incremented by the same caller. If no other callers are using the closure, then the closure will be destroyed and freed. - @@ -3091,7 +3000,6 @@ closure, then the closure will be destroyed and freed. The type used for marshaller functions. - @@ -3134,7 +3042,6 @@ closure, then the closure will be destroyed and freed. The type used for the various notification callbacks which can be registered on closures. - @@ -3150,7 +3057,6 @@ on closures. - @@ -3161,7 +3067,6 @@ on closures. The connection flags are used to specify the behaviour of a signal's connection. - whether the handler should be called before or after the default handler of the signal. @@ -3236,7 +3141,6 @@ structures, use G_DECLARE_FINAL_TYPE(). If you must use G_DECLARE_DERIVABLE_TYPE() you should be sure to include some padding at the bottom of your class structure to leave space for the addition of future virtual functions. - The name of the new type, in camel case (like GtkWidget) @@ -3311,7 +3215,6 @@ G_DECLARE_FINAL_TYPE() to G_DECLARE_DERIVABLE_TYPE() without breaking API or ABI should therefore use G_DECLARE_FINAL_TYPE() until you are sure that it makes sense for your class to be subclassed. Once a class structure has been exposed it is not possible to change its size or remove or reorder items without breaking the API and/or ABI. - The name of the new type, in camel case (like GtkWidget) @@ -3378,7 +3281,6 @@ manually define this as a macro for yourself. The declaration of the _get_type() function is the first thing emitted by the macro. This allows this macro to be used in the usual way with export control and API versioning macros. - The name of the new type, in camel case (like GtkWidget) @@ -3402,7 +3304,6 @@ to be used in the usual way with export control and API versioning macros. A convenience macro for type implementations. Similar to G_DEFINE_TYPE(), but defines an abstract type. See G_DEFINE_TYPE_EXTENDED() for an example. - The name of the new type, in Camel case. @@ -3422,7 +3323,6 @@ Similar to G_DEFINE_TYPE_WITH_CODE(), but defines an abstract type and allows you to insert custom code into the *_get_type() function, e.g. interface implementations via G_IMPLEMENT_INTERFACE(). See G_DEFINE_TYPE_EXTENDED() for an example. - The name of the new type, in Camel case. @@ -3442,7 +3342,6 @@ See G_DEFINE_TYPE_EXTENDED() for an example. Similar to G_DEFINE_TYPE_WITH_PRIVATE(), but defines an abstract type. See G_DEFINE_TYPE_EXTENDED() for an example. - The name of the new type, in Camel case. @@ -3459,7 +3358,6 @@ See G_DEFINE_TYPE_EXTENDED() for an example. A convenience macro for boxed type implementations, which defines a type_name_get_type() function registering the boxed type. - The name of the new type, in Camel case @@ -3491,7 +3389,6 @@ G_DEFINE_BOXED_TYPE_WITH_CODE (GdkRectangle, gdk_rectangle, Similarly to the %G_DEFINE_TYPE family of macros, the #GType of the newly defined boxed type is exposed in the `g_define_type_id` variable. - The name of the new type, in Camel case @@ -3520,7 +3417,6 @@ it defines a `*_get_type()` and a static `*_register_type()` functions for use in your `module_init()`. See G_DEFINE_DYNAMIC_TYPE_EXTENDED() for an example. - The name of the new type, in Camel case. @@ -3595,7 +3491,6 @@ gtk_gadget_register_type (GTypeModule *type_module) } } ]| - The name of the new type, in Camel case. @@ -3629,7 +3524,6 @@ The initialization function has signature the full #GInterfaceInitFunc signature, for brevity and convenience. If you need to use an initialization function with an `iface_data` argument, you must write the #GTypeInterface definitions manually. - The name of the new type, in Camel case. @@ -3650,7 +3544,6 @@ G_DEFINE_INTERFACE(), but allows you to insert custom code into the via G_IMPLEMENT_INTERFACE(), or additional prerequisite types. See G_DEFINE_TYPE_EXTENDED() for a similar example using G_DEFINE_TYPE_WITH_CODE(). - The name of the new type, in Camel case. @@ -3670,7 +3563,6 @@ G_DEFINE_TYPE_WITH_CODE(). A convenience macro for pointer type implementations, which defines a type_name_get_type() function registering the pointer type. - The name of the new type, in Camel case @@ -3685,7 +3577,6 @@ type_name_get_type() function registering the pointer type. A convenience macro for pointer type implementations. Similar to G_DEFINE_POINTER_TYPE(), but allows to insert custom code into the type_name_get_type() function. - The name of the new type, in Camel case @@ -3705,7 +3596,6 @@ initialization function, an instance initialization function (see #GTypeInfo for information about these) and a static variable named `t_n_parent_class` pointing to the parent class. Furthermore, it defines a *_get_type() function. See G_DEFINE_TYPE_EXTENDED() for an example. - The name of the new type, in Camel case. @@ -3782,7 +3672,6 @@ gtk_gadget_get_type (void) The only pieces which have to be manually provided are the definitions of the instance and class structure and the definitions of the instance and class init functions. - The name of the new type, in Camel case. @@ -3807,7 +3696,6 @@ class init functions. Similar to G_DEFINE_TYPE(), but allows you to insert custom code into the *_get_type() function, e.g. interface implementations via G_IMPLEMENT_INTERFACE(). See G_DEFINE_TYPE_EXTENDED() for an example. - The name of the new type, in Camel case. @@ -3838,7 +3726,6 @@ The private instance data can be retrieved using the automatically generated getter function `t_n_get_instance_private()`. See also: G_ADD_PRIVATE() - The name of the new type, in Camel case. @@ -3854,7 +3741,6 @@ See also: G_ADD_PRIVATE() Casts a derived #GEnumClass structure into a #GEnumClass structure. - a valid #GEnumClass @@ -3863,7 +3749,6 @@ See also: G_ADD_PRIVATE() Get the type identifier from a given #GEnumClass structure. - a #GEnumClass @@ -3872,7 +3757,6 @@ See also: G_ADD_PRIVATE() Get the static type name from a given #GEnumClass structure. - a #GEnumClass @@ -3882,7 +3766,6 @@ See also: G_ADD_PRIVATE() The class of an enumeration type holds information about its possible values. - the parent class @@ -3908,7 +3791,6 @@ possible values. A structure which contains a single enum value, its name, and its nickname. - the enum value @@ -3924,7 +3806,6 @@ nickname. Casts a derived #GFlagsClass structure into a #GFlagsClass structure. - a valid #GFlagsClass @@ -3933,7 +3814,6 @@ nickname. Get the type identifier from a given #GFlagsClass structure. - a #GFlagsClass @@ -3942,7 +3822,6 @@ nickname. Get the static type name from a given #GFlagsClass structure. - a #GFlagsClass @@ -3952,7 +3831,6 @@ nickname. The class of a flags type holds information about its possible values. - the parent class @@ -3974,7 +3852,6 @@ possible values. A structure which contains a single flags value, its name, and its nickname. - the flags value @@ -3995,7 +3872,6 @@ See G_DEFINE_TYPE_EXTENDED() for an example. Note that this macro can only be used together with the G_DEFINE_TYPE_* macros, since it depends on variable names from those macros. - The #GType of the interface to add @@ -4013,7 +3889,6 @@ for an example. Note that this macro can only be used together with the G_DEFINE_DYNAMIC_TYPE_EXTENDED macros, since it depends on variable names from that macro. - The #GType of the interface to add @@ -4027,7 +3902,6 @@ names from that macro. Casts a #GInitiallyUnowned or derived pointer into a (GInitiallyUnowned*) pointer. Depending on the current debugging level, this function may invoke certain runtime checks to identify invalid casts. - Object which is subject to casting. @@ -4037,7 +3911,6 @@ certain runtime checks to identify invalid casts. Casts a derived #GInitiallyUnownedClass structure into a #GInitiallyUnownedClass structure. - a valid #GInitiallyUnownedClass @@ -4046,7 +3919,6 @@ certain runtime checks to identify invalid casts. Get the class structure associated to a #GInitiallyUnowned instance. - a #GInitiallyUnowned instance. @@ -4054,7 +3926,6 @@ certain runtime checks to identify invalid casts. - @@ -4063,7 +3934,6 @@ certain runtime checks to identify invalid casts. Checks whether @class "is a" valid #GEnumClass structure of type %G_TYPE_ENUM or derived. - a #GEnumClass @@ -4073,7 +3943,6 @@ or derived. Checks whether @class "is a" valid #GFlagsClass structure of type %G_TYPE_FLAGS or derived. - a #GFlagsClass @@ -4082,7 +3951,6 @@ or derived. Checks whether a valid #GTypeInstance pointer is of type %G_TYPE_INITIALLY_UNOWNED. - Instance to check for being a %G_TYPE_INITIALLY_UNOWNED. @@ -4092,7 +3960,6 @@ or derived. Checks whether @class "is a" valid #GInitiallyUnownedClass structure of type %G_TYPE_INITIALLY_UNOWNED or derived. - a #GInitiallyUnownedClass @@ -4101,7 +3968,6 @@ or derived. Checks whether a valid #GTypeInstance pointer is of type %G_TYPE_OBJECT. - Instance to check for being a %G_TYPE_OBJECT. @@ -4111,7 +3977,6 @@ or derived. Checks whether @class "is a" valid #GObjectClass structure of type %G_TYPE_OBJECT or derived. - a #GObjectClass @@ -4121,7 +3986,6 @@ or derived. Checks whether @pspec "is a" valid #GParamSpec structure of type %G_TYPE_PARAM or derived. - a #GParamSpec @@ -4130,7 +3994,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_BOOLEAN. - a valid #GParamSpec instance @@ -4139,7 +4002,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_BOXED. - a valid #GParamSpec instance @@ -4148,7 +4010,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_CHAR. - a valid #GParamSpec instance @@ -4158,7 +4019,6 @@ or derived. Checks whether @pclass "is a" valid #GParamSpecClass structure of type %G_TYPE_PARAM or derived. - a #GParamSpecClass @@ -4167,7 +4027,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_DOUBLE. - a valid #GParamSpec instance @@ -4176,7 +4035,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_ENUM. - a valid #GParamSpec instance @@ -4185,7 +4043,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_FLAGS. - a valid #GParamSpec instance @@ -4194,7 +4051,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_FLOAT. - a valid #GParamSpec instance @@ -4203,7 +4059,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_GTYPE. - a #GParamSpec @@ -4212,7 +4067,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_INT. - a valid #GParamSpec instance @@ -4221,7 +4075,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_INT64. - a valid #GParamSpec instance @@ -4230,7 +4083,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_LONG. - a valid #GParamSpec instance @@ -4239,7 +4091,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_OBJECT. - a valid #GParamSpec instance @@ -4248,7 +4099,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_OVERRIDE. - a #GParamSpec @@ -4257,7 +4107,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_PARAM. - a valid #GParamSpec instance @@ -4266,7 +4115,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_POINTER. - a valid #GParamSpec instance @@ -4275,7 +4123,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_STRING. - a valid #GParamSpec instance @@ -4284,7 +4131,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_UCHAR. - a valid #GParamSpec instance @@ -4293,7 +4139,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_UINT. - a valid #GParamSpec instance @@ -4302,7 +4147,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_UINT64. - a valid #GParamSpec instance @@ -4311,7 +4155,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_ULONG. - a valid #GParamSpec instance @@ -4320,7 +4163,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_UNICHAR. - a valid #GParamSpec instance @@ -4330,7 +4172,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_VALUE_ARRAY. Use #GArray instead of #GValueArray - a valid #GParamSpec instance @@ -4339,7 +4180,6 @@ or derived. Checks whether the given #GParamSpec is of type %G_TYPE_PARAM_VARIANT. - a #GParamSpec @@ -4347,28 +4187,24 @@ or derived. - - - - @@ -4376,7 +4212,6 @@ or derived. Checks if @value is a valid and initialized #GValue structure. - A #GValue structure. @@ -4387,7 +4222,6 @@ or derived. All the fields in the GInitiallyUnowned structure are private to the #GInitiallyUnowned implementation and should never be accessed directly. - @@ -4400,7 +4234,6 @@ accessed directly. The class structure for the GInitiallyUnowned type. - the parent class @@ -4412,7 +4245,6 @@ accessed directly. - @@ -4431,7 +4263,6 @@ accessed directly. - @@ -4453,7 +4284,6 @@ accessed directly. - @@ -4475,7 +4305,6 @@ accessed directly. - @@ -4488,7 +4317,6 @@ accessed directly. - @@ -4501,7 +4329,6 @@ accessed directly. - @@ -4520,7 +4347,6 @@ accessed directly. - @@ -4537,7 +4363,6 @@ accessed directly. - @@ -4569,7 +4394,6 @@ belongs to the type the current initializer was introduced for. The extended members of @instance are guaranteed to have been filled with zeros before this function is called. - @@ -4589,7 +4413,6 @@ zeros before this function is called. A callback function used by the type system to finalize an interface. This function should destroy any internal data and release any resources allocated by the corresponding GInterfaceInitFunc() function. - @@ -4607,7 +4430,6 @@ allocated by the corresponding GInterfaceInitFunc() function. A structure that provides information to the type system which is used specifically for managing interface types. - location of the interface initialization function @@ -4628,7 +4450,6 @@ allocate any resources required by the interface. The members of @iface_data are guaranteed to have been filled with zeros before this function is called. - @@ -4647,7 +4468,6 @@ zeros before this function is called. Casts a #GObject or derived pointer into a (GObject*) pointer. Depending on the current debugging level, this function may invoke certain runtime checks to identify invalid casts. - Object which is subject to casting. @@ -4656,7 +4476,6 @@ certain runtime checks to identify invalid casts. Casts a derived #GObjectClass structure into a #GObjectClass structure. - a valid #GObjectClass @@ -4665,7 +4484,6 @@ certain runtime checks to identify invalid casts. Return the name of a class structure's type. - a valid #GObjectClass @@ -4674,7 +4492,6 @@ certain runtime checks to identify invalid casts. Get the type id of a class structure. - a valid #GObjectClass @@ -4683,7 +4500,6 @@ certain runtime checks to identify invalid casts. Get the class structure associated to a #GObject instance. - a #GObject instance. @@ -4692,7 +4508,6 @@ certain runtime checks to identify invalid casts. Get the type id of an object. - Object to return the type id for. @@ -4701,7 +4516,6 @@ certain runtime checks to identify invalid casts. Get the name of an object's type. - Object to return the type name for. @@ -4711,7 +4525,6 @@ certain runtime checks to identify invalid casts. This macro should be used to emit a standard warning about unexpected properties in set_property() and get_property() implementations. - the #GObject on which set_property() or get_property() was called @@ -4725,7 +4538,6 @@ properties in set_property() and get_property() implementations. - @@ -4740,7 +4552,6 @@ properties in set_property() and get_property() implementations. All the fields in the GObject structure are private to the #GObject implementation and should never be accessed directly. - Creates a new instance of a #GObject subtype and sets its properties. @@ -4762,7 +4573,6 @@ make use of the %G_GINT64_CONSTANT or %G_GUINT64_CONSTANT macros. Similarly, #gfloat is promoted to #gdouble, so you must ensure that the value you provide is a #gdouble, even for a property of type #gfloat. - a new instance of @object_type @@ -4789,7 +4599,6 @@ you provide is a #gdouble, even for a property of type #gfloat. Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY) which are not explicitly specified are set to their default values. - a new instance of @object_type @@ -4817,7 +4626,6 @@ and the names and values correspond by index. Construction parameters (see %G_PARAM_CONSTRUCT, %G_PARAM_CONSTRUCT_ONLY) which are not explicitly specified are set to their default values. - a new instance of @object_type @@ -4853,7 +4661,6 @@ Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY) which are not explicitly specified are set to their default values. Use g_object_new_with_properties() instead. deprecated. See #GParameter for more information. - a new instance of @object_type @@ -4877,7 +4684,6 @@ deprecated. See #GParameter for more information. - @@ -4896,7 +4702,6 @@ interface. Generally, the interface vtable passed in as @g_iface will be the default vtable from g_type_default_interface_ref(), or, if you know the interface has already been loaded, g_type_default_interface_peek(). - the #GParamSpec for the property of the interface with the name @property_name, or %NULL if no @@ -4932,7 +4737,6 @@ vtable initialization function (the @class_init member of been called for any object types implementing this interface. If @pspec is a floating reference, it will be consumed. - @@ -4954,7 +4758,6 @@ If @pspec is a floating reference, it will be consumed. vtable passed in as @g_iface will be the default vtable from g_type_default_interface_ref(), or, if you know the interface has already been loaded, g_type_default_interface_peek(). - a pointer to an array of pointers to #GParamSpec @@ -4978,7 +4781,6 @@ already been loaded, g_type_default_interface_peek(). - @@ -4989,7 +4791,6 @@ already been loaded, g_type_default_interface_peek(). - @@ -5006,7 +4807,6 @@ already been loaded, g_type_default_interface_peek(). - @@ -5017,7 +4817,6 @@ already been loaded, g_type_default_interface_peek(). - @@ -5028,7 +4827,6 @@ already been loaded, g_type_default_interface_peek(). - @@ -5058,7 +4856,6 @@ Note that emission of the notify signal may be blocked with g_object_freeze_notify(). In this case, the signal emissions are queued and will be emitted (in reverse order) when g_object_thaw_notify() is called. - @@ -5073,7 +4870,6 @@ called. - @@ -5121,7 +4917,6 @@ however if there are multiple toggle references to an object, none of them will ever be notified until all but one are removed. For this reason, you should only ever use a toggle reference if there is important state in the proxy object. - @@ -5152,7 +4947,6 @@ Note that as with g_object_weak_ref(), the weak references created by this method are not thread-safe: they cannot safely be used in one thread if the object's last g_object_unref() might happen in another thread. Use #GWeakRef if thread-safety is required. - @@ -5191,7 +4985,6 @@ The binding will automatically be removed when either the @source or the #GBinding instance. A #GObject can have multiple bindings. - the #GBinding instance representing the binding between the two #GObject instances. The binding is released @@ -5247,7 +5040,6 @@ and @transform_from transformation functions; the @notify function will be called once, when the binding is removed. If you need different data for each transformation function, please use g_object_bind_property_with_closures() instead. - the #GBinding instance representing the binding between the two #GObject instances. The binding is released @@ -5305,7 +5097,6 @@ the binding. This function is the language bindings friendly version of g_object_bind_property_full(), using #GClosures instead of function pointers. - the #GBinding instance representing the binding between the two #GObject instances. The binding is released @@ -5369,7 +5160,6 @@ The signal specs expected by this function have the form "signal::destroy", gtk_widget_destroyed, &menu->toplevel, NULL); ]| - @object @@ -5398,7 +5188,6 @@ The signal specs expected by this function have the form "any_signal", which means to disconnect any signal with matching callback and data, or "any_signal::signal_name", which only disconnects the signal named "signal_name". - @@ -5434,7 +5223,6 @@ is locked. This function can be useful to avoid races when multiple threads are using object data on the same key on the same object. - the result of calling @dup_func on the value associated with @key on @object, or %NULL if not set. @@ -5476,7 +5264,6 @@ is locked. This function can be useful to avoid races when multiple threads are using object data on the same key on the same object. - the result of calling @dup_func on the value associated with @quark on @object, or %NULL if not set. @@ -5508,7 +5295,6 @@ object. a [floating][floating-ref] object reference. Doing this is seldom required: all #GInitiallyUnowneds are created with a floating reference which usually just needs to be sunken by calling g_object_ref_sink(). - @@ -5529,7 +5315,6 @@ object is frozen. This is necessary for accessors that modify multiple properties to prevent premature notification while the object is still being modified. - @@ -5567,7 +5352,6 @@ of three properties: an integer, a string and an object: g_free (strval); g_object_unref (objval); ]| - @@ -5589,7 +5373,6 @@ of three properties: an integer, a string and an object: Gets a named field from the objects table of associations (see g_object_set_data()). - the data if found, or %NULL if no such data exists. @@ -5623,7 +5406,6 @@ responsible for freeing the memory by calling g_value_unset(). Note that g_object_get_property() is really intended for language bindings, g_object_get() is much more convenient for C programming. - @@ -5645,7 +5427,6 @@ bindings, g_object_get() is much more convenient for C programming. This function gets back user data pointers stored via g_object_set_qdata(). - The user data pointer set, or %NULL @@ -5669,7 +5450,6 @@ is responsible for freeing the memory in the appropriate manner for the type, for instance by calling g_free() or g_object_unref(). See g_object_get(). - @@ -5694,7 +5474,6 @@ See g_object_get(). Obtained properties will be set to @values. All properties must be valid. Warnings will be emitted and undefined behaviour may result if invalid properties are passed in. - @@ -5723,7 +5502,6 @@ properties are passed in. Checks whether @object has a [floating][floating-ref] reference. - %TRUE if @object has a floating reference @@ -5746,7 +5524,6 @@ Note that emission of the notify signal may be blocked with g_object_freeze_notify(). In this case, the signal emissions are queued and will be emitted (in reverse order) when g_object_thaw_notify() is called. - @@ -5800,7 +5577,6 @@ and then notify a change on the "foo" property with: |[<!-- language="C" --> g_object_notify_by_pspec (self, properties[PROP_FOO]); ]| - @@ -5822,7 +5598,6 @@ Since GLib 2.56, if `GLIB_VERSION_MAX_ALLOWED` is 2.56 or greater, the type of @object will be propagated to the return type (using the GCC typeof() extension), so any casting the caller needs to do on the return type must be explicit. - the same @object @@ -5846,7 +5621,6 @@ adds a new normal reference increasing the reference count by one. Since GLib 2.56, the type of @object will be propagated to the return type under the same conditions as for g_object_ref(). - @object @@ -5861,7 +5635,6 @@ under the same conditions as for g_object_ref(). Removes a reference added with g_object_add_toggle_ref(). The reference count of the object is decreased by one. - @@ -5886,7 +5659,6 @@ reference count of the object is decreased by one. Removes a weak reference from @object that was previously added using g_object_add_weak_pointer(). The @weak_pointer_location has to match the one used with g_object_add_weak_pointer(). - @@ -5919,7 +5691,6 @@ should not destroy the object in the normal way. See g_object_set_data() for guidance on using a small, bounded set of values for @key. - %TRUE if the existing value for @key was replaced by @newval, %FALSE otherwise. @@ -5966,7 +5737,6 @@ the registered destroy notify for it (passed out in @old_destroy). It’s up to the caller to free this as needed, which may or may not include using @old_destroy as sometimes replacement should not destroy the object in the normal way. - %TRUE if the existing value for @quark was replaced by @newval, %FALSE otherwise. @@ -6004,7 +5774,6 @@ should not destroy the object in the normal way. reference cycles. This function should only be called from object system implementations. - @@ -6026,7 +5795,6 @@ properties of type #gint64 or #guint64 must be 64 bits wide, using the Note that the "notify" signals are queued and only emitted (in reverse order) after all properties have been set. See g_object_freeze_notify(). - @@ -6057,7 +5825,6 @@ Internally, the @key is converted to a #GQuark using g_quark_from_string(). This means a copy of @key is kept permanently (even after @object has been finalized) — so it is recommended to only use a small, bounded set of values for @key in your program, to avoid the #GQuark storage growing unbounded. - @@ -6082,7 +5849,6 @@ for when the association is destroyed, either by setting it to a different value or when the object is destroyed. Note that the @destroy callback is not called if @data is %NULL. - @@ -6107,7 +5873,6 @@ Note that the @destroy callback is not called if @data is %NULL. Sets a property on an object. - @@ -6135,7 +5900,6 @@ until the @object is finalized. Setting a previously set user data pointer, overrides (frees) the old pointer set, using #NULL as pointer essentially removes the data stored. - @@ -6160,7 +5924,6 @@ a void (*destroy) (gpointer) function may be specified which is called with @data as argument when the @object is finalized, or the data is being overwritten by a call to g_object_set_qdata() with the same @quark. - @@ -6186,7 +5949,6 @@ with the same @quark. Sets properties on an object. - @@ -6211,7 +5973,6 @@ with the same @quark. Properties to be set will be taken from @values. All properties must be valid. Warnings will be emitted and undefined behaviour may result if invalid properties are passed in. - @@ -6241,7 +6002,6 @@ properties are passed in. Remove a specified datum from the object's data associations, without invoking the association's destroy handler. - the data if found, or %NULL if no such data exists. @@ -6294,7 +6054,6 @@ Using g_object_get_qdata() in the above example, instead of g_object_steal_qdata() would have left the destroy function set, and thus the partial string list would have been freed upon g_object_set_qdata_full(). - The user data pointer set, or %NULL @@ -6320,7 +6079,6 @@ Duplicate notifications for each property are squashed so that at most one in which they have been queued. It is an error to call this function when the freeze count is zero. - @@ -6339,7 +6097,6 @@ If the pointer to the #GObject may be reused in future (for example, if it is an instance variable of another object), it is recommended to clear the pointer to %NULL rather than retain a dangling pointer to a potentially invalid #GObject instance. Use g_clear_object() for this. - @@ -6360,7 +6117,6 @@ added as marshal guards to the @closure, to ensure that an extra reference count is held on @object during invocation of the @closure. Usually, this function will be called on closures that use this @object as closure data. - @@ -6386,7 +6142,6 @@ Note that the weak references created by this method are not thread-safe: they cannot safely be used in one thread if the object's last g_object_unref() might happen in another thread. Use #GWeakRef if thread-safety is required. - @@ -6407,7 +6162,6 @@ Use #GWeakRef if thread-safety is required. Removes a weak reference callback to an object. - @@ -6497,7 +6251,6 @@ my_singleton_constructor (GType type, return object; } ]| - the parent class @@ -6509,7 +6262,6 @@ my_singleton_constructor (GType type, - @@ -6528,7 +6280,6 @@ my_singleton_constructor (GType type, - @@ -6550,7 +6301,6 @@ my_singleton_constructor (GType type, - @@ -6572,7 +6322,6 @@ my_singleton_constructor (GType type, - @@ -6585,7 +6334,6 @@ my_singleton_constructor (GType type, - @@ -6598,7 +6346,6 @@ my_singleton_constructor (GType type, - @@ -6617,7 +6364,6 @@ my_singleton_constructor (GType type, - @@ -6634,7 +6380,6 @@ my_singleton_constructor (GType type, - @@ -6655,7 +6400,6 @@ my_singleton_constructor (GType type, Looks up the #GParamSpec for a property of a class. - the #GParamSpec for the property, or %NULL if the class doesn't have a property of that name @@ -6734,7 +6478,6 @@ my_object_set_foo (MyObject *self, gint foo) } } ]| - @@ -6767,7 +6510,6 @@ use of properties on the same type on other threads. Note that it is possible to redefine a property in a derived class, by installing a property with the same name. This can be useful at times, e.g. to change the range of allowed values or the default value. - @@ -6788,7 +6530,6 @@ e.g. to change the range of allowed values or the default value. Get an array of #GParamSpec* for all properties of a class. - an array of #GParamSpec* which should be freed after use @@ -6824,7 +6565,6 @@ instead, so that the @param_id field of the #GParamSpec will be correct. For virtually all uses, this makes no difference. If you need to get the overridden property, you can call g_param_spec_get_redirect_target(). - @@ -6849,7 +6589,6 @@ g_param_spec_get_redirect_target(). The GObjectConstructParam struct is an auxiliary structure used to hand #GParamSpec/#GValue pairs to the @constructor of a #GObjectClass. - the #GParamSpec of the construct parameter @@ -6861,7 +6600,6 @@ a #GObjectClass. The type of the @finalize function of #GObjectClass. - @@ -6874,7 +6612,6 @@ a #GObjectClass. The type of the @get_property function of #GObjectClass. - @@ -6900,7 +6637,6 @@ a #GObjectClass. The type of the @set_property function of #GObjectClass. - @@ -6926,13 +6662,11 @@ a #GObjectClass. Mask containing the bits of #GParamSpec.flags which are reserved for GLib. - Casts a derived #GParamSpec object (e.g. of type #GParamSpecInt) into a #GParamSpec object. - a valid #GParamSpec @@ -6941,7 +6675,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecBoolean. - a valid #GParamSpec instance @@ -6950,7 +6683,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecBoxed. - a valid #GParamSpec instance @@ -6959,7 +6691,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecChar. - a valid #GParamSpec instance @@ -6968,7 +6699,6 @@ a #GParamSpec object. Casts a derived #GParamSpecClass structure into a #GParamSpecClass structure. - a valid #GParamSpecClass @@ -6977,7 +6707,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecDouble. - a valid #GParamSpec instance @@ -6986,7 +6715,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecEnum. - a valid #GParamSpec instance @@ -6995,7 +6723,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecFlags. - a valid #GParamSpec instance @@ -7004,7 +6731,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecFloat. - a valid #GParamSpec instance @@ -7013,7 +6739,6 @@ a #GParamSpec object. Retrieves the #GParamSpecClass of a #GParamSpec. - a valid #GParamSpec @@ -7022,7 +6747,6 @@ a #GParamSpec object. Casts a #GParamSpec into a #GParamSpecGType. - a #GParamSpec @@ -7031,7 +6755,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecInt. - a valid #GParamSpec instance @@ -7040,7 +6763,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecInt64. - a valid #GParamSpec instance @@ -7049,7 +6771,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecLong. - a valid #GParamSpec instance @@ -7058,7 +6779,6 @@ a #GParamSpec object. Casts a #GParamSpec instance into a #GParamSpecObject. - a valid #GParamSpec instance @@ -7067,7 +6787,6 @@ a #GParamSpec object. Casts a #GParamSpec into a #GParamSpecOverride. - a #GParamSpec @@ -7076,7 +6795,6 @@ a #GParamSpec object. Casts a #GParamSpec instance into a #GParamSpecParam. - a valid #GParamSpec instance @@ -7085,7 +6803,6 @@ a #GParamSpec object. Casts a #GParamSpec instance into a #GParamSpecPointer. - a valid #GParamSpec instance @@ -7094,7 +6811,6 @@ a #GParamSpec object. Casts a #GParamSpec instance into a #GParamSpecString. - a valid #GParamSpec instance @@ -7103,7 +6819,6 @@ a #GParamSpec object. Retrieves the #GType of this @pspec. - a valid #GParamSpec @@ -7112,7 +6827,6 @@ a #GParamSpec object. Retrieves the #GType name of this @pspec. - a valid #GParamSpec @@ -7121,7 +6835,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecUChar. - a valid #GParamSpec instance @@ -7130,7 +6843,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecUInt. - a valid #GParamSpec instance @@ -7139,7 +6851,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecUInt64. - a valid #GParamSpec instance @@ -7148,7 +6859,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecULong. - a valid #GParamSpec instance @@ -7157,7 +6867,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecUnichar. - a valid #GParamSpec instance @@ -7167,7 +6876,6 @@ a #GParamSpec object. Cast a #GParamSpec instance into a #GParamSpecValueArray. Use #GArray instead of #GValueArray - a valid #GParamSpec instance @@ -7176,7 +6884,6 @@ a #GParamSpec object. Retrieves the #GType to initialize a #GValue for this parameter. - a valid #GParamSpec @@ -7185,7 +6892,6 @@ a #GParamSpec object. Casts a #GParamSpec into a #GParamSpecVariant. - a #GParamSpec @@ -7196,13 +6902,11 @@ a #GParamSpec object. #GParamFlags value alias for %G_PARAM_STATIC_NAME | %G_PARAM_STATIC_NICK | %G_PARAM_STATIC_BLURB. Since 2.13.0 - Minimum shift count to be used for user defined flags, to be stored in #GParamSpec.flags. The maximum allowed is 10. - @@ -7212,7 +6916,6 @@ structure for @TypeName. Note that this macro can only be used together with the G_DEFINE_TYPE_* and G_ADD_PRIVATE() macros, since it depends on variable names from those macros. - the name of the type in CamelCase @@ -7235,7 +6938,6 @@ structure for @TypeName. Note that this macro can only be used together with the G_DEFINE_TYPE_* and G_ADD_PRIVATE() macros, since it depends on variable names from those macros. - the name of the type in CamelCase @@ -7255,7 +6957,6 @@ structure for @TypeName. Note that this macro can only be used together with the G_DEFINE_TYPE_* and G_ADD_PRIVATE() macros, since it depends on variable names from those macros. - the name of the type in CamelCase @@ -7268,7 +6969,6 @@ those macros. Through the #GParamFlags flag values, certain aspects of parameters can be configured. See also #G_PARAM_STATIC_STRINGS. - the parameter is readable @@ -7336,7 +7036,6 @@ for signal naming (see g_signal_new()). When creating and looking up a #GParamSpec, either separator can be used, but they cannot be mixed. Using `-` is considerably more efficient, and is the ‘canonical form’. Using `_` is discouraged. - Creates a new #GParamSpec instance. @@ -7349,7 +7048,6 @@ strings associated with them, the @nick, which should be suitable for use as a label for the property in a property editor, and the @blurb, which should be a somewhat longer description, suitable for e.g. a tooltip. The @nick and @blurb should ideally be localized. - a newly allocated #GParamSpec instance @@ -7384,7 +7082,6 @@ before actually trying to create them. See [canonical parameter names][canonical-parameter-names] for details of the rules for valid names. - %TRUE if @name is a valid property name, %FALSE otherwise. @@ -7397,7 +7094,6 @@ the rules for valid names. - @@ -7408,7 +7104,6 @@ the rules for valid names. - @@ -7422,7 +7117,6 @@ the rules for valid names. - @@ -7436,7 +7130,6 @@ the rules for valid names. - @@ -7454,7 +7147,6 @@ the rules for valid names. Get the short description of a #GParamSpec. - the short description of @pspec. @@ -7470,7 +7162,6 @@ the rules for valid names. Gets the default value of @pspec as a pointer to a #GValue. The #GValue will remain valid for the life of @pspec. - a pointer to a #GValue which must not be modified @@ -7487,7 +7178,6 @@ The #GValue will remain valid for the life of @pspec. The name is always an "interned" string (as per g_intern_string()). This allows for pointer-value comparisons. - the name of @pspec. @@ -7501,7 +7191,6 @@ This allows for pointer-value comparisons. Gets the GQuark for the name. - the GQuark for @pspec->name. @@ -7515,7 +7204,6 @@ This allows for pointer-value comparisons. Get the nickname of a #GParamSpec. - the nickname of @pspec. @@ -7529,7 +7217,6 @@ This allows for pointer-value comparisons. Gets back user data pointers stored via g_param_spec_set_qdata(). - the user data pointer set, or %NULL @@ -7553,7 +7240,6 @@ type while preserving all the properties from the parent type. Redirection is established by creating a property of type #GParamSpecOverride. See g_object_class_override_property() for an example of the use of this capability. - paramspec to which requests on this paramspec should be redirected, or %NULL if none. @@ -7568,7 +7254,6 @@ for an example of the use of this capability. Increments the reference count of @pspec. - the #GParamSpec that was passed into this function @@ -7582,7 +7267,6 @@ for an example of the use of this capability. Convenience function to ref and sink a #GParamSpec. - the #GParamSpec that was passed into this function @@ -7601,7 +7285,6 @@ g_quark_from_static_string()), and the pointer can be gotten back from the @pspec with g_param_spec_get_qdata(). Setting a previously set user data pointer, overrides (frees) the old pointer set, using %NULL as pointer essentially removes the data stored. - @@ -7626,7 +7309,6 @@ a `void (*destroy) (gpointer)` function may be specified which is called with @data as argument when the @pspec is finalized, or the data is being overwritten by a call to g_param_spec_set_qdata() with the same @quark. - @@ -7658,7 +7340,6 @@ someone calls `g_param_spec_ref (pspec); g_param_spec_sink (pspec);` in sequence on it, taking over the initial reference count (thus ending up with a @pspec that has a reference count of 1 still, but is not flagged "floating" anymore). - @@ -7674,7 +7355,6 @@ count of 1 still, but is not flagged "floating" anymore). and removes the @data from @pspec without invoking its destroy() function (if any was set). Usually, calling this function is only required to update user data pointers with a destroy notifier. - the user data pointer set, or %NULL @@ -7692,7 +7372,6 @@ required to update user data pointers with a destroy notifier. Decrements the reference count of a @pspec. - @@ -7780,7 +7459,6 @@ required to update user data pointers with a destroy notifier. The class structure for the GParamSpec type. Normally, GParamSpec classes are filled by g_param_type_register_static(). - the parent class @@ -7791,7 +7469,6 @@ g_param_type_register_static(). - @@ -7804,7 +7481,6 @@ g_param_type_register_static(). - @@ -7820,7 +7496,6 @@ g_param_type_register_static(). - @@ -7836,7 +7511,6 @@ g_param_type_register_static(). - @@ -8050,10 +7724,8 @@ properties. quickly accessed by owner and name. The implementation of the #GObject property system uses such a pool to store the #GParamSpecs of the properties all object types. - Inserts a #GParamSpec in the pool. - @@ -8075,7 +7747,6 @@ types. Gets an array of all #GParamSpecs owned by @owner_type in the pool. - a newly allocated array containing pointers to all #GParamSpecs @@ -8102,7 +7773,6 @@ the pool. Gets an #GList of all #GParamSpecs owned by @owner_type in the pool. - a #GList of all #GParamSpecs owned by @owner_type in @@ -8124,7 +7794,6 @@ the pool. Looks up a #GParamSpec in the pool. - The found #GParamSpec, or %NULL if no matching #GParamSpec was found. @@ -8152,7 +7821,6 @@ matching #GParamSpec was found. Removes a #GParamSpec from the pool. - @@ -8174,7 +7842,6 @@ If @type_prefixing is %TRUE, lookups in the newly created pool will allow to specify the owner as a colon-separated prefix of the property name, like "GtkContainer:border-width". This feature is deprecated, so you should always set @type_prefixing to %FALSE. - a newly allocated #GParamSpecPool. @@ -8227,7 +7894,6 @@ The initialized structure is passed to the g_param_type_register_static() The type system will perform a deep copy of this structure, so its memory does not need to be persistent across invocation of g_param_type_register_static(). - Size of the instance (object) structure. @@ -8238,7 +7904,6 @@ g_param_type_register_static(). - @@ -8255,7 +7920,6 @@ g_param_type_register_static(). - @@ -8268,7 +7932,6 @@ g_param_type_register_static(). - @@ -8284,7 +7947,6 @@ g_param_type_register_static(). - @@ -8300,7 +7962,6 @@ g_param_type_register_static(). - @@ -8450,7 +8111,6 @@ values compare equal. The GParameter struct is an auxiliary structure used to hand parameter name/value pairs to g_object_newv(). This type is not introspectable. - the parameter name @@ -8462,12 +8122,10 @@ to hand parameter name/value pairs to g_object_newv(). A mask for all #GSignalFlags bits. - A mask for all #GSignalMatchType bits. - @@ -8477,7 +8135,6 @@ during a signal emission. The signal accumulator is specified at signal creation time, if it is left %NULL, no accumulation of callback return values is performed. The return value of signal emissions is then the value returned by the last callback. - The accumulator function returns whether the signal emission should be aborted. Returning %FALSE means to abort the @@ -8510,7 +8167,6 @@ allows you to tie a hook to the signal type, so that it will trap all emissions of that signal, from any object. You may not attach these to signals created with the #G_SIGNAL_NO_HOOKS flag. - whether it wants to stay connected. If it returns %FALSE, the signal hook is disconnected (and destroyed). @@ -8543,7 +8199,6 @@ You may not attach these to signals created with the #G_SIGNAL_NO_HOOKS flag.The signal flags are used to specify a signal's behaviour, the overall signal description outlines how especially the RUN flags control the stages of a signal emission. - Invoke the object method handler in the first emission stage. @@ -8586,7 +8241,6 @@ stages of a signal emission. The #GSignalInvocationHint structure is used to pass on additional information to callbacks during a signal emission. - The signal id of the signal invoking the callback @@ -8606,7 +8260,6 @@ to callbacks during a signal emission. The match types specify what g_signal_handlers_block_matched(), g_signal_handlers_unblock_matched() and g_signal_handlers_disconnect_matched() match signals by. - The signal id must be equal. @@ -8629,7 +8282,6 @@ match signals by. A structure holding in-depth information for a specific signal. It is filled in by the g_signal_query() function. - The signal id of the signal being queried, or 0 if the signal to be queried was unknown. @@ -8674,7 +8326,6 @@ and issues a warning if this is not the case. Returns @g_class casted to a pointer to @c_type. %NULL is not a valid class structure. This macro should only be used in type implementations. - Location of a #GTypeClass structure @@ -8692,7 +8343,6 @@ This macro should only be used in type implementations. @g_type. If @g_class is %NULL, %FALSE will be returned. This macro should only be used in type implementations. - Location of a #GTypeClass structure @@ -8708,7 +8358,6 @@ otherwise issues a warning and returns %FALSE. %NULL is not a valid #GTypeInstance. This macro should only be used in type implementations. - Location of a #GTypeInstance structure @@ -8723,7 +8372,6 @@ to a pointer to @c_type. No warning will be issued if @instance is %NULL, and %NULL will be returned. This macro should only be used in type implementations. - Location of a #GTypeInstance structure @@ -8741,7 +8389,6 @@ This macro should only be used in type implementations. If @instance is %NULL, %FALSE will be returned. This macro should only be used in type implementations. - Location of a #GTypeInstance structure. @@ -8756,7 +8403,6 @@ This macro should only be used in type implementations. @instance is %NULL, %FALSE will be returned. This macro should only be used in type implementations. - Location of a #GTypeInstance structure. @@ -8771,7 +8417,6 @@ This macro should only be used in type implementations. of a value type. This macro should only be used in type implementations. - a #GValue @@ -8783,7 +8428,6 @@ This macro should only be used in type implementations. of type @g_type. This macro should only be used in type implementations. - a #GValue @@ -8799,7 +8443,6 @@ The private structure must have been registered in the get_type() function with g_type_add_class_private(). This macro should only be used in type implementations. - the class of a type deriving from @private_type @@ -8814,14 +8457,12 @@ This macro should only be used in type implementations. A bit in the type number that's supposed to be left untouched. - Get the type identifier from a given @class structure. This macro should only be used in type implementations. - Location of a valid #GTypeClass structure @@ -8832,7 +8473,6 @@ This macro should only be used in type implementations. Get the type identifier from a given @instance structure. This macro should only be used in type implementations. - Location of a valid #GTypeInstance structure @@ -8843,7 +8483,6 @@ This macro should only be used in type implementations. Get the type identifier from a given @interface structure. This macro should only be used in type implementations. - Location of a valid #GTypeInterface structure @@ -8854,7 +8493,6 @@ This macro should only be used in type implementations. The fundamental type which is the ancestor of @type. Fundamental types are types that serve as ultimate bases for the derived types, thus they are the roots of distinct inheritance hierarchies. - A #GType value. @@ -8864,17 +8502,14 @@ thus they are the roots of distinct inheritance hierarchies. An integer constant that represents the number of identifiers reserved for types that are assigned at compile-time. - Shift value used in converting numbers to type IDs. - Checks if @type has a #GTypeValueTable. - A #GType value @@ -8889,7 +8524,6 @@ Note that while calling a GInstanceInitFunc(), the class pointer gets modified, so it might not always return the expected pointer. This macro should only be used in type implementations. - Location of the #GTypeInstance structure @@ -8906,7 +8540,6 @@ This macro should only be used in type implementations. Get the interface structure for interface @g_type of a given @instance. This macro should only be used in type implementations. - Location of the #GTypeInstance structure @@ -8927,7 +8560,6 @@ class_init function with g_type_class_add_private(). This macro should only be used in type implementations. Use %G_ADD_PRIVATE and the generated `your_type_get_instance_private()` function instead - the instance of a type deriving from @private_type @@ -8944,7 +8576,6 @@ This macro should only be used in type implementations. Checks if @type is an abstract type. An abstract type cannot be instantiated and is normally used as an abstract base class for derived classes. - A #GType value @@ -8952,7 +8583,6 @@ derived classes. - @@ -8960,7 +8590,6 @@ derived classes. Checks if @type is a classed type. - A #GType value @@ -8970,7 +8599,6 @@ derived classes. Checks if @type is a deep derivable type. A deep derivable type can be used as the base class of a deep (multi-level) class hierarchy. - A #GType value @@ -8980,7 +8608,6 @@ can be used as the base class of a deep (multi-level) class hierarchy. Checks if @type is a derivable type. A derivable type can be used as the base class of a flat (single-level) class hierarchy. - A #GType value @@ -8991,7 +8618,6 @@ be used as the base class of a flat (single-level) class hierarchy. Checks if @type is derived (or in object-oriented terminology: inherited) from another type (this holds true for all non-fundamental types). - A #GType value @@ -9000,7 +8626,6 @@ types). Checks whether @type "is a" %G_TYPE_ENUM. - a #GType ID. @@ -9009,7 +8634,6 @@ types). Checks whether @type "is a" %G_TYPE_FLAGS. - a #GType ID. @@ -9018,7 +8642,6 @@ types). Checks if @type is a fundamental type. - A #GType value @@ -9028,7 +8651,6 @@ types). Checks if @type can be instantiated. Instantiation is the process of creating an instance (object) of this type. - A #GType value @@ -9043,7 +8665,6 @@ to the interface). GLib interfaces are somewhat analogous to Java interfaces and C++ classes containing only pure virtual functions, with the difference that GType interfaces are not derivable (but see g_type_interface_add_prerequisite() for an alternative). - A #GType value @@ -9052,7 +8673,6 @@ g_type_interface_add_prerequisite() for an alternative). Check if the passed in type id is a %G_TYPE_OBJECT or derived from it. - Type id to check @@ -9061,7 +8681,6 @@ g_type_interface_add_prerequisite() for an alternative). Checks whether @type "is a" %G_TYPE_PARAM. - a #GType ID @@ -9072,7 +8691,6 @@ g_type_interface_add_prerequisite() for an alternative). Checks whether the passed in type ID can be used for g_value_init(). That is, this macro checks whether this type provides an implementation of the #GTypeValueTable functions required for a type to create a #GValue of. - A #GType value. @@ -9083,7 +8701,6 @@ of the #GTypeValueTable functions required for a type to create a #GValue of.Checks if @type is an abstract value type. An abstract value type introduces a value table, but can't be used for g_value_init() and is normally used as an abstract base type for derived value types. - A #GType value @@ -9092,7 +8709,6 @@ an abstract base type for derived value types. Checks if @type is a value type and can be used with g_value_init(). - A #GType value @@ -9103,7 +8719,6 @@ an abstract base type for derived value types. Get the type ID for the fundamental type number @x. Use g_type_fundamental_next() instead of this macro to create new fundamental types. - the fundamental type number. @@ -9111,42 +8726,36 @@ types. - - - - - - @@ -9155,35 +8764,29 @@ types. First fundamental type number to create a new fundamental type id with G_TYPE_MAKE_FUNDAMENTAL() reserved for BSE. - Last fundamental type number reserved for BSE. - First fundamental type number to create a new fundamental type id with G_TYPE_MAKE_FUNDAMENTAL() reserved for GLib. - Last fundamental type number reserved for GLib. - First available fundamental type number to create new fundamental type id with G_TYPE_MAKE_FUNDAMENTAL(). - A callback function used for notification when the state of a toggle reference changes. See g_object_add_toggle_ref(). - @@ -9210,7 +8813,6 @@ of a toggle reference changes. See g_object_add_toggle_ref(). An opaque structure used as the base of all classes. - @@ -9279,7 +8881,6 @@ my_object_get_some_field (MyObject *my_object) ]| Use the G_ADD_PRIVATE() macro with the `G_DEFINE_*` family of macros to add instance private data to a type - @@ -9304,7 +8905,6 @@ class in order to get the private data for the type represented by You can only call this function after you have registered a private data area for @g_class using g_type_class_add_private(). - the offset, in bytes @@ -9317,7 +8917,6 @@ data area for @g_class using g_type_class_add_private(). - @@ -9339,7 +8938,6 @@ class will always exist. This function is essentially equivalent to: g_type_class_peek (g_type_parent (G_TYPE_FROM_CLASS (g_class))) - the parent class of @g_class @@ -9358,7 +8956,6 @@ g_type_class_peek (g_type_parent (G_TYPE_FROM_CLASS (g_class))) Once the last reference count of a class has been released, classes may be finalized by the type system, so further dereferencing of a class pointer after g_type_class_unref() are invalid. - @@ -9374,7 +8971,6 @@ class pointer after g_type_class_unref() are invalid. implementations. It unreferences a class without consulting the chain of #GTypeClassCacheFuncs, avoiding the recursion which would occur otherwise. - @@ -9386,7 +8982,6 @@ otherwise. - @@ -9405,7 +9000,6 @@ except that the classes reference count isn't incremented. As a consequence, this function may return %NULL if the class of the type passed in does not currently exist (hasn't been referenced before). - the #GTypeClass structure for the given type ID or %NULL if the class does not @@ -9422,7 +9016,6 @@ referenced before). A more efficient version of g_type_class_peek() which works only for static types. - the #GTypeClass structure for the given type ID or %NULL if the class does not @@ -9440,7 +9033,6 @@ static types. Increments the reference count of the class structure belonging to @type. This function will demand-create the class if it doesn't exist already. - the #GTypeClass structure for the given type ID @@ -9464,7 +9056,6 @@ g_type_class_unref_uncached() instead. The functions have to check the class id passed in to figure whether they actually want to cache the class of this type, since all classes are routed through the same #GTypeClassCacheFunc chain. - %TRUE to stop further #GTypeClassCacheFuncs from being called, %FALSE to continue @@ -9489,7 +9080,6 @@ is now deprecated. If you need to enable debugging features, use the GOBJECT_DEBUG environment variable. g_type_init() is now done automatically - Print no messages @@ -9508,7 +9098,6 @@ environment variable. Bit masks used to check or determine characteristics of a type. - Indicates an abstract type. No instances can be created for an abstract type @@ -9522,7 +9111,6 @@ environment variable. Bit masks used to check or determine specific characteristics of a fundamental type. - Indicates a classed type @@ -9539,7 +9127,6 @@ fundamental type. A structure that provides information to the type system which is used specifically for managing fundamental types. - #GTypeFundamentalFlags describing the characteristics of the fundamental type @@ -9555,7 +9142,6 @@ The initialized structure is passed to the g_type_register_static() function g_type_plugin_complete_type_info()). The type system will perform a deep copy of this structure, so its memory does not need to be persistent across invocation of g_type_register_static(). - Size of the class structure (required for interface, classed and instantiatable types) @@ -9607,12 +9193,10 @@ across invocation of g_type_register_static(). An opaque structure used as the base of all type instances. - - @@ -9628,7 +9212,6 @@ across invocation of g_type_register_static(). An opaque structure used as the base of all interface types. - @@ -9640,7 +9223,6 @@ across invocation of g_type_register_static(). of the instance type to which @g_iface belongs. This is useful when deriving the implementation of an interface from the parent type and then possibly overriding some methods. - the corresponding #GTypeInterface structure of the parent type of the @@ -9661,7 +9243,6 @@ This means that any type implementing @interface_type must also implement @prerequisite_type. Prerequisites can be thought of as an alternative to interface derivation (which GType doesn't support). An interface can have at most one instantiatable prerequisite type. - @@ -9681,7 +9262,6 @@ at most one instantiatable prerequisite type. @interface_type which has been added to @instance_type, or %NULL if @interface_type has not been added to @instance_type or does not have a #GTypePlugin structure. See g_type_add_interface_dynamic(). - the #GTypePlugin for the dynamic interface @interface_type of @instance_type @@ -9701,7 +9281,6 @@ not have a #GTypePlugin structure. See g_type_add_interface_dynamic(). Returns the #GTypeInterface structure of an interface to which the passed in class conforms. - the #GTypeInterface structure of @iface_type if implemented by @instance_class, %NULL @@ -9721,7 +9300,6 @@ passed in class conforms. Returns the prerequisites of an interfaces type. - a newly-allocated zero-terminated array of #GType containing @@ -9746,7 +9324,6 @@ passed in class conforms. A callback called after an interface vtable is initialized. See g_type_add_interface_check(). - @@ -9789,10 +9366,8 @@ implementations it contains, g_type_module_unuse() is called. loading and unloading. To create a particular module type you must derive from #GTypeModule and implement the load and unload functions in #GTypeModuleClass. - - @@ -9803,7 +9378,6 @@ in #GTypeModuleClass. - @@ -9823,7 +9397,6 @@ not be unloaded. Since 2.56 if @module is %NULL this will call g_type_add_interface_static() instead. This can be used when making a static build of the module. - @@ -9857,7 +9430,6 @@ not be unloaded. Since 2.56 if @module is %NULL this will call g_type_register_static() instead. This can be used when making a static build of the module. - the new or existing type ID @@ -9891,7 +9463,6 @@ not be unloaded. Since 2.56 if @module is %NULL this will call g_type_register_static() instead. This can be used when making a static build of the module. - the new or existing type ID @@ -9929,7 +9500,6 @@ not be unloaded. Since 2.56 if @module is %NULL this will call g_type_register_static() instead. This can be used when making a static build of the module. - the new or existing type ID @@ -9959,7 +9529,6 @@ instead. This can be used when making a static build of the module. Sets the name for a #GTypeModule - @@ -9980,7 +9549,6 @@ result is zero, the module will be unloaded. (However, the #GTypeModule will not be freed, and types associated with the #GTypeModule are not unregistered. Once a #GTypeModule is initialized, it must exist forever.) - @@ -9996,7 +9564,6 @@ initialized, it must exist forever.) use count was zero before, the plugin will be loaded. If loading the plugin fails, the use count is reset to its prior value. - %FALSE if the plugin needed to be loaded and loading the plugin failed. @@ -10033,14 +9600,12 @@ its prior value. In order to implement dynamic loading of types based on #GTypeModule, the @load and @unload functions in #GTypeModuleClass must be implemented. - the parent class - @@ -10053,7 +9618,6 @@ the @load and @unload functions in #GTypeModuleClass must be implemented. - @@ -10066,7 +9630,6 @@ the @load and @unload functions in #GTypeModuleClass must be implemented. - @@ -10074,7 +9637,6 @@ the @load and @unload functions in #GTypeModuleClass must be implemented. - @@ -10082,7 +9644,6 @@ the @load and @unload functions in #GTypeModuleClass must be implemented. - @@ -10090,7 +9651,6 @@ the @load and @unload functions in #GTypeModuleClass must be implemented. - @@ -10149,7 +9709,6 @@ unloading. It even handles multiple registered types per module. Calls the @complete_interface_info function from the #GTypePluginClass of @plugin. There should be no need to use this function outside of the GObject type system itself. - @@ -10177,7 +9736,6 @@ function outside of the GObject type system itself. Calls the @complete_type_info function from the #GTypePluginClass of @plugin. There should be no need to use this function outside of the GObject type system itself. - @@ -10204,7 +9762,6 @@ type system itself. Calls the @unuse_plugin function from the #GTypePluginClass of @plugin. There should be no need to use this function outside of the GObject type system itself. - @@ -10219,7 +9776,6 @@ the GObject type system itself. Calls the @use_plugin function from the #GTypePluginClass of @plugin. There should be no need to use this function outside of the GObject type system itself. - @@ -10234,7 +9790,6 @@ the GObject type system itself. The #GTypePlugin interface is used by the type system in order to handle the lifecycle of dynamically loaded types. - @@ -10261,7 +9816,6 @@ the lifecycle of dynamically loaded types. The type of the @complete_interface_info function of #GTypePluginClass. - @@ -10287,7 +9841,6 @@ the lifecycle of dynamically loaded types. The type of the @complete_type_info function of #GTypePluginClass. - @@ -10312,7 +9865,6 @@ the lifecycle of dynamically loaded types. The type of the @unuse_plugin function of #GTypePluginClass. - @@ -10326,7 +9878,6 @@ the lifecycle of dynamically loaded types. The type of the @use_plugin function of #GTypePluginClass, which gets called to increase the use count of @plugin. - @@ -10340,7 +9891,6 @@ to increase the use count of @plugin. A structure holding information for a specific type. It is filled in by the g_type_query() function. - the #GType value of the type @@ -10361,10 +9911,8 @@ It is filled in by the g_type_query() function. The #GTypeValueTable provides the functions required by the #GValue implementation, to serve as a container for values of a type. - - @@ -10377,7 +9925,6 @@ implementation, to serve as a container for values of a type. - @@ -10390,7 +9937,6 @@ implementation, to serve as a container for values of a type. - @@ -10406,7 +9952,6 @@ implementation, to serve as a container for values of a type. - @@ -10434,7 +9979,6 @@ implementation, to serve as a container for values of a type. - @@ -10462,7 +10006,6 @@ implementation, to serve as a container for values of a type. - @@ -10488,7 +10031,6 @@ implementation, to serve as a container for values of a type. Note that this function should only be used from source code that implements or has internal knowledge of the implementation of @type. - location of the #GTypeValueTable associated with @type or %NULL if there is no #GTypeValueTable associated with @type @@ -10506,7 +10048,6 @@ that implements or has internal knowledge of the implementation of Checks if @value holds (or contains) a value of @type. This macro will also check for @value != %NULL and issue a warning if the check fails. - A #GValue structure. @@ -10518,7 +10059,6 @@ warning if the check fails. Checks whether the given #GValue can hold values of type %G_TYPE_BOOLEAN. - a valid #GValue structure @@ -10528,7 +10068,6 @@ warning if the check fails. Checks whether the given #GValue can hold values derived from type %G_TYPE_BOXED. - a valid #GValue structure @@ -10537,7 +10076,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_CHAR. - a valid #GValue structure @@ -10546,7 +10084,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_DOUBLE. - a valid #GValue structure @@ -10555,7 +10092,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values derived from type %G_TYPE_ENUM. - a valid #GValue structure @@ -10564,7 +10100,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values derived from type %G_TYPE_FLAGS. - a valid #GValue structure @@ -10573,7 +10108,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_FLOAT. - a valid #GValue structure @@ -10582,7 +10116,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_GTYPE. - a valid #GValue structure @@ -10591,7 +10124,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_INT. - a valid #GValue structure @@ -10600,7 +10132,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_INT64. - a valid #GValue structure @@ -10609,7 +10140,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_LONG. - a valid #GValue structure @@ -10618,7 +10148,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values derived from type %G_TYPE_OBJECT. - a valid #GValue structure @@ -10627,7 +10156,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values derived from type %G_TYPE_PARAM. - a valid #GValue structure @@ -10636,7 +10164,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_POINTER. - a valid #GValue structure @@ -10645,7 +10172,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_STRING. - a valid #GValue structure @@ -10654,7 +10180,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_UCHAR. - a valid #GValue structure @@ -10663,7 +10188,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_UINT. - a valid #GValue structure @@ -10672,7 +10196,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_UINT64. - a valid #GValue structure @@ -10681,7 +10204,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_ULONG. - a valid #GValue structure @@ -10690,7 +10212,6 @@ from type %G_TYPE_BOXED. Checks whether the given #GValue can hold values of type %G_TYPE_VARIANT. - a valid #GValue structure @@ -10700,12 +10221,10 @@ from type %G_TYPE_BOXED. For string values, indicates that the string contained is canonical and will exist for the duration of the process. See g_value_set_interned_string(). - Checks whether @value contains a string which is canonical. - a valid #GValue structure @@ -10717,12 +10236,10 @@ exist for the duration of the process. See g_value_set_interned_string(). but used verbatim. This does not affect ref-counted types like objects. This does not affect usage of g_value_copy(), the data will be copied if it is not ref-counted. - Get the type identifier of @value. - A #GValue structure. @@ -10731,7 +10248,6 @@ be copied if it is not ref-counted. Gets the type name of @value. - A #GValue structure. @@ -10742,7 +10258,6 @@ be copied if it is not ref-counted. This is the signature of va_list marshaller functions, an optional marshaller that can be used in some situations to avoid marshalling the signal argument into GValues. - @@ -10794,7 +10309,6 @@ types. #GValue users cannot make any assumptions about how data is stored within the 2 element @data union, and the @g_type member should only be accessed through the G_VALUE_TYPE() macro. - @@ -10805,7 +10319,6 @@ only be accessed through the G_VALUE_TYPE() macro. Copies the value of @src_value into @dest_value. - @@ -10825,7 +10338,6 @@ only be accessed through the G_VALUE_TYPE() macro. the boxed value is duplicated and needs to be later freed with g_boxed_free(), e.g. like: g_boxed_free (G_VALUE_TYPE (@value), return_value); - boxed contents of @value @@ -10841,7 +10353,6 @@ return_value); Get the contents of a %G_TYPE_OBJECT derived #GValue, increasing its reference count. If the contents of the #GValue are %NULL, then %NULL will be returned. - object content of @value, should be unreferenced when no longer needed. @@ -10857,7 +10368,6 @@ its reference count. If the contents of the #GValue are %NULL, then Get the contents of a %G_TYPE_PARAM #GValue, increasing its reference count. - #GParamSpec content of @value, should be unreferenced when no longer needed. @@ -10872,7 +10382,6 @@ reference count. Get a copy the contents of a %G_TYPE_STRING #GValue. - a newly allocated copy of the string content of @value @@ -10887,7 +10396,6 @@ reference count. Get the contents of a variant #GValue, increasing its refcount. The returned #GVariant is never floating. - variant contents of @value (may be %NULL); should be unreffed using g_variant_unref() when no longer needed @@ -10903,7 +10411,6 @@ reference count. Determines if @value will fit inside the size of a pointer value. This is an internal function introduced mainly for C marshallers. - %TRUE if @value will fit inside a pointer value. @@ -10917,7 +10424,6 @@ This is an internal function introduced mainly for C marshallers. Get the contents of a %G_TYPE_BOOLEAN #GValue. - boolean contents of @value @@ -10931,7 +10437,6 @@ This is an internal function introduced mainly for C marshallers. Get the contents of a %G_TYPE_BOXED derived #GValue. - boxed contents of @value @@ -10949,7 +10454,6 @@ type is unsigned, such as ARM and PowerPC. See g_value_get_schar(). Get the contents of a %G_TYPE_CHAR #GValue. This function's return type is broken, see g_value_get_schar() - character contents of @value @@ -10963,7 +10467,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_DOUBLE #GValue. - double contents of @value @@ -10977,7 +10480,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_ENUM #GValue. - enum contents of @value @@ -10991,7 +10493,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_FLAGS #GValue. - flags contents of @value @@ -11005,7 +10506,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_FLOAT #GValue. - float contents of @value @@ -11019,7 +10519,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_GTYPE #GValue. - the #GType stored in @value @@ -11033,7 +10532,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_INT #GValue. - integer contents of @value @@ -11047,7 +10545,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_INT64 #GValue. - 64bit integer contents of @value @@ -11061,7 +10558,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_LONG #GValue. - long integer contents of @value @@ -11075,7 +10571,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_OBJECT derived #GValue. - object contents of @value @@ -11089,7 +10584,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_PARAM #GValue. - #GParamSpec content of @value @@ -11103,7 +10597,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a pointer #GValue. - pointer contents of @value @@ -11117,7 +10610,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_CHAR #GValue. - signed 8 bit integer contents of @value @@ -11131,7 +10623,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_STRING #GValue. - string content of @value @@ -11145,7 +10636,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_UCHAR #GValue. - unsigned character contents of @value @@ -11159,7 +10649,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_UINT #GValue. - unsigned integer contents of @value @@ -11173,7 +10662,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_UINT64 #GValue. - unsigned 64bit integer contents of @value @@ -11187,7 +10675,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a %G_TYPE_ULONG #GValue. - unsigned long integer contents of @value @@ -11201,7 +10688,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a variant #GValue. - variant contents of @value (may be %NULL) @@ -11215,7 +10701,6 @@ Get the contents of a %G_TYPE_CHAR #GValue. Initializes @value with the default value of @type. - the #GValue structure that has been passed in @@ -11239,7 +10724,6 @@ Note: The @value will be initialised with the exact type of @instance. If you wish to set the @value's type to a different GType (such as a parent class GType), you need to manually call g_value_init() and g_value_set_instance(). - @@ -11258,7 +10742,6 @@ g_value_init() and g_value_set_instance(). Returns the value contents as pointer. This function asserts that g_value_fits_pointer() returned %TRUE for the passed in value. This is an internal function introduced mainly for C marshallers. - the value contents as pointer @@ -11273,7 +10756,6 @@ This is an internal function introduced mainly for C marshallers. Clears the current value in @value and resets it to the default value (as if the value had just been initialized). - the #GValue structure that has been passed in @@ -11287,7 +10769,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_BOOLEAN #GValue to @v_boolean. - @@ -11304,7 +10785,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed. - @@ -11322,7 +10802,6 @@ This is an internal function introduced mainly for C marshallers. This is an internal function introduced mainly for C marshallers. Use g_value_take_boxed() instead. - @@ -11340,7 +10819,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_CHAR #GValue to @v_char. This function's input type is broken, see g_value_set_schar() - @@ -11357,7 +10835,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_DOUBLE #GValue to @v_double. - @@ -11374,7 +10851,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_ENUM #GValue to @v_enum. - @@ -11391,7 +10867,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_FLAGS #GValue to @v_flags. - @@ -11408,7 +10883,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_FLOAT #GValue to @v_float. - @@ -11425,7 +10899,6 @@ This is an internal function introduced mainly for C marshallers. Set the contents of a %G_TYPE_GTYPE #GValue to @v_gtype. - @@ -11443,7 +10916,6 @@ This is an internal function introduced mainly for C marshallers. Sets @value from an instantiatable type via the value_table's collect_value() function. - @@ -11460,7 +10932,6 @@ value_table's collect_value() function. Set the contents of a %G_TYPE_INT #GValue to @v_int. - @@ -11477,7 +10948,6 @@ value_table's collect_value() function. Set the contents of a %G_TYPE_INT64 #GValue to @v_int64. - @@ -11496,7 +10966,6 @@ value_table's collect_value() function. Set the contents of a %G_TYPE_STRING #GValue to @v_string. The string is assumed to be static and interned (canonical, for example from g_intern_string()), and is thus not duplicated when setting the #GValue. - @@ -11513,7 +10982,6 @@ g_intern_string()), and is thus not duplicated when setting the #GValue. Set the contents of a %G_TYPE_LONG #GValue to @v_long. - @@ -11540,7 +11008,6 @@ need it), use g_value_take_object() instead. It is important that your #GValue holds a reference to @v_object (either its own, or one it has taken) to ensure that the object won't be destroyed while the #GValue still exists). - @@ -11558,7 +11025,6 @@ the #GValue still exists). This is an internal function introduced mainly for C marshallers. Use g_value_take_object() instead. - @@ -11575,7 +11041,6 @@ the #GValue still exists). Set the contents of a %G_TYPE_PARAM #GValue to @param. - @@ -11593,7 +11058,6 @@ the #GValue still exists). This is an internal function introduced mainly for C marshallers. Use g_value_take_param() instead. - @@ -11610,7 +11074,6 @@ the #GValue still exists). Set the contents of a pointer #GValue to @v_pointer. - @@ -11627,7 +11090,6 @@ the #GValue still exists). Set the contents of a %G_TYPE_CHAR #GValue to @v_char. - @@ -11646,7 +11108,6 @@ the #GValue still exists). Set the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed. The boxed value is assumed to be static, and is thus not duplicated when setting the #GValue. - @@ -11668,7 +11129,6 @@ when setting the #GValue. If the the string is a canonical string, using g_value_set_interned_string() is more appropriate. - @@ -11685,7 +11145,6 @@ is more appropriate. Set the contents of a %G_TYPE_STRING #GValue to @v_string. - @@ -11703,7 +11162,6 @@ is more appropriate. This is an internal function introduced mainly for C marshallers. Use g_value_take_string() instead. - @@ -11720,7 +11178,6 @@ is more appropriate. Set the contents of a %G_TYPE_UCHAR #GValue to @v_uchar. - @@ -11737,7 +11194,6 @@ is more appropriate. Set the contents of a %G_TYPE_UINT #GValue to @v_uint. - @@ -11754,7 +11210,6 @@ is more appropriate. Set the contents of a %G_TYPE_UINT64 #GValue to @v_uint64. - @@ -11771,7 +11226,6 @@ is more appropriate. Set the contents of a %G_TYPE_ULONG #GValue to @v_ulong. - @@ -11789,7 +11243,6 @@ is more appropriate. Set the contents of a variant #GValue to @variant. If the variant is floating, it is consumed. - @@ -11808,7 +11261,6 @@ If the variant is floating, it is consumed. Sets the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed and takes over the ownership of the caller’s reference to @v_boxed; the caller doesn’t have to unref it any more. - @@ -11831,7 +11283,6 @@ count of the object is not increased). If you want the #GValue to hold its own reference to @v_object, use g_value_set_object() instead. - @@ -11850,7 +11301,6 @@ g_value_set_object() instead. Sets the contents of a %G_TYPE_PARAM #GValue to @param and takes over the ownership of the caller’s reference to @param; the caller doesn’t have to unref it any more. - @@ -11867,7 +11317,6 @@ doesn’t have to unref it any more. Sets the contents of a %G_TYPE_STRING #GValue to @v_string. - @@ -11895,7 +11344,6 @@ If you want the #GValue to hold its own reference to @variant, use g_value_set_variant() instead. This is an internal function introduced mainly for C marshallers. - @@ -11918,7 +11366,6 @@ value types might incur precision lossage. Especially transformations into strings might reveal seemingly arbitrary results and shouldn't be relied upon for production code (such as rcfile value or object property serialization). - Whether a transformation rule was found and could be applied. Upon failing transformations, @dest_value is left untouched. @@ -11940,7 +11387,6 @@ as rcfile value or object property serialization). this releases all resources associated with this GValue. An unset value is the same as an uninitialized (zero-filled) #GValue structure. - @@ -11955,7 +11401,6 @@ structure. Registers a value transformation function for use in g_value_transform(). A previously registered transformation function for @src_type and @dest_type will be replaced. - @@ -11978,7 +11423,6 @@ will be replaced. Returns whether a #GValue of type @src_type can be copied into a #GValue of type @dest_type. - %TRUE if g_value_copy() is possible with @src_type and @dest_type. @@ -11999,7 +11443,6 @@ a #GValue of type @dest_type. of type @src_type into values of type @dest_type. Note that for the types to be transformable, they must be compatible or a transformation function must be registered. - %TRUE if the transformation is possible, %FALSE otherwise. @@ -12018,7 +11461,6 @@ transformation function must be registered. A #GValueArray contains an array of #GValue elements. - number of values contained in the array @@ -12035,7 +11477,6 @@ transformation function must be registered. for @n_prealloced elements. New arrays always contain 0 elements, regardless of the value of @n_prealloced. Use #GArray and g_array_sized_new() instead. - a newly allocated #GValueArray with 0 values @@ -12051,7 +11492,6 @@ regardless of the value of @n_prealloced. Insert a copy of @value as last element of @value_array. If @value is %NULL, an uninitialized value is appended. Use #GArray and g_array_append_val() instead. - the #GValueArray passed in as @value_array @@ -12071,7 +11511,6 @@ regardless of the value of @n_prealloced. Construct an exact copy of a #GValueArray by duplicating all its contents. Use #GArray and g_array_ref() instead. - Newly allocated copy of #GValueArray @@ -12086,7 +11525,6 @@ contents. Free a #GValueArray including its contents. Use #GArray and g_array_unref() instead. - @@ -12100,7 +11538,6 @@ contents. Return a pointer to the value at @index_ containd in @value_array. Use g_array_index() instead. - pointer to a value at @index_ in @value_array @@ -12120,7 +11557,6 @@ contents. Insert a copy of @value at specified position into @value_array. If @value is %NULL, an uninitialized value is inserted. Use #GArray and g_array_insert_val() instead. - the #GValueArray passed in as @value_array @@ -12144,7 +11580,6 @@ is %NULL, an uninitialized value is inserted. Insert a copy of @value as first element of @value_array. If @value is %NULL, an uninitialized value is prepended. Use #GArray and g_array_prepend_val() instead. - the #GValueArray passed in as @value_array @@ -12163,7 +11598,6 @@ is %NULL, an uninitialized value is inserted. Remove the value at position @index_ from @value_array. Use #GArray and g_array_remove_index() instead. - the #GValueArray passed in as @value_array @@ -12187,7 +11621,6 @@ the semantics of #GCompareFunc. The current implementation uses the same sorting algorithm as standard C qsort() function. Use #GArray and g_array_sort(). - the #GValueArray passed in as @value_array @@ -12210,7 +11643,6 @@ to the semantics of #GCompareDataFunc. The current implementation uses the same sorting algorithm as standard C qsort() function. Use #GArray and g_array_sort_with_data(). - the #GValueArray passed in as @value_array @@ -12236,7 +11668,6 @@ C qsort() function. g_value_register_transform_func(). @dest_value will be initialized to the correct destination type. - @@ -12256,7 +11687,6 @@ g_value_register_transform_func(). triggered when the object is finalized. Since the object is already being finalized when the #GWeakNotify is called, there's not much you could do with the object, apart from e.g. using its address as hash-index or the like. - @@ -12292,9 +11722,7 @@ before it was disposed will continue to point to %NULL. If #GWeakRefs are taken after the object is disposed and re-referenced, they will continue to point to it until its refcount goes back to zero, at which point they too will be invalidated. - - @@ -12305,7 +11733,6 @@ After this call, the #GWeakRef is left in an undefined state. You should only call this on a #GWeakRef that previously had g_weak_ref_init() called on it. - @@ -12327,7 +11754,6 @@ its last reference at the same time in a different thread. The caller should release the resulting reference in the usual way, by using g_object_unref(). - the object pointed to by @weak_ref, or %NULL if it was empty @@ -12350,7 +11776,6 @@ This function should always be matched with a call to g_weak_ref_clear(). It is not necessary to use this function for a #GWeakRef in static storage because it will already be properly initialised. Just use g_weak_ref_set() directly. - @@ -12372,7 +11797,6 @@ properly initialised. Just use g_weak_ref_set() directly. You must own a strong reference on @object while calling this function. - @@ -12426,7 +11850,6 @@ If assertions are disabled via `G_DISABLE_ASSERT`, this macro just calls g_object_unref() without any further checks. This macro should only be used in regression tests. - an object @@ -12435,7 +11858,6 @@ This macro should only be used in regression tests. Provide a copy of a boxed structure @src_boxed which is of type @boxed_type. - The newly created copy of the boxed structure. @@ -12454,7 +11876,6 @@ This macro should only be used in regression tests. Free the boxed structure @boxed which is of type @boxed_type. - @@ -12473,7 +11894,6 @@ This macro should only be used in regression tests. This function creates a new %G_TYPE_BOXED derived type id for a new boxed type with name @name. Boxed type handling functions have to be provided to copy and free opaque boxed structures of this type. - New %G_TYPE_BOXED derived type id for @name. @@ -12498,7 +11918,6 @@ provided to copy and free opaque boxed structures of this type. take two boxed pointers as arguments and return a boolean. If you have such a signal, you will probably also need to use an accumulator, such as g_signal_accumulator_true_handled(). - @@ -12538,7 +11957,6 @@ accumulator, such as g_signal_accumulator_true_handled(). A marshaller for a #GCClosure with a callback of type `gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type. - @@ -12573,7 +11991,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `gchar* (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data)`. - @@ -12608,7 +12025,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)`. - @@ -12643,7 +12059,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)`. - @@ -12678,7 +12093,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gchar arg1, gpointer user_data)`. - @@ -12713,7 +12127,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)`. - @@ -12748,7 +12161,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes an enumeration type.. - @@ -12783,7 +12195,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gint arg1, gpointer user_data)` where the #gint parameter denotes a flags type. - @@ -12818,7 +12229,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)`. - @@ -12853,7 +12263,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gint arg1, gpointer user_data)`. - @@ -12888,7 +12297,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, glong arg1, gpointer user_data)`. - @@ -12923,7 +12331,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)`. - @@ -12958,7 +12365,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)`. - @@ -12993,7 +12399,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)`. - @@ -13028,7 +12433,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)`. - @@ -13063,7 +12467,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, guchar arg1, gpointer user_data)`. - @@ -13098,7 +12501,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, guint arg1, gpointer user_data)`. - @@ -13133,7 +12535,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)`. - @@ -13168,7 +12569,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gulong arg1, gpointer user_data)`. - @@ -13203,7 +12603,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data)`. - @@ -13238,7 +12637,6 @@ denotes a flags type. A marshaller for a #GCClosure with a callback of type `void (*callback) (gpointer instance, gpointer user_data)`. - @@ -13276,7 +12674,6 @@ denotes a flags type. Normally this function is not passed explicitly to g_signal_new(), but used automatically by GLib when specifying a %NULL marshaller. - @@ -13317,7 +12714,6 @@ but used automatically by GLib when specifying a %NULL marshaller. the last parameter. @destroy_data will be called as a finalize notifier on the #GClosure. - a floating reference to a new #GCClosure @@ -13343,7 +12739,6 @@ calls g_object_watch_closure() on @object and the created closure. This function is useful when you have a callback closely associated with a #GObject, and want the callback to no longer run after the object is is freed. - a new #GCClosure @@ -13365,7 +12760,6 @@ and calls g_object_watch_closure() on @object and the created closure. This function is useful when you have a callback closely associated with a #GObject, and want the callback to no longer run after the object is is freed. - a new #GCClosure @@ -13386,7 +12780,6 @@ after the object is is freed. the first parameter. @destroy_data will be called as a finalize notifier on the #GClosure. - a floating reference to a new #GCClosure @@ -13417,7 +12810,6 @@ pointer is set to %NULL. A macro is also included that allows this function to be used without pointer casts. - @@ -13437,7 +12829,6 @@ If the handler ID is 0 then this function does nothing. A macro is also included that allows this function to be used without pointer casts. - @@ -13464,7 +12855,6 @@ and the pointer is set to %NULL. A macro is also included that allows this function to be used without pointer casts. The function itself is static inline, so its address may vary between compilation units. - The memory address of a pointer @@ -13492,7 +12882,6 @@ my_enum_complete_type_info (GTypePlugin *plugin, g_enum_complete_type_info (type, info, values); } ]| - @@ -13515,7 +12904,6 @@ my_enum_complete_type_info (GTypePlugin *plugin, Returns the #GEnumValue for a value. - the #GEnumValue for @value, or %NULL if @value is not a member of the enumeration @@ -13534,7 +12922,6 @@ my_enum_complete_type_info (GTypePlugin *plugin, Looks up a #GEnumValue by name. - the #GEnumValue with name @name, or %NULL if the enumeration doesn't have a member @@ -13554,7 +12941,6 @@ my_enum_complete_type_info (GTypePlugin *plugin, Looks up a #GEnumValue by nickname. - the #GEnumValue with nickname @nick, or %NULL if the enumeration doesn't have a member @@ -13578,7 +12964,6 @@ my_enum_complete_type_info (GTypePlugin *plugin, It is normally more convenient to let [glib-mkenums][glib-mkenums], generate a my_enum_get_type() function from a usual C enumeration definition than to write one yourself using g_enum_register_static(). - The new type identifier. @@ -13602,7 +12987,6 @@ definition than to write one yourself using g_enum_register_static(). This is intended to be used for debugging purposes. The format of the output may change in the future. - a newly-allocated text string @@ -13651,7 +13035,6 @@ g_type_class_unref (enum_class); This function is meant to be called from the complete_type_info() function of a #GTypePlugin implementation, see the example for g_enum_complete_type_info() above. - @@ -13674,7 +13057,6 @@ g_enum_complete_type_info() above. Returns the first #GFlagsValue which is set in @value. - the first #GFlagsValue which is set in @value, or %NULL if none is set @@ -13693,7 +13075,6 @@ g_enum_complete_type_info() above. Looks up a #GFlagsValue by name. - the #GFlagsValue with name @name, or %NULL if there is no flag with that name @@ -13712,7 +13093,6 @@ g_enum_complete_type_info() above. Looks up a #GFlagsValue by nickname. - the #GFlagsValue with nickname @nick, or %NULL if there is no flag with that nickname @@ -13735,7 +13115,6 @@ g_enum_complete_type_info() above. It is normally more convenient to let [glib-mkenums][glib-mkenums] generate a my_flags_get_type() function from a usual C enumeration definition than to write one yourself using g_flags_register_static(). - The new type identifier. @@ -13759,7 +13138,6 @@ sorted. Any extra bits will be shown at the end as a hexadecimal number. This is intended to be used for debugging purposes. The format of the output may change in the future. - a newly-allocated text string @@ -13906,7 +13284,6 @@ character must be a letter (a–z or A–Z) or an underscore (‘ characters can be letters, numbers or any of ‘-_+’. - @@ -14008,7 +13385,6 @@ values, and to allow for more values to be added in future without breaking API. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14041,7 +13417,6 @@ See g_param_spec_internal() for details on property names. derived property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14071,7 +13446,6 @@ See g_param_spec_internal() for details on property names. Creates a new #GParamSpecChar instance specifying a %G_TYPE_CHAR property. - a newly created parameter specification @@ -14112,7 +13486,6 @@ See g_param_spec_internal() for details on property names. property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14153,7 +13526,6 @@ See g_param_spec_internal() for details on property names. property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14190,7 +13562,6 @@ See g_param_spec_internal() for details on property names. property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14226,7 +13597,6 @@ See g_param_spec_internal() for details on property names. Creates a new #GParamSpecFloat instance specifying a %G_TYPE_FLOAT property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14267,7 +13637,6 @@ See g_param_spec_internal() for details on property names. %G_TYPE_GTYPE property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14300,7 +13669,6 @@ See g_param_spec_internal() for details on property names. Creates a new #GParamSpecInt instance specifying a %G_TYPE_INT property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14340,7 +13708,6 @@ See g_param_spec_internal() for details on property names. Creates a new #GParamSpecInt64 instance specifying a %G_TYPE_INT64 property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14380,7 +13747,6 @@ See g_param_spec_internal() for details on property names. Creates a new #GParamSpecLong instance specifying a %G_TYPE_LONG property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14421,7 +13787,6 @@ See g_param_spec_internal() for details on property names. derived property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14453,7 +13818,6 @@ See g_param_spec_internal() for details on property names. Creates a new property of type #GParamSpecOverride. This is used to direct operations to another paramspec, and will not be directly useful unless you are implementing a new base type similar to GObject. - the newly created #GParamSpec @@ -14474,7 +13838,6 @@ useful unless you are implementing a new base type similar to GObject. property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14508,7 +13871,6 @@ Where possible, it is better to use g_param_spec_object() or g_param_spec_boxed() to expose memory management information. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14539,7 +13901,6 @@ If @type_prefixing is %TRUE, lookups in the newly created pool will allow to specify the owner as a colon-separated prefix of the property name, like "GtkContainer:border-width". This feature is deprecated, so you should always set @type_prefixing to %FALSE. - a newly allocated #GParamSpecPool. @@ -14555,7 +13916,6 @@ deprecated, so you should always set @type_prefixing to %FALSE. Creates a new #GParamSpecString instance. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14585,7 +13945,6 @@ See g_param_spec_internal() for details on property names. Creates a new #GParamSpecUChar instance specifying a %G_TYPE_UCHAR property. - a newly created parameter specification @@ -14625,7 +13984,6 @@ See g_param_spec_internal() for details on property names. Creates a new #GParamSpecUInt instance specifying a %G_TYPE_UINT property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14666,7 +14024,6 @@ See g_param_spec_internal() for details on property names. property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14707,7 +14064,6 @@ See g_param_spec_internal() for details on property names. property. See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14749,7 +14105,6 @@ property. #GValue structures for this property can be accessed with g_value_set_uint() and g_value_get_uint(). See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14784,7 +14139,6 @@ See g_param_spec_internal() for details on property names. can be accessed with g_value_set_boxed() and g_value_get_boxed(). See g_param_spec_internal() for details on property names. - a newly created parameter specification @@ -14820,7 +14174,6 @@ property. If @default_value is floating, it is consumed. See g_param_spec_internal() for details on property names. - the newly created #GParamSpec @@ -14858,7 +14211,6 @@ See g_param_spec_internal() for details on property names. #G_TYPE_PARAM. The type system uses the information contained in the #GParamSpecTypeInfo structure pointed to by @info to manage the #GParamSpec type and its instances. - The new type identifier. @@ -14882,7 +14234,6 @@ transformed @dest_value complied to @pspec without modifications. See also g_value_type_transformable(), g_value_transform() and g_param_value_validate(). - %TRUE if transformation and validation were successful, %FALSE otherwise and @dest_value is left untouched. @@ -14910,7 +14261,6 @@ without modifications Checks whether @value contains the default value as specified in @pspec. - whether @value contains the canonical default for this @pspec @@ -14928,7 +14278,6 @@ without modifications Sets @value to its default value as specified in @pspec. - @@ -14964,7 +14313,6 @@ that integers stored in @value may not be smaller than -42 and not be greater than +42. If @value contains an integer outside of this range, it is modified accordingly, so the resulting value will fit into the range -42 .. +42. - whether modifying @value was necessary to ensure validity @@ -14984,7 +14332,6 @@ range -42 .. +42. Compares @value1 with @value2 according to @pspec, and return -1, 0 or +1, if @value1 is found to be less than, equal to or greater than @value2, respectively. - -1, 0 or +1, for a less than, equal to or greater than result @@ -15007,7 +14354,6 @@ respectively. Creates a new %G_TYPE_POINTER derived type id for a new pointer type with name @name. - a new %G_TYPE_POINTER derived type id for @name. @@ -15044,7 +14390,6 @@ One convenient usage of this function is in implementing property setters: g_object_notify (foo, "bar"); } ]| - a pointer to a #GObject reference @@ -15081,7 +14426,6 @@ One convenient usage of this function is in implementing property setters: g_object_notify (foo, "bar"); } ]| - the memory address of a pointer @@ -15103,7 +14447,6 @@ usually want the signal connection to override the class handler). This accumulator will use the return value from the first signal handler that is run as the return value for the signal and not run any further handlers (ie: the first handler "wins"). - standard #GSignalAccumulator result @@ -15135,7 +14478,6 @@ callbacks will be invoked, while a return of %FALSE allows the emission to continue. The idea here is that a %TRUE return indicates that the callback handled the signal, and no further handling is needed. - standard #GSignalAccumulator result @@ -15163,7 +14505,6 @@ handling is needed. Adds an emission hook for a signal, which will get called for any emission of that signal, independent of the instance. This is possible only for signals which don't have #G_SIGNAL_NO_HOOKS flag set. - the hook id, for later use with g_signal_remove_emission_hook(). @@ -15196,7 +14537,6 @@ for signals which don't have #G_SIGNAL_NO_HOOKS flag set. be called from an overridden class closure; see g_signal_override_class_closure() and g_signal_override_class_handler(). - @@ -15220,7 +14560,6 @@ g_signal_override_class_handler(). only be called from an overridden class closure; see g_signal_override_class_closure() and g_signal_override_class_handler(). - @@ -15245,7 +14584,6 @@ The handler will be called before the default handler of the signal. See [memory management of signal handlers][signal-memory-management] for details on how to handle the return value and memory management of @data. - the instance to connect to. @@ -15265,7 +14603,6 @@ details on how to handle the return value and memory management of @data. Connects a #GCallback function to a signal for a particular object. The handler will be called after the default handler of the signal. - the instance to connect to. @@ -15283,7 +14620,6 @@ The handler will be called after the default handler of the signal. Connects a closure to a signal for a particular object. - the handler ID (always greater than 0 for successful connections) @@ -15310,7 +14646,6 @@ The handler will be called after the default handler of the signal. Connects a closure to a signal for a particular object. - the handler ID (always greater than 0 for successful connections) @@ -15345,7 +14680,6 @@ to g_signal_connect(), but allows to provide a #GClosureNotify for the data which will be called when the signal handler is disconnected and no longer used. Specify @connect_flags if you need `..._after()` or `..._swapped()` variants of this function. - the handler ID (always greater than 0 for successful connections) @@ -15386,7 +14720,6 @@ When the @gobject is destroyed the signal handler will be automatically disconnected. Note that this is not currently threadsafe (ie: emitting a signal while @gobject is being destroyed in another thread is not safe). - the handler id. @@ -15442,7 +14775,6 @@ button_clicked_cb (GtkButton *button, GtkWidget *other_widget) g_signal_connect (button, "clicked", (GCallback) button_clicked_cb, other_widget); ]| - the instance to connect to. @@ -15463,7 +14795,6 @@ g_signal_connect (button, "clicked", Note that g_signal_emit() resets the return value to the default if no handlers are connected, in contrast to g_signal_emitv(). - @@ -15493,7 +14824,6 @@ if no handlers are connected, in contrast to g_signal_emitv(). Note that g_signal_emit_by_name() resets the return value to the default if no handlers are connected, in contrast to g_signal_emitv(). - @@ -15519,7 +14849,6 @@ if no handlers are connected, in contrast to g_signal_emitv(). Note that g_signal_emit_valist() resets the return value to the default if no handlers are connected, in contrast to g_signal_emitv(). - @@ -15550,7 +14879,6 @@ if no handlers are connected, in contrast to g_signal_emitv(). Note that g_signal_emitv() doesn't change @return_value if no handlers are connected, in contrast to g_signal_emit() and g_signal_emit_valist(). - @@ -15581,7 +14909,6 @@ specified signal returns a value, but may be ignored otherwise. Returns the invocation hint of the innermost signal emission of instance. - the invocation hint of the innermost signal emission. @@ -15602,7 +14929,6 @@ blocked before to become active again. The @handler_id has to be a valid signal handler id, connected to a signal of @instance. - @@ -15624,7 +14950,6 @@ connected to. The @handler_id becomes invalid and may be reused. The @handler_id has to be a valid signal handler id, connected to a signal of @instance. - @@ -15645,7 +14970,6 @@ The criteria mask is passed as an OR-ed combination of #GSignalMatchType flags, and the criteria values are passed as arguments. The match @mask has to be non-0 for successful matches. If no handler was found, 0 is returned. - A valid non-0 signal handler id for a successful match. @@ -15684,7 +15008,6 @@ If no handler was found, 0 is returned. Returns whether @handler_id is the ID of a handler connected to @instance. - whether @handler_id identifies a handler connected to @instance. @@ -15714,7 +15037,6 @@ proceeded yet). The @handler_id has to be a valid id of a signal handler that is connected to a signal of @instance and is currently blocked. - @@ -15731,7 +15053,6 @@ connected to a signal of @instance and is currently blocked. Blocks all handlers on an instance that match @func and @data. - The instance to block handlers from. @@ -15752,7 +15073,6 @@ Passing at least one of the %G_SIGNAL_MATCH_CLOSURE, %G_SIGNAL_MATCH_FUNC or %G_SIGNAL_MATCH_DATA match flags is required for successful matches. If no handlers were found, 0 is returned, the number of blocked handlers otherwise. - The number of handlers that matched. @@ -15793,7 +15113,6 @@ otherwise. Destroy all signal handlers of a type instance. This function is an implementation detail of the #GObject dispose implementation, and should not be used outside of the type system. - @@ -15806,7 +15125,6 @@ and should not be used outside of the type system. Disconnects all handlers on an instance that match @data. - The instance to remove handlers from @@ -15818,7 +15136,6 @@ and should not be used outside of the type system. Disconnects all handlers on an instance that match @func and @data. - The instance to remove handlers from. @@ -15840,7 +15157,6 @@ passed as arguments. Passing at least one of the %G_SIGNAL_MATCH_DATA match flags is required for successful matches. If no handlers were found, 0 is returned, the number of disconnected handlers otherwise. - The number of handlers that matched. @@ -15879,7 +15195,6 @@ disconnected handlers otherwise. Unblocks all handlers on an instance that match @func and @data. - The instance to unblock handlers from. @@ -15901,7 +15216,6 @@ or %G_SIGNAL_MATCH_DATA match flags is required for successful matches. If no handlers were found, 0 is returned, the number of unblocked handlers otherwise. The match criteria should not apply to any handlers that are not currently blocked. - The number of handlers that matched. @@ -15955,7 +15269,6 @@ One example of when you might use this is when the arguments to the signal are difficult to compute. A class implementor may opt to not emit the signal if no one is attached anyway, thus saving the cost of building the arguments. - %TRUE if a handler is connected to the signal, %FALSE otherwise. @@ -15987,7 +15300,6 @@ which need to be validated at run-time before actually trying to create them. See [canonical parameter names][canonical-parameter-names] for details of the rules for valid names. The rules for signal names are the same as those for property names. - %TRUE if @name is a valid signal name, %FALSE otherwise. @@ -16003,7 +15315,6 @@ for property names. Lists the signals by id that a certain instance or interface type created. Further information about the signals can be acquired through g_signal_query(). - Newly allocated array of signal IDs. @@ -16033,7 +15344,6 @@ example, using g_type_class_ref()) for this function to work, as signals are always installed during class initialization. See g_signal_new() for details on allowed signal names. - the signal's identifying number, or 0 if no signal was found. @@ -16053,7 +15363,6 @@ See g_signal_new() for details on allowed signal names. Given the signal's identifier, finds its name. Two different signals may have the same name, if they have differing types. - the signal name, or %NULL if the signal number was invalid. @@ -16090,7 +15399,6 @@ instead of g_cclosure_marshal_generic(). If @c_marshaller is non-%NULL, you need to also specify a va_marshaller using g_signal_set_va_marshaller() or the generic va_marshaller will be used. - the signal id @@ -16162,7 +15470,6 @@ See g_signal_new() for information about signal names. If c_marshaller is %NULL, g_cclosure_marshal_generic() will be used as the marshaller for this signal. - the signal id @@ -16224,7 +15531,6 @@ See g_signal_new() for details on allowed signal names. If c_marshaller is %NULL, g_cclosure_marshal_generic() will be used as the marshaller for this signal. - the signal id @@ -16284,7 +15590,6 @@ See g_signal_new() for details on allowed signal names. If c_marshaller is %NULL, g_cclosure_marshal_generic() will be used as the marshaller for this signal. - the signal id @@ -16350,7 +15655,6 @@ from the type to which the signal belongs. See g_signal_chain_from_overridden() and g_signal_chain_from_overridden_handler() for how to chain up to the parent class closure from inside the overridden one. - @@ -16379,7 +15683,6 @@ type to which the signal belongs. See g_signal_chain_from_overridden() and g_signal_chain_from_overridden_handler() for how to chain up to the parent class closure from inside the overridden one. - @@ -16402,7 +15705,6 @@ parent class closure from inside the overridden one. Internal function to parse a signal name into its @signal_id and @detail quark. - Whether the signal name could successfully be parsed and @signal_id_p and @detail_p contain valid return values. @@ -16437,7 +15739,6 @@ structure to hold signal-specific information. If an invalid signal id is passed in, the @signal_id member of the #GSignalQuery is 0. All members filled into the #GSignalQuery structure should be considered constant and have to be left untouched. - @@ -16455,7 +15756,6 @@ be considered constant and have to be left untouched. Deletes an emission hook. - @@ -16476,7 +15776,6 @@ be considered constant and have to be left untouched. specialised form of the marshaller that can often be used for the common case of a single connected signal handler and avoids the overhead of #GValue. Its use is optional. - @@ -16503,7 +15802,6 @@ This will prevent the default method from running, if the signal was flag). Prints a warning if used on a signal which isn't being emitted. - @@ -16527,7 +15825,6 @@ Prints a warning if used on a signal which isn't being emitted. This is just like g_signal_stop_emission() except it will look up the signal id for you. - @@ -16546,7 +15843,6 @@ signal id for you. Creates a new closure which invokes the function found at the offset @struct_offset in the class structure of the interface or classed type identified by @itype. - a floating reference to a new #GCClosure @@ -16655,7 +15951,6 @@ disconnected for some reason. If the source is not one of the standard GLib types, the @closure_callback and @closure_marshal fields of the #GSourceFuncs structure must have been filled in with pointers to appropriate functions. - @@ -16681,7 +15976,6 @@ If the source is not one of the standard GLib types, the @closure_callback and @closure_marshal fields of the #GSourceFuncs structure must have been filled in with pointers to appropriate functions. - @@ -16697,7 +15991,6 @@ functions. #GValue. The main purpose of this function is to describe #GValue contents for debugging output, the way in which the contents are described may change between different GLib versions. - Newly allocated string. @@ -16717,7 +16010,6 @@ until one of them returns %TRUE. The functions have to check the class id passed in to figure whether they actually want to cache the class of this type, since all classes are routed through the same #GTypeClassCacheFunc chain. - @@ -16743,7 +16035,6 @@ This function should be called in the type's get_type() function after the type is registered. The private structure can be retrieved using the G_TYPE_CLASS_GET_PRIVATE() macro. - @@ -16759,7 +16050,6 @@ G_TYPE_CLASS_GET_PRIVATE() macro. - @@ -16782,7 +16072,6 @@ that depends on the interfaces of a class. For instance, the implementation of #GObject uses this facility to check that an object implements all of the properties that are defined on its interfaces. - @@ -16802,7 +16091,6 @@ interfaces. Adds @interface_type to the dynamic @instantiable_type. The information contained in the #GTypePlugin structure pointed to by @plugin is used to manage the relationship. - @@ -16825,7 +16113,6 @@ is used to manage the relationship. Adds @interface_type to the static @instantiable_type. The information contained in the #GInterfaceInfo structure pointed to by @info is used to manage the relationship. - @@ -16846,7 +16133,6 @@ pointed to by @info is used to manage the relationship. - @@ -16860,7 +16146,6 @@ pointed to by @info is used to manage the relationship. - @@ -16876,7 +16161,6 @@ pointed to by @info is used to manage the relationship. Private helper function to aid implementation of the G_TYPE_CHECK_INSTANCE() macro. - %TRUE if @instance is valid, %FALSE otherwise @@ -16889,7 +16173,6 @@ G_TYPE_CHECK_INSTANCE() macro. - @@ -16903,7 +16186,6 @@ G_TYPE_CHECK_INSTANCE() macro. - @@ -16917,7 +16199,6 @@ G_TYPE_CHECK_INSTANCE() macro. - @@ -16931,7 +16212,6 @@ G_TYPE_CHECK_INSTANCE() macro. - @@ -16942,7 +16222,6 @@ G_TYPE_CHECK_INSTANCE() macro. - @@ -16953,7 +16232,6 @@ G_TYPE_CHECK_INSTANCE() macro. - @@ -16969,7 +16247,6 @@ G_TYPE_CHECK_INSTANCE() macro. Return a newly allocated and 0-terminated array of type IDs, listing the child types of @type. - Newly allocated and 0-terminated array of child types, free with g_free() @@ -16990,7 +16267,6 @@ the child types of @type. - @@ -17009,7 +16285,6 @@ except that the classes reference count isn't incremented. As a consequence, this function may return %NULL if the class of the type passed in does not currently exist (hasn't been referenced before). - the #GTypeClass structure for the given type ID or %NULL if the class does not @@ -17026,7 +16301,6 @@ referenced before). A more efficient version of g_type_class_peek() which works only for static types. - the #GTypeClass structure for the given type ID or %NULL if the class does not @@ -17044,7 +16318,6 @@ static types. Increments the reference count of the class structure belonging to @type. This function will demand-create the class if it doesn't exist already. - the #GTypeClass structure for the given type ID @@ -17074,7 +16347,6 @@ with zeros. Note: Do not use this function, unless you're implementing a fundamental type. Also language bindings should not use this function, but g_object_new() instead. - an allocated and initialized instance, subject to further treatment by the fundamental type implementation @@ -17090,7 +16362,6 @@ function, but g_object_new() instead. If the interface type @g_type is currently in use, returns its default interface vtable. - the default vtable for the interface, or %NULL if the type is not currently @@ -17115,7 +16386,6 @@ the type (the @base_init and @class_init members of #GTypeInfo). Calling g_type_default_interface_ref() is useful when you want to make sure that signals and properties for an interface have been installed. - the default vtable for the interface; call g_type_default_interface_unref() @@ -17135,7 +16405,6 @@ interface default vtable @g_iface. If the type is dynamic, then when no one is using the interface and all references have been released, the finalize function for the interface's default vtable (the @class_finalize member of #GTypeInfo) will be called. - @@ -17150,7 +16419,6 @@ vtable (the @class_finalize member of #GTypeInfo) will be called. Returns the length of the ancestry of the passed in type. This includes the type itself, so that e.g. a fundamental type has depth 1. - the depth of @type @@ -17175,7 +16443,6 @@ which _get_type() methods do on the first call). As a result, if you write a bare call to a _get_type() macro, it may get optimized out by the compiler. Using g_type_ensure() guarantees that the type's _get_type() method is called. - @@ -17192,7 +16459,6 @@ the type, if there is one. Like g_type_create_instance(), this function is reserved for implementors of fundamental types. - @@ -17208,7 +16474,6 @@ implementors of fundamental types. has been registered under this name (this is the preferred method to find out by name whether a specific type has been registered yet). - corresponding type ID or 0 @@ -17223,7 +16488,6 @@ yet). Internal function, used to extract the fundamental type ID portion. Use G_TYPE_FUNDAMENTAL() instead. - fundamental type ID @@ -17240,7 +16504,6 @@ Use G_TYPE_FUNDAMENTAL() instead. register a new fundamental type with g_type_register_fundamental(). The returned type ID represents the highest currently registered fundamental type identifier. - the next available fundamental type ID to be registered, or 0 if the type system ran out of fundamental type IDs @@ -17252,7 +16515,6 @@ fundamental type identifier. this is only available if GLib is built with debugging support and the instance_count debug flag is set (by setting the GOBJECT_DEBUG variable to include instance-count). - the number of instances allocated of the given type; if instance counts are not available, returns 0. @@ -17267,7 +16529,6 @@ variable to include instance-count). Returns the #GTypePlugin structure for @type. - the corresponding plugin if @type is a dynamic type, %NULL otherwise @@ -17287,7 +16548,6 @@ with g_type_set_qdata(). Note that this does not take subtyping into account; data attached to one type with g_type_set_qdata() cannot be retrieved from a subtype using g_type_get_qdata(). - the data, or %NULL if no data was found @@ -17309,7 +16569,6 @@ of registered types. Any time a type is registered this serial changes, which means you can cache information based on type lookups (such as g_type_from_name()) and know if the cache is still valid at a later time by comparing the current serial with the one at the type lookup. - An unsigned int, representing the state of type registrations @@ -17320,7 +16579,6 @@ time by comparing the current serial with the one at the type lookup. the type system is initialised automatically and this function does nothing. the type system is now initialised automatically - @@ -17333,7 +16591,6 @@ and this function does nothing. If you need to enable debugging features, use the GOBJECT_DEBUG environment variable. the type system is now initialised automatically - @@ -17351,7 +16608,6 @@ This means that any type implementing @interface_type must also implement @prerequisite_type. Prerequisites can be thought of as an alternative to interface derivation (which GType doesn't support). An interface can have at most one instantiatable prerequisite type. - @@ -17371,7 +16627,6 @@ at most one instantiatable prerequisite type. @interface_type which has been added to @instance_type, or %NULL if @interface_type has not been added to @instance_type or does not have a #GTypePlugin structure. See g_type_add_interface_dynamic(). - the #GTypePlugin for the dynamic interface @interface_type of @instance_type @@ -17391,7 +16646,6 @@ not have a #GTypePlugin structure. See g_type_add_interface_dynamic(). Returns the #GTypeInterface structure of an interface to which the passed in class conforms. - the #GTypeInterface structure of @iface_type if implemented by @instance_class, %NULL @@ -17411,7 +16665,6 @@ passed in class conforms. Returns the prerequisites of an interfaces type. - a newly-allocated zero-terminated array of #GType containing @@ -17435,7 +16688,6 @@ passed in class conforms. Return a newly allocated and 0-terminated array of type IDs, listing the interface types that @type conforms to. - Newly allocated and 0-terminated array of interface types, free with g_free() @@ -17459,7 +16711,6 @@ the interface types that @type conforms to. If @is_a_type is a derivable type, check whether @type is a descendant of @is_a_type. If @is_a_type is an interface, check whether @type conforms to it. - %TRUE if @type is a @is_a_type @@ -17482,7 +16733,6 @@ function (like all other GType API) cannot cope with invalid type IDs. %G_TYPE_INVALID may be passed to this function, as may be any other validly registered type ID, but randomized type IDs should not be passed in and will most likely lead to a crash. - static type name or %NULL @@ -17495,7 +16745,6 @@ not be passed in and will most likely lead to a crash. - @@ -17506,7 +16755,6 @@ not be passed in and will most likely lead to a crash. - @@ -17524,7 +16772,6 @@ derived directly from @root_type which is also a base class of @leaf_type. Given a root type and a leaf type, this function can be used to determine the types and order in which the leaf type is descended from the root type. - immediate child of @root_type and anchestor of @leaf_type @@ -17543,7 +16790,6 @@ descended from the root type. Return the direct parent type of the passed in type. If the passed in type has no parent, i.e. is a fundamental type, 0 is returned. - the parent type @@ -17557,7 +16803,6 @@ in type has no parent, i.e. is a fundamental type, 0 is returned. Get the corresponding quark of the type IDs name. - the type names quark or 0 @@ -17576,7 +16821,6 @@ type-specific information. If an invalid #GType is passed in, the @type member of the #GTypeQuery is 0. All members filled into the #GTypeQuery structure should be considered constant and have to be left untouched. - @@ -17598,7 +16842,6 @@ left untouched. #GTypePlugin structure pointed to by @plugin to manage the type and its instances (if not abstract). The value of @flags determines the nature (e.g. abstract or not) of the type. - the new type identifier or #G_TYPE_INVALID if registration failed @@ -17630,7 +16873,6 @@ The type system uses the information contained in the #GTypeInfo structure pointed to by @info and the #GTypeFundamentalInfo structure pointed to by @finfo to manage the type and its instances. The value of @flags determines additional characteristics of the fundamental type. - the predefined type identifier @@ -17664,7 +16906,6 @@ additional characteristics of the fundamental type. #GTypeInfo structure pointed to by @info to manage the type and its instances (if not abstract). The value of @flags determines the nature (e.g. abstract or not) of the type. - the new type identifier @@ -17693,7 +16934,6 @@ instances (if not abstract). The value of @flags determines the nature @parent_type. The value of @flags determines the nature (e.g. abstract or not) of the type. It works by filling a #GTypeInfo struct and calling g_type_register_static(). - the new type identifier @@ -17733,7 +16973,6 @@ struct and calling g_type_register_static(). Removes a previously installed #GTypeClassCacheFunc. The cache maintained by @cache_func has to be empty when calling g_type_remove_class_cache_func() to avoid leaks. - @@ -17751,7 +16990,6 @@ g_type_remove_class_cache_func() to avoid leaks. Removes an interface check function added with g_type_add_interface_check(). - @@ -17768,7 +17006,6 @@ g_type_add_interface_check(). Attaches arbitrary data to a type. - @@ -17788,7 +17025,6 @@ g_type_add_interface_check(). - @@ -17807,7 +17043,6 @@ g_type_add_interface_check(). Note that this function should only be used from source code that implements or has internal knowledge of the implementation of @type. - location of the #GTypeValueTable associated with @type or %NULL if there is no #GTypeValueTable associated with @type @@ -17847,7 +17082,6 @@ can be replaced by: Registers a value transformation function for use in g_value_transform(). A previously registered transformation function for @src_type and @dest_type will be replaced. - @@ -17870,7 +17104,6 @@ will be replaced. Returns whether a #GValue of type @src_type can be copied into a #GValue of type @dest_type. - %TRUE if g_value_copy() is possible with @src_type and @dest_type. @@ -17891,7 +17124,6 @@ a #GValue of type @dest_type. of type @src_type into values of type @dest_type. Note that for the types to be transformable, they must be compatible or a transformation function must be registered. - %TRUE if the transformation is possible, %FALSE otherwise. diff --git a/gir-files/Gio-2.0.gir b/gir-files/Gio-2.0.gir index f61925247..45fbe92e8 100644 --- a/gir-files/Gio-2.0.gir +++ b/gir-files/Gio-2.0.gir @@ -19,154 +19,132 @@ and/or use gtk-doc annotations. --> - - - - - - - - - - - - - - - - - - - - - - @@ -202,7 +180,6 @@ safety and for the state being enabled. Probably the only useful thing to do with a #GAction is to put it inside of a #GSimpleActionGroup. - Checks if @action_name is valid. @@ -211,7 +188,6 @@ plus '-' and '.'. The empty string is not a valid action name. It is an error to call this function with a non-utf8 @action_name. @action_name must not be %NULL. - %TRUE if @action_name is valid @@ -248,7 +224,6 @@ two sets of parens, for example: "app.action((1,2,3))". A string target can be specified this way as well: "app.action('target')". For strings, this third format must be used if * target value is empty or contains characters other than alphanumerics, '-' and '.'. - %TRUE if successful, else %FALSE with @error set @@ -279,7 +254,6 @@ and @target_value by that function. See that function for the types of strings that will be printed by this function. - a detailed format string @@ -303,7 +277,6 @@ the parameter type given at construction time). If the parameter type was %NULL then @parameter must also be %NULL. If the @parameter GVariant is floating, it is consumed. - @@ -329,7 +302,6 @@ its state or may change its state to something other than @value. See g_action_get_state_hint(). If the @value GVariant is floating, it is consumed. - @@ -349,7 +321,6 @@ If the @value GVariant is floating, it is consumed. An action must be enabled in order to be activated or in order to have its state changed from outside callers. - whether the action is enabled @@ -363,7 +334,6 @@ have its state changed from outside callers. Queries the name of @action. - the name of the action @@ -384,7 +354,6 @@ given to that function must be of the type returned by this function. In the case that this function returns %NULL, you must not give any #GVariant, but %NULL instead. - the parameter type @@ -405,7 +374,6 @@ given by g_action_get_state_type(). The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - the current state of the action @@ -436,7 +404,6 @@ within the range may fail. The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - the state range hint @@ -461,7 +428,6 @@ given as the state. All calls to g_action_change_state() must give a If the action is not stateful (e.g. created with g_simple_action_new()) then this function will return %NULL. In that case, g_action_get_state() will return %NULL and you must not call g_action_change_state(). - the state type, if the action is stateful @@ -481,7 +447,6 @@ the parameter type given at construction time). If the parameter type was %NULL then @parameter must also be %NULL. If the @parameter GVariant is floating, it is consumed. - @@ -507,7 +472,6 @@ its state or may change its state to something other than @value. See g_action_get_state_hint(). If the @value GVariant is floating, it is consumed. - @@ -527,7 +491,6 @@ If the @value GVariant is floating, it is consumed. An action must be enabled in order to be activated or in order to have its state changed from outside callers. - whether the action is enabled @@ -541,7 +504,6 @@ have its state changed from outside callers. Queries the name of @action. - the name of the action @@ -562,7 +524,6 @@ given to that function must be of the type returned by this function. In the case that this function returns %NULL, you must not give any #GVariant, but %NULL instead. - the parameter type @@ -583,7 +544,6 @@ given by g_action_get_state_type(). The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - the current state of the action @@ -614,7 +574,6 @@ within the range may fail. The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - the state range hint @@ -639,7 +598,6 @@ given as the state. All calls to g_action_change_state() must give a If the action is not stateful (e.g. created with g_simple_action_new()) then this function will return %NULL. In that case, g_action_get_state() will return %NULL and you must not call g_action_change_state(). - the state type, if the action is stateful @@ -690,14 +648,12 @@ after @name are optional. Additional optional fields may be added in the future. See g_action_map_add_action_entries() for an example. - the name of the action - @@ -730,7 +686,6 @@ See g_action_map_add_action_entries() for an example. - @@ -799,12 +754,10 @@ the virtual functions g_action_group_list_actions() and g_action_group_query_action(). The other virtual functions should not be implemented - their "wrappers" are actually implemented with calls to g_action_group_query_action(). - Emits the #GActionGroup::action-added signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -823,7 +776,6 @@ This function should only be called by #GActionGroup implementations. Emits the #GActionGroup::action-enabled-changed signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -846,7 +798,6 @@ This function should only be called by #GActionGroup implementations. Emits the #GActionGroup::action-removed signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -865,7 +816,6 @@ This function should only be called by #GActionGroup implementations. Emits the #GActionGroup::action-state-changed signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -891,7 +841,6 @@ If the action is expecting a parameter, then the correct type of parameter must be given as @parameter. If the action is expecting no parameters then @parameter must be %NULL. See g_action_group_get_action_parameter_type(). - @@ -922,7 +871,6 @@ its state or may change its state to something other than @value. See g_action_group_get_action_state_hint(). If the @value GVariant is floating, it is consumed. - @@ -946,7 +894,6 @@ If the @value GVariant is floating, it is consumed. An action must be enabled in order to be activated or in order to have its state changed from outside callers. - whether or not the action is currently enabled @@ -976,7 +923,6 @@ In the case that this function returns %NULL, you must not give any The parameter type of a particular action will never change but it is possible for an action to be removed and for a new action to be added with the same name but a different parameter type. - the parameter type @@ -1001,7 +947,6 @@ given by g_action_group_get_action_state_type(). The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - the current state of the action @@ -1036,7 +981,6 @@ within the range may fail. The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - the state range hint @@ -1069,7 +1013,6 @@ and you must not call g_action_group_change_action_state(). The state type of a particular action will never change but it is possible for an action to be removed and for a new action to be added with the same name but a different state type. - the state type, if the action is stateful @@ -1087,7 +1030,6 @@ with the same name but a different state type. Checks if the named action exists within @action_group. - whether the named action exists @@ -1108,7 +1050,6 @@ with the same name but a different state type. The caller is responsible for freeing the list with g_strfreev() when it is no longer required. - a %NULL-terminated array of the names of the actions in the group @@ -1151,7 +1092,6 @@ If the action exists, %TRUE is returned and any of the requested fields (as indicated by having a non-%NULL reference passed in) are filled. If the action doesn't exist, %FALSE is returned and the fields may or may not have been modified. - %TRUE if the action exists, else %FALSE @@ -1191,7 +1131,6 @@ fields may or may not have been modified. Emits the #GActionGroup::action-added signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -1210,7 +1149,6 @@ This function should only be called by #GActionGroup implementations. Emits the #GActionGroup::action-enabled-changed signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -1233,7 +1171,6 @@ This function should only be called by #GActionGroup implementations. Emits the #GActionGroup::action-removed signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -1252,7 +1189,6 @@ This function should only be called by #GActionGroup implementations. Emits the #GActionGroup::action-state-changed signal on @action_group. This function should only be called by #GActionGroup implementations. - @@ -1278,7 +1214,6 @@ If the action is expecting a parameter, then the correct type of parameter must be given as @parameter. If the action is expecting no parameters then @parameter must be %NULL. See g_action_group_get_action_parameter_type(). - @@ -1309,7 +1244,6 @@ its state or may change its state to something other than @value. See g_action_group_get_action_state_hint(). If the @value GVariant is floating, it is consumed. - @@ -1333,7 +1267,6 @@ If the @value GVariant is floating, it is consumed. An action must be enabled in order to be activated or in order to have its state changed from outside callers. - whether or not the action is currently enabled @@ -1363,7 +1296,6 @@ In the case that this function returns %NULL, you must not give any The parameter type of a particular action will never change but it is possible for an action to be removed and for a new action to be added with the same name but a different parameter type. - the parameter type @@ -1388,7 +1320,6 @@ given by g_action_group_get_action_state_type(). The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - the current state of the action @@ -1423,7 +1354,6 @@ within the range may fail. The return value (if non-%NULL) should be freed with g_variant_unref() when it is no longer required. - the state range hint @@ -1456,7 +1386,6 @@ and you must not call g_action_group_change_action_state(). The state type of a particular action will never change but it is possible for an action to be removed and for a new action to be added with the same name but a different state type. - the state type, if the action is stateful @@ -1474,7 +1403,6 @@ with the same name but a different state type. Checks if the named action exists within @action_group. - whether the named action exists @@ -1495,7 +1423,6 @@ with the same name but a different state type. The caller is responsible for freeing the list with g_strfreev() when it is no longer required. - a %NULL-terminated array of the names of the actions in the group @@ -1538,7 +1465,6 @@ If the action exists, %TRUE is returned and any of the requested fields (as indicated by having a non-%NULL reference passed in) are filled. If the action doesn't exist, %FALSE is returned and the fields may or may not have been modified. - %TRUE if the action exists, else %FALSE @@ -1637,13 +1563,11 @@ is still visible and can be queried from the signal handler. The virtual function table for #GActionGroup. - - whether the named action exists @@ -1662,7 +1586,6 @@ is still visible and can be queried from the signal handler. - a %NULL-terminated array of the names of the actions in the group @@ -1680,7 +1603,6 @@ actions in the group - whether or not the action is currently enabled @@ -1699,7 +1621,6 @@ actions in the group - the parameter type @@ -1718,7 +1639,6 @@ actions in the group - the state type, if the action is stateful @@ -1737,7 +1657,6 @@ actions in the group - the state range hint @@ -1756,7 +1675,6 @@ actions in the group - the current state of the action @@ -1775,7 +1693,6 @@ actions in the group - @@ -1797,7 +1714,6 @@ actions in the group - @@ -1819,7 +1735,6 @@ actions in the group - @@ -1837,7 +1752,6 @@ actions in the group - @@ -1855,7 +1769,6 @@ actions in the group - @@ -1877,7 +1790,6 @@ actions in the group - @@ -1899,7 +1811,6 @@ actions in the group - %TRUE if the action exists, else %FALSE @@ -1939,13 +1850,11 @@ actions in the group The virtual function table for #GAction. - - the name of the action @@ -1960,7 +1869,6 @@ actions in the group - the parameter type @@ -1975,7 +1883,6 @@ actions in the group - the state type, if the action is stateful @@ -1990,7 +1897,6 @@ actions in the group - the state range hint @@ -2005,7 +1911,6 @@ actions in the group - whether the action is enabled @@ -2020,7 +1925,6 @@ actions in the group - the current state of the action @@ -2035,7 +1939,6 @@ actions in the group - @@ -2053,7 +1956,6 @@ actions in the group - @@ -2080,7 +1982,6 @@ names of actions from various action groups to unique, prefixed names (e.g. by prepending "app." or "win."). This is the motivation for the 'Map' part of the interface name. - Adds an action to the @action_map. @@ -2088,7 +1989,6 @@ If the action map already contains an action with the same name as @action then the old action is dropped from the action map. The action map takes its own reference on @action. - @@ -2107,7 +2007,6 @@ The action map takes its own reference on @action. Looks up the action with the name @action_name in @action_map. If no such action exists, returns %NULL. - a #GAction, or %NULL @@ -2127,7 +2026,6 @@ If no such action exists, returns %NULL. Removes the named action from the action map. If no action of this name is in the map then nothing happens. - @@ -2149,7 +2047,6 @@ If the action map already contains an action with the same name as @action then the old action is dropped from the action map. The action map takes its own reference on @action. - @@ -2202,7 +2099,6 @@ create_action_group (void) return G_ACTION_GROUP (group); } ]| - @@ -2232,7 +2128,6 @@ create_action_group (void) Looks up the action with the name @action_name in @action_map. If no such action exists, returns %NULL. - a #GAction, or %NULL @@ -2252,7 +2147,6 @@ If no such action exists, returns %NULL. Removes the named action from the action map. If no action of this name is in the map then nothing happens. - @@ -2270,13 +2164,11 @@ If no action of this name is in the map then nothing happens. The virtual function table for #GActionMap. - - a #GAction, or %NULL @@ -2295,7 +2187,6 @@ If no action of this name is in the map then nothing happens. - @@ -2313,7 +2204,6 @@ If no action of this name is in the map then nothing happens. - @@ -2379,7 +2269,6 @@ application. It should be noted that it's generally not safe for applications to rely on the format of a particular URIs. Different launcher applications (e.g. file managers) may have different ideas of what a given URI means. - Creates a new #GAppInfo from the given information. @@ -2388,7 +2277,6 @@ Note that for @commandline, the quoting rules of the Exec key of the are applied. For example, if the @commandline contains percent-encoded URIs, the percent-character must be doubled in order to prevent it from being swallowed by Exec key unquoting. See the specification for exact quoting rules. - new #GAppInfo for given command. @@ -2417,7 +2305,6 @@ For desktop files, this includes applications that have of `OnlyShowIn` or `NotShowIn`. See g_app_info_should_show(). The returned list does not include applications which have the `Hidden` key set. - a newly allocated #GList of references to #GAppInfos. @@ -2430,7 +2317,6 @@ the `Hidden` key set. including the recommended and fallback #GAppInfos. See g_app_info_get_recommended_for_type() and g_app_info_get_fallback_for_type(). - #GList of #GAppInfos for given @content_type or %NULL on error. @@ -2447,7 +2333,6 @@ g_app_info_get_fallback_for_type(). Gets the default #GAppInfo for a given content type. - #GAppInfo for given @content_type or %NULL on error. @@ -2470,7 +2355,6 @@ g_app_info_get_fallback_for_type(). the given URI scheme. A URI scheme is the initial part of the URI, up to but not including the ':', e.g. "http", "ftp" or "sip". - #GAppInfo for given @uri_scheme or %NULL on error. @@ -2487,7 +2371,6 @@ of the URI, up to but not including the ':', e.g. "http", Gets a list of fallback #GAppInfos for a given content type, i.e. those applications which claim to support the given content type by MIME type subclassing and not directly. - #GList of #GAppInfos for given @content_type or %NULL on error. @@ -2509,7 +2392,6 @@ and not by MIME type subclassing. Note that the first application of the list is the last used one, i.e. the last one for which g_app_info_set_as_last_used_for_type() has been called. - #GList of #GAppInfos for given @content_type or %NULL on error. @@ -2533,7 +2415,6 @@ required. The D-Bus–activated applications don't have to be started if your application terminates too soon after this function. To prevent this, use g_app_info_launch_default_for_uri_async() instead. - %TRUE on success, %FALSE on error. @@ -2560,7 +2441,6 @@ dialog to the user. This is also useful if you want to be sure that the D-Bus–activated applications are really started before termination and if you are interested in receiving error information from their activation. - @@ -2589,7 +2469,6 @@ in receiving error information from their activation. Finishes an asynchronous launch-default-for-uri operation. - %TRUE if the launch was successful, %FALSE if @error is set @@ -2607,7 +2486,6 @@ g_app_info_set_as_default_for_type(), g_app_info_set_as_default_for_extension(), g_app_info_add_supports_type() or g_app_info_remove_supports_type(). - @@ -2621,7 +2499,6 @@ g_app_info_remove_supports_type(). Adds a content type to the application information to indicate the application is capable of opening files with the given content type. - %TRUE on success, %FALSE on error. @@ -2640,7 +2517,6 @@ application is capable of opening files with the given content type. Obtains the information whether the #GAppInfo can be deleted. See g_app_info_delete(). - %TRUE if @appinfo can be deleted @@ -2654,7 +2530,6 @@ See g_app_info_delete(). Checks if a supported content type can be removed from an application. - %TRUE if it is possible to remove supported content types from a given @appinfo, %FALSE if not. @@ -2673,7 +2548,6 @@ See g_app_info_delete(). On some platforms, there may be a difference between user-defined #GAppInfos which can be deleted, and system-wide ones which cannot. See g_app_info_can_delete(). - %TRUE if @appinfo has been deleted @@ -2687,7 +2561,6 @@ See g_app_info_can_delete(). Creates a duplicate of a #GAppInfo. - a duplicate of @appinfo. @@ -2705,7 +2578,6 @@ See g_app_info_can_delete(). Note that the check <emphasis>may not</emphasis> compare each individual field, and only does an identity check. In case detecting changes in the contents is needed, program code must additionally compare relevant fields. - %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise. @@ -2722,7 +2594,6 @@ contents is needed, program code must additionally compare relevant fields. - @@ -2734,7 +2605,6 @@ contents is needed, program code must additionally compare relevant fields. Gets a human-readable description of an installed application. - a string containing a description of the application @appinfo, or %NULL if none. @@ -2750,7 +2620,6 @@ application @appinfo, or %NULL if none. Gets the display name of the application. The display name is often more descriptive to the user than the name itself. - the display name of the application for @appinfo, or the name if no display name is available. @@ -2764,7 +2633,6 @@ no display name is available. - @@ -2776,7 +2644,6 @@ no display name is available. Gets the icon for the application. - the default #GIcon for @appinfo or %NULL if there is no default icon. @@ -2797,7 +2664,6 @@ desktop file id from the xdg menu specification. Note that the returned ID may be %NULL, depending on how the @appinfo has been constructed. - a string containing the application's ID. @@ -2811,7 +2677,6 @@ the @appinfo has been constructed. Gets the installed name of the application. - the name of the application for @appinfo. @@ -2830,7 +2695,6 @@ will return %NULL. This function does not take in consideration associations added with g_app_info_add_supports_type(), but only those exported directly by the application. - a list of content types. @@ -2873,7 +2737,6 @@ process. This can be used to ignore `GIO_LAUNCHED_DESKTOP_FILE`, should it be inherited by further processes. The `DISPLAY` and `DESKTOP_STARTUP_ID` environment variables are also set, based on information provided in @context. - %TRUE on successful launch, %FALSE otherwise. @@ -2906,7 +2769,6 @@ To launch the application without arguments pass a %NULL @uris list. Note that even if the launch is successful the application launched can fail to start if it runs into problems during startup. There is no way to detect this. - %TRUE on successful launch, %FALSE otherwise. @@ -2935,7 +2797,6 @@ The @callback is invoked immediately after the application launch, but it waits for activation in case of D-Bus–activated applications and also provides extended error information for sandboxed applications, see notes for g_app_info_launch_default_for_uri_async(). - @@ -2970,7 +2831,6 @@ g_app_info_launch_default_for_uri_async(). Finishes a g_app_info_launch_uris_async() operation. - %TRUE on successful launch, %FALSE otherwise. @@ -2988,7 +2848,6 @@ g_app_info_launch_default_for_uri_async(). Removes a supported type from an application, if possible. - %TRUE on success, %FALSE on error. @@ -3006,7 +2865,6 @@ g_app_info_launch_default_for_uri_async(). Sets the application as the default handler for the given file extension. - %TRUE on success, %FALSE on error. @@ -3025,7 +2883,6 @@ g_app_info_launch_default_for_uri_async(). Sets the application as the default handler for a given type. - %TRUE on success, %FALSE on error. @@ -3046,7 +2903,6 @@ g_app_info_launch_default_for_uri_async(). This will make the application appear as first in the list returned by g_app_info_get_recommended_for_type(), regardless of the default application for that content type. - %TRUE on success, %FALSE on error. @@ -3065,7 +2921,6 @@ application for that content type. Checks if the application info should be shown in menus that list available applications. - %TRUE if the @appinfo should be shown, %FALSE otherwise. @@ -3079,7 +2934,6 @@ list available applications. Checks if the application accepts files as arguments. - %TRUE if the @appinfo supports files. @@ -3093,7 +2947,6 @@ list available applications. Checks if the application supports reading files and directories from URIs. - %TRUE if the @appinfo supports URIs. @@ -3108,7 +2961,6 @@ list available applications. Adds a content type to the application information to indicate the application is capable of opening files with the given content type. - %TRUE on success, %FALSE on error. @@ -3127,7 +2979,6 @@ application is capable of opening files with the given content type. Obtains the information whether the #GAppInfo can be deleted. See g_app_info_delete(). - %TRUE if @appinfo can be deleted @@ -3141,7 +2992,6 @@ See g_app_info_delete(). Checks if a supported content type can be removed from an application. - %TRUE if it is possible to remove supported content types from a given @appinfo, %FALSE if not. @@ -3160,7 +3010,6 @@ See g_app_info_delete(). On some platforms, there may be a difference between user-defined #GAppInfos which can be deleted, and system-wide ones which cannot. See g_app_info_can_delete(). - %TRUE if @appinfo has been deleted @@ -3174,7 +3023,6 @@ See g_app_info_can_delete(). Creates a duplicate of a #GAppInfo. - a duplicate of @appinfo. @@ -3192,7 +3040,6 @@ See g_app_info_can_delete(). Note that the check <emphasis>may not</emphasis> compare each individual field, and only does an identity check. In case detecting changes in the contents is needed, program code must additionally compare relevant fields. - %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise. @@ -3211,7 +3058,6 @@ contents is needed, program code must additionally compare relevant fields. Gets the commandline with which the application will be started. - a string containing the @appinfo's commandline, or %NULL if this information is not available @@ -3226,7 +3072,6 @@ started. Gets a human-readable description of an installed application. - a string containing a description of the application @appinfo, or %NULL if none. @@ -3242,7 +3087,6 @@ application @appinfo, or %NULL if none. Gets the display name of the application. The display name is often more descriptive to the user than the name itself. - the display name of the application for @appinfo, or the name if no display name is available. @@ -3257,7 +3101,6 @@ no display name is available. Gets the executable's name for the installed application. - a string containing the @appinfo's application binaries name @@ -3272,7 +3115,6 @@ binaries name Gets the icon for the application. - the default #GIcon for @appinfo or %NULL if there is no default icon. @@ -3293,7 +3135,6 @@ desktop file id from the xdg menu specification. Note that the returned ID may be %NULL, depending on how the @appinfo has been constructed. - a string containing the application's ID. @@ -3307,7 +3148,6 @@ the @appinfo has been constructed. Gets the installed name of the application. - the name of the application for @appinfo. @@ -3326,7 +3166,6 @@ will return %NULL. This function does not take in consideration associations added with g_app_info_add_supports_type(), but only those exported directly by the application. - a list of content types. @@ -3369,7 +3208,6 @@ process. This can be used to ignore `GIO_LAUNCHED_DESKTOP_FILE`, should it be inherited by further processes. The `DISPLAY` and `DESKTOP_STARTUP_ID` environment variables are also set, based on information provided in @context. - %TRUE on successful launch, %FALSE otherwise. @@ -3402,7 +3240,6 @@ To launch the application without arguments pass a %NULL @uris list. Note that even if the launch is successful the application launched can fail to start if it runs into problems during startup. There is no way to detect this. - %TRUE on successful launch, %FALSE otherwise. @@ -3431,7 +3268,6 @@ The @callback is invoked immediately after the application launch, but it waits for activation in case of D-Bus–activated applications and also provides extended error information for sandboxed applications, see notes for g_app_info_launch_default_for_uri_async(). - @@ -3466,7 +3302,6 @@ g_app_info_launch_default_for_uri_async(). Finishes a g_app_info_launch_uris_async() operation. - %TRUE on successful launch, %FALSE otherwise. @@ -3484,7 +3319,6 @@ g_app_info_launch_default_for_uri_async(). Removes a supported type from an application, if possible. - %TRUE on success, %FALSE on error. @@ -3502,7 +3336,6 @@ g_app_info_launch_default_for_uri_async(). Sets the application as the default handler for the given file extension. - %TRUE on success, %FALSE on error. @@ -3521,7 +3354,6 @@ g_app_info_launch_default_for_uri_async(). Sets the application as the default handler for a given type. - %TRUE on success, %FALSE on error. @@ -3542,7 +3374,6 @@ g_app_info_launch_default_for_uri_async(). This will make the application appear as first in the list returned by g_app_info_get_recommended_for_type(), regardless of the default application for that content type. - %TRUE on success, %FALSE on error. @@ -3561,7 +3392,6 @@ application for that content type. Checks if the application info should be shown in menus that list available applications. - %TRUE if the @appinfo should be shown, %FALSE otherwise. @@ -3575,7 +3405,6 @@ list available applications. Checks if the application accepts files as arguments. - %TRUE if the @appinfo supports files. @@ -3589,7 +3418,6 @@ list available applications. Checks if the application supports reading files and directories from URIs. - %TRUE if the @appinfo supports URIs. @@ -3619,14 +3447,12 @@ list available applications. Application Information interface, for operating system portability. - The parent interface. - a duplicate of @appinfo. @@ -3641,7 +3467,6 @@ list available applications. - %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise. @@ -3660,7 +3485,6 @@ list available applications. - a string containing the application's ID. @@ -3675,7 +3499,6 @@ list available applications. - the name of the application for @appinfo. @@ -3690,7 +3513,6 @@ list available applications. - a string containing a description of the application @appinfo, or %NULL if none. @@ -3706,7 +3528,6 @@ application @appinfo, or %NULL if none. - @@ -3719,7 +3540,6 @@ application @appinfo, or %NULL if none. - the default #GIcon for @appinfo or %NULL if there is no default icon. @@ -3735,7 +3555,6 @@ if there is no default icon. - %TRUE on successful launch, %FALSE otherwise. @@ -3760,7 +3579,6 @@ if there is no default icon. - %TRUE if the @appinfo supports URIs. @@ -3775,7 +3593,6 @@ if there is no default icon. - %TRUE if the @appinfo supports files. @@ -3790,7 +3607,6 @@ if there is no default icon. - %TRUE on successful launch, %FALSE otherwise. @@ -3815,7 +3631,6 @@ if there is no default icon. - %TRUE if the @appinfo should be shown, %FALSE otherwise. @@ -3830,7 +3645,6 @@ if there is no default icon. - %TRUE on success, %FALSE on error. @@ -3849,7 +3663,6 @@ if there is no default icon. - %TRUE on success, %FALSE on error. @@ -3869,7 +3682,6 @@ if there is no default icon. - %TRUE on success, %FALSE on error. @@ -3888,7 +3700,6 @@ if there is no default icon. - %TRUE if it is possible to remove supported content types from a given @appinfo, %FALSE if not. @@ -3904,7 +3715,6 @@ if there is no default icon. - %TRUE on success, %FALSE on error. @@ -3923,7 +3733,6 @@ if there is no default icon. - %TRUE if @appinfo can be deleted @@ -3938,7 +3747,6 @@ if there is no default icon. - %TRUE if @appinfo has been deleted @@ -3953,7 +3761,6 @@ if there is no default icon. - @@ -3966,7 +3773,6 @@ if there is no default icon. - the display name of the application for @appinfo, or the name if no display name is available. @@ -3982,7 +3788,6 @@ no display name is available. - %TRUE on success, %FALSE on error. @@ -4001,7 +3806,6 @@ no display name is available. - a list of content types. @@ -4019,7 +3823,6 @@ no display name is available. - @@ -4055,7 +3858,6 @@ no display name is available. - %TRUE on successful launch, %FALSE otherwise. @@ -4101,7 +3903,6 @@ applications (as reported by g_app_info_get_all()) may have changed. You must only call g_object_unref() on the return value from under the same main context as you created it. - a reference to a #GAppInfoMonitor @@ -4119,11 +3920,9 @@ or removed applications). Integrating the launch with the launching application. This is used to handle for instance startup notification and launching the new application on the same screen as the launching window. - Creates a new application launch context. This is not normally used, instead you instantiate a subclass of this, such as #GdkAppLaunchContext. - a #GAppLaunchContext. @@ -4133,7 +3932,6 @@ instead you instantiate a subclass of this, such as #GdkAppLaunchContext. Gets the display string for the @context. This is used to ensure new applications are started on the same display as the launching application, by setting the `DISPLAY` environment variable. - a display string for the display. @@ -4161,7 +3959,6 @@ application, by setting the `DISPLAY` environment variable. Startup notification IDs are defined in the [FreeDesktop.Org Startup Notifications standard](http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt). - a startup notification ID for the application, or %NULL if not supported. @@ -4187,7 +3984,6 @@ Startup notification IDs are defined in the Called when an application has failed to launch, so that it can cancel the application startup notification started in g_app_launch_context_get_startup_notify_id(). - @@ -4203,7 +3999,6 @@ the application startup notification started in g_app_launch_context_get_startup - @@ -4223,7 +4018,6 @@ the application startup notification started in g_app_launch_context_get_startup Gets the display string for the @context. This is used to ensure new applications are started on the same display as the launching application, by setting the `DISPLAY` environment variable. - a display string for the display. @@ -4250,7 +4044,6 @@ application, by setting the `DISPLAY` environment variable. the child process when @context is used to launch an application. This is a %NULL-terminated array of strings, where each string has the form `KEY=VALUE`. - the child's environment @@ -4271,7 +4064,6 @@ the form `KEY=VALUE`. Startup notification IDs are defined in the [FreeDesktop.Org Startup Notifications standard](http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt). - a startup notification ID for the application, or %NULL if not supported. @@ -4297,7 +4089,6 @@ Startup notification IDs are defined in the Called when an application has failed to launch, so that it can cancel the application startup notification started in g_app_launch_context_get_startup_notify_id(). - @@ -4315,7 +4106,6 @@ the application startup notification started in g_app_launch_context_get_startup Arranges for @variable to be set to @value in the child's environment when @context is used to launch an application. - @@ -4337,7 +4127,6 @@ environment when @context is used to launch an application. Arranges for @variable to be unset in the child's environment when @context is used to launch an application. - @@ -4394,13 +4183,11 @@ platform-specific data about this launch. On UNIX, at least the - - a display string for the display. @@ -4425,7 +4212,6 @@ platform-specific data about this launch. On UNIX, at least the - a startup notification ID for the application, or %NULL if not supported. @@ -4451,7 +4237,6 @@ platform-specific data about this launch. On UNIX, at least the - @@ -4469,7 +4254,6 @@ platform-specific data about this launch. On UNIX, at least the - @@ -4488,7 +4272,6 @@ platform-specific data about this launch. On UNIX, at least the - @@ -4496,7 +4279,6 @@ platform-specific data about this launch. On UNIX, at least the - @@ -4504,7 +4286,6 @@ platform-specific data about this launch. On UNIX, at least the - @@ -4512,7 +4293,6 @@ platform-specific data about this launch. On UNIX, at least the - @@ -4637,7 +4417,6 @@ For an example of using actions with GApplication, see For an example of using extra D-Bus hooks with GApplication, see [gapplication-example-dbushooks.c](https://git.gnome.org/browse/glib/tree/gio/tests/gapplication-example-dbushooks.c). - @@ -4648,7 +4427,6 @@ g_application_id_is_valid(). If no application ID is given then some features of #GApplication (most notably application uniqueness) will be disabled. - a new #GApplication instance @@ -4672,7 +4450,6 @@ the default when it is created. You can exercise more control over this by using g_application_set_default(). If there is no default application then %NULL is returned. - the default application for this process, or %NULL @@ -4724,7 +4501,6 @@ hyphen/minus characters they should be replaced by underscores, and if it contains leading digits they should be escaped by prepending an underscore. For example, if the owner of 7-zip.org used an application identifier for an archiving application, it might be named `org._7_zip.Archiver`. - %TRUE if @application_id is valid @@ -4743,7 +4519,6 @@ In essence, this results in the #GApplication::activate signal being emitted in the primary instance. The application must be registered before calling this function. - @@ -4755,7 +4530,6 @@ The application must be registered before calling this function. - @@ -4769,7 +4543,6 @@ The application must be registered before calling this function. - @@ -4783,7 +4556,6 @@ The application must be registered before calling this function. - @@ -4797,7 +4569,6 @@ The application must be registered before calling this function. - @@ -4811,7 +4582,6 @@ The application must be registered before calling this function. - @@ -4828,7 +4598,6 @@ The application must be registered before calling this function. - @@ -4845,7 +4614,6 @@ The application must be registered before calling this function. - @@ -4869,7 +4637,6 @@ variable which can used to set the exit status that is returned from g_application_run(). See g_application_run() for more details on #GApplication startup. - %TRUE if the commandline has been completely handled @@ -4892,7 +4659,6 @@ See g_application_run() for more details on #GApplication startup. - @@ -4917,7 +4683,6 @@ for this functionality, you should use "". The application must be registered before calling this function and it must have the %G_APPLICATION_HANDLES_OPEN flag set. - @@ -4943,7 +4708,6 @@ and it must have the %G_APPLICATION_HANDLES_OPEN flag set. - @@ -4954,7 +4718,6 @@ and it must have the %G_APPLICATION_HANDLES_OPEN flag set. - @@ -4965,7 +4728,6 @@ and it must have the %G_APPLICATION_HANDLES_OPEN flag set. - @@ -4976,7 +4738,6 @@ and it must have the %G_APPLICATION_HANDLES_OPEN flag set. - @@ -4993,7 +4754,6 @@ In essence, this results in the #GApplication::activate signal being emitted in the primary instance. The application must be registered before calling this function. - @@ -5018,7 +4778,6 @@ be sent to the primary instance. See g_application_add_main_option_entries() for more details. See #GOptionEntry for more documentation of the arguments. - @@ -5109,7 +4868,6 @@ the options with g_variant_dict_lookup(): - for %G_OPTION_ARG_FILENAME, use `^&ay` - for %G_OPTION_ARG_STRING_ARRAY, use `^a&s` - for %G_OPTION_ARG_FILENAME_ARRAY, use `^a&ay` - @@ -5153,7 +4911,6 @@ Calling this function will cause the options in the supplied option group to be parsed, but it does not cause you to be "opted in" to the new functionality whereby unrecognised options are rejected even if %G_APPLICATION_HANDLES_COMMAND_LINE was given. - @@ -5175,7 +4932,6 @@ new functionality whereby unrecognised options are rejected even if The binding holds a reference to @application while it is active, but not to @object. Instead, the binding is destroyed when @object is finalized. - @@ -5196,7 +4952,6 @@ finalized. Gets the unique identifier for @application. - the identifier for @application, owned by @application @@ -5222,7 +4977,6 @@ normally be in use but we were unable to connect to the bus. This function must not be called before the application has been registered. See g_application_get_is_registered(). - a #GDBusConnection, or %NULL @@ -5249,7 +5003,6 @@ normally be in use but we were unable to connect to the bus. This function must not be called before the application has been registered. See g_application_get_is_registered(). - the object path, or %NULL @@ -5265,7 +5018,6 @@ registered. See g_application_get_is_registered(). Gets the flags for @application. See #GApplicationFlags. - the flags for @application @@ -5282,7 +5034,6 @@ See #GApplicationFlags. This is the amount of time (in milliseconds) after the last call to g_application_release() before the application stops running. - the timeout, in milliseconds @@ -5297,7 +5048,6 @@ g_application_release() before the application stops running. Gets the application's current busy state, as set through g_application_mark_busy() or g_application_bind_busy_property(). - %TRUE if @application is currently marked as busy @@ -5314,7 +5064,6 @@ g_application_mark_busy() or g_application_bind_busy_property(). An application is registered if g_application_register() has been successfully called. - %TRUE if @application is registered @@ -5337,7 +5086,6 @@ performed by the primary instance. The value of this property cannot be accessed before g_application_register() has been called. See g_application_get_is_registered(). - %TRUE if @application is remote @@ -5353,7 +5101,6 @@ g_application_get_is_registered(). Gets the resource base path of @application. See g_application_set_resource_base_path() for more information. - the base resource path, if one is set @@ -5373,7 +5120,6 @@ continue to run. For example, g_application_hold() is called by GTK+ when a toplevel window is on the screen. To cancel the hold, call g_application_release(). - @@ -5395,7 +5141,6 @@ use that information to indicate the state to the user (e.g. with a spinner). To cancel the busy indication, use g_application_unmark_busy(). - @@ -5421,7 +5166,6 @@ for this functionality, you should use "". The application must be registered before calling this function and it must have the %G_APPLICATION_HANDLES_OPEN flag set. - @@ -5460,7 +5204,6 @@ through gtk_application_add_window().) The result of calling g_application_run() again after it returns is unspecified. - @@ -5502,7 +5245,6 @@ is set appropriately. Note: the return value of this function is not an indicator that this instance is or is not the primary instance of the application. See g_application_get_is_remote() for that. - %TRUE if registration succeeded @@ -5525,7 +5267,6 @@ When the use count reaches zero, the application will stop running. Never call this function except to cancel the effect of a previous call to g_application_hold(). - @@ -5612,7 +5353,6 @@ approach is suitable for use by most graphical applications but should not be used from applications like editors that need precise control over when processes invoked via the commandline will exit and what their exit status will be. - the exit status @@ -5662,7 +5402,6 @@ notifications without an id. If @notification is no longer relevant, it can be withdrawn with g_application_withdraw_notification(). - @@ -5689,7 +5428,6 @@ mix use of this API with use of #GActionMap on the same @application or things will go very badly wrong. This function is known to introduce buggy behaviour (ie: signals not emitted on changes to the action group), so you should really use #GActionMap instead. - @@ -5712,7 +5450,6 @@ been registered. If non-%NULL, the application id must be valid. See g_application_id_is_valid(). - @@ -5734,7 +5471,6 @@ by g_application_get_default(). This function does not take its own reference on @application. If @application is destroyed then the default application will revert back to %NULL. - @@ -5752,7 +5488,6 @@ The flags can only be modified if @application has not yet been registered. See #GApplicationFlags. - @@ -5776,7 +5511,6 @@ g_application_release() before the application stops running. This call has no side effects of its own. The value set here is only used for next time g_application_release() drops the use count to zero. Any timeouts currently in progress are not impacted. - @@ -5795,7 +5529,6 @@ zero. Any timeouts currently in progress are not impacted. Adds a description to the @application option context. See g_option_context_set_description() for more information. - @@ -5818,7 +5551,6 @@ This function registers the argument to be passed to g_option_context_new() when the internal #GOptionContext of @application is created. See g_option_context_new() for more information about @parameter_string. - @@ -5838,7 +5570,6 @@ See g_option_context_new() for more information about @parameter_string. Adds a summary to the @application option context. See g_option_context_set_summary() for more information. - @@ -5888,7 +5619,6 @@ a sub-class of #GApplication you should either set the this function during the instance initialization. Alternatively, you can call this function in the #GApplicationClass.startup virtual function, before chaining up to the parent implementation. - @@ -5907,7 +5637,6 @@ before chaining up to the parent implementation. Destroys a binding between @property and the busy state of @application that was previously created with g_application_bind_busy_property(). - @@ -5934,7 +5663,6 @@ to other processes. This function must only be called to cancel the effect of a previous call to g_application_mark_busy(). - @@ -5959,7 +5687,6 @@ the sent notification. Note that notifications are dismissed when the user clicks on one of the buttons in a notification or triggers its default action, so there is no need to explicitly withdraw the notification in that case. - @@ -6137,13 +5864,11 @@ after registration. See g_application_register(). Virtual function table for #GApplication. - - @@ -6156,7 +5881,6 @@ after registration. See g_application_register(). - @@ -6170,7 +5894,6 @@ after registration. See g_application_register(). - @@ -6198,7 +5921,6 @@ after registration. See g_application_register(). - @@ -6214,7 +5936,6 @@ after registration. See g_application_register(). - %TRUE if the commandline has been completely handled @@ -6239,7 +5960,6 @@ after registration. See g_application_register(). - @@ -6255,7 +5975,6 @@ after registration. See g_application_register(). - @@ -6271,7 +5990,6 @@ after registration. See g_application_register(). - @@ -6287,7 +6005,6 @@ after registration. See g_application_register(). - @@ -6300,7 +6017,6 @@ after registration. See g_application_register(). - @@ -6313,7 +6029,6 @@ after registration. See g_application_register(). - @@ -6326,7 +6041,6 @@ after registration. See g_application_register(). - @@ -6345,7 +6059,6 @@ after registration. See g_application_register(). - @@ -6364,7 +6077,6 @@ after registration. See g_application_register(). - @@ -6380,7 +6092,6 @@ after registration. See g_application_register(). - @@ -6552,7 +6263,6 @@ hold the application until you are done with the commandline. The complete example can be found here: [gapplication-example-cmdline3.c](https://git.gnome.org/browse/glib/tree/gio/tests/gapplication-example-cmdline3.c) - Gets the stdin of the invoking process. @@ -6564,7 +6274,6 @@ If stdin is not available then %NULL will be returned. In the future, support may be expanded to other platforms. You must only call this function once per commandline invocation. - a #GInputStream for stdin @@ -6577,7 +6286,6 @@ You must only call this function once per commandline invocation. - @@ -6591,7 +6299,6 @@ You must only call this function once per commandline invocation. - @@ -6611,7 +6318,6 @@ of the invocation of @cmdline. This differs from g_file_new_for_commandline_arg() in that it resolves relative pathnames using the current working directory of the invoking process rather than the local process. - a new #GFile @@ -6639,7 +6345,6 @@ use g_option_context_parse_strv(). The return value is %NULL-terminated and should be freed using g_strfreev(). - the string array containing the arguments (the argv) @@ -6667,7 +6372,6 @@ directory, so this may be %NULL. The return value should not be modified or freed and is valid for as long as @cmdline exists. - the current directory, or %NULL @@ -6695,7 +6399,6 @@ long as @cmdline exists. See g_application_command_line_getenv() if you are only interested in the value of a single environment variable. - the environment strings, or %NULL if they were not sent @@ -6713,7 +6416,6 @@ in the value of a single environment variable. Gets the exit status of @cmdline. See g_application_command_line_set_exit_status() for more information. - the exit status @@ -6727,7 +6429,6 @@ g_application_command_line_set_exit_status() for more information. Determines if @cmdline represents a remote invocation. - %TRUE if the invocation was remote @@ -6749,7 +6450,6 @@ modified from your GApplication::handle-local-options handler. If no options were sent then an empty dictionary is returned so that you don't need to check for %NULL. - a #GVariantDict with the options @@ -6770,7 +6470,6 @@ information like the current working directory and the startup notification ID. For local invocation, it will be %NULL. - the platform data, or %NULL @@ -6793,7 +6492,6 @@ If stdin is not available then %NULL will be returned. In the future, support may be expanded to other platforms. You must only call this function once per commandline invocation. - a #GInputStream for stdin @@ -6817,7 +6515,6 @@ to invocation messages from other applications). The return value should not be modified or freed and is valid for as long as @cmdline exists. - the value of the variable, or %NULL if unset or unsent @@ -6840,7 +6537,6 @@ invoking process. If @cmdline is a local invocation then this is exactly equivalent to g_print(). If @cmdline is remote then this is equivalent to calling g_print() in the invoking process. - @@ -6866,7 +6562,6 @@ invoking process. If @cmdline is a local invocation then this is exactly equivalent to g_printerr(). If @cmdline is remote then this is equivalent to calling g_printerr() in the invoking process. - @@ -6907,7 +6602,6 @@ increased to a non-zero value) then the application is considered to have been 'successful' in a certain sense, and the exit status is always zero. If the application use count is zero, though, the exit status of the local #GApplicationCommandLine is used. - @@ -6944,13 +6638,11 @@ status of the local #GApplicationCommandLine is used. The #GApplicationCommandLineClass-struct contains private data only. - - @@ -6966,7 +6658,6 @@ contains private data only. - @@ -6982,7 +6673,6 @@ contains private data only. - a #GInputStream for stdin @@ -7190,7 +6880,6 @@ foo_async_initable_iface_init (gpointer g_iface, iface->init_finish = foo_init_finish; } ]| - Helper function for constructing #GAsyncInitable object. This is similar to g_object_new() but also initializes the object asynchronously. @@ -7198,7 +6887,6 @@ similar to g_object_new() but also initializes the object asynchronously. When the initialization is finished, @callback will be called. You can then call g_async_initable_new_finish() to get the new object and check for any errors. - @@ -7244,7 +6932,6 @@ asynchronously. When the initialization is finished, @callback will be called. You can then call g_async_initable_new_finish() to get the new object and check for any errors. - @@ -7290,7 +6977,6 @@ then call g_async_initable_new_finish() to get the new object and check for any errors. Use g_object_new_with_properties() and g_async_initable_init_async() instead. See #GParameter for more information. - @@ -7363,7 +7049,6 @@ implementation of this method will run the g_initable_init() function in a thread, so if you want to support asynchronous initialization via threads, just implement the #GAsyncInitable interface without overriding any interface methods. - @@ -7393,7 +7078,6 @@ any interface methods. Finishes asynchronous initialization and returns the result. See g_async_initable_init_async(). - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error appropriately if present. @@ -7447,7 +7131,6 @@ implementation of this method will run the g_initable_init() function in a thread, so if you want to support asynchronous initialization via threads, just implement the #GAsyncInitable interface without overriding any interface methods. - @@ -7477,7 +7160,6 @@ any interface methods. Finishes asynchronous initialization and returns the result. See g_async_initable_init_async(). - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error appropriately if present. @@ -7497,7 +7179,6 @@ will return %FALSE and set @error appropriately if present. Finishes the async construction for the various g_async_initable_new calls, returning the created object or %NULL on error. - a newly created #GObject, or %NULL on error. Free with g_object_unref(). @@ -7518,14 +7199,12 @@ calls, returning the created object or %NULL on error. Provides an interface for asynchronous initializing object such that initialization may fail. - The parent interface. - @@ -7555,7 +7234,6 @@ initialization may fail. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error appropriately if present. @@ -7583,7 +7261,6 @@ iteration of the where the #GTask was created. All other users of #GAsyncReadyCallback must likewise call it asynchronously in a later iteration of the main context. - @@ -7687,10 +7364,8 @@ I/O scheduling. Priorities are integers, with lower numbers indicating higher priority. It is recommended to choose priorities between %G_PRIORITY_LOW and %G_PRIORITY_HIGH, with %G_PRIORITY_DEFAULT as a default. - Gets the source object from a #GAsyncResult. - a new reference to the source object for the @res, or %NULL if there is none. @@ -7705,7 +7380,6 @@ as a default. Gets the user data from a #GAsyncResult. - the user data for @res. @@ -7720,7 +7394,6 @@ as a default. Checks if @res has the given @source_tag (generally a function pointer indicating the function @res was created by). - %TRUE if @res has the indicated @source_tag, %FALSE if not. @@ -7739,7 +7412,6 @@ pointer indicating the function @res was created by). Gets the source object from a #GAsyncResult. - a new reference to the source object for the @res, or %NULL if there is none. @@ -7754,7 +7426,6 @@ pointer indicating the function @res was created by). Gets the user data from a #GAsyncResult. - the user data for @res. @@ -7769,7 +7440,6 @@ pointer indicating the function @res was created by). Checks if @res has the given @source_tag (generally a function pointer indicating the function @res was created by). - %TRUE if @res has the indicated @source_tag, %FALSE if not. @@ -7797,7 +7467,6 @@ error returns themselves rather than calling into the virtual method. This should not be used in new code; #GAsyncResult errors that are set by virtual methods should also be extracted by virtual methods, to enable subclasses to chain up correctly. - %TRUE if @error is has been filled in with an error from @res, %FALSE if not. @@ -7813,14 +7482,12 @@ to enable subclasses to chain up correctly. Interface definition for #GAsyncResult. - The parent interface. - the user data for @res. @@ -7835,7 +7502,6 @@ to enable subclasses to chain up correctly. - a new reference to the source object for the @res, or %NULL if there is none. @@ -7851,7 +7517,6 @@ to enable subclasses to chain up correctly. - %TRUE if @res has the indicated @source_tag, %FALSE if not. @@ -7871,49 +7536,42 @@ to enable subclasses to chain up correctly. - - - - - - - @@ -7934,12 +7592,10 @@ g_buffered_input_stream_get_buffer_size(). To change the size of a buffered input stream's buffer, use g_buffered_input_stream_set_buffer_size(). Note that the buffer's size cannot be reduced below the size of the data within the buffer. - Creates a new #GInputStream from the given @base_stream, with a buffer set to the default size (4 kilobytes). - a #GInputStream for the given @base_stream. @@ -7954,7 +7610,6 @@ a buffer set to the default size (4 kilobytes). Creates a new #GBufferedInputStream from the given @base_stream, with a buffer set to @size. - a #GInputStream. @@ -7995,7 +7650,6 @@ On error -1 is returned and @error is set accordingly. For the asynchronous, non-blocking, version of this function, see g_buffered_input_stream_fill_async(). - the number of bytes read into @stream's buffer, up to @count, or -1 on error. @@ -8023,7 +7677,6 @@ version of this function, see g_buffered_input_stream_fill(). If @count is -1 then the attempted read size is equal to the number of bytes that are required to fill the buffer. - @@ -8056,7 +7709,6 @@ of bytes that are required to fill the buffer. Finishes an asynchronous read. - a #gssize of the read stream, or `-1` on an error. @@ -8097,7 +7749,6 @@ On error -1 is returned and @error is set accordingly. For the asynchronous, non-blocking, version of this function, see g_buffered_input_stream_fill_async(). - the number of bytes read into @stream's buffer, up to @count, or -1 on error. @@ -8125,7 +7776,6 @@ version of this function, see g_buffered_input_stream_fill(). If @count is -1 then the attempted read size is equal to the number of bytes that are required to fill the buffer. - @@ -8158,7 +7808,6 @@ of bytes that are required to fill the buffer. Finishes an asynchronous read. - a #gssize of the read stream, or `-1` on an error. @@ -8176,7 +7825,6 @@ of bytes that are required to fill the buffer. Gets the size of the available data within the stream. - size of the available stream. @@ -8190,7 +7838,6 @@ of bytes that are required to fill the buffer. Gets the size of the input buffer. - the current buffer size. @@ -8205,7 +7852,6 @@ of bytes that are required to fill the buffer. Peeks in the buffer, copying data of size @count into @buffer, offset @offset bytes. - a #gsize of the number of bytes peeked, or -1 on error. @@ -8236,7 +7882,6 @@ offset @offset bytes. Returns the buffer with the currently available bytes. The returned buffer must not be modified and will become invalid when reading from the stream or filling the buffer. - read-only buffer @@ -8269,7 +7914,6 @@ operation was partially finished when the operation was cancelled the partial result will be returned, without an error. On error -1 is returned and @error is set accordingly. - the byte read from the @stream, or -1 on end of stream or error. @@ -8289,7 +7933,6 @@ On error -1 is returned and @error is set accordingly. Sets the size of the internal buffer of @stream to @size, or to the size of the contents of the buffer. The buffer can never be resized smaller than its current contents. - @@ -8315,13 +7958,11 @@ smaller than its current contents. - - the number of bytes read into @stream's buffer, up to @count, or -1 on error. @@ -8345,7 +7986,6 @@ smaller than its current contents. - @@ -8379,7 +8019,6 @@ smaller than its current contents. - a #gssize of the read stream, or `-1` on an error. @@ -8398,7 +8037,6 @@ smaller than its current contents. - @@ -8406,7 +8044,6 @@ smaller than its current contents. - @@ -8414,7 +8051,6 @@ smaller than its current contents. - @@ -8422,7 +8058,6 @@ smaller than its current contents. - @@ -8430,7 +8065,6 @@ smaller than its current contents. - @@ -8455,11 +8089,9 @@ g_buffered_output_stream_get_buffer_size(). To change the size of a buffered output stream's buffer, use g_buffered_output_stream_set_buffer_size(). Note that the buffer's size cannot be reduced below the size of the data within the buffer. - Creates a new buffered output stream for a base stream. - a #GOutputStream for the given @base_stream. @@ -8473,7 +8105,6 @@ size cannot be reduced below the size of the data within the buffer. Creates a new buffered output stream with a given buffer size. - a #GOutputStream with an internal buffer set to @size. @@ -8491,7 +8122,6 @@ size cannot be reduced below the size of the data within the buffer. Checks if the buffer automatically grows as data is added. - %TRUE if the @stream's buffer automatically grows, %FALSE otherwise. @@ -8506,7 +8136,6 @@ size cannot be reduced below the size of the data within the buffer. Gets the size of the buffer in the @stream. - the current size of the buffer. @@ -8523,7 +8152,6 @@ size cannot be reduced below the size of the data within the buffer. If @auto_grow is true, then each write will just make the buffer larger, and you must manually flush the buffer to actually write out the data to the underlying stream. - @@ -8540,7 +8168,6 @@ the data to the underlying stream. Sets the size of the internal buffer to @size. - @@ -8569,13 +8196,11 @@ the data to the underlying stream. - - @@ -8583,7 +8208,6 @@ the data to the underlying stream. - @@ -8595,7 +8219,6 @@ the data to the underlying stream. Invoked when a connection to a message bus has been obtained. - @@ -8616,7 +8239,6 @@ the data to the underlying stream. Invoked when the name is acquired. - @@ -8637,7 +8259,6 @@ the data to the underlying stream. Invoked when the name being watched is known to have to have an owner. - @@ -8662,7 +8283,6 @@ the data to the underlying stream. Invoked when the name is lost or @connection has been closed. - @@ -8705,7 +8325,6 @@ return an error from g_bus_own_name() rather than entering the waiting queue for This is also invoked when the #GDBusConnection on which the watch was established has been closed. In that case, @connection will be %NULL. - @@ -8758,7 +8377,6 @@ png) to be used as icon. Creates a new icon for a bytes. - a #GIcon for the given @bytes, or %NULL on error. @@ -8773,7 +8391,6 @@ png) to be used as icon. Gets the #GBytes associated with the given @icon. - a #GBytes, or %NULL. @@ -8791,119 +8408,102 @@ png) to be used as icon. - - - - - - - - - - - - - - - - - @@ -8913,7 +8513,6 @@ png) to be used as icon. GCancellable is a thread-safe operation cancellation stack used throughout GIO to allow for cancellation of synchronous and asynchronous operations. - Creates a new #GCancellable object. @@ -8923,7 +8522,6 @@ and pass it to the operations. One #GCancellable can be used in multiple consecutive operations or in multiple concurrent operations. - a #GCancellable. @@ -8931,7 +8529,6 @@ operations or in multiple concurrent operations. Gets the top cancellable from the stack. - a #GCancellable from the top of the stack, or %NULL if the stack is empty. @@ -8939,7 +8536,6 @@ of the stack, or %NULL if the stack is empty. - @@ -8966,7 +8562,6 @@ operation causes it to complete asynchronously. That is, if you cancel the operation from the same thread in which it is running, then the operation's #GAsyncReadyCallback will not be invoked until the application returns to the main loop. - @@ -8996,7 +8591,6 @@ Since GLib 2.40, the lock protecting @cancellable is not held when @callback is invoked. This lifts a restriction in place for earlier GLib versions which now makes it easier to write cleanup code that unconditionally invokes e.g. g_cancellable_cancel(). - The id of the signal handler or 0 if @cancellable has already been cancelled. @@ -9036,7 +8630,6 @@ details on how to use this. If @cancellable is %NULL or @handler_id is `0` this function does nothing. - @@ -9065,7 +8658,6 @@ g_cancellable_release_fd() to free up resources allocated for the returned file descriptor. See also g_cancellable_make_pollfd(). - A valid file descriptor. `-1` if the file descriptor is not supported, or on errors. @@ -9080,7 +8672,6 @@ is not supported, or on errors. Checks if a cancellable job has been cancelled. - %TRUE if @cancellable is cancelled, FALSE if called with %NULL or if item is not cancelled. @@ -9112,7 +8703,6 @@ these cases is to ignore the @cancellable. You are not supposed to read from the fd yourself, just check for readable status. Reading to unset the readable status is done with g_cancellable_reset(). - %TRUE if @pollfd was successfully initialized, %FALSE on failure to prepare the cancellable. @@ -9132,7 +8722,6 @@ with g_cancellable_reset(). Pops @cancellable off the cancellable stack (verifying that @cancellable is on the top of the stack). - @@ -9152,7 +8741,6 @@ code that does not allow you to pass down the cancellable object. This is typically called automatically by e.g. #GFile operations, so you rarely have to call this yourself. - @@ -9173,7 +8761,6 @@ when the @cancellable is finalized. However, the @cancellable will block scarce file descriptors until it is finalized if this function is not called. This can cause the application to run out of file descriptors when many #GCancellables are used at the same time. - @@ -9196,7 +8783,6 @@ as this function might tempt you to do. The recommended practice is to drop the reference to a cancellable after cancelling it, and let it die with the outstanding async operations. You should create a fresh cancellable for further async operations. - @@ -9210,7 +8796,6 @@ create a fresh cancellable for further async operations. If the @cancellable is cancelled, sets the error to notify that the operation was cancelled. - %TRUE if @cancellable was cancelled, %FALSE if it was not @@ -9232,7 +8817,6 @@ For convenience, you can call this with a %NULL #GCancellable, in which case the source will never trigger. The new #GSource will hold a reference to the #GCancellable. - the new #GSource. @@ -9308,13 +8892,11 @@ cancellable signal should not do something that can block. - - @@ -9327,7 +8909,6 @@ cancellable signal should not do something that can block. - @@ -9335,7 +8916,6 @@ cancellable signal should not do something that can block. - @@ -9343,7 +8923,6 @@ cancellable signal should not do something that can block. - @@ -9351,7 +8930,6 @@ cancellable signal should not do something that can block. - @@ -9359,7 +8937,6 @@ cancellable signal should not do something that can block. - @@ -9372,7 +8949,6 @@ cancellable signal should not do something that can block. This is the function type of the callback used for the #GSource returned by g_cancellable_source_new(). - it should return %FALSE if the source should be removed. @@ -9391,12 +8967,10 @@ returned by g_cancellable_source_new(). #GCharsetConverter is an implementation of #GConverter based on GIConv. - Creates a new #GCharsetConverter. - a new #GCharsetConverter or %NULL on error. @@ -9414,7 +8988,6 @@ GIConv. Gets the number of fallbacks that @converter has applied so far. - the number of fallbacks that @converter has applied @@ -9428,7 +9001,6 @@ GIConv. Gets the #GCharsetConverter:use-fallback property. - %TRUE if fallbacks are used by @converter @@ -9442,7 +9014,6 @@ GIConv. Sets the #GCharsetConverter:use-fallback property. - @@ -9468,7 +9039,6 @@ GIConv. - @@ -9481,7 +9051,6 @@ stateful and may fail at any place. Some example conversions are: character set conversion, compression, decompression and regular expression replace. - This is the main operation used when converting data. It is to be called multiple times in a loop, and each time it will do some work, i.e. @@ -9565,7 +9134,6 @@ Flushing is not always possible (like if a charset converter flushes at a partial multibyte sequence). Converters are supposed to try to produce as much output as possible and then return an error (typically %G_IO_ERROR_PARTIAL_INPUT). - a #GConverterResult, %G_CONVERTER_ERROR on error. @@ -9615,7 +9183,6 @@ to produce as much output as possible and then return an error Resets all internal state in the converter, making it behave as if it was just created. If the converter has any internal state that would produce output then that output is lost. - @@ -9709,7 +9276,6 @@ Flushing is not always possible (like if a charset converter flushes at a partial multibyte sequence). Converters are supposed to try to produce as much output as possible and then return an error (typically %G_IO_ERROR_PARTIAL_INPUT). - a #GConverterResult, %G_CONVERTER_ERROR on error. @@ -9759,7 +9325,6 @@ to produce as much output as possible and then return an error Resets all internal state in the converter, making it behave as if it was just created. If the converter has any internal state that would produce output then that output is lost. - @@ -9787,14 +9352,12 @@ state that would produce output then that output is lost. Provides an interface for converting data from one type to another type. The conversion can be stateful and may fail at any place. - The parent interface. - a #GConverterResult, %G_CONVERTER_ERROR on error. @@ -9843,7 +9406,6 @@ and may fail at any place. - @@ -9862,11 +9424,9 @@ conversion of data of various types during reading. As of GLib 2.34, #GConverterInputStream implements #GPollableInputStream. - Creates a new converter input stream for the @base_stream. - a new #GInputStream. @@ -9884,7 +9444,6 @@ As of GLib 2.34, #GConverterInputStream implements Gets the #GConverter that is used by @converter_stream. - the converter of the converter input stream @@ -9907,13 +9466,11 @@ As of GLib 2.34, #GConverterInputStream implements - - @@ -9921,7 +9478,6 @@ As of GLib 2.34, #GConverterInputStream implements - @@ -9929,7 +9485,6 @@ As of GLib 2.34, #GConverterInputStream implements - @@ -9937,7 +9492,6 @@ As of GLib 2.34, #GConverterInputStream implements - @@ -9945,7 +9499,6 @@ As of GLib 2.34, #GConverterInputStream implements - @@ -9961,11 +9514,9 @@ conversion of data of various types during reading. As of GLib 2.34, #GConverterOutputStream implements #GPollableOutputStream. - Creates a new converter output stream for the @base_stream. - a new #GOutputStream. @@ -9983,7 +9534,6 @@ As of GLib 2.34, #GConverterOutputStream implements Gets the #GConverter that is used by @converter_stream. - the converter of the converter output stream @@ -10006,13 +9556,11 @@ As of GLib 2.34, #GConverterOutputStream implements - - @@ -10020,7 +9568,6 @@ As of GLib 2.34, #GConverterOutputStream implements - @@ -10028,7 +9575,6 @@ As of GLib 2.34, #GConverterOutputStream implements - @@ -10036,7 +9582,6 @@ As of GLib 2.34, #GConverterOutputStream implements - @@ -10044,7 +9589,6 @@ As of GLib 2.34, #GConverterOutputStream implements - @@ -10104,11 +9648,9 @@ This corresponds to %G_CREDENTIALS_TYPE_OPENBSD_SOCKPEERCRED. On Solaris (including OpenSolaris and its derivatives), the native credential type is a `ucred_t`. This corresponds to %G_CREDENTIALS_TYPE_SOLARIS_UCRED. - Creates a new #GCredentials object with credentials matching the the current process. - A #GCredentials. Free with g_object_unref(). @@ -10121,7 +9663,6 @@ the current process. It is a programming error (which will cause a warning to be logged) to use this method if there is no #GCredentials support for the OS or if @native_type isn't supported by the OS. - The pointer to native credentials or %NULL if the operation there is no #GCredentials support for the OS or if @@ -10148,7 +9689,6 @@ This operation can fail if #GCredentials is not supported on the OS or if the native credentials type does not contain information about the UNIX process ID (for example this is the case for %G_CREDENTIALS_TYPE_APPLE_XUCRED). - The UNIX process ID, or -1 if @error is set. @@ -10167,7 +9707,6 @@ method is only available on UNIX platforms. This operation can fail if #GCredentials is not supported on the OS or if the native credentials type does not contain information about the UNIX user. - The UNIX user identifier or -1 if @error is set. @@ -10184,7 +9723,6 @@ about the UNIX user. This operation can fail if #GCredentials is not supported on the the OS. - %TRUE if @credentials and @other_credentials has the same user, %FALSE otherwise or if @error is set. @@ -10208,7 +9746,6 @@ into @credentials. It is a programming error (which will cause a warning to be logged) to use this method if there is no #GCredentials support for the OS or if @native_type isn't supported by the OS. - @@ -10235,7 +9772,6 @@ This operation can fail if #GCredentials is not supported on the OS or if the native credentials type does not contain information about the UNIX user. It can also fail if the OS does not allow the use of "spoofed" credentials. - %TRUE if @uid was set, %FALSE if error is set. @@ -10255,7 +9791,6 @@ use of "spoofed" credentials. Creates a human-readable textual representation of @credentials that can be used in logging and debug messages. The format of the returned string may change in future GLib release. - A string that should be freed with g_free(). @@ -10270,7 +9805,6 @@ returned string may change in future GLib release. Class structure for #GCredentials. - Enumeration describing different kinds of native credential types. @@ -10297,287 +9831,246 @@ returned string may change in future GLib release. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -10603,7 +10096,6 @@ This call is non-blocking. The returned action group may or may not already be filled in. The correct thing to do is connect the signals for the action group to monitor for changes and then to call g_action_group_list_actions() to get the initial list. - a #GDBusActionGroup @@ -10627,7 +10119,6 @@ g_action_group_list_actions() to get the initial list. Information about an annotation. - The reference count or -1 if statically allocated. @@ -10649,7 +10140,6 @@ g_action_group_list_actions() to get the initial list. If @info is statically allocated does nothing. Otherwise increases the reference count. - The same @info. @@ -10665,7 +10155,6 @@ the reference count. If @info is statically allocated, does nothing. Otherwise decreases the reference count of @info. When its reference count drops to 0, the memory used is freed. - @@ -10680,7 +10169,6 @@ the memory used is freed. Looks up the value of an annotation. The cost of this function is O(n) in number of annotations. - The value or %NULL if not found. Do not free, it is owned by @annotations. @@ -10701,7 +10189,6 @@ The cost of this function is O(n) in number of annotations. Information about an argument for a method or a signal. - The reference count or -1 if statically allocated. @@ -10723,7 +10210,6 @@ The cost of this function is O(n) in number of annotations. If @info is statically allocated does nothing. Otherwise increases the reference count. - The same @info. @@ -10739,7 +10225,6 @@ the reference count. If @info is statically allocated, does nothing. Otherwise decreases the reference count of @info. When its reference count drops to 0, the memory used is freed. - @@ -10814,7 +10299,6 @@ on_authorize_authenticated_peer (GDBusAuthObserver *observer, ]| Creates a new #GDBusAuthObserver object. - A #GDBusAuthObserver. Free with g_object_unref(). @@ -10822,7 +10306,6 @@ on_authorize_authenticated_peer (GDBusAuthObserver *observer, Emits the #GDBusAuthObserver::allow-mechanism signal on @observer. - %TRUE if @mechanism can be used to authenticate the other peer, %FALSE if not. @@ -10840,7 +10323,6 @@ on_authorize_authenticated_peer (GDBusAuthObserver *observer, Emits the #GDBusAuthObserver::authorize-authenticated-peer signal on @observer. - %TRUE if the peer is authorized, %FALSE if not. @@ -10971,7 +10453,6 @@ Here is an example for exporting a #GObject: Finishes an operation started with g_dbus_connection_new(). - a #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). @@ -10987,7 +10468,6 @@ Here is an example for exporting a #GObject: Finishes an operation started with g_dbus_connection_new_for_address(). - a #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). @@ -11018,7 +10498,6 @@ g_dbus_connection_new_for_address() for the asynchronous version. If @observer is not %NULL it may be used to control the authentication process. - a #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). @@ -11059,7 +10538,6 @@ authentication process. This is a synchronous failable constructor. See g_dbus_connection_new() for the asynchronous version. - a #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). @@ -11108,7 +10586,6 @@ operation. This is an asynchronous failable constructor. See g_dbus_connection_new_sync() for the synchronous version. - @@ -11165,7 +10642,6 @@ authentication process. This is an asynchronous failable constructor. See g_dbus_connection_new_for_address_sync() for the synchronous version. - @@ -11224,7 +10700,6 @@ method from) at some point after @user_data is no longer needed. (It is not guaranteed to be called synchronously when the filter is removed, and may be called after @connection has been destroyed.) - a filter identifier that can be used with g_dbus_connection_remove_filter() @@ -11296,7 +10771,6 @@ function. If @callback is %NULL then the D-Bus method call message will be sent with the %G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED flag set. - @@ -11359,7 +10833,6 @@ the %G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED flag set. Finishes an operation started with g_dbus_connection_call(). - %NULL if @error is set. Otherwise a #GVariant tuple with return values. Free with g_variant_unref(). @@ -11413,7 +10886,6 @@ This allows convenient 'inline' use of g_variant_new(), e.g.: The calling thread is blocked until a reply is received. See g_dbus_connection_call() for the asynchronous version of this method. - %NULL if @error is set. Otherwise a #GVariant tuple with return values. Free with g_variant_unref(). @@ -11469,7 +10941,6 @@ this method. Like g_dbus_connection_call() but also takes a #GUnixFDList object. This method is only available on UNIX. - @@ -11535,7 +11006,6 @@ This method is only available on UNIX. Finishes an operation started with g_dbus_connection_call_with_unix_fd_list(). - %NULL if @error is set. Otherwise a #GVariant tuple with return values. Free with g_variant_unref(). @@ -11561,7 +11031,6 @@ This method is only available on UNIX. Like g_dbus_connection_call_sync() but also takes and returns #GUnixFDList objects. This method is only available on UNIX. - %NULL if @error is set. Otherwise a #GVariant tuple with return values. Free with g_variant_unref(). @@ -11646,7 +11115,6 @@ of the thread you are calling this method from. You can then call g_dbus_connection_close_finish() to get the result of the operation. See g_dbus_connection_close_sync() for the synchronous version. - @@ -11672,7 +11140,6 @@ version. Finishes an operation started with g_dbus_connection_close(). - %TRUE if the operation succeeded, %FALSE if @error is set @@ -11694,7 +11161,6 @@ version. until this is done. See g_dbus_connection_close() for the asynchronous version of this method and more details about what it does. - %TRUE if the operation succeeded, %FALSE if @error is set @@ -11718,7 +11184,6 @@ If the parameters GVariant is floating, it is consumed. This can only fail if @parameters is not compatible with the D-Bus protocol (%G_IO_ERROR_INVALID_ARGUMENT), or if @connection has been closed (%G_IO_ERROR_CLOSED). - %TRUE unless @error is set @@ -11774,7 +11239,6 @@ Since incoming action activations and state change requests are rather likely to cause changes on the action group, this effectively limits a given action group to being exported from only one main context. - the ID of the export (never zero), or 0 in case of failure @@ -11807,7 +11271,6 @@ returned (with @error set accordingly). You can unexport the menu model using g_dbus_connection_unexport_menu_model() with the return value of this function. - the ID of the export (never zero), or 0 in case of failure @@ -11842,7 +11305,6 @@ of the thread you are calling this method from. You can then call g_dbus_connection_flush_finish() to get the result of the operation. See g_dbus_connection_flush_sync() for the synchronous version. - @@ -11868,7 +11330,6 @@ version. Finishes an operation started with g_dbus_connection_flush(). - %TRUE if the operation succeeded, %FALSE if @error is set @@ -11890,7 +11351,6 @@ version. until this is done. See g_dbus_connection_flush() for the asynchronous version of this method and more details about what it does. - %TRUE if the operation succeeded, %FALSE if @error is set @@ -11908,7 +11368,6 @@ does. Gets the capabilities negotiated with the remote peer - zero or more flags from the #GDBusCapabilityFlags enumeration @@ -11924,7 +11383,6 @@ does. Gets whether the process is terminated when @connection is closed by the remote peer. See #GDBusConnection:exit-on-close for more details. - whether the process is terminated when @connection is closed by the remote peer @@ -11939,7 +11397,6 @@ closed by the remote peer. See Gets the flags used to construct this connection - zero or more flags from the #GDBusConnectionFlags enumeration @@ -11954,7 +11411,6 @@ closed by the remote peer. See The GUID of the peer performing the role of server when authenticating. See #GDBusConnection:guid for more details. - The GUID. Do not free this string, it is owned by @connection. @@ -11973,7 +11429,6 @@ the current thread. This includes messages sent via both low-level API such as g_dbus_connection_send_message() as well as high-level API such as g_dbus_connection_emit_signal(), g_dbus_connection_call() or g_dbus_proxy_call(). - the last used serial or zero when no message has been sent within the current thread @@ -11996,7 +11451,6 @@ authentication process. In a message bus setup, the message bus is always the server and each application is a client. So this method will always return %NULL for message bus clients. - a #GCredentials or %NULL if not available. Do not free this object, it is owned by @connection. @@ -12015,7 +11469,6 @@ each application is a client. So this method will always return While the #GDBusConnection is active, it will interact with this stream from a worker thread, so it is not safe to interact with the stream directly. - the stream used for IO @@ -12031,7 +11484,6 @@ the stream directly. Gets the unique name of @connection as assigned by the message bus. This can also be used to figure out if @connection is a message bus connection. - the unique name or %NULL if @connection is not a message bus connection. Do not free this string, it is owned by @@ -12047,7 +11499,6 @@ message bus connection. Gets whether @connection is closed. - %TRUE if the connection is closed, %FALSE otherwise @@ -12098,7 +11549,6 @@ reference count is -1, see g_dbus_interface_info_ref()) for as long as the object is exported. Also note that @vtable will be copied. See this [server][gdbus-server] for an example of how to use this method. - 0 if @error is set, otherwise a registration id (never 0) that can be used with g_dbus_connection_unregister_object() @@ -12134,7 +11584,6 @@ See this [server][gdbus-server] for an example of how to use this method. Version of g_dbus_connection_register_object() using closures instead of a #GDBusInterfaceVTable for easier binding in other languages. - 0 if @error is set, otherwise a registration id (never 0) that can be used with g_dbus_connection_unregister_object() . @@ -12202,7 +11651,6 @@ registration. See this [server][gdbus-subtree-server] for an example of how to use this method. - 0 if @error is set, otherwise a subtree registration id (never 0) that can be used with g_dbus_connection_unregister_subtree() . @@ -12245,7 +11693,6 @@ after calling g_dbus_connection_remove_filter(), so you cannot just free data that the filter might be using. Instead, you should pass a #GDestroyNotify to g_dbus_connection_add_filter(), which will be called when it is guaranteed that the data is no longer needed. - @@ -12280,7 +11727,6 @@ UNIX file descriptors. Note that @message must be unlocked, unless @flags contain the %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag. - %TRUE if the message was well-formed and queued for transmission, %FALSE if @error is set @@ -12334,7 +11780,6 @@ Note that @message must be unlocked, unless @flags contain the See this [server][gdbus-server] and [client][gdbus-unix-fd-client] for an example of how to use this low-level API to send and receive UNIX file descriptors. - @@ -12387,7 +11832,6 @@ g_dbus_message_to_gerror() to transcode this to a #GError. See this [server][gdbus-server] and [client][gdbus-unix-fd-client] for an example of how to use this low-level API to send and receive UNIX file descriptors. - a locked #GDBusMessage or %NULL if @error is set @@ -12433,7 +11877,6 @@ UNIX file descriptors. Note that @message must be unlocked, unless @flags contain the %G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag. - a locked #GDBusMessage that is the reply to @message or %NULL if @error is set @@ -12479,7 +11922,6 @@ all of a user's applications to quit when their bus connection goes away. If you are setting @exit_on_close to %FALSE for the shared session bus connection, you should make sure that your application exits when the user session ends. - @@ -12545,7 +11987,6 @@ The returned subscription identifier is an opaque value which is guaranteed to never be zero. This function can never fail. - a subscription identifier that can be used with g_dbus_connection_signal_unsubscribe() @@ -12610,7 +12051,6 @@ until the #GDestroyNotify function passed to g_dbus_connection_signal_subscribe() is called, in order to avoid memory leaks through callbacks queued on the #GMainContext after it’s stopped being iterated. - @@ -12631,7 +12071,6 @@ iterated. %G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING, this method starts processing messages. Does nothing on if @connection wasn't created with this flag or if the method has already been called. - @@ -12649,7 +12088,6 @@ g_dbus_connection_export_action_group(). It is an error to call this function with an ID that wasn't returned from g_dbus_connection_export_action_group() or to call it with the same ID more than once. - @@ -12671,7 +12109,6 @@ g_dbus_connection_export_menu_model(). It is an error to call this function with an ID that wasn't returned from g_dbus_connection_export_menu_model() or to call it with the same ID more than once. - @@ -12688,7 +12125,6 @@ same ID more than once. Unregisters an object. - %TRUE if the object was unregistered, %FALSE otherwise @@ -12707,7 +12143,6 @@ same ID more than once. Unregisters a subtree. - %TRUE if the subtree was unregistered, %FALSE otherwise @@ -13004,7 +12439,6 @@ on the wire back to a #GError using g_dbus_error_new_for_dbus_error(). This function is typically only used in object mappings to put a #GError on the wire. Regular applications should not use it. - A D-Bus error name (never %NULL). Free with g_free(). @@ -13023,7 +12457,6 @@ This function is guaranteed to return a D-Bus error name for all #GErrors returned from functions handling remote method calls (e.g. g_dbus_connection_call_finish()) unless g_dbus_error_strip_remote_error() has been used on @error. - an allocated string or %NULL if the D-Bus error name could not be found. Free with g_free(). @@ -13039,7 +12472,6 @@ g_dbus_error_strip_remote_error() has been used on @error. Checks if @error represents an error received via D-Bus from a remote peer. If so, use g_dbus_error_get_remote_error() to get the name of the error. - %TRUE if @error represents an error from a remote peer, %FALSE otherwise. @@ -13079,7 +12511,6 @@ returned #GError using the g_dbus_error_get_remote_error() function This function is typically only used in object mappings to prepare #GError instances for applications. Regular applications should not use it. - An allocated #GError. Free with g_error_free(). @@ -13106,7 +12537,6 @@ it. This is typically done in the routine that returns the #GQuark for an error domain. - %TRUE if the association was created, %FALSE if it already exists. @@ -13129,7 +12559,6 @@ exists. Helper function for associating a #GError error domain with D-Bus error names. - @@ -13158,7 +12587,6 @@ exists. Does nothing if @error is %NULL. Otherwise sets *@error to a new #GError created with g_dbus_error_new_for_dbus_error() with @dbus_error_message prepend with @format (unless %NULL). - @@ -13187,7 +12615,6 @@ with @dbus_error_message prepend with @format (unless %NULL). Like g_dbus_error_set_dbus_error() but intended for language bindings. - @@ -13221,7 +12648,6 @@ message field in @error will correspond exactly to what was received on the wire. This is typically used when presenting errors to the end user. - %TRUE if information was stripped, %FALSE otherwise. @@ -13235,7 +12661,6 @@ This is typically used when presenting errors to the end user. Destroys an association previously set up with g_dbus_error_register_error(). - %TRUE if the association was destroyed, %FALSE if it wasn't found. @@ -13258,7 +12683,6 @@ This is typically used when presenting errors to the end user. Struct used in g_dbus_error_register_error_domain(). - An error code. @@ -13272,10 +12696,8 @@ This is typically used when presenting errors to the end user. The #GDBusInterface type is the base type for D-Bus interfaces both on the service side (see #GDBusInterfaceSkeleton) and client side (see #GDBusProxy). - Gets the #GDBusObject that @interface_ belongs to, if any. - A #GDBusObject or %NULL. The returned reference should be freed with g_object_unref(). @@ -13291,7 +12713,6 @@ reference should be freed with g_object_unref(). Gets D-Bus introspection information for the D-Bus interface implemented by @interface_. - A #GDBusInterfaceInfo. Do not free. @@ -13309,7 +12730,6 @@ implemented by @interface_. It is not safe to use the returned object if @interface_ or the returned object is being used from other threads. See g_dbus_interface_dup_object() for a thread-safe alternative. - A #GDBusObject or %NULL. The returned reference belongs to @interface_ and should not be freed. @@ -13326,7 +12746,6 @@ g_dbus_interface_dup_object() for a thread-safe alternative. Sets the #GDBusObject for @interface_ to @object. Note that @interface_ will hold a weak reference to @object. - @@ -13343,7 +12762,6 @@ Note that @interface_ will hold a weak reference to @object. Gets the #GDBusObject that @interface_ belongs to, if any. - A #GDBusObject or %NULL. The returned reference should be freed with g_object_unref(). @@ -13359,7 +12777,6 @@ reference should be freed with g_object_unref(). Gets D-Bus introspection information for the D-Bus interface implemented by @interface_. - A #GDBusInterfaceInfo. Do not free. @@ -13377,7 +12794,6 @@ implemented by @interface_. It is not safe to use the returned object if @interface_ or the returned object is being used from other threads. See g_dbus_interface_dup_object() for a thread-safe alternative. - A #GDBusObject or %NULL. The returned reference belongs to @interface_ and should not be freed. @@ -13394,7 +12810,6 @@ g_dbus_interface_dup_object() for a thread-safe alternative. Sets the #GDBusObject for @interface_ to @object. Note that @interface_ will hold a weak reference to @object. - @@ -13412,7 +12827,6 @@ Note that @interface_ will hold a weak reference to @object. The type of the @get_property function in #GDBusInterfaceVTable. - A #GVariant with the value for @property_name or %NULL if @error is set. If the returned #GVariant is floating, it is @@ -13452,14 +12866,12 @@ Note that @interface_ will hold a weak reference to @object. Base type for D-Bus interfaces. - The parent interface. - A #GDBusInterfaceInfo. Do not free. @@ -13474,7 +12886,6 @@ Note that @interface_ will hold a weak reference to @object. - A #GDBusObject or %NULL. The returned reference belongs to @interface_ and should not be freed. @@ -13490,7 +12901,6 @@ Note that @interface_ will hold a weak reference to @object. - @@ -13508,7 +12918,6 @@ Note that @interface_ will hold a weak reference to @object. - A #GDBusObject or %NULL. The returned reference should be freed with g_object_unref(). @@ -13525,7 +12934,6 @@ reference should be freed with g_object_unref(). Information about a D-Bus interface. - The reference count or -1 if statically allocated. @@ -13569,7 +12977,6 @@ used and its use count is increased. Note that @info cannot be modified until g_dbus_interface_info_cache_release() is called. - @@ -13584,7 +12991,6 @@ g_dbus_interface_info_cache_release() is called. Decrements the usage count for the cache for @info built by g_dbus_interface_info_cache_build() (if any) and frees the resources used by the cache if the usage count drops to zero. - @@ -13602,7 +13008,6 @@ This function is typically used for generating introspection XML documents at run-time for handling the `org.freedesktop.DBus.Introspectable.Introspect` method. - @@ -13626,7 +13031,6 @@ method. The cost of this function is O(n) in number of methods unless g_dbus_interface_info_cache_build() has been used on @info. - A #GDBusMethodInfo or %NULL if not found. Do not free, it is owned by @info. @@ -13647,7 +13051,6 @@ g_dbus_interface_info_cache_build() has been used on @info. The cost of this function is O(n) in number of properties unless g_dbus_interface_info_cache_build() has been used on @info. - A #GDBusPropertyInfo or %NULL if not found. Do not free, it is owned by @info. @@ -13668,7 +13071,6 @@ g_dbus_interface_info_cache_build() has been used on @info. The cost of this function is O(n) in number of signals unless g_dbus_interface_info_cache_build() has been used on @info. - A #GDBusSignalInfo or %NULL if not found. Do not free, it is owned by @info. @@ -13687,7 +13089,6 @@ g_dbus_interface_info_cache_build() has been used on @info. If @info is statically allocated does nothing. Otherwise increases the reference count. - The same @info. @@ -13703,7 +13104,6 @@ the reference count. If @info is statically allocated, does nothing. Otherwise decreases the reference count of @info. When its reference count drops to 0, the memory used is freed. - @@ -13717,7 +13117,6 @@ the memory used is freed. The type of the @method_call function in #GDBusInterfaceVTable. - @@ -13758,7 +13157,6 @@ the memory used is freed. The type of the @set_property function in #GDBusInterfaceVTable. - %TRUE if the property was set to @value, %FALSE if @error is set. @@ -13800,7 +13198,6 @@ the memory used is freed. Abstract base class for D-Bus interfaces on the service side. - If @interface_ has outstanding changes, request for these changes to be @@ -13811,7 +13208,6 @@ changes and emit the `org.freedesktop.DBus.Properties.PropertiesChanged` signal later (e.g. in an idle handler). This technique is useful for collapsing multiple property changes into one. - @@ -13823,7 +13219,6 @@ for collapsing multiple property changes into one. - @@ -13839,7 +13234,6 @@ for collapsing multiple property changes into one. Gets D-Bus introspection information for the D-Bus interface implemented by @interface_. - A #GDBusInterfaceInfo (never %NULL). Do not free. @@ -13853,7 +13247,6 @@ implemented by @interface_. Gets all D-Bus properties for @interface_. - A #GVariant of type ['a{sv}'][G-VARIANT-TYPE-VARDICT:CAPS]. @@ -13871,7 +13264,6 @@ Free with g_variant_unref(). Gets the interface vtable for the D-Bus interface implemented by @interface_. The returned function pointers should expect @interface_ itself to be passed as @user_data. - A #GDBusInterfaceVTable (never %NULL). @@ -13891,7 +13283,6 @@ onto multiple connections however the @object_path provided must be the same for all connections. Use g_dbus_interface_skeleton_unexport() to unexport the object. - %TRUE if the interface was exported on @connection, otherwise %FALSE with @error set. @@ -13921,7 +13312,6 @@ changes and emit the `org.freedesktop.DBus.Properties.PropertiesChanged` signal later (e.g. in an idle handler). This technique is useful for collapsing multiple property changes into one. - @@ -13934,7 +13324,6 @@ for collapsing multiple property changes into one. Gets the first connection that @interface_ is exported on, if any. - A #GDBusConnection or %NULL if @interface_ is not exported anywhere. Do not free, the object belongs to @interface_. @@ -13949,7 +13338,6 @@ not exported anywhere. Do not free, the object belongs to @interface_. Gets a list of the connections that @interface_ is exported on. - A list of all the connections that @interface_ is exported on. The returned @@ -13969,7 +13357,6 @@ not exported anywhere. Do not free, the object belongs to @interface_. Gets the #GDBusInterfaceSkeletonFlags that describes what the behavior of @interface_ - One or more flags from the #GDBusInterfaceSkeletonFlags enumeration. @@ -13984,7 +13371,6 @@ of @interface_ Gets D-Bus introspection information for the D-Bus interface implemented by @interface_. - A #GDBusInterfaceInfo (never %NULL). Do not free. @@ -13998,7 +13384,6 @@ implemented by @interface_. Gets the object path that @interface_ is exported on, if any. - A string owned by @interface_ or %NULL if @interface_ is not exported anywhere. Do not free, the string belongs to @interface_. @@ -14013,7 +13398,6 @@ anywhere. Do not free, the string belongs to @interface_. Gets all D-Bus properties for @interface_. - A #GVariant of type ['a{sv}'][G-VARIANT-TYPE-VARDICT:CAPS]. @@ -14031,7 +13415,6 @@ Free with g_variant_unref(). Gets the interface vtable for the D-Bus interface implemented by @interface_. The returned function pointers should expect @interface_ itself to be passed as @user_data. - A #GDBusInterfaceVTable (never %NULL). @@ -14045,7 +13428,6 @@ itself to be passed as @user_data. Checks if @interface_ is exported on @connection. - %TRUE if @interface_ is exported on @connection, %FALSE otherwise. @@ -14063,7 +13445,6 @@ itself to be passed as @user_data. Sets flags describing what the behavior of @skeleton should be. - @@ -14083,7 +13464,6 @@ itself to be passed as @user_data. To unexport @interface_ from only a single connection, use g_dbus_interface_skeleton_unexport_from_connection() - @@ -14099,7 +13479,6 @@ g_dbus_interface_skeleton_unexport_from_connection() To stop exporting on all connections the interface is exported on, use g_dbus_interface_skeleton_unexport(). - @@ -14172,14 +13551,12 @@ to was exported in. Class structure for #GDBusInterfaceSkeleton. - The parent class. - A #GDBusInterfaceInfo (never %NULL). Do not free. @@ -14194,7 +13571,6 @@ to was exported in. - A #GDBusInterfaceVTable (never %NULL). @@ -14209,7 +13585,6 @@ to was exported in. - A #GVariant of type ['a{sv}'][G-VARIANT-TYPE-VARDICT:CAPS]. @@ -14226,7 +13601,6 @@ Free with g_variant_unref(). - @@ -14245,7 +13619,6 @@ Free with g_variant_unref(). - @@ -14322,7 +13695,6 @@ If you have writable properties specified in your interface info, you must ensure that you either provide a non-%NULL @set_property() function or provide an implementation of the `Set` call. If implementing the call, you must return the value of type %G_VARIANT_TYPE_UNIT. - Function for handling incoming method calls. @@ -14354,7 +13726,6 @@ All signals on the menu model (and any linked models) are reported with respect to this context. All calls on the returned menu model (and linked models) must also originate from this same context, with the thread default main context unchanged. - a #GDBusMenuModel object. Free with g_object_unref(). @@ -14382,7 +13753,6 @@ the thread default main context unchanged. on a #GDBusConnection. Creates a new empty #GDBusMessage. - A #GDBusMessage. Free with g_object_unref(). @@ -14395,7 +13765,6 @@ g_dbus_message_get_byte_order(). If the @blob cannot be parsed, contains invalid fields, or contains invalid headers, %G_IO_ERROR_INVALID_ARGUMENT will be returned. - A new #GDBusMessage or %NULL if @error is set. Free with g_object_unref(). @@ -14420,7 +13789,6 @@ g_object_unref(). Creates a new #GDBusMessage for a method call. - A #GDBusMessage. Free with g_object_unref(). @@ -14446,7 +13814,6 @@ g_object_unref(). Creates a new #GDBusMessage for a signal emission. - A #GDBusMessage. Free with g_object_unref(). @@ -14469,7 +13836,6 @@ g_object_unref(). Utility function to calculate how many bytes are needed to completely deserialize the D-Bus message stored at @blob. - Number of bytes needed or -1 if @error is set (e.g. if @blob contains invalid data or not enough data is available to @@ -14496,7 +13862,6 @@ to not be locked. This operation can fail if e.g. @message contains file descriptors and the per-process or system-wide open files limit is reached. - A new #GDBusMessage or %NULL if @error is set. Free with g_object_unref(). @@ -14511,7 +13876,6 @@ and the per-process or system-wide open files limit is reached. Convenience to get the first item in the body of @message. - The string item or %NULL if the first item in the body of @message is not a string. @@ -14526,7 +13890,6 @@ and the per-process or system-wide open files limit is reached. Gets the body of a message. - A #GVariant or %NULL if the body is empty. Do not free, it is owned by @message. @@ -14541,7 +13904,6 @@ empty. Do not free, it is owned by @message. Gets the byte order of @message. - The byte order. @@ -14555,7 +13917,6 @@ empty. Do not free, it is owned by @message. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field. - The value. @@ -14569,7 +13930,6 @@ empty. Do not free, it is owned by @message. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field. - The value. @@ -14583,7 +13943,6 @@ empty. Do not free, it is owned by @message. Gets the flags for @message. - Flags that are set (typically values from the #GDBusMessageFlags enumeration bitwise ORed together). @@ -14600,7 +13959,6 @@ empty. Do not free, it is owned by @message. The caller is responsible for checking the type of the returned #GVariant matches what is expected. - A #GVariant with the value if the header was found, %NULL otherwise. Do not free, it is owned by @message. @@ -14619,7 +13977,6 @@ otherwise. Do not free, it is owned by @message. Gets an array of all header fields on @message that are set. - An array of header fields terminated by %G_DBUS_MESSAGE_HEADER_FIELD_INVALID. Each element @@ -14637,7 +13994,6 @@ is a #guchar. Free with g_free(). Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field. - The value. @@ -14653,7 +14009,6 @@ is a #guchar. Free with g_free(). Checks whether @message is locked. To monitor changes to this value, conncet to the #GObject::notify signal to listen for changes on the #GDBusMessage:locked property. - %TRUE if @message is locked, %FALSE otherwise. @@ -14667,7 +14022,6 @@ on the #GDBusMessage:locked property. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field. - The value. @@ -14681,7 +14035,6 @@ on the #GDBusMessage:locked property. Gets the type of @message. - A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration). @@ -14695,7 +14048,6 @@ on the #GDBusMessage:locked property. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field. - The value. @@ -14709,7 +14061,6 @@ on the #GDBusMessage:locked property. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field. - The value. @@ -14723,7 +14074,6 @@ on the #GDBusMessage:locked property. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field. - The value. @@ -14737,7 +14087,6 @@ on the #GDBusMessage:locked property. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field. - The value. @@ -14751,7 +14100,6 @@ on the #GDBusMessage:locked property. Gets the serial for @message. - A #guint32. @@ -14765,7 +14113,6 @@ on the #GDBusMessage:locked property. Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field. - The value. @@ -14781,7 +14128,6 @@ on the #GDBusMessage:locked property. Gets the UNIX file descriptors associated with @message, if any. This method is only available on UNIX. - A #GUnixFDList or %NULL if no file descriptors are associated. Do not free, this object is owned by @message. @@ -14796,7 +14142,6 @@ associated. Do not free, this object is owned by @message. If @message is locked, does nothing. Otherwise locks the message. - @@ -14809,7 +14154,6 @@ associated. Do not free, this object is owned by @message. Creates a new #GDBusMessage that is an error reply to @method_call_message. - A #GDBusMessage. Free with g_object_unref(). @@ -14836,7 +14180,6 @@ create a reply message to. Creates a new #GDBusMessage that is an error reply to @method_call_message. - A #GDBusMessage. Free with g_object_unref(). @@ -14859,7 +14202,6 @@ create a reply message to. Like g_dbus_message_new_method_error() but intended for language bindings. - A #GDBusMessage. Free with g_object_unref(). @@ -14886,7 +14228,6 @@ create a reply message to. Creates a new #GDBusMessage that is a reply to @method_call_message. - #GDBusMessage. Free with g_object_unref(). @@ -14932,7 +14273,6 @@ Body: () UNIX File Descriptors: fd 12: dev=0:10,mode=020620,ino=5,uid=500,gid=5,rdev=136:2,size=0,atime=1273085037,mtime=1273085851,ctime=1272982635 ]| - A string that should be freed with g_free(). @@ -14954,7 +14294,6 @@ UNIX File Descriptors: type string of @body (or cleared if @body is %NULL). If @body is floating, @message assumes ownership of @body. - @@ -14971,7 +14310,6 @@ If @body is floating, @message assumes ownership of @body. Sets the byte order of @message. - @@ -14988,7 +14326,6 @@ If @body is floating, @message assumes ownership of @body. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field. - @@ -15005,7 +14342,6 @@ If @body is floating, @message assumes ownership of @body. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field. - @@ -15022,7 +14358,6 @@ If @body is floating, @message assumes ownership of @body. Sets the flags to set on @message. - @@ -15042,7 +14377,6 @@ enumeration bitwise ORed together). Sets a header field on @message. If @value is floating, @message assumes ownership of @value. - @@ -15063,7 +14397,6 @@ If @value is floating, @message assumes ownership of @value. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field. - @@ -15080,7 +14413,6 @@ If @value is floating, @message assumes ownership of @value. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field. - @@ -15097,7 +14429,6 @@ If @value is floating, @message assumes ownership of @value. Sets @message to be of @type. - @@ -15114,7 +14445,6 @@ If @value is floating, @message assumes ownership of @value. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field. - @@ -15131,7 +14461,6 @@ If @value is floating, @message assumes ownership of @value. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field. - @@ -15148,7 +14477,6 @@ If @value is floating, @message assumes ownership of @value. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field. - @@ -15165,7 +14493,6 @@ If @value is floating, @message assumes ownership of @value. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field. - @@ -15182,7 +14509,6 @@ If @value is floating, @message assumes ownership of @value. Sets the serial for @message. - @@ -15199,7 +14525,6 @@ If @value is floating, @message assumes ownership of @value. Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field. - @@ -15221,7 +14546,6 @@ field is set to the number of fds in @fd_list (or cleared if @fd_list is %NULL). This method is only available on UNIX. - @@ -15239,7 +14563,6 @@ This method is only available on UNIX. Serializes @message to a blob. The byte order returned by g_dbus_message_get_byte_order() will be used. - A pointer to a valid binary D-Bus message of @out_size bytes generated by @message @@ -15271,7 +14594,6 @@ Otherwise this method encodes the error in @message as a #GError using g_dbus_error_set_dbus_error() using the information in the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field of @message as well as the first string item in @message's body. - %TRUE if @error was set, %FALSE otherwise. @@ -15356,7 +14678,6 @@ descriptors, not compatible with @connection), then a warning is logged to standard error. Applications can check this ahead of time using g_dbus_message_to_blob() passing a #GDBusCapabilityFlags value obtained from @connection. - A #GDBusMessage that will be freed with g_object_unref() or %NULL to drop the message. Passive filter @@ -15454,7 +14775,6 @@ authorization. Since 2.46. Information about a method on an D-Bus interface. - The reference count or -1 if statically allocated. @@ -15484,7 +14804,6 @@ authorization. Since 2.46. If @info is statically allocated does nothing. Otherwise increases the reference count. - The same @info. @@ -15500,7 +14819,6 @@ the reference count. If @info is statically allocated, does nothing. Otherwise decreases the reference count of @info. When its reference count drops to 0, the memory used is freed. - @@ -15522,7 +14840,6 @@ it as an argument to the handle_method_call() function in a #GDBusInterfaceVTable that was passed to g_dbus_connection_register_object(). Gets the #GDBusConnection the method was invoked on. - A #GDBusConnection. Do not free, it is owned by @invocation. @@ -15541,7 +14858,6 @@ If this method call is a property Get, Set or GetAll call that has been redirected to the method call handler then "org.freedesktop.DBus.Properties" will be returned. See #GDBusInterfaceVTable for more information. - A string. Do not free, it is owned by @invocation. @@ -15562,7 +14878,6 @@ descriptor passing, that cannot be properly expressed in the See this [server][gdbus-server] and [client][gdbus-unix-fd-client] for an example of how to use this low-level API to send and receive UNIX file descriptors. - #GDBusMessage. Do not free, it is owned by @invocation. @@ -15581,7 +14896,6 @@ If this method invocation is a property Get, Set or GetAll call that has been redirected to the method call handler then %NULL will be returned. See g_dbus_method_invocation_get_property_info() and #GDBusInterfaceVTable for more information. - A #GDBusMethodInfo or %NULL. Do not free, it is owned by @invocation. @@ -15595,7 +14909,6 @@ returned. See g_dbus_method_invocation_get_property_info() and Gets the name of the method that was invoked. - A string. Do not free, it is owned by @invocation. @@ -15609,7 +14922,6 @@ returned. See g_dbus_method_invocation_get_property_info() and Gets the object path the method was invoked on. - A string. Do not free, it is owned by @invocation. @@ -15624,7 +14936,6 @@ returned. See g_dbus_method_invocation_get_property_info() and Gets the parameters of the method invocation. If there are no input parameters then this will return a GVariant with 0 children rather than NULL. - A #GVariant tuple. Do not unref this because it is owned by @invocation. @@ -15648,7 +14959,6 @@ property_set() vtable pointers being unset. See #GDBusInterfaceVTable for more information. If the call was GetAll, %NULL will be returned. - a #GDBusPropertyInfo or %NULL @@ -15662,7 +14972,6 @@ If the call was GetAll, %NULL will be returned. Gets the bus name that invoked the method. - A string. Do not free, it is owned by @invocation. @@ -15676,7 +14985,6 @@ If the call was GetAll, %NULL will be returned. Gets the @user_data #gpointer passed to g_dbus_connection_register_object(). - A #gpointer. @@ -15694,7 +15002,6 @@ If the call was GetAll, %NULL will be returned. This method will take ownership of @invocation. See #GDBusInterfaceVTable for more information about the ownership of @invocation. - @@ -15734,7 +15041,6 @@ This method will take ownership of @invocation. See Since 2.48, if the method call requested for a reply not to be sent then this call will free @invocation but otherwise do nothing (as per the recommendations of the D-Bus specification). - @@ -15767,7 +15073,6 @@ the recommendations of the D-Bus specification). This method will take ownership of @invocation. See #GDBusInterfaceVTable for more information about the ownership of @invocation. - @@ -15797,7 +15102,6 @@ language bindings. This method will take ownership of @invocation. See #GDBusInterfaceVTable for more information about the ownership of @invocation. - @@ -15831,7 +15135,6 @@ instead of the error domain, error code and message. This method will take ownership of @invocation. See #GDBusInterfaceVTable for more information about the ownership of @invocation. - @@ -15879,7 +15182,6 @@ Since 2.48, if the method call requested for a reply not to be sent then this call will sink @parameters and free @invocation, but otherwise do nothing (as per the recommendations of the D-Bus specification). - @@ -15902,7 +15204,6 @@ This method is only available on UNIX. This method will take ownership of @invocation. See #GDBusInterfaceVTable for more information about the ownership of @invocation. - @@ -15928,7 +15229,6 @@ of @error so the caller does not need to free it. This method will take ownership of @invocation. See #GDBusInterfaceVTable for more information about the ownership of @invocation. - @@ -15946,7 +15246,6 @@ This method will take ownership of @invocation. See Information about nodes in a remote object hierarchy. - The reference count or -1 if statically allocated. @@ -15982,7 +15281,6 @@ The introspection XML must contain exactly one top-level Note that this routine is using a [GMarkup][glib-Simple-XML-Subset-Parser.description]-based parser that only accepts a subset of valid XML documents. - A #GDBusNodeInfo structure or %NULL if @error is set. Free with g_dbus_node_info_unref(). @@ -16000,7 +15298,6 @@ with g_dbus_node_info_unref(). This function is typically used for generating introspection XML documents at run-time for handling the `org.freedesktop.DBus.Introspectable.Introspect` method. - @@ -16023,7 +15320,6 @@ handling the `org.freedesktop.DBus.Introspectable.Introspect` method. Looks up information about an interface. The cost of this function is O(n) in number of interfaces. - A #GDBusInterfaceInfo or %NULL if not found. Do not free, it is owned by @info. @@ -16042,7 +15338,6 @@ The cost of this function is O(n) in number of interfaces. If @info is statically allocated does nothing. Otherwise increases the reference count. - The same @info. @@ -16058,7 +15353,6 @@ the reference count. If @info is statically allocated, does nothing. Otherwise decreases the reference count of @info. When its reference count drops to 0, the memory used is freed. - @@ -16075,11 +15369,9 @@ the memory used is freed. the service side (see #GDBusObjectSkeleton) and the client side (see #GDBusObjectProxy). It is essentially just a container of interfaces. - Gets the D-Bus interface with name @interface_name associated with @object, if any. - %NULL if not found, otherwise a #GDBusInterface that must be freed with g_object_unref(). @@ -16098,7 +15390,6 @@ interfaces. Gets the D-Bus interfaces associated with @object. - A list of #GDBusInterface instances. The returned list must be freed by g_list_free() after each element has been freed @@ -16116,7 +15407,6 @@ interfaces. Gets the object path for @object. - A string owned by @object. Do not free. @@ -16129,7 +15419,6 @@ interfaces. - @@ -16143,7 +15432,6 @@ interfaces. - @@ -16159,7 +15447,6 @@ interfaces. Gets the D-Bus interface with name @interface_name associated with @object, if any. - %NULL if not found, otherwise a #GDBusInterface that must be freed with g_object_unref(). @@ -16178,7 +15465,6 @@ interfaces. Gets the D-Bus interfaces associated with @object. - A list of #GDBusInterface instances. The returned list must be freed by g_list_free() after each element has been freed @@ -16196,7 +15482,6 @@ interfaces. Gets the object path for @object. - A string owned by @object. Do not free. @@ -16235,14 +15520,12 @@ interfaces. Base object type for D-Bus objects. - The parent interface. - A string owned by @object. Do not free. @@ -16257,7 +15540,6 @@ interfaces. - A list of #GDBusInterface instances. The returned list must be freed by g_list_free() after each element has been freed @@ -16276,7 +15558,6 @@ interfaces. - %NULL if not found, otherwise a #GDBusInterface that must be freed with g_object_unref(). @@ -16296,7 +15577,6 @@ interfaces. - @@ -16312,7 +15592,6 @@ interfaces. - @@ -16335,11 +15614,9 @@ interface. See #GDBusObjectManagerClient for the client-side implementation and #GDBusObjectManagerServer for the service-side implementation. - Gets the interface proxy for @interface_name at @object_path, if any. - A #GDBusInterface instance or %NULL. Free with g_object_unref(). @@ -16362,7 +15639,6 @@ any. Gets the #GDBusObjectProxy at @object_path, if any. - A #GDBusObject or %NULL. Free with g_object_unref(). @@ -16381,7 +15657,6 @@ any. Gets the object path that @manager is for. - A string owned by @manager. Do not free. @@ -16395,7 +15670,6 @@ any. Gets all #GDBusObject objects known to @manager. - A list of #GDBusObject objects. The returned list should be freed with @@ -16413,7 +15687,6 @@ any. - @@ -16430,7 +15703,6 @@ any. - @@ -16447,7 +15719,6 @@ any. - @@ -16461,7 +15732,6 @@ any. - @@ -16477,7 +15747,6 @@ any. Gets the interface proxy for @interface_name at @object_path, if any. - A #GDBusInterface instance or %NULL. Free with g_object_unref(). @@ -16500,7 +15769,6 @@ any. Gets the #GDBusObjectProxy at @object_path, if any. - A #GDBusObject or %NULL. Free with g_object_unref(). @@ -16519,7 +15787,6 @@ any. Gets the object path that @manager is for. - A string owned by @manager. Do not free. @@ -16533,7 +15800,6 @@ any. Gets all #GDBusObject objects known to @manager. - A list of #GDBusObject objects. The returned list should be freed with @@ -16689,13 +15955,11 @@ in. Additionally, the #GDBusObjectProxy and #GDBusProxy objects originating from the #GDBusObjectManagerClient object will be created in the same context and, consequently, will deliver signals in the same main loop. - Finishes an operation started with g_dbus_object_manager_client_new(). - A #GDBusObjectManagerClient object or %NULL if @error is set. Free @@ -16711,7 +15975,6 @@ same main loop. Finishes an operation started with g_dbus_object_manager_client_new_for_bus(). - A #GDBusObjectManagerClient object or %NULL if @error is set. Free @@ -16732,7 +15995,6 @@ of a #GDBusConnection. This is a synchronous failable constructor - the calling thread is blocked until a reply is received. See g_dbus_object_manager_client_new_for_bus() for the asynchronous version. - A #GDBusObjectManagerClient object or %NULL if @error is set. Free @@ -16780,7 +16042,6 @@ for the asynchronous version. This is a synchronous failable constructor - the calling thread is blocked until a reply is received. See g_dbus_object_manager_client_new() for the asynchronous version. - A #GDBusObjectManagerClient object or %NULL if @error is set. Free @@ -16831,7 +16092,6 @@ ready, @callback will be invoked in the of the thread you are calling this method from. You can then call g_dbus_object_manager_client_new_finish() to get the result. See g_dbus_object_manager_client_new_sync() for the synchronous version. - @@ -16888,7 +16148,6 @@ ready, @callback will be invoked in the of the thread you are calling this method from. You can then call g_dbus_object_manager_client_new_for_bus_finish() to get the result. See g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version. - @@ -16936,7 +16195,6 @@ g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version. - @@ -16959,7 +16217,6 @@ g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version. - @@ -16986,7 +16243,6 @@ g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version. Gets the #GDBusConnection used by @manager. - A #GDBusConnection object. Do not free, the object belongs to @manager. @@ -17001,7 +16257,6 @@ g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version. Gets the flags that @manager was constructed with. - Zero of more flags from the #GDBusObjectManagerClientFlags enumeration. @@ -17017,7 +16272,6 @@ enumeration. Gets the name that @manager is for, or %NULL if not a message bus connection. - A unique or well-known name. Do not free, the string belongs to @manager. @@ -17035,7 +16289,6 @@ belongs to @manager. no-one currently owns that name. You can connect to the #GObject::notify signal to track changes to the #GDBusObjectManagerClient:name-owner property. - The name owner or %NULL if no name owner exists. Free with g_free(). @@ -17171,14 +16424,12 @@ that @manager was constructed in. Class structure for #GDBusObjectManagerClient. - The parent class. - @@ -17206,7 +16457,6 @@ that @manager was constructed in. - @@ -17252,14 +16502,12 @@ that @manager was constructed in. Base type for D-Bus object managers. - The parent interface. - A string owned by @manager. Do not free. @@ -17274,7 +16522,6 @@ that @manager was constructed in. - A list of #GDBusObject objects. The returned list should be freed with @@ -17294,7 +16541,6 @@ that @manager was constructed in. - A #GDBusObject or %NULL. Free with g_object_unref(). @@ -17314,7 +16560,6 @@ that @manager was constructed in. - A #GDBusInterface instance or %NULL. Free with g_object_unref(). @@ -17338,7 +16583,6 @@ that @manager was constructed in. - @@ -17354,7 +16598,6 @@ that @manager was constructed in. - @@ -17370,7 +16613,6 @@ that @manager was constructed in. - @@ -17389,7 +16631,6 @@ that @manager was constructed in. - @@ -17430,7 +16671,6 @@ See #GDBusObjectManagerClient for the client-side code that is intended to be used with #GDBusObjectManagerServer or any D-Bus object implementing the org.freedesktop.DBus.ObjectManager interface. - Creates a new #GDBusObjectManagerServer object. @@ -17440,7 +16680,6 @@ use g_dbus_object_manager_server_set_connection(). Normally you want to export all of your objects before doing so to avoid [InterfacesAdded](http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-objectmanager) signals being emitted. - A #GDBusObjectManagerServer object. Free with g_object_unref(). @@ -17463,7 +16702,6 @@ object path for @manager. Note that @manager will take a reference on @object for as long as it is exported. - @@ -17483,7 +16721,6 @@ it is exported. the form _N (with N being a natural number) to @object's object path if an object with the given path already exists. As such, the #GDBusObjectProxy:g-object-path property of @object may be modified. - @@ -17500,7 +16737,6 @@ if an object with the given path already exists. As such, the Gets the #GDBusConnection used by @manager. - A #GDBusConnection object or %NULL if @manager isn't exported on a connection. The returned object should @@ -17516,7 +16752,6 @@ if an object with the given path already exists. As such, the Returns whether @object is currently exported on @manager. - %TRUE if @object is exported @@ -17535,7 +16770,6 @@ if an object with the given path already exists. As such, the Exports all objects managed by @manager on @connection. If @connection is %NULL, stops exporting objects. - @@ -17556,7 +16790,6 @@ does nothing. Note that @object_path must be in the hierarchy rooted by the object path for @manager. - %TRUE if object at @object_path was removed, %FALSE otherwise. @@ -17589,7 +16822,6 @@ object path for @manager. Class structure for #GDBusObjectManagerServer. - The parent class. @@ -17608,12 +16840,10 @@ object path for @manager. with one or more D-Bus interfaces. Normally, you don't instantiate a #GDBusObjectProxy yourself - typically #GDBusObjectManagerClient is used to obtain it. - Creates a new #GDBusObjectProxy for the given connection and object path. - a new #GDBusObjectProxy @@ -17631,7 +16861,6 @@ object path. Gets the connection that @proxy is for. - A #GDBusConnection. Do not free, the object is owned by @proxy. @@ -17661,7 +16890,6 @@ object path. Class structure for #GDBusObjectProxy. - The parent class. @@ -17681,11 +16909,9 @@ interfaces. The set of exported interfaces on the object may be dynamic and change at runtime. This type is intended to be used with #GDBusObjectManager. - Creates a new #GDBusObjectSkeleton. - A #GDBusObjectSkeleton. Free with g_object_unref(). @@ -17698,7 +16924,6 @@ This type is intended to be used with #GDBusObjectManager. - @@ -17722,7 +16947,6 @@ interface name, it is removed before @interface_ is added. Note that @object takes its own reference on @interface_ and holds it until removed. - @@ -17741,7 +16965,6 @@ it until removed. This method simply calls g_dbus_interface_skeleton_flush() on all interfaces belonging to @object. See that method for when flushing is useful. - @@ -17754,7 +16977,6 @@ is useful. Removes @interface_ from @object. - @@ -17774,7 +16996,6 @@ is useful. If no D-Bus interface of the given interface exists, this function does nothing. - @@ -17791,7 +17012,6 @@ does nothing. Sets the object path for @object. - @@ -17843,14 +17063,12 @@ The default class handler just returns %TRUE. Class structure for #GDBusObjectSkeleton. - The parent class. - @@ -17878,7 +17096,6 @@ The default class handler just returns %TRUE. Information about a D-Bus property on a D-Bus interface. - The reference count or -1 if statically allocated. @@ -17904,7 +17121,6 @@ The default class handler just returns %TRUE. If @info is statically allocated does nothing. Otherwise increases the reference count. - The same @info. @@ -17920,7 +17136,6 @@ the reference count. If @info is statically allocated, does nothing. Otherwise decreases the reference count of @info. When its reference count drops to 0, the memory used is freed. - @@ -17982,13 +17197,11 @@ of the thread where the instance was constructed. An example using a proxy for a well-known name can be found in [gdbus-example-watch-proxy.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-watch-proxy.c) - Finishes creating a #GDBusProxy. - A #GDBusProxy or %NULL if @error is set. Free with g_object_unref(). @@ -18003,7 +17216,6 @@ An example using a proxy for a well-known name can be found in Finishes creating a #GDBusProxy. - A #GDBusProxy or %NULL if @error is set. Free with g_object_unref(). @@ -18020,7 +17232,6 @@ An example using a proxy for a well-known name can be found in Like g_dbus_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection. #GDBusProxy is used in this [example][gdbus-wellknown-proxy]. - A #GDBusProxy or %NULL if error is set. Free with g_object_unref(). @@ -18081,7 +17292,6 @@ This is a synchronous failable constructor. See g_dbus_proxy_new() and g_dbus_proxy_new_finish() for the asynchronous version. #GDBusProxy is used in this [example][gdbus-wellknown-proxy]. - A #GDBusProxy or %NULL if error is set. Free with g_object_unref(). @@ -18146,7 +17356,6 @@ g_dbus_proxy_new_finish() to get the result. See g_dbus_proxy_new_sync() and for a synchronous version of this constructor. #GDBusProxy is used in this [example][gdbus-wellknown-proxy]. - @@ -18193,7 +17402,6 @@ See g_dbus_proxy_new_sync() and for a synchronous version of this constructor. Like g_dbus_proxy_new() but takes a #GBusType instead of a #GDBusConnection. #GDBusProxy is used in this [example][gdbus-wellknown-proxy]. - @@ -18237,7 +17445,6 @@ See g_dbus_proxy_new_sync() and for a synchronous version of this constructor. - @@ -18254,7 +17461,6 @@ See g_dbus_proxy_new_sync() and for a synchronous version of this constructor. - @@ -18316,7 +17522,6 @@ version of this method. If @callback is %NULL then the D-Bus method call message will be sent with the %G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED flag set. - @@ -18359,7 +17564,6 @@ care about the result of the method invocation. Finishes an operation started with g_dbus_proxy_call(). - %NULL if @error is set. Otherwise a #GVariant tuple with return values. Free with g_variant_unref(). @@ -18411,7 +17615,6 @@ method. If @proxy has an expected interface (see #GDBusProxy:g-interface-info) and @method_name is referenced by it, then the return value is checked against the return type. - %NULL if @error is set. Otherwise a #GVariant tuple with return values. Free with g_variant_unref(). @@ -18450,7 +17653,6 @@ return values. Free with g_variant_unref(). Like g_dbus_proxy_call() but also takes a #GUnixFDList object. This method is only available on UNIX. - @@ -18497,7 +17699,6 @@ care about the result of the method invocation. Finishes an operation started with g_dbus_proxy_call_with_unix_fd_list(). - %NULL if @error is set. Otherwise a #GVariant tuple with return values. Free with g_variant_unref(). @@ -18522,7 +17723,6 @@ return values. Free with g_variant_unref(). Like g_dbus_proxy_call_sync() but also takes and returns #GUnixFDList objects. This method is only available on UNIX. - %NULL if @error is set. Otherwise a #GVariant tuple with return values. Free with g_variant_unref(). @@ -18572,7 +17772,6 @@ blocking IO. If @proxy has an expected interface (see #GDBusProxy:g-interface-info) and @property_name is referenced by it, then @value is checked against the type of the property. - A reference to the #GVariant instance that holds the value for @property_name or %NULL if the value is not in @@ -18592,7 +17791,6 @@ it, then @value is checked against the type of the property. Gets the names of all cached properties on @proxy. - A %NULL-terminated array of strings or %NULL if @@ -18611,7 +17809,6 @@ it, then @value is checked against the type of the property. Gets the connection @proxy is for. - A #GDBusConnection owned by @proxy. Do not free. @@ -18629,7 +17826,6 @@ passed as @timeout_msec in the g_dbus_proxy_call() and g_dbus_proxy_call_sync() functions. See the #GDBusProxy:g-default-timeout property for more details. - Timeout to use for @proxy. @@ -18643,7 +17839,6 @@ See the #GDBusProxy:g-default-timeout property for more details. Gets the flags that @proxy was constructed with. - Flags from the #GDBusProxyFlags enumeration. @@ -18659,7 +17854,6 @@ See the #GDBusProxy:g-default-timeout property for more details. Returns the #GDBusInterfaceInfo, if any, specifying the interface that @proxy conforms to. See the #GDBusProxy:g-interface-info property for more details. - A #GDBusInterfaceInfo or %NULL. Do not unref the returned object, it is owned by @proxy. @@ -18674,7 +17868,6 @@ property for more details. Gets the D-Bus interface name @proxy is for. - A string owned by @proxy. Do not free. @@ -18688,7 +17881,6 @@ property for more details. Gets the name that @proxy was constructed for. - A string owned by @proxy. Do not free. @@ -18705,7 +17897,6 @@ property for more details. no-one currently owns that name. You may connect to the #GObject::notify signal to track changes to the #GDBusProxy:g-name-owner property. - The name owner or %NULL if no name owner exists. Free with g_free(). @@ -18720,7 +17911,6 @@ no-one currently owns that name. You may connect to the Gets the object path @proxy is for. - A string owned by @proxy. Do not free. @@ -18766,7 +17956,6 @@ transmitting the same (long) array every time the property changes, it is more efficient to only transmit the delta using e.g. signals `ChatroomParticipantJoined(String name)` and `ChatroomParticipantParted(String name)`. - @@ -18791,7 +17980,6 @@ passed as @timeout_msec in the g_dbus_proxy_call() and g_dbus_proxy_call_sync() functions. See the #GDBusProxy:g-default-timeout property for more details. - @@ -18810,7 +17998,6 @@ See the #GDBusProxy:g-default-timeout property for more details. Ensure that interactions with @proxy conform to the given interface. See the #GDBusProxy:g-interface-info property for more details. - @@ -18955,13 +18142,11 @@ This signal corresponds to the Class structure for #GDBusProxy. - - @@ -18980,7 +18165,6 @@ This signal corresponds to the - @@ -19043,7 +18227,6 @@ object proxy (if @interface_name is %NULL). This function is called in the [thread-default main loop][g-main-context-push-thread-default] that @manager was constructed in. - A #GType to use for the remote object. The returned type must be a #GDBusProxy or #GDBusObjectProxy -derived @@ -19119,7 +18302,6 @@ g_dbus_server_start(). This is a synchronous failable constructor. There is currently no asynchronous version. - A #GDBusServer or %NULL if @error is set. Free with g_object_unref(). @@ -19152,7 +18334,6 @@ g_object_unref(). Gets a [D-Bus address](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses) string that can be used by clients to connect to @server. - A D-Bus address string. Do not free, the string is owned by @server. @@ -19167,7 +18348,6 @@ by @server. Gets the flags for @server. - A set of flags from the #GDBusServerFlags enumeration. @@ -19181,7 +18361,6 @@ by @server. Gets the GUID for @server. - A D-Bus GUID. Do not free this string, it is owned by @server. @@ -19195,7 +18374,6 @@ by @server. Gets whether @server is active. - %TRUE if server is active, %FALSE otherwise. @@ -19209,7 +18387,6 @@ by @server. Starts @server. - @@ -19222,7 +18399,6 @@ by @server. Stops @server. - @@ -19309,7 +18485,6 @@ authentication method. Signature for callback function used in g_dbus_connection_signal_subscribe(). - @@ -19367,7 +18542,6 @@ or one of the paths is a subpath of the other. Information about a signal on a D-Bus interface. - The reference count or -1 if statically allocated. @@ -19391,7 +18565,6 @@ or one of the paths is a subpath of the other. If @info is statically allocated does nothing. Otherwise increases the reference count. - The same @info. @@ -19407,7 +18580,6 @@ the reference count. If @info is statically allocated, does nothing. Otherwise decreases the reference count of @info. When its reference count drops to 0, the memory used is freed. - @@ -19424,7 +18596,6 @@ the memory used is freed. Subtrees are flat. @node, if non-%NULL, is always exactly one segment of the object path (ie: it never contains a slash). - A #GDBusInterfaceVTable or %NULL if you don't want to handle the methods. @@ -19472,7 +18643,6 @@ Hierarchies are not supported; the items that you return should not contain the '/' character. The return value will be freed with g_strfreev(). - A newly allocated array of strings for node names that are children of @object_path. @@ -19528,7 +18698,6 @@ The difference between returning %NULL and an array containing zero items is that the standard DBus interfaces will returned to the remote introspector in the empty array case, but not in the %NULL case. - A %NULL-terminated array of pointers to #GDBusInterfaceInfo, or %NULL. @@ -19558,7 +18727,6 @@ case. Virtual table for handling subtrees registered with g_dbus_connection_register_subtree(). - Function for enumerating child nodes. @@ -19578,28 +18746,24 @@ case. - - - - @@ -19610,25 +18774,21 @@ case. [Extending GIO][extending-gio]. The #GDesktopAppInfoLookup interface is deprecated and unused by GIO. - - - - @@ -19636,46 +18796,39 @@ case. The string used to obtain a Unix device path with g_drive_get_identifier(). - - - - - - - @@ -19684,11 +18837,9 @@ case. Data input stream implements #GInputStream and includes functions for reading structured data directly from a binary input stream. - Creates a new data input stream for the @base_stream. - a new #GDataInputStream. @@ -19702,7 +18853,6 @@ reading structured data directly from a binary input stream. Gets the byte order for the data input stream. - the @stream's current #GDataStreamByteOrder. @@ -19716,7 +18866,6 @@ reading structured data directly from a binary input stream. Gets the current newline type for the @stream. - #GDataStreamNewlineType for the given @stream. @@ -19730,7 +18879,6 @@ reading structured data directly from a binary input stream. Reads an unsigned 8-bit/1-byte value from @stream. - an unsigned 8-bit/1-byte value read from the @stream or `0` if an error occurred. @@ -19752,7 +18900,6 @@ if an error occurred. In order to get the correct byte order for this read operation, see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order(). - a signed 16-bit/2-byte value read from @stream or `0` if an error occurred. @@ -19778,7 +18925,6 @@ see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order( If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a signed 32-bit/4-byte value read from the @stream or `0` if an error occurred. @@ -19804,7 +18950,6 @@ see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order( If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a signed 64-bit/8-byte value read from @stream or `0` if an error occurred. @@ -19829,7 +18974,6 @@ be UTF-8, and may in fact have embedded NUL characters. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a NUL terminated byte array with the line that was read in @@ -19863,7 +19007,6 @@ an error to have two outstanding calls to this function. When the operation is finished, @callback will be called. You can then call g_data_input_stream_read_line_finish() to get the result of the operation. - @@ -19895,7 +19038,6 @@ the result of the operation. g_data_input_stream_read_line_async(). Note the warning about string encoding in g_data_input_stream_read_line() applies here as well. - a NUL-terminated byte array with the line that was read in @@ -19925,7 +19067,6 @@ well. Finish an asynchronous call started by g_data_input_stream_read_line_async(). - a string with the line that was read in (without the newlines). Set @length to a #gsize to @@ -19956,7 +19097,6 @@ g_data_input_stream_read_line_async(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a NUL terminated UTF-8 string with the line that was read in (without the newlines). Set @@ -19987,7 +19127,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. In order to get the correct byte order for this read operation, see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order(). - an unsigned 16-bit/2-byte value read from the @stream or `0` if an error occurred. @@ -20013,7 +19152,6 @@ see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order( If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - an unsigned 32-bit/4-byte value read from the @stream or `0` if an error occurred. @@ -20039,7 +19177,6 @@ see g_data_input_stream_get_byte_order(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - an unsigned 64-bit/8-byte read from @stream or `0` if an error occurred. @@ -20070,7 +19207,6 @@ g_data_input_stream_read_upto() instead, but note that that function does not consume the stop character. Use g_data_input_stream_read_upto() instead, which has more consistent behaviour regarding the stop character. - a string with the data that was read before encountering any of the stop characters. Set @length to @@ -20115,7 +19251,6 @@ will be marked as deprecated in a future release. Use g_data_input_stream_read_upto_async() instead. Use g_data_input_stream_read_upto_async() instead, which has more consistent behaviour regarding the stop character. - @@ -20151,7 +19286,6 @@ g_data_input_stream_read_upto_async() instead. g_data_input_stream_read_until_async(). Use g_data_input_stream_read_upto_finish() instead, which has more consistent behaviour regarding the stop character. - a string with the data that was read before encountering any of the stop characters. Set @length to @@ -20187,7 +19321,6 @@ Note that @stop_chars may contain '\0' if @stop_chars_len is specified. The returned string will always be nul-terminated on success. - a string with the data that was read before encountering any of the stop characters. Set @length to @@ -20234,7 +19367,6 @@ specified. When the operation is finished, @callback will be called. You can then call g_data_input_stream_read_upto_finish() to get the result of the operation. - @@ -20279,7 +19411,6 @@ have to use g_data_input_stream_read_byte() to get it before calling g_data_input_stream_read_upto_async() again. The returned string will always be nul-terminated on success. - a string with the data that was read before encountering any of the stop characters. Set @length to @@ -20305,7 +19436,6 @@ The returned string will always be nul-terminated on success. This function sets the byte order for the given @stream. All subsequent reads from the @stream will be read in the given @order. - @@ -20326,7 +19456,6 @@ reads from the @stream will be read in the given @order. Note that using G_DATA_STREAM_NEWLINE_TYPE_ANY is slightly unsafe. If a read chunk ends in "CR" we must read an additional byte to know if this is "CR" or "CR LF", and this might block if there is no more data available. - @@ -20355,13 +19484,11 @@ chunk ends in "CR" we must read an additional byte to know if this is "CR" or - - @@ -20369,7 +19496,6 @@ chunk ends in "CR" we must read an additional byte to know if this is "CR" or - @@ -20377,7 +19503,6 @@ chunk ends in "CR" we must read an additional byte to know if this is "CR" or - @@ -20385,7 +19510,6 @@ chunk ends in "CR" we must read an additional byte to know if this is "CR" or - @@ -20393,7 +19517,6 @@ chunk ends in "CR" we must read an additional byte to know if this is "CR" or - @@ -20406,11 +19529,9 @@ chunk ends in "CR" we must read an additional byte to know if this is "CR" or Data output stream implements #GOutputStream and includes functions for writing data directly to an output stream. - Creates a new data output stream for @base_stream. - #GDataOutputStream. @@ -20424,7 +19545,6 @@ writing data directly to an output stream. Gets the byte order for the stream. - the #GDataStreamByteOrder for the @stream. @@ -20438,7 +19558,6 @@ writing data directly to an output stream. Puts a byte into the output stream. - %TRUE if @data was successfully added to the @stream. @@ -20460,7 +19579,6 @@ writing data directly to an output stream. Puts a signed 16-bit integer into the output stream. - %TRUE if @data was successfully added to the @stream. @@ -20482,7 +19600,6 @@ writing data directly to an output stream. Puts a signed 32-bit integer into the output stream. - %TRUE if @data was successfully added to the @stream. @@ -20504,7 +19621,6 @@ writing data directly to an output stream. Puts a signed 64-bit integer into the stream. - %TRUE if @data was successfully added to the @stream. @@ -20526,7 +19642,6 @@ writing data directly to an output stream. Puts a string into the output stream. - %TRUE if @string was successfully added to the @stream. @@ -20548,7 +19663,6 @@ writing data directly to an output stream. Puts an unsigned 16-bit integer into the output stream. - %TRUE if @data was successfully added to the @stream. @@ -20570,7 +19684,6 @@ writing data directly to an output stream. Puts an unsigned 32-bit integer into the stream. - %TRUE if @data was successfully added to the @stream. @@ -20592,7 +19705,6 @@ writing data directly to an output stream. Puts an unsigned 64-bit integer into the stream. - %TRUE if @data was successfully added to the @stream. @@ -20614,7 +19726,6 @@ writing data directly to an output stream. Sets the byte order of the data output stream to @order. - @@ -20642,13 +19753,11 @@ multi-byte entities (such as integers) to the stream. - - @@ -20656,7 +19765,6 @@ multi-byte entities (such as integers) to the stream. - @@ -20664,7 +19772,6 @@ multi-byte entities (such as integers) to the stream. - @@ -20672,7 +19779,6 @@ multi-byte entities (such as integers) to the stream. - @@ -20680,7 +19786,6 @@ multi-byte entities (such as integers) to the stream. - @@ -20766,7 +19871,6 @@ received in each I/O operation. Like most other APIs in GLib, #GDatagramBased is not inherently thread safe. To use a #GDatagramBased concurrently from multiple threads, you must implement your own locking. - Checks on the readiness of @datagram_based to perform operations. The operations specified in @condition are checked for and masked against the @@ -20804,7 +19908,6 @@ conditions will always be set in the output if they are true. Apart from these flags, the output is guaranteed to be masked by @condition. This call never blocks. - the #GIOCondition mask of the current state @@ -20827,7 +19930,6 @@ This call never blocks. If @cancellable is cancelled before the condition is met, or if @timeout is reached before the condition is met, then %FALSE is returned and @error is set appropriately (%G_IO_ERROR_CANCELLED or %G_IO_ERROR_TIMED_OUT). - %TRUE if the condition was met, %FALSE otherwise @@ -20867,7 +19969,6 @@ cause the source to trigger, reporting the current condition (which is likely 0 unless cancellation happened at the same time as a condition change). You can check for this in the callback using g_cancellable_is_cancelled(). - a newly allocated #GSource @@ -20938,7 +20039,6 @@ be returned if zero messages could be received; otherwise the number of messages successfully received before the error will be returned. If @cancellable is cancelled, %G_IO_ERROR_CANCELLED is returned as with any other error. - number of messages received, or -1 on error. Note that the number of messages received may be smaller than @num_messages if @timeout is @@ -21019,7 +20119,6 @@ On error -1 is returned and @error is set accordingly. An error will only be returned if zero messages could be sent; otherwise the number of messages successfully sent before the error will be returned. If @cancellable is cancelled, %G_IO_ERROR_CANCELLED is returned as with any other error. - number of messages sent, or -1 on error. Note that the number of messages sent may be smaller than @num_messages if @timeout is zero @@ -21094,7 +20193,6 @@ conditions will always be set in the output if they are true. Apart from these flags, the output is guaranteed to be masked by @condition. This call never blocks. - the #GIOCondition mask of the current state @@ -21117,7 +20215,6 @@ This call never blocks. If @cancellable is cancelled before the condition is met, or if @timeout is reached before the condition is met, then %FALSE is returned and @error is set appropriately (%G_IO_ERROR_CANCELLED or %G_IO_ERROR_TIMED_OUT). - %TRUE if the condition was met, %FALSE otherwise @@ -21157,7 +20254,6 @@ cause the source to trigger, reporting the current condition (which is likely 0 unless cancellation happened at the same time as a condition change). You can check for this in the callback using g_cancellable_is_cancelled(). - a newly allocated #GSource @@ -21228,7 +20324,6 @@ be returned if zero messages could be received; otherwise the number of messages successfully received before the error will be returned. If @cancellable is cancelled, %G_IO_ERROR_CANCELLED is returned as with any other error. - number of messages received, or -1 on error. Note that the number of messages received may be smaller than @num_messages if @timeout is @@ -21309,7 +20404,6 @@ On error -1 is returned and @error is set accordingly. An error will only be returned if zero messages could be sent; otherwise the number of messages successfully sent before the error will be returned. If @cancellable is cancelled, %G_IO_ERROR_CANCELLED is returned as with any other error. - number of messages sent, or -1 on error. Note that the number of messages sent may be smaller than @num_messages if @timeout is zero @@ -21354,14 +20448,12 @@ following the Berkeley sockets API. The interface methods are thin wrappers around the corresponding virtual methods, and no pre-processing of inputs is implemented — so implementations of this API must handle all functionality documented in the interface methods. - The parent interface. - number of messages received, or -1 on error. Note that the number of messages received may be smaller than @num_messages if @timeout is @@ -21403,7 +20495,6 @@ documented in the interface methods. - number of messages sent, or -1 on error. Note that the number of messages sent may be smaller than @num_messages if @timeout is zero @@ -21444,7 +20535,6 @@ documented in the interface methods. - a newly allocated #GSource @@ -21467,7 +20557,6 @@ documented in the interface methods. - the #GIOCondition mask of the current state @@ -21486,7 +20575,6 @@ documented in the interface methods. - %TRUE if the condition was met, %FALSE otherwise @@ -21516,7 +20604,6 @@ documented in the interface methods. This is the function type of the callback used for the #GSource returned by g_datagram_based_create_source(). - %G_SOURCE_REMOVE if the source should be removed, %G_SOURCE_CONTINUE otherwise @@ -21544,7 +20631,6 @@ desktop files. Note that `<gio/gdesktopappinfo.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - Creates a new #GDesktopAppInfo based on a desktop file id. @@ -21558,7 +20644,6 @@ prefix-to-subdirectory mapping that is described in the [Menu Spec](http://standards.freedesktop.org/menu-spec/latest/) (i.e. a desktop id of kde-foo.desktop will match `/usr/share/applications/kde/foo.desktop`). - a new #GDesktopAppInfo, or %NULL if no desktop file with that id exists. @@ -21573,7 +20658,6 @@ prefix-to-subdirectory mapping that is described in the Creates a new #GDesktopAppInfo. - a new #GDesktopAppInfo or %NULL on error. @@ -21588,7 +20672,6 @@ prefix-to-subdirectory mapping that is described in the Creates a new #GDesktopAppInfo. - a new #GDesktopAppInfo or %NULL on error. @@ -21605,7 +20688,6 @@ prefix-to-subdirectory mapping that is described in the An application implements an interface if that interface is listed in the Implements= line of the desktop file of the application. - a list of #GDesktopAppInfo objects. @@ -21636,7 +20718,6 @@ the executable referenced by a result exists), and so it is possible for g_desktop_app_info_new() to return %NULL when passed an app ID returned by this function. It is expected that calling code will do this when subsequently creating a #GDesktopAppInfo for each result. - a list of strvs. Free each item with g_strfreev() and free the outer @@ -21664,7 +20745,6 @@ desktop entry fields. Should be called only once; subsequent calls are ignored. do not use this API. Since 2.42 the value of the `XDG_CURRENT_DESKTOP` environment variable will be used. - @@ -21681,7 +20761,6 @@ action" specified by @action_name. This corresponds to the "Name" key within the keyfile group for the action. - the locale-specific action name @@ -21702,7 +20781,6 @@ action. Looks up a boolean value in the keyfile backing @info. The @key is looked up in the "Desktop Entry" group. - the boolean value, or %FALSE if the key is not found @@ -21721,7 +20799,6 @@ The @key is looked up in the "Desktop Entry" group. Gets the categories from the desktop file. - The unparsed Categories key from the desktop file; i.e. no attempt is made to split it by ';' or validate it. @@ -21738,7 +20815,6 @@ The @key is looked up in the "Desktop Entry" group. When @info was created from a known filename, return it. In some situations such as the #GDesktopAppInfo returned from g_desktop_app_info_new_from_keyfile(), this function will return %NULL. - The full path to the file for @info, or %NULL if not known. @@ -21753,7 +20829,6 @@ g_desktop_app_info_new_from_keyfile(), this function will return %NULL. Gets the generic name from the destkop file. - The value of the GenericName key @@ -21768,7 +20843,6 @@ g_desktop_app_info_new_from_keyfile(), this function will return %NULL. A desktop file is hidden if the Hidden key in it is set to True. - %TRUE if hidden, %FALSE otherwise. @@ -21782,7 +20856,6 @@ set to True. Gets the keywords from the desktop file. - The value of the Keywords key @@ -21801,7 +20874,6 @@ set to True. translated to the current locale. The @key is looked up in the "Desktop Entry" group. - a newly allocated string, or %NULL if the key is not found @@ -21822,7 +20894,6 @@ The @key is looked up in the "Desktop Entry" group. Gets the value of the NoDisplay key, which helps determine if the application info should be shown in menus. See #G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY and g_app_info_should_show(). - The value of the NoDisplay key @@ -21846,7 +20917,6 @@ but this is not recommended. Note that g_app_info_should_show() for @info will include this check (with %NULL for @desktop_env) as well as additional checks. - %TRUE if the @info should be shown in @desktop_env according to the `OnlyShowIn` and `NotShowIn` keys, %FALSE @@ -21868,7 +20938,6 @@ otherwise. Retrieves the StartupWMClass field from @info. This represents the WM_CLASS property of the main window of the application, if launched through @info. - the startup WM class, or %NULL if none is set in the desktop file. @@ -21885,7 +20954,6 @@ in the desktop file. Looks up a string value in the keyfile backing @info. The @key is looked up in the "Desktop Entry" group. - a newly allocated string, or %NULL if the key is not found @@ -21906,7 +20974,6 @@ The @key is looked up in the "Desktop Entry" group. Looks up a string list value in the keyfile backing @info. The @key is looked up in the "Desktop Entry" group. - a %NULL-terminated string array or %NULL if the specified @@ -21933,7 +21000,6 @@ The @key is looked up in the "Desktop Entry" group. Returns whether @key exists in the "Desktop Entry" group of the keyfile backing @info. - %TRUE if the @key exists @@ -21965,7 +21031,6 @@ actions, as per the desktop file specification. As with g_app_info_launch() there is no way to detect failures that occur while using this function. - @@ -22001,7 +21066,6 @@ optimized posix_spawn() codepath to be used. If application launching occurs via some other mechanism (eg: D-Bus activation) then @spawn_flags, @user_setup, @user_setup_data, @pid_callback and @pid_callback_data are ignored. - %TRUE on successful launch, %FALSE otherwise. @@ -22051,7 +21115,6 @@ of the launched process. If application launching occurs via some non-spawn mechanism (e.g. D-Bus activation) then @stdin_fd, @stdout_fd and @stderr_fd are ignored. - %TRUE on successful launch, %FALSE otherwise. @@ -22112,7 +21175,6 @@ desktop file, as per the desktop file specification. As per the specification, this is the list of actions that are explicitly listed in the "Actions" key of the [Desktop Entry] group. - a list of strings, always non-%NULL @@ -22132,7 +21194,6 @@ explicitly listed in the "Actions" key of the [Desktop Entry] group. - @@ -22142,7 +21203,6 @@ explicitly listed in the "Actions" key of the [Desktop Entry] group. using the following functions. The #GDesktopAppInfoLookup interface is deprecated and unused by GIO. - Gets the default application for launching applications using this URI scheme for a particular #GDesktopAppInfoLookup @@ -22154,7 +21214,6 @@ in a GIO module. There is no reason for applications to use it directly. Applications should use g_app_info_get_default_for_uri_scheme(). The #GDesktopAppInfoLookup interface is deprecated and unused by GIO. - #GAppInfo for given @uri_scheme or %NULL on error. @@ -22182,7 +21241,6 @@ in a GIO module. There is no reason for applications to use it directly. Applications should use g_app_info_get_default_for_uri_scheme(). The #GDesktopAppInfoLookup interface is deprecated and unused by GIO. - #GAppInfo for given @uri_scheme or %NULL on error. @@ -22203,13 +21261,11 @@ directly. Applications should use g_app_info_get_default_for_uri_scheme(). Interface that is used by backends to associate default handlers with URI schemes. - - #GAppInfo for given @uri_scheme or %NULL on error. @@ -22232,7 +21288,6 @@ handlers with URI schemes. During invocation, g_desktop_app_info_launch_uris_as_manager() may create one or more child processes. This callback is invoked once for each, providing the process ID. - @@ -22278,10 +21333,8 @@ file manager, use g_drive_get_start_stop_type(). For porting from GnomeVFS note that there is no equivalent of #GDrive in that API. - Checks if a drive can be ejected. - %TRUE if the @drive can be ejected, %FALSE otherwise. @@ -22295,7 +21348,6 @@ For porting from GnomeVFS note that there is no equivalent of Checks if a drive can be polled for media changes. - %TRUE if the @drive can be polled for media changes, %FALSE otherwise. @@ -22310,7 +21362,6 @@ For porting from GnomeVFS note that there is no equivalent of Checks if a drive can be started. - %TRUE if the @drive can be started, %FALSE otherwise. @@ -22324,7 +21375,6 @@ For porting from GnomeVFS note that there is no equivalent of Checks if a drive can be started degraded. - %TRUE if the @drive can be started degraded, %FALSE otherwise. @@ -22338,7 +21388,6 @@ For porting from GnomeVFS note that there is no equivalent of Checks if a drive can be stopped. - %TRUE if the @drive can be stopped, %FALSE otherwise. @@ -22351,7 +21400,6 @@ For porting from GnomeVFS note that there is no equivalent of - @@ -22362,7 +21410,6 @@ For porting from GnomeVFS note that there is no equivalent of - @@ -22379,7 +21426,6 @@ When the operation is finished, @callback will be called. You can then call g_drive_eject_finish() to obtain the result of the operation. Use g_drive_eject_with_operation() instead. - @@ -22407,7 +21453,6 @@ result of the operation. - @@ -22420,7 +21465,6 @@ result of the operation. Finishes ejecting a drive. Use g_drive_eject_with_operation_finish() instead. - %TRUE if the drive has been ejected successfully, %FALSE otherwise. @@ -22441,7 +21485,6 @@ result of the operation. Ejects a drive. This is an asynchronous operation, and is finished by calling g_drive_eject_with_operation_finish() with the @drive and #GAsyncResult data returned in the @callback. - @@ -22476,7 +21519,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a drive. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the drive was successfully ejected. %FALSE otherwise. @@ -22496,7 +21538,6 @@ and #GAsyncResult data returned in the @callback. Gets the kinds of identifiers that @drive has. Use g_drive_get_identifier() to obtain the identifiers themselves. - a %NULL-terminated array of strings containing kinds of identifiers. Use g_strfreev() @@ -22514,7 +21555,6 @@ themselves. Gets the icon for @drive. - #GIcon for the @drive. Free the returned object with g_object_unref(). @@ -22531,7 +21571,6 @@ themselves. Gets the identifier of the given kind for @drive. The only identifier currently available is #G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE. - a newly allocated string containing the requested identifier, or %NULL if the #GDrive @@ -22551,7 +21590,6 @@ identifier currently available is Gets the name of @drive. - a string containing @drive's name. The returned string should be freed when no longer needed. @@ -22566,7 +21604,6 @@ identifier currently available is Gets the sort key for @drive, if any. - Sorting key for @drive or %NULL if no such key is available. @@ -22580,7 +21617,6 @@ identifier currently available is Gets a hint about how a drive can be started/stopped. - A value from the #GDriveStartStopType enumeration. @@ -22594,7 +21630,6 @@ identifier currently available is Gets the icon for @drive. - symbolic #GIcon for the @drive. Free the returned object with g_object_unref(). @@ -22612,7 +21647,6 @@ identifier currently available is The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - #GList containing any #GVolume objects on the given @drive. @@ -22630,7 +21664,6 @@ its elements have been unreffed with g_object_unref(). Checks if the @drive has media. Note that the OS may not be polling the drive for media changes; see g_drive_is_media_check_automatic() for more details. - %TRUE if @drive has media, %FALSE otherwise. @@ -22644,7 +21677,6 @@ for more details. Check if @drive has any mountable volumes. - %TRUE if the @drive contains volumes, %FALSE otherwise. @@ -22658,7 +21690,6 @@ for more details. Checks if @drive is capable of automatically detecting media changes. - %TRUE if the @drive is capable of automatically detecting media changes, %FALSE otherwise. @@ -22673,7 +21704,6 @@ for more details. Checks if the @drive supports removable media. - %TRUE if @drive supports removable media, %FALSE otherwise. @@ -22688,7 +21718,6 @@ for more details. Checks if the #GDrive and/or its media is considered removable by the user. See g_drive_is_media_removable(). - %TRUE if @drive and/or its media is considered removable, %FALSE otherwise. @@ -22706,7 +21735,6 @@ See g_drive_is_media_removable(). When the operation is finished, @callback will be called. You can then call g_drive_poll_for_media_finish() to obtain the result of the operation. - @@ -22731,7 +21759,6 @@ result of the operation. Finishes an operation started with g_drive_poll_for_media() on a drive. - %TRUE if the drive has been poll_for_mediaed successfully, %FALSE otherwise. @@ -22754,7 +21781,6 @@ result of the operation. When the operation is finished, @callback will be called. You can then call g_drive_start_finish() to obtain the result of the operation. - @@ -22788,7 +21814,6 @@ result of the operation. Finishes starting a drive. - %TRUE if the drive has been started successfully, %FALSE otherwise. @@ -22811,7 +21836,6 @@ result of the operation. When the operation is finished, @callback will be called. You can then call g_drive_stop_finish() to obtain the result of the operation. - @@ -22844,7 +21868,6 @@ result of the operation. - @@ -22856,7 +21879,6 @@ result of the operation. Finishes stopping a drive. - %TRUE if the drive has been stopped successfully, %FALSE otherwise. @@ -22875,7 +21897,6 @@ result of the operation. Checks if a drive can be ejected. - %TRUE if the @drive can be ejected, %FALSE otherwise. @@ -22889,7 +21910,6 @@ result of the operation. Checks if a drive can be polled for media changes. - %TRUE if the @drive can be polled for media changes, %FALSE otherwise. @@ -22904,7 +21924,6 @@ result of the operation. Checks if a drive can be started. - %TRUE if the @drive can be started, %FALSE otherwise. @@ -22918,7 +21937,6 @@ result of the operation. Checks if a drive can be started degraded. - %TRUE if the @drive can be started degraded, %FALSE otherwise. @@ -22932,7 +21950,6 @@ result of the operation. Checks if a drive can be stopped. - %TRUE if the @drive can be stopped, %FALSE otherwise. @@ -22951,7 +21968,6 @@ When the operation is finished, @callback will be called. You can then call g_drive_eject_finish() to obtain the result of the operation. Use g_drive_eject_with_operation() instead. - @@ -22981,7 +21997,6 @@ result of the operation. Finishes ejecting a drive. Use g_drive_eject_with_operation_finish() instead. - %TRUE if the drive has been ejected successfully, %FALSE otherwise. @@ -23002,7 +22017,6 @@ result of the operation. Ejects a drive. This is an asynchronous operation, and is finished by calling g_drive_eject_with_operation_finish() with the @drive and #GAsyncResult data returned in the @callback. - @@ -23037,7 +22051,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a drive. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the drive was successfully ejected. %FALSE otherwise. @@ -23057,7 +22070,6 @@ and #GAsyncResult data returned in the @callback. Gets the kinds of identifiers that @drive has. Use g_drive_get_identifier() to obtain the identifiers themselves. - a %NULL-terminated array of strings containing kinds of identifiers. Use g_strfreev() @@ -23075,7 +22087,6 @@ themselves. Gets the icon for @drive. - #GIcon for the @drive. Free the returned object with g_object_unref(). @@ -23092,7 +22103,6 @@ themselves. Gets the identifier of the given kind for @drive. The only identifier currently available is #G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE. - a newly allocated string containing the requested identifier, or %NULL if the #GDrive @@ -23112,7 +22122,6 @@ identifier currently available is Gets the name of @drive. - a string containing @drive's name. The returned string should be freed when no longer needed. @@ -23127,7 +22136,6 @@ identifier currently available is Gets the sort key for @drive, if any. - Sorting key for @drive or %NULL if no such key is available. @@ -23141,7 +22149,6 @@ identifier currently available is Gets a hint about how a drive can be started/stopped. - A value from the #GDriveStartStopType enumeration. @@ -23155,7 +22162,6 @@ identifier currently available is Gets the icon for @drive. - symbolic #GIcon for the @drive. Free the returned object with g_object_unref(). @@ -23173,7 +22179,6 @@ identifier currently available is The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - #GList containing any #GVolume objects on the given @drive. @@ -23191,7 +22196,6 @@ its elements have been unreffed with g_object_unref(). Checks if the @drive has media. Note that the OS may not be polling the drive for media changes; see g_drive_is_media_check_automatic() for more details. - %TRUE if @drive has media, %FALSE otherwise. @@ -23205,7 +22209,6 @@ for more details. Check if @drive has any mountable volumes. - %TRUE if the @drive contains volumes, %FALSE otherwise. @@ -23219,7 +22222,6 @@ for more details. Checks if @drive is capable of automatically detecting media changes. - %TRUE if the @drive is capable of automatically detecting media changes, %FALSE otherwise. @@ -23234,7 +22236,6 @@ for more details. Checks if the @drive supports removable media. - %TRUE if @drive supports removable media, %FALSE otherwise. @@ -23249,7 +22250,6 @@ for more details. Checks if the #GDrive and/or its media is considered removable by the user. See g_drive_is_media_removable(). - %TRUE if @drive and/or its media is considered removable, %FALSE otherwise. @@ -23267,7 +22267,6 @@ See g_drive_is_media_removable(). When the operation is finished, @callback will be called. You can then call g_drive_poll_for_media_finish() to obtain the result of the operation. - @@ -23292,7 +22291,6 @@ result of the operation. Finishes an operation started with g_drive_poll_for_media() on a drive. - %TRUE if the drive has been poll_for_mediaed successfully, %FALSE otherwise. @@ -23315,7 +22313,6 @@ result of the operation. When the operation is finished, @callback will be called. You can then call g_drive_start_finish() to obtain the result of the operation. - @@ -23349,7 +22346,6 @@ result of the operation. Finishes starting a drive. - %TRUE if the drive has been started successfully, %FALSE otherwise. @@ -23372,7 +22368,6 @@ result of the operation. When the operation is finished, @callback will be called. You can then call g_drive_stop_finish() to obtain the result of the operation. - @@ -23406,7 +22401,6 @@ result of the operation. Finishes stopping a drive. - %TRUE if the drive has been stopped successfully, %FALSE otherwise. @@ -23455,14 +22449,12 @@ been pressed. Interface for creating #GDrive implementations. - The parent interface. - @@ -23475,7 +22467,6 @@ been pressed. - @@ -23488,7 +22479,6 @@ been pressed. - @@ -23501,7 +22491,6 @@ been pressed. - a string containing @drive's name. The returned string should be freed when no longer needed. @@ -23517,7 +22506,6 @@ been pressed. - #GIcon for the @drive. Free the returned object with g_object_unref(). @@ -23533,7 +22521,6 @@ been pressed. - %TRUE if the @drive contains volumes, %FALSE otherwise. @@ -23548,7 +22535,6 @@ been pressed. - #GList containing any #GVolume objects on the given @drive. @@ -23565,7 +22551,6 @@ been pressed. - %TRUE if @drive supports removable media, %FALSE otherwise. @@ -23580,7 +22565,6 @@ been pressed. - %TRUE if @drive has media, %FALSE otherwise. @@ -23595,7 +22579,6 @@ been pressed. - %TRUE if the @drive is capable of automatically detecting media changes, %FALSE otherwise. @@ -23611,7 +22594,6 @@ been pressed. - %TRUE if the @drive can be ejected, %FALSE otherwise. @@ -23626,7 +22608,6 @@ been pressed. - %TRUE if the @drive can be polled for media changes, %FALSE otherwise. @@ -23642,7 +22623,6 @@ been pressed. - @@ -23672,7 +22652,6 @@ been pressed. - %TRUE if the drive has been ejected successfully, %FALSE otherwise. @@ -23692,7 +22671,6 @@ been pressed. - @@ -23718,7 +22696,6 @@ been pressed. - %TRUE if the drive has been poll_for_mediaed successfully, %FALSE otherwise. @@ -23738,7 +22715,6 @@ been pressed. - a newly allocated string containing the requested identifier, or %NULL if the #GDrive @@ -23759,7 +22735,6 @@ been pressed. - a %NULL-terminated array of strings containing kinds of identifiers. Use g_strfreev() @@ -23778,7 +22753,6 @@ been pressed. - A value from the #GDriveStartStopType enumeration. @@ -23793,7 +22767,6 @@ been pressed. - %TRUE if the @drive can be started, %FALSE otherwise. @@ -23808,7 +22781,6 @@ been pressed. - %TRUE if the @drive can be started degraded, %FALSE otherwise. @@ -23823,7 +22795,6 @@ been pressed. - @@ -23858,7 +22829,6 @@ been pressed. - %TRUE if the drive has been started successfully, %FALSE otherwise. @@ -23878,7 +22848,6 @@ been pressed. - %TRUE if the @drive can be stopped, %FALSE otherwise. @@ -23893,7 +22862,6 @@ been pressed. - @@ -23928,7 +22896,6 @@ been pressed. - %TRUE if the drive has been stopped successfully, %FALSE otherwise. @@ -23948,7 +22915,6 @@ been pressed. - @@ -23961,7 +22927,6 @@ been pressed. - @@ -23996,7 +22961,6 @@ been pressed. - %TRUE if the drive was successfully ejected. %FALSE otherwise. @@ -24015,7 +22979,6 @@ been pressed. - Sorting key for @drive or %NULL if no such key is available. @@ -24030,7 +22993,6 @@ been pressed. - symbolic #GIcon for the @drive. Free the returned object with g_object_unref(). @@ -24046,7 +23008,6 @@ been pressed. - %TRUE if @drive and/or its media is considered removable, %FALSE otherwise. @@ -24095,13 +23056,11 @@ been pressed. #GDtlsClientConnection is the client-side subclass of #GDtlsConnection, representing a client-side DTLS connection. - Creates a new #GDtlsClientConnection wrapping @base_socket which is assumed to communicate with the server identified by @server_identity. - the new #GDtlsClientConnection, or %NULL on error @@ -24126,7 +23085,6 @@ Otherwise, it will be %NULL. Each item in the list is a #GByteArray which contains the complete subject DN of the certificate authority. - the list of CA DNs. You should unref each element with g_byte_array_unref() and then @@ -24146,7 +23104,6 @@ the free the list with g_list_free(). Gets @conn's expected server identity - a #GSocketConnectable describing the expected server identity, or %NULL if the expected identity is not @@ -24162,7 +23119,6 @@ known. Gets @conn's validation flags - the validation flags @@ -24179,7 +23135,6 @@ known. servers on virtual hosts which certificate to present, and also to let @conn know what name to look for in the certificate when performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled. - @@ -24198,7 +23153,6 @@ performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled. Sets @conn's validation flags, to override the default set of checks performed when validating a server certificate. By default, %G_TLS_CERTIFICATE_VALIDATE_ALL is used. - @@ -24252,7 +23206,6 @@ overrides the default via #GDtlsConnection::accept-certificate. vtable for a #GDtlsClientConnection implementation. - The parent interface. @@ -24278,10 +23231,8 @@ on their base #GDatagramBased if it is a #GSocket — it is up to the calle do that if they wish. If they do not, and g_socket_close() is called on the base socket, the #GDtlsConnection will not raise a %G_IO_ERROR_NOT_CONNECTED error on further I/O. - - @@ -24298,7 +23249,6 @@ error on further I/O. - @@ -24324,7 +23274,6 @@ If the peer did not use the ALPN extension, or did not advertise a protocol that matched one of @conn's protocols, or the TLS backend does not support ALPN, then this will be %NULL. See g_dtls_connection_set_advertised_protocols(). - the negotiated protocol, or %NULL @@ -24363,7 +23312,6 @@ the initial handshake will no longer do anything. #GDtlsConnection::accept_certificate may be emitted during the handshake. - success or failure @@ -24382,7 +23330,6 @@ handshake. Asynchronously performs a TLS handshake on @conn. See g_dtls_connection_handshake() for more information. - @@ -24412,7 +23359,6 @@ g_dtls_connection_handshake() for more information. Finish an asynchronous TLS handshake operation. See g_dtls_connection_handshake() for more information. - %TRUE on success, %FALSE on failure, in which case @error will be set. @@ -24440,7 +23386,6 @@ of @protocols will disable ALPN negotiation. See [IANA TLS ALPN Protocol IDs](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids) for a list of registered protocol IDs. - @@ -24475,7 +23420,6 @@ is equivalent to calling g_dtls_connection_close(). If @cancellable is cancelled, the #GDtlsConnection may be left partially-closed and any pending untransmitted data may be lost. Call g_dtls_connection_shutdown() again to complete closing the #GDtlsConnection. - %TRUE on success, %FALSE otherwise @@ -24502,7 +23446,6 @@ g_dtls_connection_shutdown() again to complete closing the #GDtlsConnection. Asynchronously shut down part or all of the DTLS connection. See g_dtls_connection_shutdown() for more information. - @@ -24540,7 +23483,6 @@ g_dtls_connection_shutdown() for more information. Finish an asynchronous TLS shutdown operation. See g_dtls_connection_shutdown() for more information. - %TRUE on success, %FALSE on failure, in which case @error will be set @@ -24577,7 +23519,6 @@ released as early as possible. If @cancellable is cancelled, the #GDtlsConnection may be left partially-closed and any pending untransmitted data may be lost. Call g_dtls_connection_close() again to complete closing the #GDtlsConnection. - %TRUE on success, %FALSE otherwise @@ -24596,7 +23537,6 @@ g_dtls_connection_close() again to complete closing the #GDtlsConnection. Asynchronously close the DTLS connection. See g_dtls_connection_close() for more information. - @@ -24626,7 +23566,6 @@ more information. Finish an asynchronous TLS close operation. See g_dtls_connection_close() for more information. - %TRUE on success, %FALSE on failure, in which case @error will be set @@ -24646,7 +23585,6 @@ case @error will be set Used by #GDtlsConnection implementations to emit the #GDtlsConnection::accept-certificate signal. - %TRUE if one of the signal handlers has returned %TRUE to accept @peer_cert @@ -24670,7 +23608,6 @@ case @error will be set Gets @conn's certificate, as set by g_dtls_connection_set_certificate(). - @conn's certificate, or %NULL @@ -24696,7 +23633,6 @@ is supported by the TLS backend). It does not guarantee that the data will be available though. That could happen if TLS connection does not support @type or the binding data is not available yet due to additional negotiation or input required. - %TRUE on success, %FALSE otherwise @@ -24722,7 +23658,6 @@ negotiation or input required. Gets the certificate database that @conn uses to verify peer certificates. See g_dtls_connection_set_database(). - the certificate database that @conn uses or %NULL @@ -24738,7 +23673,6 @@ peer certificates. See g_dtls_connection_set_database(). Get the object that will be used to interact with the user. It will be used for things like prompting the user for passwords. If %NULL is returned, then no user interaction will occur for this connection. - The interaction object. @@ -24758,7 +23692,6 @@ If the peer did not use the ALPN extension, or did not advertise a protocol that matched one of @conn's protocols, or the TLS backend does not support ALPN, then this will be %NULL. See g_dtls_connection_set_advertised_protocols(). - the negotiated protocol, or %NULL @@ -24774,7 +23707,6 @@ g_dtls_connection_set_advertised_protocols(). Gets @conn's peer's certificate after the handshake has completed or failed. (It is not set during the emission of #GDtlsConnection::accept-certificate.) - @conn's peer's certificate, or %NULL @@ -24790,7 +23722,6 @@ or failed. (It is not set during the emission of Gets the errors associated with validating @conn's peer's certificate, after the handshake has completed or failed. (It is not set during the emission of #GDtlsConnection::accept-certificate.) - @conn's peer's certificate errors @@ -24808,7 +23739,6 @@ g_dtls_connection_set_rehandshake_mode() for details. Changing the rehandshake mode is no longer required for compatibility. Also, rehandshaking has been removed from the TLS protocol in TLS 1.3. - %G_TLS_REHANDSHAKE_SAFELY @@ -24824,7 +23754,6 @@ g_dtls_connection_set_rehandshake_mode() for details. Tests whether or not @conn expects a proper TLS close notification when the connection is closed. See g_dtls_connection_set_require_close_notify() for details. - %TRUE if @conn requires a proper TLS close notification. @@ -24863,7 +23792,6 @@ the initial handshake will no longer do anything. #GDtlsConnection::accept_certificate may be emitted during the handshake. - success or failure @@ -24882,7 +23810,6 @@ handshake. Asynchronously performs a TLS handshake on @conn. See g_dtls_connection_handshake() for more information. - @@ -24912,7 +23839,6 @@ g_dtls_connection_handshake() for more information. Finish an asynchronous TLS handshake operation. See g_dtls_connection_handshake() for more information. - %TRUE on success, %FALSE on failure, in which case @error will be set. @@ -24940,7 +23866,6 @@ of @protocols will disable ALPN negotiation. See [IANA TLS ALPN Protocol IDs](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids) for a list of registered protocol IDs. - @@ -24977,7 +23902,6 @@ or without a certificate; in that case, if you don't provide a certificate, you can tell that the server requested one by the fact that g_dtls_client_connection_get_accepted_cas() will return non-%NULL.) - @@ -25001,7 +23925,6 @@ peer certificate validation will always set the #GDtlsConnection::accept-certificate will always be emitted on client-side connections, unless that bit is not set in #GDtlsClientConnection:validation-flags). - @@ -25023,7 +23946,6 @@ for things like prompting the user for passwords. The @interaction argument will normally be a derived subclass of #GTlsInteraction. %NULL can also be provided if no user interaction should occur for this connection. - @@ -25046,7 +23968,6 @@ rekey operations. Changing the rehandshake mode is no longer required for compatibility. Also, rehandshaking has been removed from the TLS protocol in TLS 1.3. - @@ -25087,7 +24008,6 @@ connection; when the application calls g_dtls_connection_close_async() on setting of this property. If you explicitly want to do an unclean close, you can close @conn's #GDtlsConnection:base-socket rather than closing @conn itself. - @@ -25119,7 +24039,6 @@ is equivalent to calling g_dtls_connection_close(). If @cancellable is cancelled, the #GDtlsConnection may be left partially-closed and any pending untransmitted data may be lost. Call g_dtls_connection_shutdown() again to complete closing the #GDtlsConnection. - %TRUE on success, %FALSE otherwise @@ -25146,7 +24065,6 @@ g_dtls_connection_shutdown() again to complete closing the #GDtlsConnection. Asynchronously shut down part or all of the DTLS connection. See g_dtls_connection_shutdown() for more information. - @@ -25184,7 +24102,6 @@ g_dtls_connection_shutdown() for more information. Finish an asynchronous TLS shutdown operation. See g_dtls_connection_shutdown() for more information. - %TRUE on success, %FALSE on failure, in which case @error will be set @@ -25320,14 +24237,12 @@ no one else overrides it. Virtual method table for a #GDtlsConnection implementation. - The parent interface. - @@ -25346,7 +24261,6 @@ no one else overrides it. - success or failure @@ -25365,7 +24279,6 @@ no one else overrides it. - @@ -25395,7 +24308,6 @@ no one else overrides it. - %TRUE on success, %FALSE on failure, in which case @error will be set. @@ -25415,7 +24327,6 @@ case @error will be set. - %TRUE on success, %FALSE otherwise @@ -25442,7 +24353,6 @@ case @error will be set. - @@ -25480,7 +24390,6 @@ case @error will be set. - %TRUE on success, %FALSE on failure, in which case @error will be set @@ -25500,7 +24409,6 @@ case @error will be set - @@ -25521,7 +24429,6 @@ case @error will be set - the negotiated protocol, or %NULL @@ -25536,7 +24443,6 @@ case @error will be set - @@ -25559,12 +24465,10 @@ case @error will be set #GDtlsServerConnection is the server-side subclass of #GDtlsConnection, representing a server-side DTLS connection. - Creates a new #GDtlsServerConnection wrapping @base_socket. - the new #GDtlsServerConnection, or %NULL on error @@ -25590,49 +24494,42 @@ rehandshake with a different mode from the initial handshake. vtable for a #GDtlsServerConnection implementation. - The parent interface. - - - - - - @@ -25645,11 +24542,9 @@ It can than be added to a #GEmblemedIcon. Currently, only metainformation about the emblem's origin is supported. More may be added in the future. - Creates a new emblem for @icon. - a new #GEmblem. @@ -25663,7 +24558,6 @@ supported. More may be added in the future. Creates a new emblem for @icon. - a new #GEmblem. @@ -25681,7 +24575,6 @@ supported. More may be added in the future. Gives back the icon from @emblem. - a #GIcon. The returned object belongs to the emblem and should not be modified or freed. @@ -25696,7 +24589,6 @@ supported. More may be added in the future. Gets the origin of the emblem. - the origin of the emblem @@ -25741,11 +24633,9 @@ icon is ensured via g_emblemed_icon_add_emblem(). Note that #GEmblemedIcon allows no control over the position of the emblems. See also #GEmblem for more information. - Creates a new emblemed icon for @icon with the emblem @emblem. - a new #GIcon @@ -25763,7 +24653,6 @@ of the emblems. See also #GEmblem for more information. Adds @emblem to the #GList of #GEmblems. - @@ -25780,7 +24669,6 @@ of the emblems. See also #GEmblem for more information. Removes all the emblems from @icon. - @@ -25793,7 +24681,6 @@ of the emblems. See also #GEmblem for more information. Gets the list of emblems for the @icon. - a #GList of #GEmblems that is owned by @emblemed @@ -25810,7 +24697,6 @@ of the emblems. See also #GEmblem for more information. Gets the main icon for @emblemed. - a #GIcon that is owned by @emblemed @@ -25833,7 +24719,6 @@ of the emblems. See also #GEmblem for more information. - @@ -25842,28 +24727,24 @@ of the emblems. See also #GEmblem for more information. - - - - @@ -25873,28 +24754,24 @@ of the emblems. See also #GEmblem for more information. A key in the "access" namespace for checking deletion privileges. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. This attribute will be %TRUE if the user is able to delete the file. - A key in the "access" namespace for getting execution privileges. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. This attribute will be %TRUE if the user is able to execute the file. - A key in the "access" namespace for getting read privileges. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. This attribute will be %TRUE if the user is able to read the file. - A key in the "access" namespace for checking renaming privileges. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. This attribute will be %TRUE if the user is able to rename the file. - @@ -25902,14 +24779,12 @@ This attribute will be %TRUE if the user is able to rename the file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. This attribute will be %TRUE if the user is able to move the file to the trash. - A key in the "access" namespace for getting write privileges. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. This attribute will be %TRUE if the user is able to write to the file. - @@ -25917,7 +24792,6 @@ This attribute will be %TRUE if the user is able to write to the file. is set. This attribute is %TRUE if the archive flag is set. This attribute is only available for DOS file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -25927,7 +24801,6 @@ This attribute is %TRUE if file is a reparse point of type [IO_REPARSE_TAG_MOUNT_POINT](https://msdn.microsoft.com/en-us/library/dd541667.aspx). This attribute is only available for DOS file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -25935,7 +24808,6 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. is set. This attribute is %TRUE if the backup flag is set. This attribute is only available for DOS file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -25944,55 +24816,47 @@ This value is 0 for files that are not reparse points. See the [Reparse Tags](https://msdn.microsoft.com/en-us/library/dd541667.aspx) page for possible reparse tag values. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - A key in the "etag" namespace for getting the value of the file's entity tag. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "filesystem" namespace for getting the number of bytes of free space left on the file system. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. - A key in the "filesystem" namespace for checking if the file system is read only. Is set to %TRUE if the file system is read only. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "filesystem" namespace for checking if the file system is remote. Is set to %TRUE if the file system is remote. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "filesystem" namespace for getting the total size (in bytes) of the file system, used in g_file_query_filesystem_info(). Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. - A key in the "filesystem" namespace for getting the file system's type. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "filesystem" namespace for getting the number of bytes of used on the file system. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. - @@ -26000,14 +24864,12 @@ file system. Corresponding #GFileAttributeType is application whether it should preview (e.g. thumbnail) files on the file system. The value for this key contain a #GFilesystemPreviewType. - A key in the "gvfs" namespace that gets the name of the current GVFS backend in use. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - @@ -26015,7 +24877,6 @@ GVFS backend in use. Corresponding #GFileAttributeType is Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. An example use would be during listing files, to avoid recursive directory scanning. - @@ -26024,101 +24885,85 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. An example use would be during drag and drop to see if the source and target are on the same filesystem (default to move) or not (default to copy). - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be ejected. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is mountable. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be polled. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started degraded. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be stopped. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is unmountable. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for getting the HAL UDI for the mountable file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is automatically polled for media. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "mountable" namespace for getting the #GDriveStartStopType. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - A key in the "mountable" namespace for getting the unix device. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - A key in the "mountable" namespace for getting the unix device file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "owner" namespace for getting the file owner's group. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "owner" namespace for getting the user name of the file's owner. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "owner" namespace for getting the real name of the user that owns the file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - @@ -26127,14 +24972,12 @@ used to get preview of the file. For example, it may be a low resolution thumbnail without metadata. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. The value for this key should contain a #GIcon. - A key in the "recent" namespace for getting time, when the metadata for the file in `recent:///` was last changed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_INT64. - @@ -26142,7 +24985,6 @@ file in `recent:///` was last changed. Corresponding #GFileAttributeType is context. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. Note that this attribute is only available if GLib has been built with SELinux support. - @@ -26151,14 +24993,12 @@ that is consumed by the file (in bytes). This will generally be larger than the file size (due to block size overhead) but can occasionally be smaller (for example, for sparse files). Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. - A key in the "standard" namespace for getting the content type of the file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. The value for this key should contain a valid content type. - @@ -26170,7 +25010,6 @@ might have a different encoding. If the filename is not a valid string in the encoding selected for the filesystem it is in then the copy name will not be set. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - @@ -26182,7 +25021,6 @@ for a file in the trash. This is useful for instance as the window title when displaying a directory or for a bookmarks menu. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - @@ -26190,7 +25028,6 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. A display name is guaranteed to be in UTF-8 and can thus be displayed in the UI. It is guaranteed to be set on every file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - @@ -26201,7 +25038,6 @@ might contain information you don't want in the new filename (such as "(invalid unicode)" if the filename was in an invalid encoding). Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - @@ -26210,26 +25046,22 @@ The fast content type isn't as reliable as the regular one, as it only uses the filename to guess it, but it is faster to calculate than the regular content type. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "standard" namespace for getting the icon for the file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. The value for this key should contain a #GIcon. - A key in the "standard" namespace for checking if a file is a backup file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "standard" namespace for checking if a file is hidden. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -26238,13 +25070,11 @@ Typically the actual type is something else, if we followed the symlink to get the type. On Windows NTFS mountpoints are considered to be symlinks as well. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "standard" namespace for checking if a file is virtual. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -26254,7 +25084,6 @@ indicate that the URI is not persistent. Applications should look at #G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET for the persistent URI. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -26265,13 +25094,11 @@ every file. Use #G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME if you need to display the name in a user interface. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. - A key in the "standard" namespace for getting the file's size (in bytes). Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. - @@ -26281,42 +25108,36 @@ An example use would be in file managers, which would use this key to set the order files are displayed. Files with smaller sort order should be sorted first, and files without sort order as if sort order was zero. - A key in the "standard" namespace for getting the symbolic icon for the file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. The value for this key should contain a #GIcon. - A key in the "standard" namespace for getting the symlink target, if the file is a symlink. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. - A key in the "standard" namespace for getting the target URI for the file, in the case of %G_FILE_TYPE_SHORTCUT or %G_FILE_TYPE_MOUNTABLE files. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "standard" namespace for storing file types. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. The value for this key should contain a #GFileType. - A key in the "thumbnail" namespace for checking if thumbnailing failed. This attribute is %TRUE if thumbnailing failed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -26328,14 +25149,12 @@ If %G_FILE_ATTRIBUTE_THUMBNAILING_FAILED is %TRUE and this attribute is %FALSE, it indicates that thumbnailing may be attempted again and may succeed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - A key in the "thumbnail" namespace for getting the path to the thumbnail image. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. - @@ -26343,7 +25162,6 @@ image. Corresponding #GFileAttributeType is accessed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the file was last accessed, in seconds since the UNIX epoch. - @@ -26351,7 +25169,6 @@ file was last accessed, in seconds since the UNIX epoch. the file was last accessed. This should be used in conjunction with #G_FILE_ATTRIBUTE_TIME_ACCESS. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26361,7 +25178,6 @@ and contains the time since the file was last changed, in seconds since the UNIX epoch. This corresponds to the traditional UNIX ctime. - @@ -26369,7 +25185,6 @@ This corresponds to the traditional UNIX ctime. the file was last changed. This should be used in conjunction with #G_FILE_ATTRIBUTE_TIME_CHANGED. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26380,7 +25195,6 @@ epoch. This may correspond to Linux stx_btime, FreeBSD st_birthtim, NetBSD st_birthtime or NTFS ctime. - @@ -26388,7 +25202,6 @@ st_birthtime or NTFS ctime. the file was created. This should be used in conjunction with #G_FILE_ATTRIBUTE_TIME_CREATED. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26396,7 +25209,6 @@ the file was created. This should be used in conjunction with modified. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the file was modified, in seconds since the UNIX epoch. - @@ -26404,7 +25216,6 @@ file was modified, in seconds since the UNIX epoch. the file was last modified. This should be used in conjunction with #G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26412,14 +25223,12 @@ the file was last modified. This should be used in conjunction with items in `trash:///`, will return the date and time when the file was trashed. The format of the returned string is YYYY-MM-DDThh:mm:ss. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING. - A key in the "trash" namespace. When requested against `trash:///` returns the number of (toplevel) items in the trash folder. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26427,21 +25236,18 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. items in `trash:///`, will return the original path to the file before it was trashed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING. - A key in the "unix" namespace for getting the number of blocks allocated for the file. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. - A key in the "unix" namespace for getting the block size for the file system. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26449,21 +25255,18 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. file is located on (see stat() documentation). This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - A key in the "unix" namespace for getting the group ID for the file. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - A key in the "unix" namespace for getting the inode of the file. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64. - @@ -26472,7 +25275,6 @@ UNIX mount point. This attribute is %TRUE if the file is a UNIX mount point. Since 2.58, `/` is considered to be a mount point. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN. - @@ -26482,7 +25284,6 @@ documentation for `lstat()`: this attribute is equivalent to the `st_mode` member of `struct stat`, and includes both the file type and permissions. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26490,7 +25291,6 @@ Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. for a file. See lstat() documentation. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - @@ -26498,221 +25298,189 @@ for UNIX file systems. Corresponding #GFileAttributeType is (if it is a special file). See lstat() documentation. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - A key in the "unix" namespace for getting the user ID for the file. This attribute is only available for UNIX file systems. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -26800,14 +25568,12 @@ has been modified from the version on the file system. See the HTTP 1.1 [specification](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html) for HTTP Etag headers, which are a very similar concept. - Constructs a #GFile from a series of elements using the correct separator for filenames. Using this function is equivalent to calling g_build_filename(), followed by g_file_new_for_path() on the result. - a new #GFile @@ -26838,7 +25604,6 @@ the commandline. #GApplication also uses UTF-8 but g_application_command_line_create_file_for_arg() may be more useful for you there. It is also always possible to use this function with #GOptionContext arguments of type %G_OPTION_ARG_FILENAME. - a new #GFile. Free the returned object with g_object_unref(). @@ -26863,7 +25628,6 @@ This is useful if the commandline argument was given in a context other than the invocation of the current process. See also g_application_command_line_create_file_for_arg(). - a new #GFile @@ -26883,7 +25647,6 @@ See also g_application_command_line_create_file_for_arg(). Constructs a #GFile for a given path. This operation never fails, but the returned object might not support any I/O operation if @path is malformed. - a new #GFile for the given @path. Free the returned object with g_object_unref(). @@ -26902,7 +25665,6 @@ operation if @path is malformed. fails, but the returned object might not support any I/O operation if @uri is malformed or if the uri type is not supported. - a new #GFile for the given @uri. Free the returned object with g_object_unref(). @@ -26926,7 +25688,6 @@ directory components. If it is %NULL, a default template is used. Unlike the other #GFile constructors, this will return %NULL if a temporary file could not be created. - a new #GFile. Free the returned object with g_object_unref(). @@ -26949,7 +25710,6 @@ a temporary file could not be created. given by g_file_get_parse_name()). This operation never fails, but the returned object might not support any I/O operation if the @parse_name cannot be parsed. - a new #GFile. @@ -26979,7 +25739,6 @@ Some file systems don't allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME error. If the file is a directory the %G_IO_ERROR_IS_DIRECTORY error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileOutputStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -27010,7 +25769,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_append_to_finish() to get the result of the operation. - @@ -27046,7 +25804,6 @@ of the operation. Finishes an asynchronous file append operation started with g_file_append_to_async(). - a valid #GFileOutputStream or %NULL on error. @@ -27105,7 +25862,6 @@ If the source is a directory and the target does not exist, or If you are interested in copying the #GFile object itself (not the on-disk file), see g_file_dup(). - %TRUE on success, %FALSE otherwise. @@ -27150,7 +25906,6 @@ run in. When the operation is finished, @callback will be called. You can then call g_file_copy_finish() to get the result of the operation. - @@ -27197,7 +25952,6 @@ g_file_copy_finish() to get the result of the operation. Finishes copying the file started with g_file_copy_async(). - a %TRUE on success, %FALSE on error. @@ -27233,7 +25987,6 @@ allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME error, and if the name is to long %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileOutputStream for the newly created file, or %NULL on error. @@ -27266,7 +26019,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_create_finish() to get the result of the operation. - @@ -27302,7 +26054,6 @@ of the operation. Finishes an asynchronous file create operation started with g_file_create_async(). - a #GFileOutputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -27343,7 +26094,6 @@ kind of filesystem the file is on. Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, rather than just opening for reading or writing. - a #GFileIOStream for the newly created file, or %NULL on error. @@ -27376,7 +26126,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_create_readwrite_finish() to get the result of the operation. - @@ -27412,7 +26161,6 @@ the result of the operation. Finishes an asynchronous file create operation started with g_file_create_readwrite_async(). - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -27451,7 +26199,6 @@ if (!g_file_delete (my_file, my_cancellable, &local_error) && If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the file was deleted. %FALSE otherwise. @@ -27472,7 +26219,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Asynchronously delete a file. If the @file is a directory, it will only be deleted if it is empty. This has the same semantics as g_unlink(). - @@ -27503,7 +26249,6 @@ g_unlink(). Finishes deleting a file started with g_file_delete_async(). - %TRUE if the file was deleted. %FALSE otherwise. @@ -27530,7 +26275,6 @@ within the same thread, use g_object_ref() to increment the existing object reference count. This call does no blocking I/O. - a new #GFile that is a duplicate of the given #GFile. @@ -27553,7 +26297,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Use g_file_eject_mountable_with_operation() instead. - @@ -27587,7 +26330,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. g_file_eject_mountable(). Use g_file_eject_mountable_with_operation_finish() instead. - %TRUE if the @file was ejected successfully. %FALSE otherwise. @@ -27613,7 +26355,6 @@ g_file_eject_mountable_with_operation_finish(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - @@ -27650,7 +26391,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes an asynchronous eject operation started by g_file_eject_mountable_with_operation(). - %TRUE if the @file was ejected successfully. %FALSE otherwise. @@ -27691,7 +26431,6 @@ returned. If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. If the file is not a directory, the %G_IO_ERROR_NOT_DIRECTORY error will be returned. Other errors are possible too. - A #GFileEnumerator if successful, %NULL on error. Free the returned object with g_object_unref(). @@ -27728,7 +26467,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_enumerate_children_finish() to get the result of the operation. - @@ -27768,7 +26506,6 @@ the operation. Finishes an async enumerate children operation. See g_file_enumerate_children_async(). - a #GFileEnumerator or %NULL if an error occurred. @@ -27794,7 +26531,6 @@ file on the filesystem due to various forms of filename aliasing. This call does no blocking I/O. - %TRUE if @file1 and @file2 are equal. @@ -27820,7 +26556,6 @@ This call does no blocking I/O. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GMount where the @file is located or %NULL on error. @@ -27848,7 +26583,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_find_enclosing_mount_finish() to get the result of the operation. - @@ -27880,7 +26614,6 @@ get the result of the operation. Finishes an asynchronous find mount request. See g_file_find_enclosing_mount_async(). - #GMount for given @file or %NULL on error. Free the returned object with g_object_unref(). @@ -27898,7 +26631,6 @@ See g_file_find_enclosing_mount_async(). - @@ -27917,7 +26649,6 @@ user interface, for instance when you select a directory and type a filename in the file selector. This call does no blocking I/O. - a #GFile to the specified child, or %NULL if the display name couldn't be converted. @@ -27941,7 +26672,6 @@ If the @file represents the root directory of the file system, then %NULL will be returned. This call does no blocking I/O. - a #GFile structure to the parent of the given #GFile or %NULL if there is no parent. Free @@ -27970,7 +26700,6 @@ to UTF-8 the pathname is used, otherwise the IRI is used (a form of URI that allows UTF-8 characters unescaped). This call does no blocking I/O. - a string containing the #GFile's parse name. The returned string should be freed with g_free() @@ -27985,7 +26714,6 @@ This call does no blocking I/O. - @@ -27996,7 +26724,6 @@ This call does no blocking I/O. - @@ -28013,7 +26740,6 @@ This call does no blocking I/O. Gets the URI for the @file. This call does no blocking I/O. - a string containing the #GFile's URI. The returned string should be freed with g_free() @@ -28036,7 +26762,6 @@ URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] Common schemes include "file", "http", "ftp", etc. This call does no blocking I/O. - a string containing the URI scheme for the given #GFile. The returned string should be freed with g_free() @@ -28054,7 +26779,6 @@ This call does no blocking I/O. Checks to see if a #GFile has a given URI scheme. This call does no blocking I/O. - %TRUE if #GFile's backend supports the given URI scheme, %FALSE if URI scheme is %NULL, @@ -28076,7 +26800,6 @@ This call does no blocking I/O. Creates a hash value for a #GFile. This call does no blocking I/O. - 0 if @file is not a valid #GFile, otherwise an integer that can be used as hash value for the #GFile. @@ -28103,7 +26826,6 @@ filesystem via a userspace filesystem (FUSE), in these cases this call will return %FALSE, but g_file_get_path() will still return a native path. This call does no blocking I/O. - %TRUE if @file is native @@ -28130,7 +26852,6 @@ For a local #GFile the newly created directory will have the default If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on successful creation, %FALSE otherwise. @@ -28149,7 +26870,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Asynchronously creates a directory. - @@ -28181,7 +26901,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes an asynchronous directory creation, started with g_file_make_directory_async(). - %TRUE on successful directory creation, %FALSE otherwise. @@ -28204,7 +26923,6 @@ g_file_make_directory_async(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on the creation of a new symlink, %FALSE otherwise. @@ -28245,7 +26963,6 @@ in a user interface. periodic progress updates while scanning. See the documentation for #GFileMeasureProgressCallback for information about when and how the callback will be invoked. - %TRUE if successful, with the out parameters set. %FALSE otherwise, with @error set. @@ -28291,7 +27008,6 @@ callback will be invoked. This is the asynchronous version of g_file_measure_disk_usage(). See there for more information. - @@ -28334,7 +27050,6 @@ there for more information. Collects the results from an earlier call to g_file_measure_disk_usage_async(). See g_file_measure_disk_usage() for more information. - %TRUE if successful, with the out parameters set. %FALSE otherwise, with @error set. @@ -28376,7 +27091,6 @@ It does not make sense for @flags to contain directories. It is not possible to monitor all the files in a directory for changes made via hard links; if you want to do this then you must register individual watches with g_file_monitor(). - a #GFileMonitor for the given @file, or %NULL on error. @@ -28414,7 +27128,6 @@ changes made through the filename contained in @file to be reported. Using this flag may result in an increase in resource usage, and may not have any effect depending on the #GFileMonitor backend and/or filesystem type. - a #GFileMonitor for the given @file, or %NULL on error. @@ -28448,7 +27161,6 @@ g_file_mount_enclosing_volume_finish(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - @@ -28484,7 +27196,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes a mount operation started by g_file_mount_enclosing_volume(). - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -28514,7 +27225,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_mount_mountable_finish() to get the result of the operation. - @@ -28553,7 +27263,6 @@ the result of the operation. Finish an asynchronous mount operation that was started with g_file_mount_mountable(). - a #GFile or %NULL on error. Free the returned object with g_object_unref(). @@ -28604,7 +27313,6 @@ If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is specified and the target is a file, then the %G_IO_ERROR_WOULD_RECURSE error may be returned (if the native move operation isn't available). - %TRUE on successful move, %FALSE otherwise. @@ -28656,7 +27364,6 @@ what kind of filesystem the file is on. Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, rather than just opening for reading or writing. - #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -28682,7 +27389,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_open_readwrite_finish() to get the result of the operation. - @@ -28714,7 +27420,6 @@ the result of the operation. Finishes an asynchronous file read operation started with g_file_open_readwrite_async(). - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -28741,7 +27446,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_mount_mountable_finish() to get the result of the operation. - @@ -28770,7 +27474,6 @@ the result of the operation. Finish an asynchronous poll operation that was polled with g_file_poll_mountable(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -28802,7 +27505,6 @@ This call does no I/O, as it works purely on names. As such it can sometimes return %FALSE even if @file is inside a @prefix (from a filesystem point of view), because the prefix of @file is an alias of @prefix. - %TRUE if the @file's parent, grandparent, etc is @prefix, %FALSE otherwise. @@ -28845,7 +27547,6 @@ returned. If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileInfo or %NULL if there was an error. Free the returned object with g_object_unref(). @@ -28879,7 +27580,6 @@ synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_query_info_finish() to get the result of the operation. - @@ -28915,7 +27615,6 @@ operation. Finishes an asynchronous filesystem info query. See g_file_query_filesystem_info_async(). - #GFileInfo for given @file or %NULL on error. @@ -28964,7 +27663,6 @@ about the symlink itself will be returned. If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileInfo for the given @file, or %NULL on error. Free the returned object with g_object_unref(). @@ -29000,7 +27698,6 @@ version of this call. When the operation is finished, @callback will be called. You can then call g_file_query_info_finish() to get the result of the operation. - @@ -29040,7 +27737,6 @@ then call g_file_query_info_finish() to get the result of the operation. Finishes an asynchronous file info query. See g_file_query_info_async(). - #GFileInfo for given @file or %NULL on error. Free the returned object with @@ -29069,7 +27765,6 @@ specific file may not support a specific attribute. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GFileAttributeInfoList describing the settable attributes. When you are done with it, release it with @@ -29096,7 +27791,6 @@ attributes (in the "xattr" namespace). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GFileAttributeInfoList describing the writable namespaces. When you are done with it, release it with @@ -29124,7 +27818,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_read_finish() to get the result of the operation. - @@ -29156,7 +27849,6 @@ of the operation. Finishes an asynchronous file read operation started with g_file_read_async(). - a #GFileInputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -29185,7 +27877,6 @@ If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. If the file is a directory, the %G_IO_ERROR_IS_DIRECTORY error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - #GFileInputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -29244,7 +27935,6 @@ file systems don't allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME error, and if the name is to long %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileOutputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -29285,7 +27975,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_replace_finish() to get the result of the operation. - @@ -29330,7 +28019,6 @@ of the operation. Finishes an asynchronous file replace operation started with g_file_replace_async(). - a #GFileOutputStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -29358,7 +28046,6 @@ same thing but returns an output stream only. Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, rather than just opening for reading or writing. - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -29400,7 +28087,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_replace_readwrite_finish() to get the result of the operation. - @@ -29445,7 +28131,6 @@ the result of the operation. Finishes an asynchronous file replace operation started with g_file_replace_readwrite_async(). - a #GFileIOStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -29466,7 +28151,6 @@ g_file_replace_readwrite_async(). Resolves a relative path for @file to an absolute path. This call does no blocking I/O. - #GFile to the resolved path. %NULL if @relative_path is %NULL or if @file is invalid. @@ -29493,7 +28177,6 @@ Some attributes can be unset by setting @type to If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the attribute was set, %FALSE otherwise. @@ -29536,7 +28219,6 @@ which is the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_set_attributes_finish() to get the result of the operation. - @@ -29574,7 +28256,6 @@ the result of the operation. Finishes setting an attribute started in g_file_set_attributes_async(). - %TRUE if the attributes were set correctly, %FALSE otherwise. @@ -29607,7 +28288,6 @@ also detect further errors. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %FALSE if there was any error, %TRUE otherwise. @@ -29648,7 +28328,6 @@ On success the resulting converted filename is returned. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GFile specifying what @file was renamed to, or %NULL if there was an error. @@ -29680,7 +28359,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_set_display_name_finish() to get the result of the operation. - @@ -29716,7 +28394,6 @@ the result of the operation. Finishes setting a display name started with g_file_set_display_name_async(). - a #GFile or %NULL on error. Free the returned object with g_object_unref(). @@ -29745,7 +28422,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_mount_mountable_finish() to get the result of the operation. - @@ -29781,7 +28457,6 @@ the result of the operation. Finish an asynchronous start operation that was started with g_file_start_mountable(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -29808,7 +28483,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_stop_mountable_finish() to get the result of the operation. - @@ -29847,7 +28521,6 @@ the result of the operation. Finish an asynchronous stop operation that was started with g_file_stop_mountable(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -29875,7 +28548,6 @@ mounts, the %G_IO_ERROR_NOT_SUPPORTED error will be returned in that case. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on successful trash, %FALSE otherwise. @@ -29894,7 +28566,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Asynchronously sends @file to the Trash location, if possible. - @@ -29926,7 +28597,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes an asynchronous file trashing operation, started with g_file_trash_async(). - %TRUE on successful trash, %FALSE otherwise. @@ -29953,7 +28623,6 @@ When the operation is finished, @callback will be called. You can then call g_file_unmount_mountable_finish() to get the result of the operation. Use g_file_unmount_mountable_with_operation() instead. - @@ -29989,7 +28658,6 @@ Finish an asynchronous unmount operation that was started with g_file_unmount_mountable(). Use g_file_unmount_mountable_with_operation_finish() instead. - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -30016,7 +28684,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_unmount_mountable_finish() to get the result of the operation. - @@ -30056,7 +28723,6 @@ see g_file_unmount_mountable_with_operation() for details. Finish an asynchronous unmount operation that was started with g_file_unmount_mountable_with_operation(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -30091,7 +28757,6 @@ Some file systems don't allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME error. If the file is a directory the %G_IO_ERROR_IS_DIRECTORY error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileOutputStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -30122,7 +28787,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_append_to_finish() to get the result of the operation. - @@ -30158,7 +28822,6 @@ of the operation. Finishes an asynchronous file append operation started with g_file_append_to_async(). - a valid #GFileOutputStream or %NULL on error. @@ -30217,7 +28880,6 @@ If the source is a directory and the target does not exist, or If you are interested in copying the #GFile object itself (not the on-disk file), see g_file_dup(). - %TRUE on success, %FALSE otherwise. @@ -30262,7 +28924,6 @@ run in. When the operation is finished, @callback will be called. You can then call g_file_copy_finish() to get the result of the operation. - @@ -30316,7 +28977,6 @@ those that are copies in a normal file copy operation if #G_FILE_COPY_ALL_METADATA is specified in @flags, then all the metadata that is possible to copy is copied. This is useful when implementing move by copy + delete source. - %TRUE if the attributes were copied successfully, %FALSE otherwise. @@ -30344,7 +29004,6 @@ is useful when implementing move by copy + delete source. Finishes copying the file started with g_file_copy_async(). - a %TRUE on success, %FALSE on error. @@ -30380,7 +29039,6 @@ allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME error, and if the name is to long %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileOutputStream for the newly created file, or %NULL on error. @@ -30413,7 +29071,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_create_finish() to get the result of the operation. - @@ -30449,7 +29106,6 @@ of the operation. Finishes an asynchronous file create operation started with g_file_create_async(). - a #GFileOutputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -30490,7 +29146,6 @@ kind of filesystem the file is on. Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, rather than just opening for reading or writing. - a #GFileIOStream for the newly created file, or %NULL on error. @@ -30523,7 +29178,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_create_readwrite_finish() to get the result of the operation. - @@ -30559,7 +29213,6 @@ the result of the operation. Finishes an asynchronous file create operation started with g_file_create_readwrite_async(). - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -30598,7 +29251,6 @@ if (!g_file_delete (my_file, my_cancellable, &local_error) && If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the file was deleted. %FALSE otherwise. @@ -30619,7 +29271,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Asynchronously delete a file. If the @file is a directory, it will only be deleted if it is empty. This has the same semantics as g_unlink(). - @@ -30650,7 +29301,6 @@ g_unlink(). Finishes deleting a file started with g_file_delete_async(). - %TRUE if the file was deleted. %FALSE otherwise. @@ -30677,7 +29327,6 @@ within the same thread, use g_object_ref() to increment the existing object reference count. This call does no blocking I/O. - a new #GFile that is a duplicate of the given #GFile. @@ -30700,7 +29349,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Use g_file_eject_mountable_with_operation() instead. - @@ -30734,7 +29382,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. g_file_eject_mountable(). Use g_file_eject_mountable_with_operation_finish() instead. - %TRUE if the @file was ejected successfully. %FALSE otherwise. @@ -30760,7 +29407,6 @@ g_file_eject_mountable_with_operation_finish(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - @@ -30797,7 +29443,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes an asynchronous eject operation started by g_file_eject_mountable_with_operation(). - %TRUE if the @file was ejected successfully. %FALSE otherwise. @@ -30838,7 +29483,6 @@ returned. If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. If the file is not a directory, the %G_IO_ERROR_NOT_DIRECTORY error will be returned. Other errors are possible too. - A #GFileEnumerator if successful, %NULL on error. Free the returned object with g_object_unref(). @@ -30875,7 +29519,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_enumerate_children_finish() to get the result of the operation. - @@ -30915,7 +29558,6 @@ the operation. Finishes an async enumerate children operation. See g_file_enumerate_children_async(). - a #GFileEnumerator or %NULL if an error occurred. @@ -30941,7 +29583,6 @@ file on the filesystem due to various forms of filename aliasing. This call does no blocking I/O. - %TRUE if @file1 and @file2 are equal. @@ -30967,7 +29608,6 @@ This call does no blocking I/O. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GMount where the @file is located or %NULL on error. @@ -30995,7 +29635,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_find_enclosing_mount_finish() to get the result of the operation. - @@ -31027,7 +29666,6 @@ get the result of the operation. Finishes an asynchronous find mount request. See g_file_find_enclosing_mount_async(). - #GMount for given @file or %NULL on error. Free the returned object with g_object_unref(). @@ -31058,7 +29696,6 @@ can get by requesting the %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME attribute with g_file_query_info(). This call does no blocking I/O. - string containing the #GFile's base name, or %NULL if given #GFile is invalid. The returned string @@ -31080,7 +29717,6 @@ you can still have a #GFile that points to it. You can use this for instance to create that file. This call does no blocking I/O. - a #GFile to a child specified by @name. Free the returned object with g_object_unref(). @@ -31106,7 +29742,6 @@ user interface, for instance when you select a directory and type a filename in the file selector. This call does no blocking I/O. - a #GFile to the specified child, or %NULL if the display name couldn't be converted. @@ -31130,7 +29765,6 @@ If the @file represents the root directory of the file system, then %NULL will be returned. This call does no blocking I/O. - a #GFile structure to the parent of the given #GFile or %NULL if there is no parent. Free @@ -31159,7 +29793,6 @@ to UTF-8 the pathname is used, otherwise the IRI is used (a form of URI that allows UTF-8 characters unescaped). This call does no blocking I/O. - a string containing the #GFile's parse name. The returned string should be freed with g_free() @@ -31178,7 +29811,6 @@ This call does no blocking I/O. guaranteed to be an absolute, canonical path. It might contain symlinks. This call does no blocking I/O. - string containing the #GFile's path, or %NULL if no such path exists. The returned string should be freed @@ -31196,7 +29828,6 @@ This call does no blocking I/O. Gets the path for @descendant relative to @parent. This call does no blocking I/O. - string with the relative path from @descendant to @parent, or %NULL if @descendant doesn't have @parent as @@ -31219,7 +29850,6 @@ This call does no blocking I/O. Gets the URI for the @file. This call does no blocking I/O. - a string containing the #GFile's URI. The returned string should be freed with g_free() @@ -31242,7 +29872,6 @@ URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] Common schemes include "file", "http", "ftp", etc. This call does no blocking I/O. - a string containing the URI scheme for the given #GFile. The returned string should be freed with g_free() @@ -31262,7 +29891,6 @@ This call does no blocking I/O. If @parent is %NULL then this function returns %TRUE if @file has any parent at all. If @parent is non-%NULL then %TRUE is only returned if @file is an immediate child of @parent. - %TRUE if @file is an immediate child of @parent (or any parent in the case that @parent is %NULL). @@ -31294,7 +29922,6 @@ This call does no I/O, as it works purely on names. As such it can sometimes return %FALSE even if @file is inside a @prefix (from a filesystem point of view), because the prefix of @file is an alias of @prefix. - %TRUE if the @file's parent, grandparent, etc is @prefix, %FALSE otherwise. @@ -31315,7 +29942,6 @@ of @prefix. Checks to see if a #GFile has a given URI scheme. This call does no blocking I/O. - %TRUE if #GFile's backend supports the given URI scheme, %FALSE if URI scheme is %NULL, @@ -31337,7 +29963,6 @@ This call does no blocking I/O. Creates a hash value for a #GFile. This call does no blocking I/O. - 0 if @file is not a valid #GFile, otherwise an integer that can be used as hash value for the #GFile. @@ -31364,7 +29989,6 @@ filesystem via a userspace filesystem (FUSE), in these cases this call will return %FALSE, but g_file_get_path() will still return a native path. This call does no blocking I/O. - %TRUE if @file is native @@ -31388,7 +30012,6 @@ For resources, @etag_out will be set to %NULL. The data contained in the resulting #GBytes is always zero-terminated, but this is not included in the #GBytes length. The resulting #GBytes should be freed with g_bytes_unref() when no longer in use. - a #GBytes or %NULL and @error is set @@ -31420,7 +30043,6 @@ g_file_load_contents_async() and g_bytes_new_take(). asynchronous operation. See g_file_load_bytes() for more information. - @@ -31454,7 +30076,6 @@ this is not included in the #GBytes length. The resulting #GBytes should be freed with g_bytes_unref() when no longer in use. See g_file_load_bytes() for more information. - a #GBytes or %NULL and @error is set @@ -31484,7 +30105,6 @@ needed. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the @file's contents were successfully loaded. %FALSE if there were errors. @@ -31531,7 +30151,6 @@ the @callback. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - @@ -31560,7 +30179,6 @@ The contents are placed in @contents, and @length is set to the size of the @contents string. The @contents should be freed with g_free() when no longer needed. If @etag_out is present, it will be set to the new entity tag for the @file. - %TRUE if the load was successful. If %FALSE and @error is present, it will be set appropriately. @@ -31605,7 +30223,6 @@ both the @read_more_callback and the @callback. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - @@ -31641,7 +30258,6 @@ with g_file_load_partial_contents_async(). The data is always zero-terminated, but this is not included in the resultant @length. The returned @contents should be freed with g_free() when no longer needed. - %TRUE if the load was successful. If %FALSE and @error is present, it will be set appropriately. @@ -31689,7 +30305,6 @@ For a local #GFile the newly created directory will have the default If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on successful creation, %FALSE otherwise. @@ -31708,7 +30323,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Asynchronously creates a directory. - @@ -31740,7 +30354,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes an asynchronous directory creation, started with g_file_make_directory_async(). - %TRUE on successful directory creation, %FALSE otherwise. @@ -31770,7 +30383,6 @@ For a local #GFile the newly created directories will have the default If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if all directories have been successfully created, %FALSE otherwise. @@ -31795,7 +30407,6 @@ otherwise. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on the creation of a new symlink, %FALSE otherwise. @@ -31836,7 +30447,6 @@ in a user interface. periodic progress updates while scanning. See the documentation for #GFileMeasureProgressCallback for information about when and how the callback will be invoked. - %TRUE if successful, with the out parameters set. %FALSE otherwise, with @error set. @@ -31882,7 +30492,6 @@ callback will be invoked. This is the asynchronous version of g_file_measure_disk_usage(). See there for more information. - @@ -31925,7 +30534,6 @@ there for more information. Collects the results from an earlier call to g_file_measure_disk_usage_async(). See g_file_measure_disk_usage() for more information. - %TRUE if successful, with the out parameters set. %FALSE otherwise, with @error set. @@ -31961,7 +30569,6 @@ depending on the type of the file. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GFileMonitor for the given @file, or %NULL on error. @@ -31997,7 +30604,6 @@ It does not make sense for @flags to contain directories. It is not possible to monitor all the files in a directory for changes made via hard links; if you want to do this then you must register individual watches with g_file_monitor(). - a #GFileMonitor for the given @file, or %NULL on error. @@ -32035,7 +30641,6 @@ changes made through the filename contained in @file to be reported. Using this flag may result in an increase in resource usage, and may not have any effect depending on the #GFileMonitor backend and/or filesystem type. - a #GFileMonitor for the given @file, or %NULL on error. @@ -32069,7 +30674,6 @@ g_file_mount_enclosing_volume_finish(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - @@ -32105,7 +30709,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes a mount operation started by g_file_mount_enclosing_volume(). - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -32135,7 +30738,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_mount_mountable_finish() to get the result of the operation. - @@ -32174,7 +30776,6 @@ the result of the operation. Finish an asynchronous mount operation that was started with g_file_mount_mountable(). - a #GFile or %NULL on error. Free the returned object with g_object_unref(). @@ -32225,7 +30826,6 @@ If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is specified and the target is a file, then the %G_IO_ERROR_WOULD_RECURSE error may be returned (if the native move operation isn't available). - %TRUE on successful move, %FALSE otherwise. @@ -32277,7 +30877,6 @@ what kind of filesystem the file is on. Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, rather than just opening for reading or writing. - #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -32303,7 +30902,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_open_readwrite_finish() to get the result of the operation. - @@ -32335,7 +30933,6 @@ the result of the operation. Finishes an asynchronous file read operation started with g_file_open_readwrite_async(). - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -32360,7 +30957,6 @@ also avoids an extra duplicated string when possible, so will be generally more efficient. This call does no blocking I/O. - string containing the #GFile's path, or %NULL if no such path exists. The returned string is owned by @file. @@ -32383,7 +30979,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_mount_mountable_finish() to get the result of the operation. - @@ -32412,7 +31007,6 @@ the result of the operation. Finish an asynchronous poll operation that was polled with g_file_poll_mountable(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -32436,7 +31030,6 @@ application to handle the file specified by @file. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GAppInfo if the handle was found, %NULL if there were errors. @@ -32456,7 +31049,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Async version of g_file_query_default_handler(). - @@ -32485,7 +31077,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes a g_file_query_default_handler_async() operation. - a #GAppInfo if the handle was found, %NULL if there were errors. @@ -32526,7 +31117,6 @@ for instance to make a menu item sensitive/insensitive, so that you don't have to fool users that something is possible and then just show an error dialog. If you do this, you should make sure to also handle the errors that can happen due to races when you execute the operation. - %TRUE if the file exists (and can be detected without error), %FALSE otherwise (or if cancelled). @@ -32550,7 +31140,6 @@ implemented using g_file_query_info() and as such does blocking I/O. The primary use case of this method is to check if a file is a regular file, directory, or symlink. - The #GFileType of the file and #G_FILE_TYPE_UNKNOWN if the file does not exist @@ -32598,7 +31187,6 @@ returned. If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileInfo or %NULL if there was an error. Free the returned object with g_object_unref(). @@ -32632,7 +31220,6 @@ synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_query_info_finish() to get the result of the operation. - @@ -32668,7 +31255,6 @@ operation. Finishes an asynchronous filesystem info query. See g_file_query_filesystem_info_async(). - #GFileInfo for given @file or %NULL on error. @@ -32717,7 +31303,6 @@ about the symlink itself will be returned. If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileInfo for the given @file, or %NULL on error. Free the returned object with g_object_unref(). @@ -32753,7 +31338,6 @@ version of this call. When the operation is finished, @callback will be called. You can then call g_file_query_info_finish() to get the result of the operation. - @@ -32793,7 +31377,6 @@ then call g_file_query_info_finish() to get the result of the operation. Finishes an asynchronous file info query. See g_file_query_info_async(). - #GFileInfo for given @file or %NULL on error. Free the returned object with @@ -32822,7 +31405,6 @@ specific file may not support a specific attribute. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GFileAttributeInfoList describing the settable attributes. When you are done with it, release it with @@ -32849,7 +31431,6 @@ attributes (in the "xattr" namespace). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GFileAttributeInfoList describing the writable namespaces. When you are done with it, release it with @@ -32880,7 +31461,6 @@ If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be returned. If the file is a directory, the %G_IO_ERROR_IS_DIRECTORY error will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - #GFileInputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -32906,7 +31486,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_read_finish() to get the result of the operation. - @@ -32938,7 +31517,6 @@ of the operation. Finishes an asynchronous file read operation started with g_file_read_async(). - a #GFileInputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -32997,7 +31575,6 @@ file systems don't allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME error, and if the name is to long %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors are possible too, and depend on what kind of filesystem the file is on. - a #GFileOutputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -33038,7 +31615,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_replace_finish() to get the result of the operation. - @@ -33097,7 +31673,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. The returned @new_etag can be used to verify that the file hasn't changed the next time it is saved over. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error appropriately if present. @@ -33163,7 +31738,6 @@ Note that no copy of @contents will be made, so it must stay valid until @callback is called. See g_file_replace_contents_bytes_async() for a #GBytes version that will automatically hold a reference to the contents (without copying) for the duration of the call. - @@ -33217,7 +31791,6 @@ content without waiting for the callback. When this operation has completed, @callback will be called with @user_user data, and the operation can be finalized with g_file_replace_contents_finish(). - @@ -33260,7 +31833,6 @@ g_file_replace_contents_finish(). Finishes an asynchronous replace of the given @file. See g_file_replace_contents_async(). Sets @new_etag to the new entity tag for the document, if present. - %TRUE on success, %FALSE on failure. @@ -33285,7 +31857,6 @@ tag for the document, if present. Finishes an asynchronous file replace operation started with g_file_replace_async(). - a #GFileOutputStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -33313,7 +31884,6 @@ same thing but returns an output stream only. Note that in many non-local file cases read and write streams are not supported, so make sure you really need to do read and write streaming, rather than just opening for reading or writing. - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -33355,7 +31925,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_replace_readwrite_finish() to get the result of the operation. - @@ -33400,7 +31969,6 @@ the result of the operation. Finishes an asynchronous file replace operation started with g_file_replace_readwrite_async(). - a #GFileIOStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -33421,7 +31989,6 @@ g_file_replace_readwrite_async(). Resolves a relative path for @file to an absolute path. This call does no blocking I/O. - #GFile to the resolved path. %NULL if @relative_path is %NULL or if @file is invalid. @@ -33448,7 +32015,6 @@ Some attributes can be unset by setting @type to If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the attribute was set, %FALSE otherwise. @@ -33490,7 +32056,6 @@ returning %FALSE. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the @attribute was successfully set to @value in the @file, %FALSE otherwise. @@ -33527,7 +32092,6 @@ If @attribute is of a different type, this operation will fail. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the @attribute was successfully set to @value in the @file, %FALSE otherwise. @@ -33564,7 +32128,6 @@ If @attribute is of a different type, this operation will fail. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the @attribute was successfully set, %FALSE otherwise. @@ -33600,7 +32163,6 @@ If @attribute is of a different type, this operation will fail. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the @attribute was successfully set, %FALSE otherwise. @@ -33636,7 +32198,6 @@ If @attribute is of a different type, this operation will fail. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the @attribute was successfully set to @value in the @file, %FALSE otherwise. @@ -33673,7 +32234,6 @@ If @attribute is of a different type, this operation will fail. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if the @attribute was successfully set to @value in the @file, %FALSE otherwise. @@ -33712,7 +32272,6 @@ which is the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_set_attributes_finish() to get the result of the operation. - @@ -33750,7 +32309,6 @@ the result of the operation. Finishes setting an attribute started in g_file_set_attributes_async(). - %TRUE if the attributes were set correctly, %FALSE otherwise. @@ -33783,7 +32341,6 @@ also detect further errors. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %FALSE if there was any error, %TRUE otherwise. @@ -33824,7 +32381,6 @@ On success the resulting converted filename is returned. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GFile specifying what @file was renamed to, or %NULL if there was an error. @@ -33856,7 +32412,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_file_set_display_name_finish() to get the result of the operation. - @@ -33892,7 +32447,6 @@ the result of the operation. Finishes setting a display name started with g_file_set_display_name_async(). - a #GFile or %NULL on error. Free the returned object with g_object_unref(). @@ -33921,7 +32475,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_mount_mountable_finish() to get the result of the operation. - @@ -33957,7 +32510,6 @@ the result of the operation. Finish an asynchronous start operation that was started with g_file_start_mountable(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -33984,7 +32536,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_stop_mountable_finish() to get the result of the operation. - @@ -34023,7 +32574,6 @@ the result of the operation. Finish an asynchronous stop operation that was started with g_file_stop_mountable(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -34045,7 +32595,6 @@ with g_file_stop_mountable(). [thread-default contexts][g-main-context-push-thread-default-context]. If this returns %FALSE, you cannot perform asynchronous operations on @file in a thread that has a thread-default context. - Whether or not @file supports thread-default contexts. @@ -34068,7 +32617,6 @@ mounts, the %G_IO_ERROR_NOT_SUPPORTED error will be returned in that case. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on successful trash, %FALSE otherwise. @@ -34087,7 +32635,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Asynchronously sends @file to the Trash location, if possible. - @@ -34119,7 +32666,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Finishes an asynchronous file trashing operation, started with g_file_trash_async(). - %TRUE on successful trash, %FALSE otherwise. @@ -34146,7 +32692,6 @@ When the operation is finished, @callback will be called. You can then call g_file_unmount_mountable_finish() to get the result of the operation. Use g_file_unmount_mountable_with_operation() instead. - @@ -34182,7 +32727,6 @@ Finish an asynchronous unmount operation that was started with g_file_unmount_mountable(). Use g_file_unmount_mountable_with_operation_finish() instead. - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -34209,7 +32753,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished, @callback will be called. You can then call g_file_unmount_mountable_finish() to get the result of the operation. - @@ -34249,7 +32792,6 @@ see g_file_unmount_mountable_with_operation() for details. Finish an asynchronous unmount operation that was started with g_file_unmount_mountable_with_operation(). - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -34269,7 +32811,6 @@ with g_file_unmount_mountable_with_operation(). Information about a specific attribute. - the name of the attribute. @@ -34298,7 +32839,6 @@ with g_file_unmount_mountable_with_operation(). Acts as a lightweight registry for possible valid file attributes. The registry stores Key-Value pair formats as #GFileAttributeInfos. - an array of #GFileAttributeInfos. @@ -34309,7 +32849,6 @@ The registry stores Key-Value pair formats as #GFileAttributeInfos. Creates a new file attribute info list. - a #GFileAttributeInfoList. @@ -34318,7 +32857,6 @@ The registry stores Key-Value pair formats as #GFileAttributeInfos. Adds a new attribute with @name to the @list, setting its @type and @flags. - @@ -34343,7 +32881,6 @@ its @type and @flags. Makes a duplicate of a file attribute info list. - a copy of the given @list. @@ -34357,7 +32894,6 @@ its @type and @flags. Gets the file attribute with the name @name from @list. - a #GFileAttributeInfo for the @name, or %NULL if an attribute isn't found. @@ -34376,7 +32912,6 @@ attribute isn't found. References a file attribute info list. - #GFileAttributeInfoList or %NULL on error. @@ -34391,7 +32926,6 @@ attribute isn't found. Removes a reference from the given @list. If the reference count falls to zero, the @list is deleted. - @@ -34405,7 +32939,6 @@ falls to zero, the @list is deleted. Determines if a string matches a file attribute. - Creates a new file attribute matcher, which matches attributes against a given string. #GFileAttributeMatchers are reference @@ -34426,7 +32959,6 @@ The wildcard "*" may be used to match all keys and namespaces, or standard namespace. - `"standard::type,unix::*"`: matches the type key in the standard namespace and all keys in the unix namespace. - a #GFileAttributeMatcher @@ -34445,7 +32977,6 @@ matcher was created with "standard::*" and @ns is "standard", or if matcher was using "*" and namespace is anything.) TODO: this is awkwardly worded. - %TRUE if the matcher matches all of the entries in the given @ns, %FALSE otherwise. @@ -34464,7 +32995,6 @@ in the given @ns, %FALSE otherwise. Gets the next matched attribute from a #GFileAttributeMatcher. - a string containing the next attribute or, %NULL if no more attribute exist. @@ -34481,7 +33011,6 @@ no more attribute exist. Checks if an attribute will be matched by an attribute matcher. If the matcher was created with the "*" matching string, this function will always return %TRUE. - %TRUE if @attribute matches @matcher. %FALSE otherwise. @@ -34500,7 +33029,6 @@ will always return %TRUE. Checks if a attribute matcher only matches a given attribute. Always returns %FALSE if "*" was used when creating the matcher. - %TRUE if the matcher only matches @attribute. %FALSE otherwise. @@ -34518,7 +33046,6 @@ returns %FALSE if "*" was used when creating the matcher. References a file attribute matcher. - a #GFileAttributeMatcher. @@ -34539,7 +33066,6 @@ attribute when the @matcher matches the whole namespace - or remove a namespace or attribute when the matcher matches everything. This is a limitation of the current implementation, but may be fixed in the future. - A file attribute matcher matching all attributes of @matcher that are not matched by @subtract @@ -34561,7 +33087,6 @@ in the future. equal to the format passed to g_file_attribute_matcher_new(). The output however, might not be identical, as the matcher may decide to use a different order or omit needless parts. - a string describing the attributes the matcher matches against or %NULL if @matcher was %NULL. @@ -34577,7 +33102,6 @@ decide to use a different order or omit needless parts. Unreferences @matcher. If the reference count falls below 1, the @matcher is automatically freed. - @@ -34687,10 +33211,8 @@ the @matcher is automatically freed. Note that `<gio/gfiledescriptorbased.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - Gets the underlying file descriptor. - The file descriptor @@ -34704,7 +33226,6 @@ file when using it. Gets the underlying file descriptor. - The file descriptor @@ -34719,14 +33240,12 @@ file when using it. An interface for file descriptor based io objects. - The parent interface. - The file descriptor @@ -34767,7 +33286,6 @@ To close a #GFileEnumerator, use g_file_enumerator_close(), or its asynchronous version, g_file_enumerator_close_async(). Once a #GFileEnumerator is closed, no further actions may be performed on it, and it should be freed with g_object_unref(). - Asynchronously closes the file enumerator. @@ -34775,7 +33293,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned in g_file_enumerator_close_finish(). - @@ -34813,7 +33330,6 @@ return %FALSE. If @cancellable was not %NULL, then the operation may have been cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %FALSE will be returned. - %TRUE if the close operation has finished successfully. @@ -34830,7 +33346,6 @@ returned. - @@ -34855,7 +33370,6 @@ order of returned files. On error, returns %NULL and sets @error to the error. If the enumerator is at the end, %NULL will be returned and @error will be unset. - A #GFileInfo or %NULL on error or end of enumerator. Free the returned object with @@ -34893,7 +33407,6 @@ result in %G_IO_ERROR_PENDING errors. Any outstanding i/o request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. Default priority is %G_PRIORITY_DEFAULT. - @@ -34926,7 +33439,6 @@ priority is %G_PRIORITY_DEFAULT. Finishes the asynchronous operation started with g_file_enumerator_next_files_async(). - a #GList of #GFileInfos. You must free the list with g_list_free() and unref the infos with g_object_unref() when you're @@ -34953,7 +33465,6 @@ enumerator return %G_IO_ERROR_CLOSED on all calls. This will be automatically called when the last reference is dropped, but you might want to call this function to make sure resources are released as early as possible. - #TRUE on success or #FALSE on error. @@ -34976,7 +33487,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned in g_file_enumerator_close_finish(). - @@ -35014,7 +33524,6 @@ return %FALSE. If @cancellable was not %NULL, then the operation may have been cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %FALSE will be returned. - %TRUE if the close operation has finished successfully. @@ -35041,7 +33550,6 @@ This is a convenience method that's equivalent to: GFile *child = g_file_get_child (g_file_enumerator_get_container (enumr), name); ]| - a #GFile for the #GFileInfo passed it. @@ -35060,7 +33568,6 @@ This is a convenience method that's equivalent to: Get the #GFile container which is being enumerated. - the #GFile which is being enumerated. @@ -35074,7 +33581,6 @@ This is a convenience method that's equivalent to: Checks if the file enumerator has pending operations. - %TRUE if the @enumerator has pending operations. @@ -35088,7 +33594,6 @@ This is a convenience method that's equivalent to: Checks if the file enumerator has been closed. - %TRUE if the @enumerator is closed. @@ -35139,7 +33644,6 @@ while (TRUE) out: g_object_unref (direnum); // Note: frees the last @info ]| - @@ -35174,7 +33678,6 @@ order of returned files. On error, returns %NULL and sets @error to the error. If the enumerator is at the end, %NULL will be returned and @error will be unset. - A #GFileInfo or %NULL on error or end of enumerator. Free the returned object with @@ -35212,7 +33715,6 @@ result in %G_IO_ERROR_PENDING errors. Any outstanding i/o request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. Default priority is %G_PRIORITY_DEFAULT. - @@ -35245,7 +33747,6 @@ priority is %G_PRIORITY_DEFAULT. Finishes the asynchronous operation started with g_file_enumerator_next_files_async(). - a #GList of #GFileInfos. You must free the list with g_list_free() and unref the infos with g_object_unref() when you're @@ -35267,7 +33768,6 @@ priority is %G_PRIORITY_DEFAULT. Sets the file enumerator as having pending operations. - @@ -35293,13 +33793,11 @@ priority is %G_PRIORITY_DEFAULT. - - A #GFileInfo or %NULL on error or end of enumerator. Free the returned object with @@ -35320,7 +33818,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35336,7 +33833,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35370,7 +33866,6 @@ priority is %G_PRIORITY_DEFAULT. - a #GList of #GFileInfos. You must free the list with g_list_free() and unref the infos with g_object_unref() when you're @@ -35393,7 +33888,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35423,7 +33917,6 @@ priority is %G_PRIORITY_DEFAULT. - %TRUE if the close operation has finished successfully. @@ -35442,7 +33935,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35450,7 +33942,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35458,7 +33949,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35466,7 +33956,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35474,7 +33963,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35482,7 +33970,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35490,7 +33977,6 @@ priority is %G_PRIORITY_DEFAULT. - @@ -35521,10 +34007,8 @@ stream, use g_seekable_truncate(). The default implementation of all the #GFileIOStream operations and the implementation of #GSeekable just call into the same operations on the output stream. - - @@ -35535,7 +34019,6 @@ on the output stream. - @@ -35549,7 +34032,6 @@ on the output stream. Gets the entity tag for the file when it has been written. This must be called after the stream has been written and closed, as the etag can change while writing. - the entity tag for the stream. @@ -35579,7 +34061,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will be returned. - a #GFileInfo for the @stream, or %NULL on error. @@ -35606,7 +34087,6 @@ finish the operation with g_file_io_stream_query_info_finish(). For the synchronous version of this function, see g_file_io_stream_query_info(). - @@ -35640,7 +34120,6 @@ g_file_io_stream_query_info(). Finalizes the asynchronous query started by g_file_io_stream_query_info_async(). - A #GFileInfo for the finished query. @@ -35657,7 +34136,6 @@ by g_file_io_stream_query_info_async(). - @@ -35677,7 +34155,6 @@ by g_file_io_stream_query_info_async(). - @@ -35688,7 +34165,6 @@ by g_file_io_stream_query_info_async(). - @@ -35708,7 +34184,6 @@ by g_file_io_stream_query_info_async(). Gets the entity tag for the file when it has been written. This must be called after the stream has been written and closed, as the etag can change while writing. - the entity tag for the stream. @@ -35738,7 +34213,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will be returned. - a #GFileInfo for the @stream, or %NULL on error. @@ -35765,7 +34239,6 @@ finish the operation with g_file_io_stream_query_info_finish(). For the synchronous version of this function, see g_file_io_stream_query_info(). - @@ -35799,7 +34272,6 @@ g_file_io_stream_query_info(). Finalizes the asynchronous query started by g_file_io_stream_query_info_async(). - A #GFileInfo for the finished query. @@ -35823,13 +34295,11 @@ by g_file_io_stream_query_info_async(). - - @@ -35842,7 +34312,6 @@ by g_file_io_stream_query_info_async(). - @@ -35855,7 +34324,6 @@ by g_file_io_stream_query_info_async(). - @@ -35877,7 +34345,6 @@ by g_file_io_stream_query_info_async(). - @@ -35890,7 +34357,6 @@ by g_file_io_stream_query_info_async(). - @@ -35909,7 +34375,6 @@ by g_file_io_stream_query_info_async(). - a #GFileInfo for the @stream, or %NULL on error. @@ -35932,7 +34397,6 @@ by g_file_io_stream_query_info_async(). - @@ -35966,7 +34430,6 @@ by g_file_io_stream_query_info_async(). - A #GFileInfo for the finished query. @@ -35985,7 +34448,6 @@ by g_file_io_stream_query_info_async(). - the entity tag for the stream. @@ -36000,7 +34462,6 @@ by g_file_io_stream_query_info_async(). - @@ -36008,7 +34469,6 @@ by g_file_io_stream_query_info_async(). - @@ -36016,7 +34476,6 @@ by g_file_io_stream_query_info_async(). - @@ -36024,7 +34483,6 @@ by g_file_io_stream_query_info_async(). - @@ -36032,7 +34490,6 @@ by g_file_io_stream_query_info_async(). - @@ -36045,12 +34502,10 @@ by g_file_io_stream_query_info_async(). #GFileIcon specifies an icon by pointing to an image file to be used as icon. - Creates a new icon for a file. - a #GIcon for the given @file, or %NULL on error. @@ -36065,7 +34520,6 @@ to be used as icon. Gets the #GFile associated with the given @icon. - a #GFile, or %NULL. @@ -36087,14 +34541,12 @@ to be used as icon. An interface for writing VFS file handles. - The parent interface. - a new #GFile that is a duplicate of the given #GFile. @@ -36110,7 +34562,6 @@ to be used as icon. - 0 if @file is not a valid #GFile, otherwise an integer that can be used as hash value for the #GFile. @@ -36128,7 +34579,6 @@ to be used as icon. - %TRUE if @file1 and @file2 are equal. @@ -36147,7 +34597,6 @@ to be used as icon. - %TRUE if @file is native @@ -36162,7 +34611,6 @@ to be used as icon. - %TRUE if #GFile's backend supports the given URI scheme, %FALSE if URI scheme is %NULL, @@ -36183,7 +34631,6 @@ to be used as icon. - a string containing the URI scheme for the given #GFile. The returned string should be freed with g_free() @@ -36200,7 +34647,6 @@ to be used as icon. - @@ -36213,7 +34659,6 @@ to be used as icon. - @@ -36226,7 +34671,6 @@ to be used as icon. - a string containing the #GFile's URI. The returned string should be freed with g_free() @@ -36243,7 +34687,6 @@ to be used as icon. - a string containing the #GFile's parse name. The returned string should be freed with g_free() @@ -36260,7 +34703,6 @@ to be used as icon. - a #GFile structure to the parent of the given #GFile or %NULL if there is no parent. Free @@ -36277,7 +34719,6 @@ to be used as icon. - %TRUE if the @file's parent, grandparent, etc is @prefix, %FALSE otherwise. @@ -36297,7 +34738,6 @@ to be used as icon. - @@ -36313,7 +34753,6 @@ to be used as icon. - #GFile to the resolved path. %NULL if @relative_path is %NULL or if @file is invalid. @@ -36334,7 +34773,6 @@ to be used as icon. - a #GFile to the specified child, or %NULL if the display name couldn't be converted. @@ -36355,7 +34793,6 @@ to be used as icon. - A #GFileEnumerator if successful, %NULL on error. Free the returned object with g_object_unref(). @@ -36384,7 +34821,6 @@ to be used as icon. - @@ -36424,7 +34860,6 @@ to be used as icon. - a #GFileEnumerator or %NULL if an error occurred. @@ -36445,7 +34880,6 @@ to be used as icon. - a #GFileInfo for the given @file, or %NULL on error. Free the returned object with g_object_unref(). @@ -36474,7 +34908,6 @@ to be used as icon. - @@ -36514,7 +34947,6 @@ to be used as icon. - #GFileInfo for given @file or %NULL on error. Free the returned object with @@ -36535,7 +34967,6 @@ to be used as icon. - a #GFileInfo or %NULL if there was an error. Free the returned object with g_object_unref(). @@ -36560,7 +34991,6 @@ to be used as icon. - @@ -36596,7 +35026,6 @@ to be used as icon. - #GFileInfo for given @file or %NULL on error. @@ -36617,7 +35046,6 @@ to be used as icon. - a #GMount where the @file is located or %NULL on error. @@ -36639,7 +35067,6 @@ to be used as icon. - @@ -36671,7 +35098,6 @@ to be used as icon. - #GMount for given @file or %NULL on error. Free the returned object with g_object_unref(). @@ -36691,7 +35117,6 @@ to be used as icon. - a #GFile specifying what @file was renamed to, or %NULL if there was an error. @@ -36717,7 +35142,6 @@ to be used as icon. - @@ -36753,7 +35177,6 @@ to be used as icon. - a #GFile or %NULL on error. Free the returned object with g_object_unref(). @@ -36773,7 +35196,6 @@ to be used as icon. - a #GFileAttributeInfoList describing the settable attributes. When you are done with it, release it with @@ -36795,7 +35217,6 @@ to be used as icon. - @@ -36803,7 +35224,6 @@ to be used as icon. - @@ -36811,7 +35231,6 @@ to be used as icon. - a #GFileAttributeInfoList describing the writable namespaces. When you are done with it, release it with @@ -36833,7 +35252,6 @@ to be used as icon. - @@ -36841,7 +35259,6 @@ to be used as icon. - @@ -36849,7 +35266,6 @@ to be used as icon. - %TRUE if the attribute was set, %FALSE otherwise. @@ -36886,7 +35302,6 @@ to be used as icon. - %FALSE if there was any error, %TRUE otherwise. @@ -36914,7 +35329,6 @@ to be used as icon. - @@ -36953,7 +35367,6 @@ to be used as icon. - %TRUE if the attributes were set correctly, %FALSE otherwise. @@ -36976,7 +35389,6 @@ to be used as icon. - #GFileInputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -36996,7 +35408,6 @@ to be used as icon. - @@ -37028,7 +35439,6 @@ to be used as icon. - a #GFileInputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -37048,7 +35458,6 @@ to be used as icon. - a #GFileOutputStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -37073,7 +35482,6 @@ to be used as icon. - @@ -37109,7 +35517,6 @@ to be used as icon. - a valid #GFileOutputStream or %NULL on error. @@ -37130,7 +35537,6 @@ to be used as icon. - a #GFileOutputStream for the newly created file, or %NULL on error. @@ -37156,7 +35562,6 @@ to be used as icon. - @@ -37192,7 +35597,6 @@ to be used as icon. - a #GFileOutputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -37212,7 +35616,6 @@ to be used as icon. - a #GFileOutputStream or %NULL on error. Free the returned object with g_object_unref(). @@ -37246,7 +35649,6 @@ to be used as icon. - @@ -37291,7 +35693,6 @@ to be used as icon. - a #GFileOutputStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -37311,7 +35712,6 @@ to be used as icon. - %TRUE if the file was deleted. %FALSE otherwise. @@ -37331,7 +35731,6 @@ to be used as icon. - @@ -37363,7 +35762,6 @@ to be used as icon. - %TRUE if the file was deleted. %FALSE otherwise. @@ -37382,7 +35780,6 @@ to be used as icon. - %TRUE on successful trash, %FALSE otherwise. @@ -37402,7 +35799,6 @@ to be used as icon. - @@ -37434,7 +35830,6 @@ to be used as icon. - %TRUE on successful trash, %FALSE otherwise. @@ -37453,7 +35848,6 @@ to be used as icon. - %TRUE on successful creation, %FALSE otherwise. @@ -37473,7 +35867,6 @@ to be used as icon. - @@ -37505,7 +35898,6 @@ to be used as icon. - %TRUE on successful directory creation, %FALSE otherwise. @@ -37524,7 +35916,6 @@ to be used as icon. - %TRUE on the creation of a new symlink, %FALSE otherwise. @@ -37549,7 +35940,6 @@ to be used as icon. - @@ -37557,7 +35947,6 @@ to be used as icon. - @@ -37565,7 +35954,6 @@ to be used as icon. - %TRUE on success, %FALSE otherwise. @@ -37602,7 +35990,6 @@ to be used as icon. - @@ -37650,7 +36037,6 @@ to be used as icon. - a %TRUE on success, %FALSE on error. @@ -37669,7 +36055,6 @@ to be used as icon. - %TRUE on successful move, %FALSE otherwise. @@ -37707,7 +36092,6 @@ to be used as icon. - @@ -37715,7 +36099,6 @@ to be used as icon. - @@ -37723,7 +36106,6 @@ to be used as icon. - @@ -37760,7 +36142,6 @@ to be used as icon. - a #GFile or %NULL on error. Free the returned object with g_object_unref(). @@ -37780,7 +36161,6 @@ to be used as icon. - @@ -37812,7 +36192,6 @@ to be used as icon. - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -37832,7 +36211,6 @@ to be used as icon. - @@ -37864,7 +36242,6 @@ to be used as icon. - %TRUE if the @file was ejected successfully. %FALSE otherwise. @@ -37884,7 +36261,6 @@ to be used as icon. - @@ -37921,7 +36297,6 @@ to be used as icon. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -37942,7 +36317,6 @@ to be used as icon. - a #GFileMonitor for the given @file, or %NULL on error. @@ -37968,7 +36342,6 @@ to be used as icon. - a #GFileMonitor for the given @file, or %NULL on error. @@ -37994,7 +36367,6 @@ to be used as icon. - #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -38014,7 +36386,6 @@ to be used as icon. - @@ -38046,7 +36417,6 @@ to be used as icon. - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -38066,7 +36436,6 @@ to be used as icon. - a #GFileIOStream for the newly created file, or %NULL on error. @@ -38092,7 +36461,6 @@ to be used as icon. - @@ -38128,7 +36496,6 @@ to be used as icon. - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -38148,7 +36515,6 @@ to be used as icon. - a #GFileIOStream or %NULL on error. Free the returned object with g_object_unref(). @@ -38182,7 +36548,6 @@ to be used as icon. - @@ -38227,7 +36592,6 @@ to be used as icon. - a #GFileIOStream, or %NULL on error. Free the returned object with g_object_unref(). @@ -38247,7 +36611,6 @@ to be used as icon. - @@ -38281,7 +36644,6 @@ to be used as icon. - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -38301,7 +36663,6 @@ otherwise. - @@ -38338,7 +36699,6 @@ otherwise. - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -38362,7 +36722,6 @@ otherwise. - @@ -38399,7 +36758,6 @@ otherwise. - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -38419,7 +36777,6 @@ otherwise. - @@ -38456,7 +36813,6 @@ otherwise. - %TRUE if the @file was ejected successfully. %FALSE otherwise. @@ -38476,7 +36832,6 @@ otherwise. - @@ -38503,7 +36858,6 @@ otherwise. - %TRUE if the operation finished successfully. %FALSE otherwise. @@ -38523,7 +36877,6 @@ otherwise. - %TRUE if successful, with the out parameters set. %FALSE otherwise, with @error set. @@ -38567,7 +36920,6 @@ otherwise. - @@ -38609,7 +36961,6 @@ otherwise. - %TRUE if successful, with the out parameters set. %FALSE otherwise, with @error set. @@ -38665,10 +37016,8 @@ of a particular file at runtime. #GFileAttributeMatcher allows for searching through a #GFileInfo for attributes. - Creates a new file info structure. - a #GFileInfo. @@ -38676,7 +37025,6 @@ attributes. Clears the status information from @info. - @@ -38690,7 +37038,6 @@ attributes. First clears all of the [GFileAttribute][gio-GFileAttribute] of @dest_info, and then copies all of the file attributes from @src_info to @dest_info. - @@ -38707,7 +37054,6 @@ and then copies all of the file attributes from @src_info to @dest_info. Duplicates a file info structure. - a duplicate #GFileInfo of @other. @@ -38723,7 +37069,6 @@ and then copies all of the file attributes from @src_info to @dest_info. Gets the value of a attribute, formatted as a string. This escapes things as needed to make the string valid UTF-8. - a UTF-8 string associated with the given @attribute, or %NULL if the attribute wasn’t set. @@ -38744,7 +37089,6 @@ UTF-8. Gets the value of a boolean attribute. If the attribute does not contain a boolean value, %FALSE will be returned. - the boolean value contained within the attribute. @@ -38763,7 +37107,6 @@ contain a boolean value, %FALSE will be returned. Gets the value of a byte string attribute. If the attribute does not contain a byte string, %NULL will be returned. - the contents of the @attribute value as a byte string, or %NULL otherwise. @@ -38782,7 +37125,6 @@ not contain a byte string, %NULL will be returned. Gets the attribute type, value and status for an attribute key. - %TRUE if @info has an attribute named @attribute, %FALSE otherwise. @@ -38816,7 +37158,6 @@ not contain a byte string, %NULL will be returned. Gets a signed 32-bit integer contained within the attribute. If the attribute does not contain a signed 32-bit integer, or is invalid, 0 will be returned. - a signed 32-bit integer from the attribute. @@ -38836,7 +37177,6 @@ attribute does not contain a signed 32-bit integer, or is invalid, Gets a signed 64-bit integer contained within the attribute. If the attribute does not contain a signed 64-bit integer, or is invalid, 0 will be returned. - a signed 64-bit integer from the attribute. @@ -38855,7 +37195,6 @@ attribute does not contain a signed 64-bit integer, or is invalid, Gets the value of a #GObject attribute. If the attribute does not contain a #GObject, %NULL will be returned. - a #GObject associated with the given @attribute, or %NULL otherwise. @@ -38874,7 +37213,6 @@ or %NULL otherwise. Gets the attribute status for an attribute key. - a #GFileAttributeStatus for the given @attribute, or %G_FILE_ATTRIBUTE_STATUS_UNSET if the key is invalid. @@ -38894,7 +37232,6 @@ or %NULL otherwise. Gets the value of a string attribute. If the attribute does not contain a string, %NULL will be returned. - the contents of the @attribute value as a UTF-8 string, or %NULL otherwise. @@ -38914,7 +37251,6 @@ or %NULL otherwise. Gets the value of a stringv attribute. If the attribute does not contain a stringv, %NULL will be returned. - the contents of the @attribute value as a stringv, or %NULL otherwise. Do not free. These returned strings are UTF-8. @@ -38935,7 +37271,6 @@ or %NULL otherwise. Do not free. These returned strings are UTF-8. Gets the attribute type for an attribute key. - a #GFileAttributeType for the given @attribute, or %G_FILE_ATTRIBUTE_TYPE_INVALID if the key is not set. @@ -38956,7 +37291,6 @@ or %NULL otherwise. Do not free. These returned strings are UTF-8. Gets an unsigned 32-bit integer contained within the attribute. If the attribute does not contain an unsigned 32-bit integer, or is invalid, 0 will be returned. - an unsigned 32-bit integer from the attribute. @@ -38976,7 +37310,6 @@ attribute does not contain an unsigned 32-bit integer, or is invalid, Gets a unsigned 64-bit integer contained within the attribute. If the attribute does not contain an unsigned 64-bit integer, or is invalid, 0 will be returned. - a unsigned 64-bit integer from the attribute. @@ -38994,7 +37327,6 @@ attribute does not contain an unsigned 64-bit integer, or is invalid, Gets the file's content type. - a string containing the file's content type, or %NULL if unknown. @@ -39011,7 +37343,6 @@ or %NULL if unknown. Returns the #GDateTime representing the deletion date of the file, as available in G_FILE_ATTRIBUTE_TRASH_DELETION_DATE. If the G_FILE_ATTRIBUTE_TRASH_DELETION_DATE attribute is unset, %NULL is returned. - a #GDateTime, or %NULL. @@ -39025,7 +37356,6 @@ G_FILE_ATTRIBUTE_TRASH_DELETION_DATE attribute is unset, %NULL is returned. Gets a display name for a file. This is guaranteed to always be set. - a string containing the display name. @@ -39039,7 +37369,6 @@ G_FILE_ATTRIBUTE_TRASH_DELETION_DATE attribute is unset, %NULL is returned. Gets the edit name for a file. - a string containing the edit name. @@ -39054,7 +37383,6 @@ G_FILE_ATTRIBUTE_TRASH_DELETION_DATE attribute is unset, %NULL is returned. Gets the [entity tag][gfile-etag] for a given #GFileInfo. See %G_FILE_ATTRIBUTE_ETAG_VALUE. - a string containing the value of the "etag:value" attribute. @@ -39069,7 +37397,6 @@ G_FILE_ATTRIBUTE_TRASH_DELETION_DATE attribute is unset, %NULL is returned. Gets a file's type (whether it is a regular file, symlink, etc). This is different from the file's content type, see g_file_info_get_content_type(). - a #GFileType for the given file. @@ -39083,7 +37410,6 @@ This is different from the file's content type, see g_file_info_get_content_type Gets the icon for a file. - #GIcon for the given @info. @@ -39097,7 +37423,6 @@ This is different from the file's content type, see g_file_info_get_content_type Checks if a file is a backup file. - %TRUE if file is a backup file, %FALSE otherwise. @@ -39111,7 +37436,6 @@ This is different from the file's content type, see g_file_info_get_content_type Checks if a file is hidden. - %TRUE if the file is a hidden file, %FALSE otherwise. @@ -39125,7 +37449,6 @@ This is different from the file's content type, see g_file_info_get_content_type Checks if a file is a symlink. - %TRUE if the given @info is a symlink. @@ -39144,7 +37467,6 @@ This is different from the file's content type, see g_file_info_get_content_type This requires the %G_FILE_ATTRIBUTE_TIME_MODIFIED attribute. If %G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC is provided, the resulting #GDateTime will have microsecond precision. - modification time, or %NULL if unknown @@ -39161,7 +37483,6 @@ will have microsecond precision. in @result. Use g_file_info_get_modification_date_time() instead, as #GTimeVal is deprecated due to the year 2038 problem. - @@ -39178,7 +37499,6 @@ in @result. Gets the name for a file. This is guaranteed to always be set. - a string containing the file name. @@ -39192,7 +37512,6 @@ in @result. Gets the file's size. - a #goffset containing the file's size. @@ -39207,7 +37526,6 @@ in @result. Gets the value of the sort_order attribute from the #GFileInfo. See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. - a #gint32 containing the value of the "standard::sort_order" attribute. @@ -39221,7 +37539,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. Gets the symbolic icon for a file. - #GIcon for the given @info. @@ -39235,7 +37552,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. Gets the symlink target for a given #GFileInfo. - a string containing the symlink target. @@ -39249,7 +37565,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. Checks if a file info structure has an attribute named @attribute. - %TRUE if @info has an attribute named @attribute, %FALSE otherwise. @@ -39269,7 +37584,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. Checks if a file info structure has an attribute in the specified @name_space. - %TRUE if @info has an attribute in @name_space, %FALSE otherwise. @@ -39288,7 +37602,6 @@ specified @name_space. Lists the file info structure's attributes. - a null-terminated array of strings of all of the possible attribute @@ -39311,7 +37624,6 @@ types for the given @name_space, or %NULL on error. Removes all cases of @attribute from @info if it exists. - @@ -39329,7 +37641,6 @@ types for the given @name_space, or %NULL on error. Sets the @attribute to contain the given value, if possible. To unset the attribute, use %G_FILE_ATTRIBUTE_TYPE_INVALID for @type. - @@ -39355,7 +37666,6 @@ attribute, use %G_FILE_ATTRIBUTE_TYPE_INVALID for @type. Sets the @attribute to contain the given @attr_value, if possible. - @@ -39377,7 +37687,6 @@ if possible. Sets the @attribute to contain the given @attr_value, if possible. - @@ -39399,7 +37708,6 @@ if possible. Sets the @attribute to contain the given @attr_value, if possible. - @@ -39421,7 +37729,6 @@ if possible. Sets the @attribute to contain the given @attr_value, if possible. - @@ -39442,7 +37749,6 @@ if possible. Sets @mask on @info to match specific attribute types. - @@ -39460,7 +37766,6 @@ if possible. Sets the @attribute to contain the given @attr_value, if possible. - @@ -39486,7 +37791,6 @@ or similar functions. The attribute must exist in @info for this to work. Otherwise %FALSE is returned and @info is unchanged. - %TRUE if the status was changed, %FALSE if the key was not set. @@ -39509,7 +37813,6 @@ is returned and @info is unchanged. Sets the @attribute to contain the given @attr_value, if possible. - @@ -39533,7 +37836,6 @@ if possible. if possible. Sinze: 2.22 - @@ -39558,7 +37860,6 @@ Sinze: 2.22 Sets the @attribute to contain the given @attr_value, if possible. - @@ -39580,7 +37881,6 @@ if possible. Sets the @attribute to contain the given @attr_value, if possible. - @@ -39602,7 +37902,6 @@ if possible. Sets the content type attribute for a given #GFileInfo. See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE. - @@ -39620,7 +37919,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE. Sets the display name for the current #GFileInfo. See %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME. - @@ -39638,7 +37936,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME. Sets the edit name for the current file. See %G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME. - @@ -39656,7 +37953,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME. Sets the file type in a #GFileInfo to @type. See %G_FILE_ATTRIBUTE_STANDARD_TYPE. - @@ -39674,7 +37970,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_TYPE. Sets the icon for a given #GFileInfo. See %G_FILE_ATTRIBUTE_STANDARD_ICON. - @@ -39692,7 +37987,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_ICON. Sets the "is_hidden" attribute in a #GFileInfo according to @is_hidden. See %G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN. - @@ -39710,7 +38004,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN. Sets the "is_symlink" attribute in a #GFileInfo according to @is_symlink. See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK. - @@ -39729,7 +38022,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK. Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED and %G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC attributes in the file info to the given date/time value. - @@ -39750,7 +38042,6 @@ given date/time value. given time value. Use g_file_info_set_modification_date_time() instead, as #GTimeVal is deprecated due to the year 2038 problem. - @@ -39768,7 +38059,6 @@ given time value. Sets the name attribute for the current #GFileInfo. See %G_FILE_ATTRIBUTE_STANDARD_NAME. - @@ -39786,7 +38076,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_NAME. Sets the %G_FILE_ATTRIBUTE_STANDARD_SIZE attribute in the file info to the given size. - @@ -39804,7 +38093,6 @@ to the given size. Sets the sort order attribute in the file info structure. See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. - @@ -39822,7 +38110,6 @@ to the given size. Sets the symbolic icon for a given #GFileInfo. See %G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON. - @@ -39840,7 +38127,6 @@ See %G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON. Sets the %G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET attribute in the file info to the given symlink target. - @@ -39858,7 +38144,6 @@ to the given symlink target. Unsets a mask set by g_file_info_set_attribute_mask(), if one is set. - @@ -39883,10 +38168,8 @@ filesystem of the file allows it. To find the position of a file input stream, use g_seekable_tell(). To find out if a file input stream supports seeking, use g_seekable_can_seek(). To position a file input stream, use g_seekable_seek(). - - @@ -39902,7 +38185,6 @@ while querying the stream. For the asynchronous (non-blocking) version of this function, see g_file_input_stream_query_info_async(). While the stream is blocked, the stream will set the pending flag internally, and any other operations on the stream will fail with %G_IO_ERROR_PENDING. - a #GFileInfo, or %NULL on error. @@ -39934,7 +38216,6 @@ see g_file_input_stream_query_info(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -39967,7 +38248,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set Finishes an asynchronous info query operation. - #GFileInfo. @@ -39984,7 +38264,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40004,7 +38283,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40020,7 +38298,6 @@ while querying the stream. For the asynchronous (non-blocking) version of this function, see g_file_input_stream_query_info_async(). While the stream is blocked, the stream will set the pending flag internally, and any other operations on the stream will fail with %G_IO_ERROR_PENDING. - a #GFileInfo, or %NULL on error. @@ -40052,7 +38329,6 @@ see g_file_input_stream_query_info(). If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40085,7 +38361,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set Finishes an asynchronous info query operation. - #GFileInfo. @@ -40109,13 +38384,11 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - - @@ -40128,7 +38401,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40141,7 +38413,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40163,7 +38434,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - a #GFileInfo, or %NULL on error. @@ -40186,7 +38456,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40220,7 +38489,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - #GFileInfo. @@ -40239,7 +38507,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40247,7 +38514,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40255,7 +38521,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40263,7 +38528,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40271,7 +38535,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be set - @@ -40330,7 +38593,6 @@ ideally about once every 200ms. The last progress callback may or may not be equal to the final result. Always check the async result to get the final value. - @@ -40372,10 +38634,8 @@ of the thread that the monitor was created in (though if the global default main context is blocked, this may cause notifications to be blocked even if the thread-default context is still running). - Cancels a file monitor. - always %TRUE @@ -40388,7 +38648,6 @@ context is still running). - @@ -40409,7 +38668,6 @@ context is still running). Cancels a file monitor. - always %TRUE @@ -40429,7 +38687,6 @@ implementations only. Implementations are responsible to call this method from the [thread-default main context][g-main-context-push-thread-default] of the thread that the monitor was created in. - @@ -40454,7 +38711,6 @@ thread that the monitor was created in. Returns whether the monitor is canceled. - %TRUE if monitor is canceled. %FALSE otherwise. @@ -40469,7 +38725,6 @@ thread that the monitor was created in. Sets the rate limit to which the @monitor will report consecutive change events to the same file. - @@ -40546,13 +38801,11 @@ In all the other cases, @other_file will be set to #NULL. - - @@ -40574,7 +38827,6 @@ In all the other cases, @other_file will be set to #NULL. - always %TRUE @@ -40589,7 +38841,6 @@ In all the other cases, @other_file will be set to #NULL. - @@ -40597,7 +38848,6 @@ In all the other cases, @other_file will be set to #NULL. - @@ -40605,7 +38855,6 @@ In all the other cases, @other_file will be set to #NULL. - @@ -40613,7 +38862,6 @@ In all the other cases, @other_file will be set to #NULL. - @@ -40621,7 +38869,6 @@ In all the other cases, @other_file will be set to #NULL. - @@ -40716,10 +38963,8 @@ g_seekable_can_seek().To position a file output stream, use g_seekable_seek(). To find out if a file output stream supports truncating, use g_seekable_can_truncate(). To truncate a file output stream, use g_seekable_truncate(). - - @@ -40730,7 +38975,6 @@ stream, use g_seekable_truncate(). - @@ -40744,7 +38988,6 @@ stream, use g_seekable_truncate(). Gets the entity tag for the file when it has been written. This must be called after the stream has been written and closed, as the etag can change while writing. - the entity tag for the stream. @@ -40774,7 +39017,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will be returned. - a #GFileInfo for the @stream, or %NULL on error. @@ -40801,7 +39043,6 @@ finish the operation with g_file_output_stream_query_info_finish(). For the synchronous version of this function, see g_file_output_stream_query_info(). - @@ -40835,7 +39076,6 @@ g_file_output_stream_query_info(). Finalizes the asynchronous query started by g_file_output_stream_query_info_async(). - A #GFileInfo for the finished query. @@ -40852,7 +39092,6 @@ by g_file_output_stream_query_info_async(). - @@ -40872,7 +39111,6 @@ by g_file_output_stream_query_info_async(). - @@ -40883,7 +39121,6 @@ by g_file_output_stream_query_info_async(). - @@ -40903,7 +39140,6 @@ by g_file_output_stream_query_info_async(). Gets the entity tag for the file when it has been written. This must be called after the stream has been written and closed, as the etag can change while writing. - the entity tag for the stream. @@ -40933,7 +39169,6 @@ If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will be returned. - a #GFileInfo for the @stream, or %NULL on error. @@ -40960,7 +39195,6 @@ finish the operation with g_file_output_stream_query_info_finish(). For the synchronous version of this function, see g_file_output_stream_query_info(). - @@ -40994,7 +39228,6 @@ g_file_output_stream_query_info(). Finalizes the asynchronous query started by g_file_output_stream_query_info_async(). - A #GFileInfo for the finished query. @@ -41018,13 +39251,11 @@ by g_file_output_stream_query_info_async(). - - @@ -41037,7 +39268,6 @@ by g_file_output_stream_query_info_async(). - @@ -41050,7 +39280,6 @@ by g_file_output_stream_query_info_async(). - @@ -41072,7 +39301,6 @@ by g_file_output_stream_query_info_async(). - @@ -41085,7 +39313,6 @@ by g_file_output_stream_query_info_async(). - @@ -41104,7 +39331,6 @@ by g_file_output_stream_query_info_async(). - a #GFileInfo for the @stream, or %NULL on error. @@ -41127,7 +39353,6 @@ by g_file_output_stream_query_info_async(). - @@ -41161,7 +39386,6 @@ by g_file_output_stream_query_info_async(). - A #GFileInfo for the finished query. @@ -41180,7 +39404,6 @@ by g_file_output_stream_query_info_async(). - the entity tag for the stream. @@ -41195,7 +39418,6 @@ by g_file_output_stream_query_info_async(). - @@ -41203,7 +39425,6 @@ by g_file_output_stream_query_info_async(). - @@ -41211,7 +39432,6 @@ by g_file_output_stream_query_info_async(). - @@ -41219,7 +39439,6 @@ by g_file_output_stream_query_info_async(). - @@ -41227,7 +39446,6 @@ by g_file_output_stream_query_info_async(). - @@ -41241,7 +39459,6 @@ by g_file_output_stream_query_info_async(). When doing file operations that may take a while, such as moving a file or copying a file, a progress callback is used to pass how far along that operation is to the application. - @@ -41274,7 +39491,6 @@ far along that operation is to the application. it may become necessary to determine if any more data from the file should be loaded. A #GFileReadMoreCallback function facilitates this by returning %TRUE if more data should be read, or %FALSE otherwise. - %TRUE if more data should be read back. %FALSE otherwise. @@ -41333,17 +39549,14 @@ which is why all Windows symlinks will continue to be reported as Completes partial file and directory names given a partial string by looking in the file system for clues. Can return a list of possible completion strings for widget implementations. - Creates a new filename completer. - a #GFilenameCompleter. - @@ -41355,7 +39568,6 @@ completion strings for widget implementations. Obtains a completion for @initial_text from @completer. - a completed string, or %NULL if no completion exists. This string is not owned by GIO, so remember to g_free() it @@ -41375,7 +39587,6 @@ completion strings for widget implementations. Gets an array of completion strings for a given initial text. - array of strings with possible completions for @initial_text. This array must be freed by g_strfreev() when finished. @@ -41397,7 +39608,6 @@ This array must be freed by g_strfreev() when finished. If @dirs_only is %TRUE, @completer will only complete directory names, and not file names. - @@ -41420,13 +39630,11 @@ complete directory names, and not file names. - - @@ -41439,7 +39647,6 @@ complete directory names, and not file names. - @@ -41447,7 +39654,6 @@ complete directory names, and not file names. - @@ -41455,7 +39661,6 @@ complete directory names, and not file names. - @@ -41481,10 +39686,8 @@ previewed in a file manager. Returned as the value of the key kind of filtering operation on a base stream. Typical examples of filtering operations are character set conversion, compression and byte order flipping. - Gets the base stream for the filter stream. - a #GInputStream. @@ -41499,7 +39702,6 @@ and byte order flipping. Returns whether the base stream will be closed when @stream is closed. - %TRUE if the base stream will be closed. @@ -41513,7 +39715,6 @@ closed. Sets whether the base stream will be closed when @stream is closed. - @@ -41542,13 +39743,11 @@ closed. - - @@ -41556,7 +39755,6 @@ closed. - @@ -41564,7 +39762,6 @@ closed. - @@ -41576,10 +39773,8 @@ closed. kind of filtering operation on a base stream. Typical examples of filtering operations are character set conversion, compression and byte order flipping. - Gets the base stream for the filter stream. - a #GOutputStream. @@ -41594,7 +39789,6 @@ and byte order flipping. Returns whether the base stream will be closed when @stream is closed. - %TRUE if the base stream will be closed. @@ -41608,7 +39802,6 @@ closed. Sets whether the base stream will be closed when @stream is closed. - @@ -41637,13 +39830,11 @@ closed. - - @@ -41651,7 +39842,6 @@ closed. - @@ -41659,7 +39849,6 @@ closed. - @@ -41667,112 +39856,96 @@ closed. - - - - - - - - - - - - - - - - @@ -41958,13 +40131,11 @@ See also #GPollableReturn for a cheaper way of returning #GIOExtension is an opaque data structure and can only be accessed using the following functions. - Gets the name under which @extension was registered. Note that the same type may be registered as extension for multiple extension points, under different names. - the name of @extension. @@ -41978,7 +40149,6 @@ for multiple extension points, under different names. Gets the priority with which @extension was registered. - the priority of @extension @@ -41992,7 +40162,6 @@ for multiple extension points, under different names. Gets the type associated with @extension. - the type of @extension @@ -42007,7 +40176,6 @@ for multiple extension points, under different names. Gets a reference to the class for the type that is associated with @extension. - the #GTypeClass for the type of @extension @@ -42023,10 +40191,8 @@ associated with @extension. #GIOExtensionPoint is an opaque data structure and can only be accessed using the following functions. - Finds a #GIOExtension for an extension point by name. - the #GIOExtension for @extension_point that has the given name, or %NULL if there is no extension with that name @@ -42046,7 +40212,6 @@ using the following functions. Gets a list of all extensions that implement this extension point. The list is sorted by priority, beginning with the highest priority. - a #GList of #GIOExtensions. The list is owned by GIO and should not be @@ -42064,7 +40229,6 @@ The list is sorted by priority, beginning with the highest priority. Gets the required type for @extension_point. - the #GType that all implementations must have, or #G_TYPE_INVALID if the extension point has no required type @@ -42080,7 +40244,6 @@ The list is sorted by priority, beginning with the highest priority. Sets the required type for @extension_point to @type. All implementations must henceforth have this type. - @@ -42101,7 +40264,6 @@ All implementations must henceforth have this type. If @type has already been registered as an extension for this extension point, the existing #GIOExtension object is returned. - a #GIOExtension object for #GType @@ -42127,7 +40289,6 @@ extension point, the existing #GIOExtension object is returned. Looks up an existing extension point. - the #GIOExtensionPoint, or %NULL if there is no registered extension point with the given name. @@ -42142,7 +40303,6 @@ extension point, the existing #GIOExtension object is returned. Registers an extension point. - the new #GIOExtensionPoint. This object is owned by GIO and should not be freed. @@ -42160,12 +40320,10 @@ extension point, the existing #GIOExtension object is returned. Provides an interface and default functions for loading and unloading modules. This is used internally to make GIO extensible, but can also be used by others to implement module loading. - Creates a new GIOModule that will load the specific shared library when in use. - a #GIOModule from given @filename, or %NULL on error. @@ -42210,7 +40368,6 @@ throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`. Using the new symbol names avoids name clashes when building modules statically. The old symbol names continue to be supported, but cannot be used for static builds. - A %NULL-terminated array of strings, listing the supported extension points of the module. The array @@ -42234,7 +40391,6 @@ throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`. Using the new symbol names avoids name clashes when building modules statically. The old symbol names continue to be supported, but cannot be used for static builds. - @@ -42258,7 +40414,6 @@ throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`. Using the new symbol names avoids name clashes when building modules statically. The old symbol names continue to be supported, but cannot be used for static builds. - @@ -42279,12 +40434,10 @@ duplicate modules, or blocking a module you don't want to load. The scope can be used with g_io_modules_load_all_in_directory_with_scope() or g_io_modules_scan_all_in_directory_with_scope(). - Block modules with the given @basename from being loaded when this scope is used with g_io_modules_scan_all_in_directory_with_scope() or g_io_modules_load_all_in_directory_with_scope(). - @@ -42301,7 +40454,6 @@ or g_io_modules_load_all_in_directory_with_scope(). Free a module scope. - @@ -42319,7 +40471,6 @@ blocking duplicate modules, or blocking a module you don't want to load. Specify the %G_IO_MODULE_SCOPE_BLOCK_DUPLICATES flag to block modules which have the same base name as a module that has already been seen in this scope. - the new module scope @@ -42345,13 +40496,11 @@ in this scope. Opaque class for defining and scheduling IO jobs. - Used from an I/O job to send a callback to be run in the thread that the job was started from, waiting for the result (and thus blocking the I/O job). Use g_main_context_invoke(). - The return value of @func @@ -42386,7 +40535,6 @@ on to this function you have to ensure that it is not freed before @func is called, either by passing %NULL as @notify to g_io_scheduler_push_job() or by using refcounting for @user_data. Use g_main_context_invoke(). - @@ -42415,7 +40563,6 @@ g_io_scheduler_push_job() or by using refcounting for @user_data. Long-running jobs should periodically check the @cancellable to see if they have been cancelled. - %TRUE if this function should be called again to complete the job, %FALSE if the job is complete (or cancelled) @@ -42483,10 +40630,8 @@ application code may only run operations on the base (wrapped) stream when the wrapper stream is idle. Note that the semantics of such operations may not be well-defined due to the state the wrapper stream leaves the base stream in (though they are guaranteed not to crash). - Finishes an asynchronous io stream splice operation. - %TRUE on success, %FALSE otherwise. @@ -42509,7 +40654,6 @@ For behaviour details see g_io_stream_close(). The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -42538,7 +40682,6 @@ classes. However, if you override one you must override all. Closes a stream. - %TRUE if stream was successfully closed, %FALSE otherwise. @@ -42555,7 +40698,6 @@ classes. However, if you override one you must override all. - @@ -42571,7 +40713,6 @@ classes. However, if you override one you must override all. Gets the input stream for this object. This is used for reading. - a #GInputStream, owned by the #GIOStream. Do not free. @@ -42587,7 +40728,6 @@ Do not free. Gets the output stream for this object. This is used for writing. - a #GOutputStream, owned by the #GIOStream. Do not free. @@ -42602,7 +40742,6 @@ Do not free. Clears the pending flag on @stream. - @@ -42647,7 +40786,6 @@ can use a faster close that doesn't block to e.g. check errors. The default implementation of this method just calls close on the individual input/output streams. - %TRUE on success, %FALSE on failure @@ -42674,7 +40812,6 @@ For behaviour details see g_io_stream_close(). The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -42703,7 +40840,6 @@ classes. However, if you override one you must override all. Closes a stream. - %TRUE if stream was successfully closed, %FALSE otherwise. @@ -42722,7 +40858,6 @@ classes. However, if you override one you must override all. Gets the input stream for this object. This is used for reading. - a #GInputStream, owned by the #GIOStream. Do not free. @@ -42738,7 +40873,6 @@ Do not free. Gets the output stream for this object. This is used for writing. - a #GOutputStream, owned by the #GIOStream. Do not free. @@ -42753,7 +40887,6 @@ Do not free. Checks if a stream has pending actions. - %TRUE if @stream has pending actions. @@ -42767,7 +40900,6 @@ Do not free. Checks if a stream is closed. - %TRUE if the stream is closed. @@ -42783,7 +40915,6 @@ Do not free. Sets @stream to have actions pending. If the pending flag is already set or @stream is closed, it will return %FALSE and set @error. - %TRUE if pending was previously unset and is now set. @@ -42803,7 +40934,6 @@ already set or @stream is closed, it will return %FALSE and set When the operation is finished @callback will be called. You can then call g_io_stream_splice_finish() to get the result of the operation. - @@ -42858,13 +40988,11 @@ result of the operation. - - a #GInputStream, owned by the #GIOStream. Do not free. @@ -42880,7 +41008,6 @@ Do not free. - a #GOutputStream, owned by the #GIOStream. Do not free. @@ -42896,7 +41023,6 @@ Do not free. - @@ -42912,7 +41038,6 @@ Do not free. - @@ -42942,7 +41067,6 @@ Do not free. - %TRUE if stream was successfully closed, %FALSE otherwise. @@ -42961,7 +41085,6 @@ Do not free. - @@ -42969,7 +41092,6 @@ Do not free. - @@ -42977,7 +41099,6 @@ Do not free. - @@ -42985,7 +41106,6 @@ Do not free. - @@ -42993,7 +41113,6 @@ Do not free. - @@ -43001,7 +41120,6 @@ Do not free. - @@ -43009,7 +41127,6 @@ Do not free. - @@ -43017,7 +41134,6 @@ Do not free. - @@ -43025,7 +41141,6 @@ Do not free. - @@ -43033,7 +41148,6 @@ Do not free. - @@ -43062,1652 +41176,1416 @@ Do not free. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -44742,10 +42620,8 @@ implements #GLoadableIcon. Additionally, you must provide an implementation of g_icon_serialize() that gives a result that is understood by g_icon_deserialize(), yielding one of the built-in icon types. - Deserializes a #GIcon previously serialized using g_icon_serialize(). - a #GIcon, or %NULL when deserialization fails. @@ -44759,7 +42635,6 @@ types. Gets a hash for an icon. - a #guint containing a hash for the @icon, suitable for use in a #GHashTable or similar data structure. @@ -44779,7 +42654,6 @@ use in a #GHashTable or similar data structure. If your application or library provides one or more #GIcon implementations you need to ensure that each #GType is registered with the type system prior to calling g_icon_new_for_string(). - An object implementing the #GIcon interface or %NULL if @error is set. @@ -44794,7 +42668,6 @@ with the type system prior to calling g_icon_new_for_string(). Checks if two icons are equal. - %TRUE if @icon1 is equal to @icon2. %FALSE otherwise. @@ -44812,7 +42685,6 @@ with the type system prior to calling g_icon_new_for_string(). Gets a hash for an icon. - a #guint containing a hash for the @icon, suitable for use in a #GHashTable or similar data structure. @@ -44831,7 +42703,6 @@ back by calling g_icon_deserialize() on the returned value. As serialization will avoid using raw icon data when possible, it only makes sense to transfer the #GVariant between processes on the same machine, (as opposed to over the network), and within the same file system namespace. - a #GVariant, or %NULL when serialization fails. The #GVariant will not be floating. @@ -44860,7 +42731,6 @@ in the following two cases - If @icon is a #GThemedIcon with exactly one name and no fallbacks, the encoding is simply the name (such as `network-server`). - An allocated NUL-terminated UTF8 string or %NULL if @icon can't be serialized. Use g_free() to free. @@ -44883,7 +42753,6 @@ in the following two cases Checks if two icons are equal. - %TRUE if @icon1 is equal to @icon2. %FALSE otherwise. @@ -44905,7 +42774,6 @@ back by calling g_icon_deserialize() on the returned value. As serialization will avoid using raw icon data when possible, it only makes sense to transfer the #GVariant between processes on the same machine, (as opposed to over the network), and within the same file system namespace. - a #GVariant, or %NULL when serialization fails. The #GVariant will not be floating. @@ -44934,7 +42802,6 @@ in the following two cases - If @icon is a #GThemedIcon with exactly one name and no fallbacks, the encoding is simply the name (such as `network-server`). - An allocated NUL-terminated UTF8 string or %NULL if @icon can't be serialized. Use g_free() to free. @@ -44952,14 +42819,12 @@ in the following two cases GIconIface is used to implement GIcon types for various different systems. See #GThemedIcon and #GLoadableIcon for examples of how to implement this interface. - The parent interface. - a #guint containing a hash for the @icon, suitable for use in a #GHashTable or similar data structure. @@ -44975,7 +42840,6 @@ use in a #GHashTable or similar data structure. - %TRUE if @icon1 is equal to @icon2. %FALSE otherwise. @@ -44994,7 +42858,6 @@ use in a #GHashTable or similar data structure. - An allocated NUL-terminated UTF8 string or %NULL if @icon can't be serialized. Use g_free() to free. @@ -45018,7 +42881,6 @@ use in a #GHashTable or similar data structure. - @@ -45037,7 +42899,6 @@ use in a #GHashTable or similar data structure. - a #GVariant, or %NULL when serialization fails. The #GVariant will not be floating. @@ -45062,11 +42923,9 @@ g_resolver_lookup_by_address_async() to look up the hostname for a To actually connect to a remote host, you will need a #GInetSocketAddress (which includes a #GInetAddress as well as a port number). - Creates a #GInetAddress for the "any" address (unassigned/"don't care") for @family. - a new #GInetAddress corresponding to the "any" address for @family. @@ -45084,7 +42943,6 @@ for @family. Creates a new #GInetAddress from the given @family and @bytes. @bytes should be 4 bytes for %G_SOCKET_FAMILY_IPV4 and 16 bytes for %G_SOCKET_FAMILY_IPV6. - a new #GInetAddress corresponding to @family and @bytes. Free the returned object with g_object_unref(). @@ -45105,7 +42963,6 @@ for @family. Parses @string as an IP address and creates a new #GInetAddress. - a new #GInetAddress corresponding to @string, or %NULL if @string could not be parsed. @@ -45121,7 +42978,6 @@ to @string, or %NULL if @string could not be parsed. Creates a #GInetAddress for the loopback address for @family. - a new #GInetAddress corresponding to the loopback address for @family. @@ -45137,7 +42993,6 @@ for @family. Gets the raw binary address data from @address. - a pointer to an internal array of the bytes in @address, which should not be modified, stored, or freed. The size of this @@ -45153,7 +43008,6 @@ array can be gotten with g_inet_address_get_native_size(). Converts @address to string form. - a representation of @address as a string, which should be freed after use. @@ -45168,7 +43022,6 @@ freed after use. Checks if two #GInetAddress instances are equal, e.g. the same address. - %TRUE if @address and @other_address are equal, %FALSE otherwise. @@ -45186,7 +43039,6 @@ freed after use. Gets @address's family - @address's family @@ -45200,7 +43052,6 @@ freed after use. Tests whether @address is the "any" address for its family. - %TRUE if @address is the "any" address for its family. @@ -45216,7 +43067,6 @@ freed after use. Tests whether @address is a link-local address (that is, if it identifies a host on a local network that is not connected to the Internet). - %TRUE if @address is a link-local address. @@ -45230,7 +43080,6 @@ Internet). Tests whether @address is the loopback address for its family. - %TRUE if @address is the loopback address for its family. @@ -45244,7 +43093,6 @@ Internet). Tests whether @address is a global multicast address. - %TRUE if @address is a global multicast address. @@ -45258,7 +43106,6 @@ Internet). Tests whether @address is a link-local multicast address. - %TRUE if @address is a link-local multicast address. @@ -45272,7 +43119,6 @@ Internet). Tests whether @address is a node-local multicast address. - %TRUE if @address is a node-local multicast address. @@ -45286,7 +43132,6 @@ Internet). Tests whether @address is an organization-local multicast address. - %TRUE if @address is an organization-local multicast address. @@ -45300,7 +43145,6 @@ Internet). Tests whether @address is a site-local multicast address. - %TRUE if @address is a site-local multicast address. @@ -45314,7 +43158,6 @@ Internet). Tests whether @address is a multicast address. - %TRUE if @address is a multicast address. @@ -45331,7 +43174,6 @@ Internet). (that is, the address identifies a host on a local network that can not be reached directly from the Internet, but which may have outgoing Internet connectivity via a NAT or firewall). - %TRUE if @address is a site-local address. @@ -45346,7 +43188,6 @@ outgoing Internet connectivity via a NAT or firewall). Gets the size of the native raw binary address for @address. This is the size of the data that you get from g_inet_address_to_bytes(). - the number of bytes used for the native version of @address. @@ -45360,7 +43201,6 @@ is the size of the data that you get from g_inet_address_to_bytes(). Gets the raw binary address data from @address. - a pointer to an internal array of the bytes in @address, which should not be modified, stored, or freed. The size of this @@ -45376,7 +43216,6 @@ array can be gotten with g_inet_address_get_native_size(). Converts @address to string form. - a representation of @address as a string, which should be freed after use. @@ -45453,13 +43292,11 @@ See g_inet_address_get_is_loopback(). - - a representation of @address as a string, which should be freed after use. @@ -45475,7 +43312,6 @@ freed after use. - a pointer to an internal array of the bytes in @address, which should not be modified, stored, or freed. The size of this @@ -45496,12 +43332,10 @@ array can be gotten with g_inet_address_get_native_size(). described by a base address and a length indicating how many bits of the base address are relevant for matching purposes. These are often given in string form. Eg, "10.0.0.0/8", or "fe80::/10". - Creates a new #GInetAddressMask representing all addresses whose first @length bits match @addr. - a new #GInetAddressMask, or %NULL on error @@ -45522,7 +43356,6 @@ first @length bits match @addr. creates a new #GInetAddressMask. The length, if present, is delimited by a "/". If it is not present, then the length is assumed to be the full length of the address. - a new #GInetAddressMask corresponding to @string, or %NULL on error. @@ -45537,7 +43370,6 @@ on error. Tests if @mask and @mask2 are the same mask. - whether @mask and @mask2 are the same mask @@ -45555,7 +43387,6 @@ on error. Gets @mask's base address - @mask's base address @@ -45569,7 +43400,6 @@ on error. Gets the #GSocketFamily of @mask's address - the #GSocketFamily of @mask's address @@ -45583,7 +43413,6 @@ on error. Gets @mask's length - @mask's length @@ -45597,7 +43426,6 @@ on error. Tests if @address falls within the range described by @mask. - whether @address falls within the range described by @mask. @@ -45616,7 +43444,6 @@ on error. Converts @mask back to its corresponding string form. - a string corresponding to @mask. @@ -45645,7 +43472,6 @@ on error. - @@ -45659,11 +43485,9 @@ on error. An IPv4 or IPv6 socket address; that is, the combination of a #GInetAddress and a port number. - Creates a new #GInetSocketAddress for @address and @port. - a new #GInetSocketAddress @@ -45684,7 +43508,6 @@ on error. If @address is an IPv6 address, it can also contain a scope ID (separated from the address by a `%`). - a new #GInetSocketAddress, or %NULL if @address cannot be parsed. @@ -45703,7 +43526,6 @@ or %NULL if @address cannot be parsed. Gets @address's #GInetAddress. - the #GInetAddress for @address, which must be g_object_ref()'d if it will be stored @@ -45719,7 +43541,6 @@ g_object_ref()'d if it will be stored Gets the `sin6_flowinfo` field from @address, which must be an IPv6 address. - the flowinfo field @@ -45733,7 +43554,6 @@ which must be an IPv6 address. Gets @address's port. - the port for @address @@ -45748,7 +43568,6 @@ which must be an IPv6 address. Gets the `sin6_scope_id` field from @address, which must be an IPv6 address. - the scope id field @@ -45781,7 +43600,6 @@ which must be an IPv6 address. - @@ -45814,12 +43632,10 @@ For bindings in languages where the native constructor supports exceptions the binding could check for objects implementing %GInitable during normal construction and automatically initialize them, throwing an exception on failure. - Helper function for constructing #GInitable object. This is similar to g_object_new() but also initializes the object and returns %NULL, setting an error on failure. - a newly allocated #GObject, or %NULL on error @@ -45855,7 +43671,6 @@ and returns %NULL, setting an error on failure. Helper function for constructing #GInitable object. This is similar to g_object_new_valist() but also initializes the object and returns %NULL, setting an error on failure. - a newly allocated #GObject, or %NULL on error @@ -45887,7 +43702,6 @@ similar to g_object_newv() but also initializes the object and returns %NULL, setting an error on failure. Use g_object_new_with_properties() and g_initable_init() instead. See #GParameter for more information. - a newly allocated #GObject, or %NULL on error @@ -45953,7 +43767,6 @@ it is designed to be used via the singleton pattern, with a In this pattern, a caller would expect to be able to call g_initable_init() on the result of g_object_new(), regardless of whether it is in fact a new instance. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error appropriately if present. @@ -46009,7 +43822,6 @@ it is designed to be used via the singleton pattern, with a In this pattern, a caller would expect to be able to call g_initable_init() on the result of g_object_new(), regardless of whether it is in fact a new instance. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error appropriately if present. @@ -46030,14 +43842,12 @@ instance. Provides an interface for initializing object such that initialization may fail. - The parent interface. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error appropriately if present. @@ -46076,7 +43886,6 @@ this array, which may be zero. Flags relevant to this message will be returned in @flags. For example, `MSG_EOR` or `MSG_TRUNC`. - return location for a #GSocketAddress, or %NULL @@ -46128,7 +43937,6 @@ See the documentation for #GIOStream for details of thread safety of streaming APIs. All of these functions have async variants too. - Requests an asynchronous closes of the stream, releasing resources related to it. When the operation is finished @callback will be called. @@ -46140,7 +43948,6 @@ For behaviour details see g_input_stream_close(). The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -46169,7 +43976,6 @@ override one you must override all. Finishes closing a stream asynchronously, started from g_input_stream_close_async(). - %TRUE if the stream was closed successfully. @@ -46186,7 +43992,6 @@ override one you must override all. - @@ -46223,7 +44028,6 @@ priority is %G_PRIORITY_DEFAULT. The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -46264,7 +44068,6 @@ of the request. Finishes an asynchronous stream read operation. - number of bytes read in, or -1 on error, or 0 on end of file. @@ -46281,7 +44084,6 @@ of the request. - @@ -46315,7 +44117,6 @@ triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an operation was partially finished when the operation was cancelled the partial result will be returned, without an error. - Number of bytes skipped, or -1 on error @@ -46359,7 +44160,6 @@ Default priority is %G_PRIORITY_DEFAULT. The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one, you must override all. - @@ -46392,7 +44192,6 @@ However, if you override one, you must override all. Finishes a stream skip operation. - the size of the bytes skipped, or `-1` on error. @@ -46410,7 +44209,6 @@ However, if you override one, you must override all. Clears the pending flag on @stream. - @@ -46445,7 +44243,6 @@ triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Cancelling a close will still leave the stream closed, but some streams can use a faster close that doesn't block to e.g. check errors. - %TRUE on success, %FALSE on failure @@ -46472,7 +44269,6 @@ For behaviour details see g_input_stream_close(). The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -46501,7 +44297,6 @@ override one you must override all. Finishes closing a stream asynchronously, started from g_input_stream_close_async(). - %TRUE if the stream was closed successfully. @@ -46519,7 +44314,6 @@ override one you must override all. Checks if an input stream has pending actions. - %TRUE if @stream has pending actions. @@ -46533,7 +44327,6 @@ override one you must override all. Checks if an input stream is closed. - %TRUE if the stream is closed. @@ -46567,7 +44360,6 @@ operation was partially finished when the operation was cancelled the partial result will be returned, without an error. On error -1 is returned and @error is set accordingly. - Number of bytes read, or -1 on error, or 0 on end of file. @@ -46614,7 +44406,6 @@ use #GError, if this function returns %FALSE (and sets @error) then read before the error was encountered. This functionality is only available from C. If you need it from another language then you must write your own loop around g_input_stream_read(). - %TRUE on success, %FALSE if there was an error @@ -46656,7 +44447,6 @@ Call g_input_stream_read_all_finish() to collect the result. Any outstanding I/O request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. Default priority is %G_PRIORITY_DEFAULT. - @@ -46704,7 +44494,6 @@ use #GError, if this function returns %FALSE (and sets @error) then read before the error was encountered. This functionality is only available from C. If you need it from another language then you must write your own loop around g_input_stream_read_async(). - %TRUE on success, %FALSE if there was an error @@ -46748,7 +44537,6 @@ priority is %G_PRIORITY_DEFAULT. The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -46811,7 +44599,6 @@ operation was partially finished when the operation was cancelled the partial result will be returned, without an error. On error %NULL is returned and @error is set accordingly. - a new #GBytes, or %NULL on error @@ -46853,7 +44640,6 @@ many bytes as requested. Zero is returned on end of file (or if Any outstanding I/O request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. Default priority is %G_PRIORITY_DEFAULT. - @@ -46886,7 +44672,6 @@ priority. Default priority is %G_PRIORITY_DEFAULT. Finishes an asynchronous stream read-into-#GBytes operation. - the newly-allocated #GBytes, or %NULL on error @@ -46904,7 +44689,6 @@ priority. Default priority is %G_PRIORITY_DEFAULT. Finishes an asynchronous stream read operation. - number of bytes read in, or -1 on error, or 0 on end of file. @@ -46924,7 +44708,6 @@ priority. Default priority is %G_PRIORITY_DEFAULT. Sets @stream to have actions pending. If the pending flag is already set or @stream is closed, it will return %FALSE and set @error. - %TRUE if pending was previously unset and is now set. @@ -46951,7 +44734,6 @@ triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an operation was partially finished when the operation was cancelled the partial result will be returned, without an error. - Number of bytes skipped, or -1 on error @@ -46995,7 +44777,6 @@ Default priority is %G_PRIORITY_DEFAULT. The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one, you must override all. - @@ -47028,7 +44809,6 @@ However, if you override one, you must override all. Finishes a stream skip operation. - the size of the bytes skipped, or `-1` on error. @@ -47052,13 +44832,11 @@ However, if you override one, you must override all. - - @@ -47080,7 +44858,6 @@ However, if you override one, you must override all. - Number of bytes skipped, or -1 on error @@ -47103,7 +44880,6 @@ However, if you override one, you must override all. - @@ -47119,7 +44895,6 @@ However, if you override one, you must override all. - @@ -47161,7 +44936,6 @@ of the request. - number of bytes read in, or -1 on error, or 0 on end of file. @@ -47180,7 +44954,6 @@ of the request. - @@ -47214,7 +44987,6 @@ of the request. - the size of the bytes skipped, or `-1` on error. @@ -47233,7 +45005,6 @@ of the request. - @@ -47263,7 +45034,6 @@ of the request. - %TRUE if the stream was closed successfully. @@ -47282,7 +45052,6 @@ of the request. - @@ -47290,7 +45059,6 @@ of the request. - @@ -47298,7 +45066,6 @@ of the request. - @@ -47306,7 +45073,6 @@ of the request. - @@ -47314,7 +45080,6 @@ of the request. - @@ -47329,7 +45094,6 @@ of the request. You generally pass in an array of #GInputVectors and the operation will store the read data starting in the first buffer, switching to the next as needed. - Pointer to a buffer where data will be written. @@ -47340,14 +45104,12 @@ first buffer, switching to the next as needed. - - @@ -47401,14 +45163,12 @@ thread in which it is appropriate to use it depends on the particular implementation, but typically it will be from the thread that owns the [thread-default main context][g-main-context-push-thread-default] in effect at the time that the model was created. - Get the item at @position. If @position is greater than the number of items in @list, %NULL is returned. %NULL is never returned for an index that is smaller than the length of the list. See g_list_model_get_n_items(). - the object at @position. @@ -47431,7 +45191,6 @@ implementation of that interface. The item type of a #GListModel can not change during the life of the model. - the #GType of the items contained in @list. @@ -47449,7 +45208,6 @@ model. Depending on the model implementation, calling this function may be less efficient than iterating the list with increasing values for @position until g_list_model_get_item() returns %NULL. - the number of items in @list. @@ -47467,7 +45225,6 @@ items in @list, %NULL is returned. %NULL is never returned for an index that is smaller than the length of the list. See g_list_model_get_n_items(). - the item at @position. @@ -47490,7 +45247,6 @@ implementation of that interface. The item type of a #GListModel can not change during the life of the model. - the #GType of the items contained in @list. @@ -47508,7 +45264,6 @@ model. Depending on the model implementation, calling this function may be less efficient than iterating the list with increasing values for @position until g_list_model_get_item() returns %NULL. - the number of items in @list. @@ -47526,7 +45281,6 @@ items in @list, %NULL is returned. %NULL is never returned for an index that is smaller than the length of the list. See g_list_model_get_n_items(). - the object at @position. @@ -47563,7 +45317,6 @@ Stated another way: in general, it is assumed that code making a series of accesses to the model via the API, without returning to the mainloop, and without calling other code, will continue to view the same contents of the model. - @@ -47614,14 +45367,12 @@ in the model change. The virtual function table for #GListModel. - parent #GTypeInterface - the #GType of the items contained in @list. @@ -47636,7 +45387,6 @@ in the model change. - the number of items in @list. @@ -47651,7 +45401,6 @@ in the model change. - the object at @position. @@ -47675,12 +45424,10 @@ items in memory. It provides insertions, deletions, and lookups in logarithmic time with a fast path for the common case of iterating the list linearly. - Creates a new #GListStore with items of type @item_type. @item_type must be a subclass of #GObject. - a new #GListStore @@ -47699,7 +45446,6 @@ This function takes a ref on @item. Use g_list_store_splice() to append multiple items at the same time efficiently. - @@ -47721,7 +45467,6 @@ not be set, and this method will return %FALSE. If you need to compare the two items with a custom comparison function, use g_list_store_find_with_equal_func() with a custom #GEqualFunc instead. - Whether @store contains @item. If it was found, @position will be set to the position where @item occurred for the first time. @@ -47747,7 +45492,6 @@ set to the position where @item occurred for the first time. comparing them with @compare_func until the first occurrence of @item which matches. If @item was not found, then @position will not be set, and this method will return %FALSE. - Whether @store contains @item. If it was found, @position will be set to the position where @item occurred for the first time. @@ -47781,7 +45525,6 @@ This function takes a ref on @item. Use g_list_store_splice() to insert multiple items at the same time efficiently. - @@ -47809,7 +45552,6 @@ result is undefined. Usually you would approach this by only ever inserting items by way of this function. This function takes a ref on @item. - the position at which @item was inserted @@ -47839,7 +45581,6 @@ smaller than the current length of the list. Use g_list_store_splice() to remove multiple items at the same time efficiently. - @@ -47856,7 +45597,6 @@ efficiently. Removes all items from @store. - @@ -47869,7 +45609,6 @@ efficiently. Sort the items in @store according to @compare_func. - @@ -47902,7 +45641,6 @@ This function takes a ref on each item in @additions. The parameters @position and @n_removals must be correct (ie: @position + @n_removals must be less than or equal to the length of the list at the time this function is called). - @@ -47938,7 +45676,6 @@ subclasses of #GObject. - @@ -47946,12 +45683,10 @@ subclasses of #GObject. Extends the #GIcon interface and adds the ability to load icons from streams. - Loads a loadable icon. For the asynchronous version of this function, see g_loadable_icon_load_async(). - a #GInputStream to read the icon from. @@ -47981,7 +45716,6 @@ ignore. Loads an icon asynchronously. To finish this function, see g_loadable_icon_load_finish(). For the synchronous, blocking version of this function, see g_loadable_icon_load(). - @@ -48011,7 +45745,6 @@ version of this function, see g_loadable_icon_load(). Finishes an asynchronous icon load started in g_loadable_icon_load_async(). - a #GInputStream to read the icon from. @@ -48035,7 +45768,6 @@ version of this function, see g_loadable_icon_load(). Loads a loadable icon. For the asynchronous version of this function, see g_loadable_icon_load_async(). - a #GInputStream to read the icon from. @@ -48065,7 +45797,6 @@ ignore. Loads an icon asynchronously. To finish this function, see g_loadable_icon_load_finish(). For the synchronous, blocking version of this function, see g_loadable_icon_load(). - @@ -48095,7 +45826,6 @@ version of this function, see g_loadable_icon_load(). Finishes an asynchronous icon load started in g_loadable_icon_load_async(). - a #GInputStream to read the icon from. @@ -48119,14 +45849,12 @@ version of this function, see g_loadable_icon_load(). Interface for icons that can be loaded as a stream. - The parent interface. - a #GInputStream to read the icon from. @@ -48155,7 +45883,6 @@ ignore. - @@ -48186,7 +45913,6 @@ ignore. - a #GInputStream to read the icon from. @@ -48210,28 +45936,24 @@ ignore. - - - - @@ -48240,39 +45962,33 @@ ignore. Extension point for memory usage monitoring functionality. See [Extending GIO][extending-gio]. - - - - - - @@ -48285,13 +46001,11 @@ action resides. For example, "win." for window-specific actions and "app." for application-wide actions. See also g_menu_model_get_item_attribute() and g_menu_item_set_attribute(). - The menu item attribute that holds the namespace for all action names in menus that are linked from this item. - @@ -48302,25 +46016,21 @@ The icon is stored in the format returned by g_icon_serialize(). This attribute is intended only to represent 'noun' icons such as favicons for a webpage, or application icons. It should not be used for 'verbs' (ie: stock icons). - - - - @@ -48328,7 +46038,6 @@ for 'verbs' (ie: stock icons). The menu item attribute which holds the label of the item. - @@ -48336,32 +46045,27 @@ for 'verbs' (ie: stock icons). will be activated. See also g_menu_item_set_action_and_target() - - - - - @@ -48373,67 +46077,57 @@ menu will usually be shown in place of the menu item, using the item's label as a header. See also g_menu_item_set_link(). - The name of the link that associates a menu item with a submenu. See also g_menu_item_set_link(). - - - - - - - - - @@ -48445,12 +46139,10 @@ memory chunks as input for GIO streaming input operations. As of GLib 2.34, #GMemoryInputStream implements #GPollableInputStream. - Creates a new empty #GMemoryInputStream. - a new #GInputStream @@ -48458,7 +46150,6 @@ As of GLib 2.34, #GMemoryInputStream implements Creates a new #GMemoryInputStream with data from the given @bytes. - new #GInputStream read from @bytes @@ -48472,7 +46163,6 @@ As of GLib 2.34, #GMemoryInputStream implements Creates a new #GMemoryInputStream with data in memory of a given size. - new #GInputStream read from @data of @len bytes. @@ -48496,7 +46186,6 @@ As of GLib 2.34, #GMemoryInputStream implements Appends @bytes to data that can be read from the input stream. - @@ -48513,7 +46202,6 @@ As of GLib 2.34, #GMemoryInputStream implements Appends @data to data that can be read from the input stream - @@ -48546,13 +46234,11 @@ As of GLib 2.34, #GMemoryInputStream implements - - @@ -48560,7 +46246,6 @@ As of GLib 2.34, #GMemoryInputStream implements - @@ -48568,7 +46253,6 @@ As of GLib 2.34, #GMemoryInputStream implements - @@ -48576,7 +46260,6 @@ As of GLib 2.34, #GMemoryInputStream implements - @@ -48584,7 +46267,6 @@ As of GLib 2.34, #GMemoryInputStream implements - @@ -48640,18 +46322,15 @@ monitor_low_memory (void) Don't forget to disconnect the #GMemoryMonitor::low-memory-warning signal, and unref the #GMemoryMonitor itself when exiting. - Gets a reference to the default #GMemoryMonitor for the system. - a new reference to the default #GMemoryMonitor - @@ -48682,14 +46361,12 @@ details. The virtual function table for #GMemoryMonitor. - The parent interface. - @@ -48735,7 +46412,6 @@ memory chunks as output for GIO streaming output operations. As of GLib 2.34, #GMemoryOutputStream trivially implements #GPollableOutputStream: it always polls as ready. - @@ -48780,7 +46456,6 @@ stream2 = g_memory_output_stream_new (NULL, 0, g_realloc, g_free); data = malloc (200); stream3 = g_memory_output_stream_new (data, 200, NULL, free); ]| - A newly created #GMemoryOutputStream object. @@ -48809,7 +46484,6 @@ stream3 = g_memory_output_stream_new (data, 200, NULL, free); Creates a new #GMemoryOutputStream, using g_realloc() and g_free() for memory allocation. - @@ -48819,7 +46493,6 @@ for memory allocation. Note that the returned pointer may become invalid on the next write or truncate operation on the stream. - pointer to the stream's data, or %NULL if the data has been stolen @@ -48835,7 +46508,6 @@ write or truncate operation on the stream. Returns the number of bytes from the start up to including the last byte written in the stream that has not been truncated away. - the number of bytes written to the stream @@ -48863,7 +46535,6 @@ stream and further writes will return %G_IO_ERROR_NO_SPACE. In any case, if you want the number of bytes currently written to the stream, use g_memory_output_stream_get_data_size(). - the number of bytes allocated for the data buffer @@ -48878,7 +46549,6 @@ stream, use g_memory_output_stream_get_data_size(). Returns data from the @ostream as a #GBytes. @ostream must be closed before calling this function. - the stream's data @@ -48897,7 +46567,6 @@ freed using the free function set in @ostream's #GMemoryOutputStream:destroy-function property. @ostream must be closed before calling this function. - the stream's data, or %NULL if it has previously been stolen @@ -48938,13 +46607,11 @@ freed using the free function set in @ostream's - - @@ -48952,7 +46619,6 @@ freed using the free function set in @ostream's - @@ -48960,7 +46626,6 @@ freed using the free function set in @ostream's - @@ -48968,7 +46633,6 @@ freed using the free function set in @ostream's - @@ -48976,7 +46640,6 @@ freed using the free function set in @ostream's - @@ -48999,7 +46662,6 @@ g_menu_insert_submenu(). Creates a new #GMenu. The new menu has no items. - a new #GMenu @@ -49009,7 +46671,6 @@ The new menu has no items. Convenience function for appending a normal menu item to the end of @menu. Combine g_menu_item_new() and g_menu_insert_item() for a more flexible alternative. - @@ -49032,7 +46693,6 @@ flexible alternative. Appends @item to the end of @menu. See g_menu_insert_item() for more information. - @@ -49051,7 +46711,6 @@ See g_menu_insert_item() for more information. Convenience function for appending a section menu item to the end of @menu. Combine g_menu_item_new_section() and g_menu_insert_item() for a more flexible alternative. - @@ -49074,7 +46733,6 @@ more flexible alternative. Convenience function for appending a submenu menu item to the end of @menu. Combine g_menu_item_new_submenu() and g_menu_insert_item() for a more flexible alternative. - @@ -49102,7 +46760,6 @@ longer be used. This function causes g_menu_model_is_mutable() to begin returning %FALSE, which has some positive performance implications. - @@ -49117,7 +46774,6 @@ This function causes g_menu_model_is_mutable() to begin returning Convenience function for inserting a normal menu item into @menu. Combine g_menu_item_new() and g_menu_insert_item() for a more flexible alternative. - @@ -49158,7 +46814,6 @@ There are many convenience functions to take care of common cases. See g_menu_insert(), g_menu_insert_section() and g_menu_insert_submenu() as well as "prepend" and "append" variants of each of these functions. - @@ -49181,7 +46836,6 @@ each of these functions. Convenience function for inserting a section menu item into @menu. Combine g_menu_item_new_section() and g_menu_insert_item() for a more flexible alternative. - @@ -49208,7 +46862,6 @@ flexible alternative. Convenience function for inserting a submenu menu item into @menu. Combine g_menu_item_new_submenu() and g_menu_insert_item() for a more flexible alternative. - @@ -49235,7 +46888,6 @@ flexible alternative. Convenience function for prepending a normal menu item to the start of @menu. Combine g_menu_item_new() and g_menu_insert_item() for a more flexible alternative. - @@ -49258,7 +46910,6 @@ flexible alternative. Prepends @item to the start of @menu. See g_menu_insert_item() for more information. - @@ -49277,7 +46928,6 @@ See g_menu_insert_item() for more information. Convenience function for prepending a section menu item to the start of @menu. Combine g_menu_item_new_section() and g_menu_insert_item() for a more flexible alternative. - @@ -49300,7 +46950,6 @@ a more flexible alternative. Convenience function for prepending a submenu menu item to the start of @menu. Combine g_menu_item_new_submenu() and g_menu_insert_item() for a more flexible alternative. - @@ -49330,7 +46979,6 @@ less than the number of items in the menu. It is not possible to remove items by identity since items are added to the menu simply by copying their links and attributes (ie: identity of the item itself is not preserved). - @@ -49347,7 +46995,6 @@ identity of the item itself is not preserved). Removes all items in the menu. - @@ -49362,7 +47009,6 @@ identity of the item itself is not preserved). #GMenuAttributeIter is an opaque structure type. You must access it using the functions below. - This function combines g_menu_attribute_iter_next() with g_menu_attribute_iter_get_name() and g_menu_attribute_iter_get_value(). @@ -49379,7 +47025,6 @@ return the same values again. The value returned in @name remains valid for as long as the iterator remains at the current position. The value returned in @value must be unreffed using g_variant_unref() when it is no longer in use. - %TRUE on success, or %FALSE if there is no additional attribute @@ -49405,7 +47050,6 @@ be unreffed using g_variant_unref() when it is no longer in use. a string. The iterator is not advanced. - the name of the attribute @@ -49433,7 +47077,6 @@ return the same values again. The value returned in @name remains valid for as long as the iterator remains at the current position. The value returned in @value must be unreffed using g_variant_unref() when it is no longer in use. - %TRUE on success, or %FALSE if there is no additional attribute @@ -49458,7 +47101,6 @@ be unreffed using g_variant_unref() when it is no longer in use. Gets the value of the attribute at the current iterator position. The iterator is not advanced. - the value of the current attribute @@ -49480,7 +47122,6 @@ attributes. You must call this function when you first acquire the iterator to advance it to the first attribute (and determine if the first attribute exists at all). - %TRUE on success, or %FALSE when there are no more attributes @@ -49500,13 +47141,11 @@ attribute exists at all). - - %TRUE on success, or %FALSE if there is no additional attribute @@ -49544,7 +47183,6 @@ new item. If @detailed_action is non-%NULL it is used to set the "action" and possibly the "target" attribute of the new item. See g_menu_item_set_detailed_action() for more information. - a new #GMenuItem @@ -49566,7 +47204,6 @@ g_menu_item_set_detailed_action() for more information. @item_index must be valid (ie: be sure to call g_menu_model_get_n_items() first). - a new #GMenuItem. @@ -49643,7 +47280,6 @@ purpose of understanding what is really going on). </item> </menu> ]| - a new #GMenuItem @@ -49664,7 +47300,6 @@ purpose of understanding what is really going on). This is a convenience API around g_menu_item_new() and g_menu_item_set_submenu(). - a new #GMenuItem @@ -49690,7 +47325,6 @@ value into the positional parameters and %TRUE is returned. If the attribute does not exist, or it does exist but has the wrong type, then the positional parameters are ignored and %FALSE is returned. - %TRUE if the named attribute was found with the expected type @@ -49721,7 +47355,6 @@ returned. If @expected_type is specified and the attribute does not have this type, %NULL is returned. %NULL is also returned if the attribute simply does not exist. - the attribute value, or %NULL @@ -49743,7 +47376,6 @@ simply does not exist. Queries the named @link on @menu_item. - the link, or %NULL @@ -49779,7 +47411,6 @@ works with string-typed targets. See also g_menu_item_set_action_and_target_value() for a description of the semantics of the action and target attributes. - @@ -49839,7 +47470,6 @@ state is equal to the value of the @target property. See g_menu_item_set_action_and_target() or g_menu_item_set_detailed_action() for two equivalent calls that are probably more convenient for most uses. - @@ -49876,7 +47506,6 @@ and the named attribute is unset. See also g_menu_item_set_attribute_value() for an equivalent call that directly accepts a #GVariant. - @@ -49919,7 +47548,6 @@ the @value #GVariant is floating, it is consumed. See also g_menu_item_set_attribute() for a more convenient way to do the same. - @@ -49950,7 +47578,6 @@ slightly less convenient) alternatives. See also g_menu_item_set_action_and_target_value() for a description of the semantics of the action and target attributes. - @@ -49978,7 +47605,6 @@ menu items corresponding to verbs (eg: stock icons for 'Save' or 'Quit'). If @icon is %NULL then the icon is unset. - @@ -49998,7 +47624,6 @@ If @icon is %NULL then the icon is unset. If @label is non-%NULL it is used as the label for the menu item. If it is %NULL then the label attribute is unset. - @@ -50024,7 +47649,6 @@ is no guarantee that clients will be able to make sense of them. Link types are restricted to lowercase characters, numbers and '-'. Furthermore, the names must begin with a lowercase character, must not end with a '-', and must not contain consecutive dashes. - @@ -50051,7 +47675,6 @@ exactly as it sounds: the items from @section become a direct part of the menu that @menu_item is added to. See g_menu_item_new_section() for more information about what it means for a menu item to be a section. - @@ -50074,7 +47697,6 @@ link is unset. The effect of having one menu appear as a submenu of another is exactly as it sounds. - @@ -50093,7 +47715,6 @@ exactly as it sounds. #GMenuLinkIter is an opaque structure type. You must access it using the functions below. - This function combines g_menu_link_iter_next() with g_menu_link_iter_get_name() and g_menu_link_iter_get_value(). @@ -50109,7 +47730,6 @@ same values again. The value returned in @out_link remains valid for as long as the iterator remains at the current position. The value returned in @value must be unreffed using g_object_unref() when it is no longer in use. - %TRUE on success, or %FALSE if there is no additional link @@ -50133,7 +47753,6 @@ be unreffed using g_object_unref() when it is no longer in use. Gets the name of the link at the current iterator position. The iterator is not advanced. - the type of the link @@ -50160,7 +47779,6 @@ same values again. The value returned in @out_link remains valid for as long as the iterator remains at the current position. The value returned in @value must be unreffed using g_object_unref() when it is no longer in use. - %TRUE on success, or %FALSE if there is no additional link @@ -50184,7 +47802,6 @@ be unreffed using g_object_unref() when it is no longer in use. Gets the linked #GMenuModel at the current iterator position. The iterator is not advanced. - the #GMenuModel that is linked to @@ -50205,7 +47822,6 @@ link. You must call this function when you first acquire the iterator to advance it to the first link (and determine if the first link exists at all). - %TRUE on success, or %FALSE when there are no more links @@ -50225,13 +47841,11 @@ at all). - - %TRUE on success, or %FALSE if there is no additional link @@ -50370,7 +47984,6 @@ have a target value. Selecting that menu item will result in activation of the action with the target value as the parameter. The menu item should be rendered as "selected" when the state of the action is equal to the target value of the menu item. - Queries the item at position @item_index in @model for the attribute specified by @attribute. @@ -50383,7 +47996,6 @@ expected type is unspecified) then the value is returned. If the attribute does not exist, or does not match the expected type then %NULL is returned. - the value of the attribute @@ -50410,7 +48022,6 @@ then %NULL is returned. Gets all the attributes associated with the item in the menu model. - @@ -50438,7 +48049,6 @@ specified by @link. If the link exists, the linked #GMenuModel is returned. If the link does not exist, %NULL is returned. - the linked #GMenuModel, or %NULL @@ -50460,7 +48070,6 @@ does not exist, %NULL is returned. Gets all the links associated with the item in the menu model. - @@ -50484,7 +48093,6 @@ does not exist, %NULL is returned. Query the number of items in @model. - the number of items @@ -50501,7 +48109,6 @@ does not exist, %NULL is returned. An immutable #GMenuModel will never emit the #GMenuModel::items-changed signal. Consumers of the model may make optimisations accordingly. - %TRUE if the model is mutable (ie: "items-changed" may be emitted). @@ -50519,7 +48126,6 @@ signal. Consumers of the model may make optimisations accordingly. the item at position @item_index in @model. You must free the iterator with g_object_unref() when you are done. - a new #GMenuAttributeIter @@ -50540,7 +48146,6 @@ You must free the iterator with g_object_unref() when you are done. position @item_index in @model. You must free the iterator with g_object_unref() when you are done. - a new #GMenuLinkIter @@ -50573,7 +48178,6 @@ g_variant_get(), followed by a g_variant_unref(). As such, @format_string must make a complete copy of the data (since the #GVariant may go away after the call to g_variant_unref()). In particular, no '&' characters are allowed in @format_string. - %TRUE if the named attribute was found with the expected type @@ -50614,7 +48218,6 @@ expected type is unspecified) then the value is returned. If the attribute does not exist, or does not match the expected type then %NULL is returned. - the value of the attribute @@ -50645,7 +48248,6 @@ specified by @link. If the link exists, the linked #GMenuModel is returned. If the link does not exist, %NULL is returned. - the linked #GMenuModel, or %NULL @@ -50667,7 +48269,6 @@ does not exist, %NULL is returned. Query the number of items in @model. - the number of items @@ -50684,7 +48285,6 @@ does not exist, %NULL is returned. An immutable #GMenuModel will never emit the #GMenuModel::items-changed signal. Consumers of the model may make optimisations accordingly. - %TRUE if the model is mutable (ie: "items-changed" may be emitted). @@ -50713,7 +48313,6 @@ The implementation must dispatch this call directly from a mainloop entry and not in response to calls -- particularly those from the #GMenuModel API. Said another way: the menu must not change while user code is running without returning to the mainloop. - @@ -50741,7 +48340,6 @@ user code is running without returning to the mainloop. the item at position @item_index in @model. You must free the iterator with g_object_unref() when you are done. - a new #GMenuAttributeIter @@ -50762,7 +48360,6 @@ You must free the iterator with g_object_unref() when you are done. position @item_index in @model. You must free the iterator with g_object_unref() when you are done. - a new #GMenuLinkIter @@ -50825,13 +48422,11 @@ reported. The signal is emitted after the modification. - - %TRUE if the model is mutable (ie: "items-changed" may be emitted). @@ -50847,7 +48442,6 @@ reported. The signal is emitted after the modification. - the number of items @@ -50862,7 +48456,6 @@ reported. The signal is emitted after the modification. - @@ -50887,7 +48480,6 @@ reported. The signal is emitted after the modification. - a new #GMenuAttributeIter @@ -50906,7 +48498,6 @@ reported. The signal is emitted after the modification. - the value of the attribute @@ -50934,7 +48525,6 @@ reported. The signal is emitted after the modification. - @@ -50959,7 +48549,6 @@ reported. The signal is emitted after the modification. - a new #GMenuLinkIter @@ -50978,7 +48567,6 @@ reported. The signal is emitted after the modification. - the linked #GMenuModel, or %NULL @@ -51023,10 +48611,8 @@ callback should then call g_mount_unmount_with_operation_finish() with the #GMou and the #GAsyncResult data to see if the operation was completed successfully. If an @error is present when g_mount_unmount_with_operation_finish() is called, then it will be filled with any error information. - Checks if @mount can be ejected. - %TRUE if the @mount can be ejected. @@ -51040,7 +48626,6 @@ is called, then it will be filled with any error information. Checks if @mount can be unmounted. - %TRUE if the @mount can be unmounted. @@ -51053,7 +48638,6 @@ is called, then it will be filled with any error information. - @@ -51068,7 +48652,6 @@ is called, then it will be filled with any error information. finished by calling g_mount_eject_finish() with the @mount and #GAsyncResult data returned in the @callback. Use g_mount_eject_with_operation() instead. - @@ -51099,7 +48682,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. Use g_mount_eject_with_operation_finish() instead. - %TRUE if the mount was successfully ejected. %FALSE otherwise. @@ -51119,7 +48701,6 @@ and #GAsyncResult data returned in the @callback. Ejects a mount. This is an asynchronous operation, and is finished by calling g_mount_eject_with_operation_finish() with the @mount and #GAsyncResult data returned in the @callback. - @@ -51154,7 +48735,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the mount was successfully ejected. %FALSE otherwise. @@ -51174,7 +48754,6 @@ and #GAsyncResult data returned in the @callback. Gets the default location of @mount. The default location of the given @mount is a path that reflects the main entry point for the user (e.g. the home directory, or the root of the volume). - a #GFile. The returned object should be unreffed with @@ -51193,7 +48772,6 @@ the home directory, or the root of the volume). This is a convenience method for getting the #GVolume and then using that object to get the #GDrive. - a #GDrive or %NULL if @mount is not associated with a volume or a drive. @@ -51210,7 +48788,6 @@ using that object to get the #GDrive. Gets the icon for @mount. - a #GIcon. The returned object should be unreffed with @@ -51226,7 +48803,6 @@ using that object to get the #GDrive. Gets the name of @mount. - the name for the given @mount. The returned string should be freed with g_free() @@ -51242,7 +48818,6 @@ using that object to get the #GDrive. Gets the root directory on @mount. - a #GFile. The returned object should be unreffed with @@ -51258,7 +48833,6 @@ using that object to get the #GDrive. Gets the sort key for @mount, if any. - Sorting key for @mount or %NULL if no such key is available. @@ -51272,7 +48846,6 @@ using that object to get the #GDrive. Gets the symbolic icon for @mount. - a #GIcon. The returned object should be unreffed with @@ -51291,7 +48864,6 @@ using that object to get the #GDrive. the file system UUID for the mount in question and should be considered an opaque string. Returns %NULL if there is no UUID available. - the UUID for @mount or %NULL if no UUID can be computed. @@ -51308,7 +48880,6 @@ available. Gets the volume for the @mount. - a #GVolume or %NULL if @mount is not associated with a volume. @@ -51335,7 +48906,6 @@ This is an asynchronous operation (see g_mount_guess_content_type_sync() for the synchronous version), and is finished by calling g_mount_guess_content_type_finish() with the @mount and #GAsyncResult data returned in the @callback. - @@ -51369,7 +48939,6 @@ during the operation, @error will be set to contain the errors and %FALSE will be returned. In particular, you may get an %G_IO_ERROR_NOT_SUPPORTED if the mount does not support content guessing. - a %NULL-terminated array of content types or %NULL on error. Caller should free this array with g_strfreev() when done with it. @@ -51398,7 +48967,6 @@ specification for more on x-content types. This is a synchronous operation and as such may block doing IO; see g_mount_guess_content_type() for the asynchronous version. - a %NULL-terminated array of content types or %NULL on error. Caller should free this array with g_strfreev() when done with it. @@ -51423,7 +48991,6 @@ see g_mount_guess_content_type() for the asynchronous version. - @@ -51443,7 +49010,6 @@ of the volume has been changed, as these may need a remount to take affect. While this is semantically equivalent with unmounting and then remounting not all backends might need to actually be unmounted. - @@ -51478,7 +49044,6 @@ unmounted. Finishes remounting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the mount was successfully remounted. %FALSE otherwise. @@ -51499,7 +49064,6 @@ unmounted. finished by calling g_mount_unmount_finish() with the @mount and #GAsyncResult data returned in the @callback. Use g_mount_unmount_with_operation() instead. - @@ -51530,7 +49094,6 @@ and #GAsyncResult data returned in the @callback. Finishes unmounting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. Use g_mount_unmount_with_operation_finish() instead. - %TRUE if the mount was successfully unmounted. %FALSE otherwise. @@ -51550,7 +49113,6 @@ and #GAsyncResult data returned in the @callback. Unmounts a mount. This is an asynchronous operation, and is finished by calling g_mount_unmount_with_operation_finish() with the @mount and #GAsyncResult data returned in the @callback. - @@ -51585,7 +49147,6 @@ and #GAsyncResult data returned in the @callback. Finishes unmounting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the mount was successfully unmounted. %FALSE otherwise. @@ -51602,7 +49163,6 @@ and #GAsyncResult data returned in the @callback. - @@ -51614,7 +49174,6 @@ and #GAsyncResult data returned in the @callback. Checks if @mount can be ejected. - %TRUE if the @mount can be ejected. @@ -51628,7 +49187,6 @@ and #GAsyncResult data returned in the @callback. Checks if @mount can be unmounted. - %TRUE if the @mount can be unmounted. @@ -51645,7 +49203,6 @@ and #GAsyncResult data returned in the @callback. finished by calling g_mount_eject_finish() with the @mount and #GAsyncResult data returned in the @callback. Use g_mount_eject_with_operation() instead. - @@ -51676,7 +49233,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. Use g_mount_eject_with_operation_finish() instead. - %TRUE if the mount was successfully ejected. %FALSE otherwise. @@ -51696,7 +49252,6 @@ and #GAsyncResult data returned in the @callback. Ejects a mount. This is an asynchronous operation, and is finished by calling g_mount_eject_with_operation_finish() with the @mount and #GAsyncResult data returned in the @callback. - @@ -51731,7 +49286,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the mount was successfully ejected. %FALSE otherwise. @@ -51751,7 +49305,6 @@ and #GAsyncResult data returned in the @callback. Gets the default location of @mount. The default location of the given @mount is a path that reflects the main entry point for the user (e.g. the home directory, or the root of the volume). - a #GFile. The returned object should be unreffed with @@ -51770,7 +49323,6 @@ the home directory, or the root of the volume). This is a convenience method for getting the #GVolume and then using that object to get the #GDrive. - a #GDrive or %NULL if @mount is not associated with a volume or a drive. @@ -51787,7 +49339,6 @@ using that object to get the #GDrive. Gets the icon for @mount. - a #GIcon. The returned object should be unreffed with @@ -51803,7 +49354,6 @@ using that object to get the #GDrive. Gets the name of @mount. - the name for the given @mount. The returned string should be freed with g_free() @@ -51819,7 +49369,6 @@ using that object to get the #GDrive. Gets the root directory on @mount. - a #GFile. The returned object should be unreffed with @@ -51835,7 +49384,6 @@ using that object to get the #GDrive. Gets the sort key for @mount, if any. - Sorting key for @mount or %NULL if no such key is available. @@ -51849,7 +49397,6 @@ using that object to get the #GDrive. Gets the symbolic icon for @mount. - a #GIcon. The returned object should be unreffed with @@ -51868,7 +49415,6 @@ using that object to get the #GDrive. the file system UUID for the mount in question and should be considered an opaque string. Returns %NULL if there is no UUID available. - the UUID for @mount or %NULL if no UUID can be computed. @@ -51885,7 +49431,6 @@ available. Gets the volume for the @mount. - a #GVolume or %NULL if @mount is not associated with a volume. @@ -51912,7 +49457,6 @@ This is an asynchronous operation (see g_mount_guess_content_type_sync() for the synchronous version), and is finished by calling g_mount_guess_content_type_finish() with the @mount and #GAsyncResult data returned in the @callback. - @@ -51946,7 +49490,6 @@ during the operation, @error will be set to contain the errors and %FALSE will be returned. In particular, you may get an %G_IO_ERROR_NOT_SUPPORTED if the mount does not support content guessing. - a %NULL-terminated array of content types or %NULL on error. Caller should free this array with g_strfreev() when done with it. @@ -51975,7 +49518,6 @@ specification for more on x-content types. This is a synchronous operation and as such may block doing IO; see g_mount_guess_content_type() for the asynchronous version. - a %NULL-terminated array of content types or %NULL on error. Caller should free this array with g_strfreev() when done with it. @@ -52023,7 +49565,6 @@ root) that would shadow the original mount. The proxy monitor in GVfs 2.26 and later, automatically creates and manage shadow mounts (and shadows the underlying mount) if the activation root on a #GVolume is set. - %TRUE if @mount is shadowed. @@ -52045,7 +49586,6 @@ of the volume has been changed, as these may need a remount to take affect. While this is semantically equivalent with unmounting and then remounting not all backends might need to actually be unmounted. - @@ -52080,7 +49620,6 @@ unmounted. Finishes remounting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the mount was successfully remounted. %FALSE otherwise. @@ -52101,7 +49640,6 @@ unmounted. #GVolumeMonitor implementations when creating a shadow mount for @mount, see g_mount_is_shadowed() for more information. The caller will need to emit the #GMount::changed signal on @mount manually. - @@ -52117,7 +49655,6 @@ will need to emit the #GMount::changed signal on @mount manually. finished by calling g_mount_unmount_finish() with the @mount and #GAsyncResult data returned in the @callback. Use g_mount_unmount_with_operation() instead. - @@ -52148,7 +49685,6 @@ and #GAsyncResult data returned in the @callback. Finishes unmounting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. Use g_mount_unmount_with_operation_finish() instead. - %TRUE if the mount was successfully unmounted. %FALSE otherwise. @@ -52168,7 +49704,6 @@ and #GAsyncResult data returned in the @callback. Unmounts a mount. This is an asynchronous operation, and is finished by calling g_mount_unmount_with_operation_finish() with the @mount and #GAsyncResult data returned in the @callback. - @@ -52203,7 +49738,6 @@ and #GAsyncResult data returned in the @callback. Finishes unmounting a mount. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the mount was successfully unmounted. %FALSE otherwise. @@ -52224,7 +49758,6 @@ and #GAsyncResult data returned in the @callback. #GVolumeMonitor implementations when destroying a shadow mount for @mount, see g_mount_is_shadowed() for more information. The caller will need to emit the #GMount::changed signal on @mount manually. - @@ -52263,14 +49796,12 @@ finalized. Interface for implementing operations for mounts. - The parent interface. - @@ -52283,7 +49814,6 @@ finalized. - @@ -52296,7 +49826,6 @@ finalized. - a #GFile. The returned object should be unreffed with @@ -52313,7 +49842,6 @@ finalized. - the name for the given @mount. The returned string should be freed with g_free() @@ -52330,7 +49858,6 @@ finalized. - a #GIcon. The returned object should be unreffed with @@ -52347,7 +49874,6 @@ finalized. - the UUID for @mount or %NULL if no UUID can be computed. @@ -52365,7 +49891,6 @@ finalized. - a #GVolume or %NULL if @mount is not associated with a volume. @@ -52383,7 +49908,6 @@ finalized. - a #GDrive or %NULL if @mount is not associated with a volume or a drive. @@ -52401,7 +49925,6 @@ finalized. - %TRUE if the @mount can be unmounted. @@ -52416,7 +49939,6 @@ finalized. - %TRUE if the @mount can be ejected. @@ -52431,7 +49953,6 @@ finalized. - @@ -52461,7 +49982,6 @@ finalized. - %TRUE if the mount was successfully unmounted. %FALSE otherwise. @@ -52480,7 +50000,6 @@ finalized. - @@ -52510,7 +50029,6 @@ finalized. - %TRUE if the mount was successfully ejected. %FALSE otherwise. @@ -52529,7 +50047,6 @@ finalized. - @@ -52564,7 +50081,6 @@ finalized. - %TRUE if the mount was successfully remounted. %FALSE otherwise. @@ -52583,7 +50099,6 @@ finalized. - @@ -52614,7 +50129,6 @@ finalized. - a %NULL-terminated array of content types or %NULL on error. Caller should free this array with g_strfreev() when done with it. @@ -52636,7 +50150,6 @@ finalized. - a %NULL-terminated array of content types or %NULL on error. Caller should free this array with g_strfreev() when done with it. @@ -52663,7 +50176,6 @@ finalized. - @@ -52676,7 +50188,6 @@ finalized. - @@ -52711,7 +50222,6 @@ finalized. - %TRUE if the mount was successfully unmounted. %FALSE otherwise. @@ -52730,7 +50240,6 @@ finalized. - @@ -52765,7 +50274,6 @@ finalized. - %TRUE if the mount was successfully ejected. %FALSE otherwise. @@ -52784,7 +50292,6 @@ finalized. - a #GFile. The returned object should be unreffed with @@ -52801,7 +50308,6 @@ finalized. - Sorting key for @mount or %NULL if no such key is available. @@ -52816,7 +50322,6 @@ finalized. - a #GIcon. The returned object should be unreffed with @@ -52860,17 +50365,14 @@ The term ‘TCRYPT’ is used to mean ‘compatible with TrueCryp encrypting file containers, partitions or whole disks, typically used with Windows. [VeraCrypt](https://www.veracrypt.fr/) is a maintained fork of TrueCrypt with various improvements and auditing fixes. - Creates a new mount operation. - a #GMountOperation. - @@ -52881,7 +50383,6 @@ improvements and auditing fixes. - @@ -52905,7 +50406,6 @@ improvements and auditing fixes. Virtual implementation of #GMountOperation::ask-question. - @@ -52929,7 +50429,6 @@ improvements and auditing fixes. Emits the #GMountOperation::reply signal. - @@ -52946,7 +50445,6 @@ improvements and auditing fixes. Virtual implementation of #GMountOperation::show-processes. - @@ -52976,7 +50474,6 @@ improvements and auditing fixes. - @@ -52998,7 +50495,6 @@ improvements and auditing fixes. Check to see whether the mount operation is being used for an anonymous user. - %TRUE if mount operation is anonymous. @@ -53012,7 +50508,6 @@ for an anonymous user. Gets a choice from the mount operation. - an integer containing an index of the user's choice from the choice's list, or `0`. @@ -53027,7 +50522,6 @@ the choice's list, or `0`. Gets the domain of the mount operation. - a string set to the domain. @@ -53042,7 +50536,6 @@ the choice's list, or `0`. Check to see whether the mount operation is being used for a TCRYPT hidden volume. - %TRUE if mount operation is for hidden volume. @@ -53057,7 +50550,6 @@ for a TCRYPT hidden volume. Check to see whether the mount operation is being used for a TCRYPT system volume. - %TRUE if mount operation is for system volume. @@ -53071,7 +50563,6 @@ for a TCRYPT system volume. Gets a password from the mount operation. - a string containing the password within @op. @@ -53085,7 +50576,6 @@ for a TCRYPT system volume. Gets the state of saving passwords for the mount operation. - a #GPasswordSave flag. @@ -53099,7 +50589,6 @@ for a TCRYPT system volume. Gets a PIM from the mount operation. - The VeraCrypt PIM within @op. @@ -53113,7 +50602,6 @@ for a TCRYPT system volume. Get the user name from the mount operation. - a string containing the user name. @@ -53127,7 +50615,6 @@ for a TCRYPT system volume. Emits the #GMountOperation::reply signal. - @@ -53144,7 +50631,6 @@ for a TCRYPT system volume. Sets the mount operation to use an anonymous user if @anonymous is %TRUE. - @@ -53161,7 +50647,6 @@ for a TCRYPT system volume. Sets a default choice for the mount operation. - @@ -53178,7 +50663,6 @@ for a TCRYPT system volume. Sets the mount operation's domain. - @@ -53195,7 +50679,6 @@ for a TCRYPT system volume. Sets the mount operation to use a hidden volume if @hidden_volume is %TRUE. - @@ -53212,7 +50695,6 @@ for a TCRYPT system volume. Sets the mount operation to use a system volume if @system_volume is %TRUE. - @@ -53229,7 +50711,6 @@ for a TCRYPT system volume. Sets the mount operation's password to @password. - @@ -53246,7 +50727,6 @@ for a TCRYPT system volume. Sets the state of saving passwords for the mount operation. - @@ -53263,7 +50743,6 @@ for a TCRYPT system volume. Sets the mount operation's PIM to @pim. - @@ -53280,7 +50759,6 @@ for a TCRYPT system volume. Sets the user name within @op to @username. - @@ -53495,13 +50973,11 @@ primary text in a #GtkMessageDialog. - - @@ -53526,7 +51002,6 @@ primary text in a #GtkMessageDialog. - @@ -53551,7 +51026,6 @@ primary text in a #GtkMessageDialog. - @@ -53569,7 +51043,6 @@ primary text in a #GtkMessageDialog. - @@ -53582,7 +51055,6 @@ primary text in a #GtkMessageDialog. - @@ -53614,7 +51086,6 @@ primary text in a #GtkMessageDialog. - @@ -53636,7 +51107,6 @@ primary text in a #GtkMessageDialog. - @@ -53644,7 +51114,6 @@ primary text in a #GtkMessageDialog. - @@ -53652,7 +51121,6 @@ primary text in a #GtkMessageDialog. - @@ -53660,7 +51128,6 @@ primary text in a #GtkMessageDialog. - @@ -53668,7 +51135,6 @@ primary text in a #GtkMessageDialog. - @@ -53676,7 +51142,6 @@ primary text in a #GtkMessageDialog. - @@ -53684,7 +51149,6 @@ primary text in a #GtkMessageDialog. - @@ -53692,7 +51156,6 @@ primary text in a #GtkMessageDialog. - @@ -53700,7 +51163,6 @@ primary text in a #GtkMessageDialog. - @@ -53737,67 +51199,57 @@ information is send by the mounting operation. - - - - - - - - - - @@ -53806,39 +51258,33 @@ information is send by the mounting operation. Extension point for network status monitoring functionality. See [Extending GIO][extending-gio]. - - - - - - @@ -53846,11 +51292,9 @@ See [Extending GIO][extending-gio]. A socket address of some unknown native type. - Creates a new #GNativeSocketAddress for @native and @len. - a new #GNativeSocketAddress @@ -53874,7 +51318,6 @@ See [Extending GIO][extending-gio]. - @@ -53883,19 +51326,16 @@ See [Extending GIO][extending-gio]. - - - @@ -53921,7 +51361,6 @@ alive for too long. See #GSocketConnectable for an example of using the connectable interface. - Creates a new #GSocketConnectable for connecting to the given @@ -53932,7 +51371,6 @@ Note that depending on the configuration of the machine, a only, or to both IPv4 and IPv6; use g_network_address_new_loopback() to create a #GNetworkAddress that is guaranteed to resolve to both addresses. - the new #GNetworkAddress @@ -53961,7 +51399,6 @@ resolving `localhost`, and an IPv6 address for `localhost6`. g_network_address_get_hostname() will always return `localhost` for a #GNetworkAddress created with this constructor. - the new #GNetworkAddress @@ -53995,7 +51432,6 @@ and @default_port is expected to be provided by the application. service name rather than as a numeric port, but this functionality is deprecated, because it depends on the contents of /etc/services, which is generally quite sparse on platforms other than Linux.) - the new #GNetworkAddress, or %NULL on error @@ -54019,7 +51455,6 @@ which is generally quite sparse on platforms other than Linux.) Using this rather than g_network_address_new() or g_network_address_parse() allows #GSocketClient to determine when to use application-specific proxy protocols. - the new #GNetworkAddress, or %NULL on error @@ -54039,7 +51474,6 @@ when to use application-specific proxy protocols. Gets @addr's hostname. This might be either UTF-8 or ASCII-encoded, depending on what @addr was created with. - @addr's hostname @@ -54053,7 +51487,6 @@ depending on what @addr was created with. Gets @addr's port number - @addr's port (which may be 0) @@ -54067,7 +51500,6 @@ depending on what @addr was created with. Gets @addr's scheme - @addr's scheme (%NULL if not built from URI) @@ -54096,7 +51528,6 @@ depending on what @addr was created with. - @@ -54132,11 +51563,9 @@ implementations are based on the kernel's netlink interface and on NetworkManager. There is also an implementation for use inside Flatpak sandboxes. - Gets the default #GNetworkMonitor for the system. - a #GNetworkMonitor @@ -54160,7 +51589,6 @@ Note that although this does not attempt to connect to @connectable, it may still block for a brief period of time (eg, trying to do multicast DNS on the local network), so if you do not want to block, you should use g_network_monitor_can_reach_async(). - %TRUE if @connectable is reachable, %FALSE if not. @@ -54190,7 +51618,6 @@ For more details, see g_network_monitor_can_reach(). When the operation is finished, @callback will be called. You can then call g_network_monitor_can_reach_finish() to get the result of the operation. - @@ -54221,7 +51648,6 @@ to get the result of the operation. Finishes an async network connectivity test. See g_network_monitor_can_reach_async(). - %TRUE if network is reachable, %FALSE if not. @@ -54238,7 +51664,6 @@ See g_network_monitor_can_reach_async(). - @@ -54269,7 +51694,6 @@ Note that although this does not attempt to connect to @connectable, it may still block for a brief period of time (eg, trying to do multicast DNS on the local network), so if you do not want to block, you should use g_network_monitor_can_reach_async(). - %TRUE if @connectable is reachable, %FALSE if not. @@ -54299,7 +51723,6 @@ For more details, see g_network_monitor_can_reach(). When the operation is finished, @callback will be called. You can then call g_network_monitor_can_reach_finish() to get the result of the operation. - @@ -54330,7 +51753,6 @@ to get the result of the operation. Finishes an async network connectivity test. See g_network_monitor_can_reach_async(). - %TRUE if network is reachable, %FALSE if not. @@ -54366,7 +51788,6 @@ Note that in the case of %G_NETWORK_CONNECTIVITY_LIMITED and reachable but others are not. In this case, applications can attempt to connect to remote servers, but should gracefully fall back to their "offline" behavior if the connection attempt fails. - the network connectivity state @@ -54383,7 +51804,6 @@ back to their "offline" behavior if the connection attempt fails. system has a default route available for at least one of IPv4 or IPv6. It does not necessarily imply that the public Internet is reachable. See #GNetworkMonitor:network-available for more details. - whether the network is available @@ -54398,7 +51818,6 @@ reachable. See #GNetworkMonitor:network-available for more details. Checks if the network is metered. See #GNetworkMonitor:network-metered for more details. - whether the connection is metered @@ -54471,14 +51890,12 @@ See also #GNetworkMonitor:network-available. The virtual function table for #GNetworkMonitor. - The parent interface. - @@ -54494,7 +51911,6 @@ See also #GNetworkMonitor:network-available. - %TRUE if @connectable is reachable, %FALSE if not. @@ -54517,7 +51933,6 @@ See also #GNetworkMonitor:network-available. - @@ -54548,7 +51963,6 @@ See also #GNetworkMonitor:network-available. - %TRUE if network is reachable, %FALSE if not. @@ -54576,13 +51990,11 @@ address families. See #GSrvTarget for more information about SRV records, and see #GSocketConnectable for an example of using the connectable interface. - Creates a new #GNetworkService representing the given @service, @protocol, and @domain. This will initially be unresolved; use the #GSocketConnectable interface to resolve it. - a new #GNetworkService @@ -54605,7 +52017,6 @@ interface. Gets the domain that @srv serves. This might be either UTF-8 or ASCII-encoded, depending on what @srv was created with. - @srv's domain name @@ -54619,7 +52030,6 @@ ASCII-encoded, depending on what @srv was created with. Gets @srv's protocol name (eg, "tcp"). - @srv's protocol name @@ -54634,7 +52044,6 @@ ASCII-encoded, depending on what @srv was created with. Gets the URI scheme used to resolve proxies. By default, the service name is used as scheme. - @srv's scheme name @@ -54648,7 +52057,6 @@ is used as scheme. Gets @srv's service name (eg, "ldap"). - @srv's service name @@ -54663,7 +52071,6 @@ is used as scheme. Set's the URI scheme used to resolve proxies. By default, the service name is used as scheme. - @@ -54698,7 +52105,6 @@ is used as scheme. - @@ -54735,7 +52141,6 @@ After populating @notification with more details, it can be sent to the desktop shell with g_application_send_notification(). Changing any properties after this call will not have any effect until resending @notification. - a new #GNotification instance @@ -54756,7 +52161,6 @@ its parameter. See g_action_parse_detailed_name() for a description of the format for @detailed_action. - @@ -54783,7 +52187,6 @@ If @target_format is given, it is used to collect remaining positional parameters into a #GVariant instance, similar to g_variant_new(). @action will be activated with that #GVariant as its parameter. - @@ -54816,7 +52219,6 @@ parameter. If @target is non-%NULL, @action will be activated with @target as its parameter. - @@ -54841,7 +52243,6 @@ its parameter. Sets the body of @notification to @body. - @@ -54868,7 +52269,6 @@ for @detailed_action. When no default action is set, the application that the notification was sent on is activated. - @@ -54895,7 +52295,6 @@ parameter. When no default action is set, the application that the notification was sent on is activated. - @@ -54928,7 +52327,6 @@ its parameter. When no default action is set, the application that the notification was sent on is activated. - @@ -54949,7 +52347,6 @@ was sent on is activated. Sets the icon of @notification to @icon. - @@ -54967,7 +52364,6 @@ was sent on is activated. Sets the priority of @notification to @priority. See #GNotificationPriority for possible values. - @@ -54984,7 +52380,6 @@ was sent on is activated. Sets the title of @notification to @title. - @@ -55003,7 +52398,6 @@ was sent on is activated. Deprecated in favor of g_notification_set_priority(). Since 2.42, this has been deprecated in favour of g_notification_set_priority(). - @@ -55043,21 +52437,18 @@ was sent on is activated. - - - @@ -55071,7 +52462,6 @@ were one buffer. If @address is %NULL then the message is sent to the default receiver (as previously set by g_socket_connect()). - a #GSocketAddress, or %NULL @@ -55113,7 +52503,6 @@ See the documentation for #GIOStream for details of thread safety of streaming APIs. All of these functions have async variants too. - Requests an asynchronous close of the stream, releasing resources related to it. When the operation is finished @callback will be @@ -55125,7 +52514,6 @@ For behaviour details see g_output_stream_close(). The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -55154,7 +52542,6 @@ classes. However, if you override one you must override all. Closes an output stream. - %TRUE if stream was successfully closed, %FALSE otherwise. @@ -55171,7 +52558,6 @@ classes. However, if you override one you must override all. - @@ -55194,7 +52580,6 @@ This function is optional for inherited classes. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on success, %FALSE on error @@ -55218,7 +52603,6 @@ For behaviour details see g_output_stream_flush(). When the operation is finished @callback will be called. You can then call g_output_stream_flush_finish() to get the result of the operation. - @@ -55247,7 +52631,6 @@ result of the operation. Finishes flushing an output stream. - %TRUE if flush operation succeeded, %FALSE otherwise. @@ -55265,7 +52648,6 @@ result of the operation. Splices an input stream into an output stream. - a #gssize containing the size of the data spliced, or -1 if an error occurred. Note that if the number of bytes @@ -55301,7 +52683,6 @@ result of the operation. For the synchronous, blocking version of this function, see g_output_stream_splice(). - @@ -55338,7 +52719,6 @@ g_output_stream_splice(). Finishes an asynchronous stream splice operation. - a #gssize of the number of bytes spliced. Note that if the number of bytes spliced is greater than %G_MAXSSIZE, then that @@ -55393,7 +52773,6 @@ Note that no copy of @buffer will be made, so it must stay valid until @callback is called. See g_output_stream_write_bytes_async() for a #GBytes version that will automatically hold a reference to the contents (without copying) for the duration of the call. - @@ -55432,7 +52811,6 @@ the contents (without copying) for the duration of the call. Finishes a stream write operation. - a #gssize containing the number of bytes written to the stream. @@ -55469,7 +52847,6 @@ operation was partially finished when the operation was cancelled the partial result will be returned, without an error. On error -1 is returned and @error is set accordingly. - Number of bytes written, or -1 on error @@ -55526,7 +52903,6 @@ g_output_stream_writev(). Note that no copy of @vectors will be made, so it must stay valid until @callback is called. - @@ -55565,7 +52941,6 @@ until @callback is called. Finishes a stream writev operation. - %TRUE on success, %FALSE if there was an error @@ -55609,7 +52984,6 @@ Some implementations of g_output_stream_writev() may have limitations on the aggregate buffer size, and will return %G_IO_ERROR_INVALID_ARGUMENT if these are exceeded. For example, when writing to a local file on UNIX platforms, the aggregate buffer size must not exceed %G_MAXSSIZE bytes. - %TRUE on success, %FALSE if there was an error @@ -55642,7 +53016,6 @@ the aggregate buffer size must not exceed %G_MAXSSIZE bytes. Clears the pending flag on @stream. - @@ -55683,7 +53056,6 @@ Cancelling a close will still leave the stream closed, but there some streams can use a faster close that doesn't block to e.g. check errors. On cancellation (as with any error) there is no guarantee that all written data will reach the target. - %TRUE on success, %FALSE on failure @@ -55710,7 +53082,6 @@ For behaviour details see g_output_stream_close(). The asynchronous methods have a default fallback that uses threads to implement asynchronicity, so they are optional for inheriting classes. However, if you override one you must override all. - @@ -55739,7 +53110,6 @@ classes. However, if you override one you must override all. Closes an output stream. - %TRUE if stream was successfully closed, %FALSE otherwise. @@ -55765,7 +53135,6 @@ This function is optional for inherited classes. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE on success, %FALSE on error @@ -55789,7 +53158,6 @@ For behaviour details see g_output_stream_flush(). When the operation is finished @callback will be called. You can then call g_output_stream_flush_finish() to get the result of the operation. - @@ -55818,7 +53186,6 @@ result of the operation. Finishes flushing an output stream. - %TRUE if flush operation succeeded, %FALSE otherwise. @@ -55836,7 +53203,6 @@ result of the operation. Checks if an output stream has pending actions. - %TRUE if @stream has pending actions. @@ -55850,7 +53216,6 @@ result of the operation. Checks if an output stream has already been closed. - %TRUE if @stream is closed. %FALSE otherwise. @@ -55867,7 +53232,6 @@ result of the operation. used inside e.g. a flush implementation to see if the flush (or other i/o operation) is called from within the closing operation. - %TRUE if @stream is being closed. %FALSE otherwise. @@ -55892,7 +53256,6 @@ function due to the variable length of the written string, if you need precise control over partial write failures, you need to create you own printf()-like wrapper around g_output_stream_write() or g_output_stream_write_all(). - %TRUE on success, %FALSE if there was an error @@ -55929,7 +53292,6 @@ or g_output_stream_write_all(). Sets @stream to have actions pending. If the pending flag is already set or @stream is closed, it will return %FALSE and set @error. - %TRUE if pending was previously unset and is now set. @@ -55943,7 +53305,6 @@ already set or @stream is closed, it will return %FALSE and set Splices an input stream into an output stream. - a #gssize containing the size of the data spliced, or -1 if an error occurred. Note that if the number of bytes @@ -55979,7 +53340,6 @@ result of the operation. For the synchronous, blocking version of this function, see g_output_stream_splice(). - @@ -56016,7 +53376,6 @@ g_output_stream_splice(). Finishes an asynchronous stream splice operation. - a #gssize of the number of bytes spliced. Note that if the number of bytes spliced is greater than %G_MAXSSIZE, then that @@ -56048,7 +53407,6 @@ function due to the variable length of the written string, if you need precise control over partial write failures, you need to create you own printf()-like wrapper around g_output_stream_write() or g_output_stream_write_all(). - %TRUE on success, %FALSE if there was an error @@ -56102,7 +53460,6 @@ operation was partially finished when the operation was cancelled the partial result will be returned, without an error. On error -1 is returned and @error is set accordingly. - Number of bytes written, or -1 on error @@ -56148,7 +53505,6 @@ successfully written before the error was encountered. This functionality is only available from C. If you need it from another language then you must write your own loop around g_output_stream_write(). - %TRUE on success, %FALSE if there was an error @@ -56195,7 +53551,6 @@ priority. Default priority is %G_PRIORITY_DEFAULT. Note that no copy of @buffer will be made, so it must stay valid until @callback is called. - @@ -56243,7 +53598,6 @@ successfully written before the error was encountered. This functionality is only available from C. If you need it from another language then you must write your own loop around g_output_stream_write_async(). - %TRUE on success, %FALSE if there was an error @@ -56299,7 +53653,6 @@ Note that no copy of @buffer will be made, so it must stay valid until @callback is called. See g_output_stream_write_bytes_async() for a #GBytes version that will automatically hold a reference to the contents (without copying) for the duration of the call. - @@ -56348,7 +53701,6 @@ writing, you will need to create a new #GBytes containing just the remaining bytes, using g_bytes_new_from_bytes(). Passing the same #GBytes instance multiple times potentially can result in duplicated data in the output stream. - Number of bytes written, or -1 on error @@ -56382,7 +53734,6 @@ data in the output stream. For the synchronous, blocking version of this function, see g_output_stream_write_bytes(). - @@ -56415,7 +53766,6 @@ g_output_stream_write_bytes(). Finishes a stream write-from-#GBytes operation. - a #gssize containing the number of bytes written to the stream. @@ -56433,7 +53783,6 @@ g_output_stream_write_bytes(). Finishes a stream write operation. - a #gssize containing the number of bytes written to the stream. @@ -56473,7 +53822,6 @@ Some implementations of g_output_stream_writev() may have limitations on the aggregate buffer size, and will return %G_IO_ERROR_INVALID_ARGUMENT if these are exceeded. For example, when writing to a local file on UNIX platforms, the aggregate buffer size must not exceed %G_MAXSSIZE bytes. - %TRUE on success, %FALSE if there was an error @@ -56527,7 +53875,6 @@ g_output_stream_write(). The content of the individual elements of @vectors might be changed by this function. - %TRUE on success, %FALSE if there was an error @@ -56575,7 +53922,6 @@ priority. Default priority is %G_PRIORITY_DEFAULT. Note that no copy of @vectors will be made, so it must stay valid until @callback is called. The content of the individual elements of @vectors might be changed by this function. - @@ -56623,7 +53969,6 @@ successfully written before the error was encountered. This functionality is only available from C. If you need it from another language then you must write your own loop around g_output_stream_writev_async(). - %TRUE on success, %FALSE if there was an error @@ -56674,7 +54019,6 @@ g_output_stream_writev(). Note that no copy of @vectors will be made, so it must stay valid until @callback is called. - @@ -56713,7 +54057,6 @@ until @callback is called. Finishes a stream writev operation. - %TRUE on success, %FALSE if there was an error @@ -56741,13 +54084,11 @@ until @callback is called. - - Number of bytes written, or -1 on error @@ -56776,7 +54117,6 @@ until @callback is called. - a #gssize containing the size of the data spliced, or -1 if an error occurred. Note that if the number of bytes @@ -56807,7 +54147,6 @@ until @callback is called. - %TRUE on success, %FALSE on error @@ -56826,7 +54165,6 @@ until @callback is called. - @@ -56842,7 +54180,6 @@ until @callback is called. - @@ -56882,7 +54219,6 @@ until @callback is called. - a #gssize containing the number of bytes written to the stream. @@ -56901,7 +54237,6 @@ until @callback is called. - @@ -56939,7 +54274,6 @@ until @callback is called. - a #gssize of the number of bytes spliced. Note that if the number of bytes spliced is greater than %G_MAXSSIZE, then that @@ -56961,7 +54295,6 @@ until @callback is called. - @@ -56991,7 +54324,6 @@ until @callback is called. - %TRUE if flush operation succeeded, %FALSE otherwise. @@ -57010,7 +54342,6 @@ until @callback is called. - @@ -57040,7 +54371,6 @@ until @callback is called. - %TRUE if stream was successfully closed, %FALSE otherwise. @@ -57059,7 +54389,6 @@ until @callback is called. - %TRUE on success, %FALSE if there was an error @@ -57093,7 +54422,6 @@ until @callback is called. - @@ -57133,7 +54461,6 @@ until @callback is called. - %TRUE on success, %FALSE if there was an error @@ -57156,7 +54483,6 @@ until @callback is called. - @@ -57164,7 +54490,6 @@ until @callback is called. - @@ -57172,7 +54497,6 @@ until @callback is called. - @@ -57180,7 +54504,6 @@ until @callback is called. - @@ -57188,7 +54511,6 @@ until @callback is called. - @@ -57217,7 +54539,6 @@ until @callback is called. You generally pass in an array of #GOutputVectors and the operation will use all the buffers as if they were one buffer. - Pointer to a buffer of data to read. @@ -57228,105 +54549,90 @@ one buffer. - - - - - - - - - - - - - - - @@ -57335,18 +54641,15 @@ one buffer. Extension point for proxy functionality. See [Extending GIO][extending-gio]. - - - @@ -57355,11 +54658,9 @@ See [Extending GIO][extending-gio]. Extension point for proxy resolving functionality. See [Extending GIO][extending-gio]. - - @@ -57396,7 +54697,6 @@ user to write to a #GSettings object. This #GPermission object could then be used to decide if it is appropriate to show a "Click here to unlock" button in a dialog and to provide the mechanism to invoke when that button is clicked. - Attempts to acquire the permission represented by @permission. @@ -57413,7 +54713,6 @@ If the permission is acquired then %TRUE is returned. Otherwise, This call is blocking, likely for a very long time (in the case that user interaction is required). See g_permission_acquire_async() for the non-blocking version. - %TRUE if the permission was successfully acquired @@ -57434,7 +54733,6 @@ the non-blocking version. This is the first half of the asynchronous version of g_permission_acquire(). - @@ -57463,7 +54761,6 @@ represented by @permission. This is the second half of the asynchronous version of g_permission_acquire(). - %TRUE if the permission was successfully acquired @@ -57495,7 +54792,6 @@ If the permission is released then %TRUE is returned. Otherwise, This call is blocking, likely for a very long time (in the case that user interaction is required). See g_permission_release_async() for the non-blocking version. - %TRUE if the permission was successfully released @@ -57516,7 +54812,6 @@ the non-blocking version. This is the first half of the asynchronous version of g_permission_release(). - @@ -57545,7 +54840,6 @@ represented by @permission. This is the second half of the asynchronous version of g_permission_release(). - %TRUE if the permission was successfully released @@ -57577,7 +54871,6 @@ If the permission is acquired then %TRUE is returned. Otherwise, This call is blocking, likely for a very long time (in the case that user interaction is required). See g_permission_acquire_async() for the non-blocking version. - %TRUE if the permission was successfully acquired @@ -57598,7 +54891,6 @@ the non-blocking version. This is the first half of the asynchronous version of g_permission_acquire(). - @@ -57627,7 +54919,6 @@ represented by @permission. This is the second half of the asynchronous version of g_permission_acquire(). - %TRUE if the permission was successfully acquired @@ -57647,7 +54938,6 @@ g_permission_acquire(). Gets the value of the 'allowed' property. This property is %TRUE if the caller currently has permission to perform the action that @permission represents the permission to perform. - the value of the 'allowed' property @@ -57663,7 +54953,6 @@ the caller currently has permission to perform the action that Gets the value of the 'can-acquire' property. This property is %TRUE if it is generally possible to acquire the permission by calling g_permission_acquire(). - the value of the 'can-acquire' property @@ -57679,7 +54968,6 @@ g_permission_acquire(). Gets the value of the 'can-release' property. This property is %TRUE if it is generally possible to release the permission by calling g_permission_release(). - the value of the 'can-release' property @@ -57697,7 +54985,6 @@ the properties of the permission. You should never call this function except from a #GPermission implementation. GObject notify signals are generated, as appropriate. - @@ -57736,7 +55023,6 @@ If the permission is released then %TRUE is returned. Otherwise, This call is blocking, likely for a very long time (in the case that user interaction is required). See g_permission_release_async() for the non-blocking version. - %TRUE if the permission was successfully released @@ -57757,7 +55043,6 @@ the non-blocking version. This is the first half of the asynchronous version of g_permission_release(). - @@ -57786,7 +55071,6 @@ represented by @permission. This is the second half of the asynchronous version of g_permission_release(). - %TRUE if the permission was successfully released @@ -57825,13 +55109,11 @@ g_permission_release(). - - %TRUE if the permission was successfully acquired @@ -57850,7 +55132,6 @@ g_permission_release(). - @@ -57876,7 +55157,6 @@ g_permission_release(). - %TRUE if the permission was successfully acquired @@ -57895,7 +55175,6 @@ g_permission_release(). - %TRUE if the permission was successfully released @@ -57914,7 +55193,6 @@ g_permission_release(). - @@ -57940,7 +55218,6 @@ g_permission_release(). - %TRUE if the permission was successfully released @@ -57971,7 +55248,6 @@ g_permission_release(). can be polled for readiness to read. This can be used when interfacing with a non-GIO API that expects UNIX-file-descriptor-style asynchronous I/O rather than GIO-style. - Checks if @stream is actually pollable. Some classes may implement @@ -57981,7 +55257,6 @@ other #GPollableInputStream methods is undefined. For any given stream, the value returned by this method is constant; a stream cannot switch from pollable to non-pollable or vice versa. - %TRUE if @stream is pollable, %FALSE if not. @@ -58002,7 +55277,6 @@ As with g_pollable_input_stream_is_readable(), it is possible that the stream may not actually be readable even after the source triggers, so you should use g_pollable_input_stream_read_nonblocking() rather than g_input_stream_read() from the callback. - a new #GSource @@ -58027,7 +55301,6 @@ after this returns %TRUE would still block. To guarantee non-blocking behavior, you should always use g_pollable_input_stream_read_nonblocking(), which will return a %G_IO_ERROR_WOULD_BLOCK error rather than blocking. - %TRUE if @stream is readable, %FALSE if not. If an error has occurred on @stream, this will result in @@ -58054,7 +55327,6 @@ use @cancellable to cancel it. However, it will return an error if @cancellable has already been cancelled when you call, which may happen if you call this method after a source triggers due to having been cancelled. - the number of bytes read, or -1 on error (including %G_IO_ERROR_WOULD_BLOCK). @@ -58086,7 +55358,6 @@ other #GPollableInputStream methods is undefined. For any given stream, the value returned by this method is constant; a stream cannot switch from pollable to non-pollable or vice versa. - %TRUE if @stream is pollable, %FALSE if not. @@ -58107,7 +55378,6 @@ As with g_pollable_input_stream_is_readable(), it is possible that the stream may not actually be readable even after the source triggers, so you should use g_pollable_input_stream_read_nonblocking() rather than g_input_stream_read() from the callback. - a new #GSource @@ -58132,7 +55402,6 @@ after this returns %TRUE would still block. To guarantee non-blocking behavior, you should always use g_pollable_input_stream_read_nonblocking(), which will return a %G_IO_ERROR_WOULD_BLOCK error rather than blocking. - %TRUE if @stream is readable, %FALSE if not. If an error has occurred on @stream, this will result in @@ -58159,7 +55428,6 @@ use @cancellable to cancel it. However, it will return an error if @cancellable has already been cancelled when you call, which may happen if you call this method after a source triggers due to having been cancelled. - the number of bytes read, or -1 on error (including %G_IO_ERROR_WOULD_BLOCK). @@ -58199,14 +55467,12 @@ g_input_stream_read() if it returns %TRUE. This means you only need to override it if it is possible that your @is_readable implementation may return %TRUE when the stream is not actually readable. - The parent interface. - %TRUE if @stream is pollable, %FALSE if not. @@ -58221,7 +55487,6 @@ readable. - %TRUE if @stream is readable, %FALSE if not. If an error has occurred on @stream, this will result in @@ -58239,7 +55504,6 @@ readable. - a new #GSource @@ -58258,7 +55522,6 @@ readable. - the number of bytes read, or -1 on error (including %G_IO_ERROR_WOULD_BLOCK). @@ -58289,7 +55552,6 @@ readable. can be polled for readiness to write. This can be used when interfacing with a non-GIO API that expects UNIX-file-descriptor-style asynchronous I/O rather than GIO-style. - Checks if @stream is actually pollable. Some classes may implement @@ -58299,7 +55561,6 @@ of other #GPollableOutputStream methods is undefined. For any given stream, the value returned by this method is constant; a stream cannot switch from pollable to non-pollable or vice versa. - %TRUE if @stream is pollable, %FALSE if not. @@ -58320,7 +55581,6 @@ As with g_pollable_output_stream_is_writable(), it is possible that the stream may not actually be writable even after the source triggers, so you should use g_pollable_output_stream_write_nonblocking() rather than g_output_stream_write() from the callback. - a new #GSource @@ -58345,7 +55605,6 @@ after this returns %TRUE would still block. To guarantee non-blocking behavior, you should always use g_pollable_output_stream_write_nonblocking(), which will return a %G_IO_ERROR_WOULD_BLOCK error rather than blocking. - %TRUE if @stream is writable, %FALSE if not. If an error has occurred on @stream, this will result in @@ -58376,7 +55635,6 @@ to having been cancelled. Also note that if %G_IO_ERROR_WOULD_BLOCK is returned some underlying transports like D/TLS require that you re-send the same @buffer and @count in the next write call. - the number of bytes written, or -1 on error (including %G_IO_ERROR_WOULD_BLOCK). @@ -58417,7 +55675,6 @@ to having been cancelled. Also note that if %G_POLLABLE_RETURN_WOULD_BLOCK is returned some underlying transports like D/TLS require that you re-send the same @vectors and @n_vectors in the next write call. - %@G_POLLABLE_RETURN_OK on success, %G_POLLABLE_RETURN_WOULD_BLOCK if the stream is not currently writable (and @error is *not* set), or @@ -58455,7 +55712,6 @@ of other #GPollableOutputStream methods is undefined. For any given stream, the value returned by this method is constant; a stream cannot switch from pollable to non-pollable or vice versa. - %TRUE if @stream is pollable, %FALSE if not. @@ -58476,7 +55732,6 @@ As with g_pollable_output_stream_is_writable(), it is possible that the stream may not actually be writable even after the source triggers, so you should use g_pollable_output_stream_write_nonblocking() rather than g_output_stream_write() from the callback. - a new #GSource @@ -58501,7 +55756,6 @@ after this returns %TRUE would still block. To guarantee non-blocking behavior, you should always use g_pollable_output_stream_write_nonblocking(), which will return a %G_IO_ERROR_WOULD_BLOCK error rather than blocking. - %TRUE if @stream is writable, %FALSE if not. If an error has occurred on @stream, this will result in @@ -58532,7 +55786,6 @@ to having been cancelled. Also note that if %G_IO_ERROR_WOULD_BLOCK is returned some underlying transports like D/TLS require that you re-send the same @buffer and @count in the next write call. - the number of bytes written, or -1 on error (including %G_IO_ERROR_WOULD_BLOCK). @@ -58577,7 +55830,6 @@ to having been cancelled. Also note that if %G_POLLABLE_RETURN_WOULD_BLOCK is returned some underlying transports like D/TLS require that you re-send the same @vectors and @n_vectors in the next write call. - %@G_POLLABLE_RETURN_OK on success, %G_POLLABLE_RETURN_WOULD_BLOCK if the stream is not currently writable (and @error is *not* set), or @@ -58629,14 +55881,12 @@ g_pollable_output_stream_write_nonblocking() for each vector, and converts its return value and error (if set) to a #GPollableReturn. You should override this where possible to avoid having to allocate a #GError to return %G_IO_ERROR_WOULD_BLOCK. - The parent interface. - %TRUE if @stream is pollable, %FALSE if not. @@ -58651,7 +55901,6 @@ override this where possible to avoid having to allocate a #GError to return - %TRUE if @stream is writable, %FALSE if not. If an error has occurred on @stream, this will result in @@ -58669,7 +55918,6 @@ override this where possible to avoid having to allocate a #GError to return - a new #GSource @@ -58688,7 +55936,6 @@ override this where possible to avoid having to allocate a #GError to return - the number of bytes written, or -1 on error (including %G_IO_ERROR_WOULD_BLOCK). @@ -58715,7 +55962,6 @@ override this where possible to avoid having to allocate a #GError to return - %@G_POLLABLE_RETURN_OK on success, %G_POLLABLE_RETURN_WOULD_BLOCK if the stream is not currently writable (and @error is *not* set), or @@ -58771,7 +56017,6 @@ operation to give details about the error that happened. This is the function type of the callback used for the #GSource returned by g_pollable_input_stream_create_source() and g_pollable_output_stream_create_source(). - it should return %FALSE if the source should be removed. @@ -58849,7 +56094,6 @@ construct-only). This function takes a reference on @object and doesn't release it until the action is destroyed. - a new #GPropertyAction @@ -58922,11 +56166,9 @@ The extensions are named after their proxy protocol name. As an example, a SOCKS5 proxy implementation can be retrieved with the name 'socks5' using the function g_io_extension_point_get_extension_by_name(). - Find the `gio-proxy` extension point for a proxy implementation that supports the specified protocol. - return a #GProxy or NULL if protocol is not supported. @@ -58944,7 +56186,6 @@ the specified protocol. #GSocketConnection that is connected to the proxy server), this does the necessary handshake to connect to @proxy_address, and if required, wraps the #GIOStream to handle proxy payload. - a #GIOStream that will replace @connection. This might be the same as @connection, in which case a reference @@ -58972,7 +56213,6 @@ required, wraps the #GIOStream to handle proxy payload. Asynchronous version of g_proxy_connect(). - @@ -59005,7 +56245,6 @@ required, wraps the #GIOStream to handle proxy payload. See g_proxy_connect(). - a #GIOStream. @@ -59029,7 +56268,6 @@ implementing such a protocol. When %FALSE is returned, the caller should resolve the destination hostname first, and then pass a #GProxyAddress containing the stringified IP address to g_proxy_connect() or g_proxy_connect_async(). - %TRUE if hostname resolution is supported. @@ -59046,7 +56284,6 @@ g_proxy_connect() or g_proxy_connect_async(). #GSocketConnection that is connected to the proxy server), this does the necessary handshake to connect to @proxy_address, and if required, wraps the #GIOStream to handle proxy payload. - a #GIOStream that will replace @connection. This might be the same as @connection, in which case a reference @@ -59074,7 +56311,6 @@ required, wraps the #GIOStream to handle proxy payload. Asynchronous version of g_proxy_connect(). - @@ -59107,7 +56343,6 @@ required, wraps the #GIOStream to handle proxy payload. See g_proxy_connect(). - a #GIOStream. @@ -59131,7 +56366,6 @@ implementing such a protocol. When %FALSE is returned, the caller should resolve the destination hostname first, and then pass a #GProxyAddress containing the stringified IP address to g_proxy_connect() or g_proxy_connect_async(). - %TRUE if hostname resolution is supported. @@ -59146,7 +56380,6 @@ g_proxy_connect() or g_proxy_connect_async(). Support for proxied #GInetSocketAddress. - Creates a new #GProxyAddress for @inetaddr with @protocol that should @@ -59155,7 +56388,6 @@ tunnel through @dest_hostname and @dest_port. (Note that this method doesn't set the #GProxyAddress:uri or #GProxyAddress:destination-protocol fields; use g_object_new() directly if you want to set those.) - a new #GProxyAddress @@ -59197,7 +56429,6 @@ directly if you want to set those.) Gets @proxy's destination hostname; that is, the name of the host that will be connected to via the proxy, not the name of the proxy itself. - the @proxy's destination hostname @@ -59213,7 +56444,6 @@ itself. Gets @proxy's destination port; that is, the port on the destination host that will be connected to via the proxy, not the port number of the proxy itself. - the @proxy's destination port @@ -59228,7 +56458,6 @@ port number of the proxy itself. Gets the protocol that is being spoken to the destination server; eg, "http" or "ftp". - the @proxy's destination protocol @@ -59242,7 +56471,6 @@ server; eg, "http" or "ftp". Gets @proxy's password. - the @proxy's password @@ -59256,7 +56484,6 @@ server; eg, "http" or "ftp". Gets @proxy's protocol. eg, "socks" or "http" - the @proxy's protocol @@ -59270,7 +56497,6 @@ server; eg, "http" or "ftp". Gets the proxy URI that @proxy was constructed from. - the @proxy's URI, or %NULL if unknown @@ -59284,7 +56510,6 @@ server; eg, "http" or "ftp". Gets @proxy's username. - the @proxy's username @@ -59330,7 +56555,6 @@ if the creator didn't specify this). Class structure for #GProxyAddress. - @@ -59345,7 +56569,6 @@ This enumerator will be returned (for example, by g_socket_connectable_enumerate()) as appropriate when a proxy is configured; there should be no need to manually wrap a #GSocketAddressEnumerator instance with one. - @@ -59370,13 +56593,11 @@ specify one. Class structure for #GProxyAddressEnumerator. - - @@ -59384,7 +56605,6 @@ specify one. - @@ -59392,7 +56612,6 @@ specify one. - @@ -59400,7 +56619,6 @@ specify one. - @@ -59408,7 +56626,6 @@ specify one. - @@ -59416,7 +56633,6 @@ specify one. - @@ -59424,7 +56640,6 @@ specify one. - @@ -59439,14 +56654,12 @@ specify one. Provides an interface for handling proxy connection and payload. - The parent interface. - a #GIOStream that will replace @connection. This might be the same as @connection, in which case a reference @@ -59475,7 +56688,6 @@ specify one. - @@ -59509,7 +56721,6 @@ specify one. - a #GIOStream. @@ -59528,7 +56739,6 @@ specify one. - %TRUE if hostname resolution is supported. @@ -59550,10 +56760,8 @@ the method g_socket_connectable_proxy_enumerate(). Implementations of #GProxyResolver based on libproxy and GNOME settings can be found in glib-networking. GIO comes with an implementation for use inside Flatpak portals. - Gets the default #GProxyResolver for the system. - the default #GProxyResolver. @@ -59563,7 +56771,6 @@ Flatpak portals. Checks if @resolver can be used on this system. (This is used internally; g_proxy_resolver_get_default() will only return a proxy resolver that returns %TRUE for this method.) - %TRUE if @resolver is supported. @@ -59591,7 +56798,6 @@ In this case, the resolver might still return a generic proxy type `direct://` is used when no proxy is needed. Direct connection should not be attempted unless it is part of the returned array of proxies. - A NULL-terminated array of proxy URIs. Must be freed @@ -59618,7 +56824,6 @@ returned array of proxies. Asynchronous lookup of proxy. See g_proxy_resolver_lookup() for more details. - @@ -59649,7 +56854,6 @@ details. Call this function to obtain the array of proxy URIs when g_proxy_resolver_lookup_async() is complete. See g_proxy_resolver_lookup() for more details. - A NULL-terminated array of proxy URIs. Must be freed @@ -59673,7 +56877,6 @@ g_proxy_resolver_lookup() for more details. Checks if @resolver can be used on this system. (This is used internally; g_proxy_resolver_get_default() will only return a proxy resolver that returns %TRUE for this method.) - %TRUE if @resolver is supported. @@ -59701,7 +56904,6 @@ In this case, the resolver might still return a generic proxy type `direct://` is used when no proxy is needed. Direct connection should not be attempted unless it is part of the returned array of proxies. - A NULL-terminated array of proxy URIs. Must be freed @@ -59728,7 +56930,6 @@ returned array of proxies. Asynchronous lookup of proxy. See g_proxy_resolver_lookup() for more details. - @@ -59759,7 +56960,6 @@ details. Call this function to obtain the array of proxy URIs when g_proxy_resolver_lookup_async() is complete. See g_proxy_resolver_lookup() for more details. - A NULL-terminated array of proxy URIs. Must be freed @@ -59782,14 +56982,12 @@ g_proxy_resolver_lookup() for more details. The virtual function table for #GProxyResolver. - The parent interface. - %TRUE if @resolver is supported. @@ -59804,7 +57002,6 @@ g_proxy_resolver_lookup() for more details. - A NULL-terminated array of proxy URIs. Must be freed @@ -59831,7 +57028,6 @@ g_proxy_resolver_lookup() for more details. - @@ -59861,7 +57057,6 @@ g_proxy_resolver_lookup() for more details. - A NULL-terminated array of proxy URIs. Must be freed @@ -59884,35 +57079,30 @@ g_proxy_resolver_lookup() for more details. - - - - - @@ -59923,7 +57113,6 @@ g_proxy_resolver_lookup() for more details. @size bytes. The function should have the same semantics as realloc(). - a pointer to the reallocated memory @@ -59961,7 +57150,6 @@ the exported #GActionGroup implements #GRemoteActionGroup and use the `_full` variants of the calls if available. This provides a mechanism by which to receive platform data for action invocations that arrive by way of D-Bus. - Activates the remote action. @@ -59973,7 +57161,6 @@ interaction timestamp or startup notification information. @platform_data must be non-%NULL and must have the type %G_VARIANT_TYPE_VARDICT. If it is floating, it will be consumed. - @@ -60006,7 +57193,6 @@ user interaction timestamp or startup notification information. @platform_data must be non-%NULL and must have the type %G_VARIANT_TYPE_VARDICT. If it is floating, it will be consumed. - @@ -60039,7 +57225,6 @@ interaction timestamp or startup notification information. @platform_data must be non-%NULL and must have the type %G_VARIANT_TYPE_VARDICT. If it is floating, it will be consumed. - @@ -60072,7 +57257,6 @@ user interaction timestamp or startup notification information. @platform_data must be non-%NULL and must have the type %G_VARIANT_TYPE_VARDICT. If it is floating, it will be consumed. - @@ -60098,13 +57282,11 @@ user interaction timestamp or startup notification information. The virtual function table for #GRemoteActionGroup. - - @@ -60130,7 +57312,6 @@ user interaction timestamp or startup notification information. - @@ -60164,13 +57345,11 @@ g_resolver_lookup_by_name() and their async variants) and SRV #GNetworkAddress and #GNetworkService provide wrappers around #GResolver functionality that also implement #GSocketConnectable, making it easy to connect to a remote host/service. - Frees @addresses (which should be the return value from g_resolver_lookup_by_name() or g_resolver_lookup_by_name_finish()). (This is a convenience method; you can also simply free the results by hand.) - @@ -60188,7 +57367,6 @@ by hand.) g_resolver_lookup_service() or g_resolver_lookup_service_finish()). (This is a convenience method; you can also simply free the results by hand.) - @@ -60205,7 +57383,6 @@ results by hand.) Gets the default #GResolver. You should unref it when you are done with it. #GResolver may use its reference count as a hint about how many threads it should allocate for concurrent DNS resolutions. - the default #GResolver. @@ -60221,7 +57398,6 @@ a value from #GResolverError. If @cancellable is non-%NULL, it can be used to cancel the operation, in which case @error (if non-%NULL) will be set to %G_IO_ERROR_CANCELLED. - a hostname (either ASCII-only, or in ASCII-encoded form), or %NULL on error. @@ -60246,7 +57422,6 @@ operation, in which case @error (if non-%NULL) will be set to Begins asynchronously reverse-resolving @address to determine its associated hostname, and eventually calls @callback, which must call g_resolver_lookup_by_address_finish() to get the final result. - @@ -60280,7 +57455,6 @@ g_resolver_lookup_by_address_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a hostname (either ASCII-only, or in ASCII-encoded form), or %NULL on error. @@ -60321,7 +57495,6 @@ operation, in which case @error (if non-%NULL) will be set to If you are planning to connect to a socket on the resolved IP address, it may be easier to create a #GNetworkAddress and use its #GSocketConnectable interface. - a non-empty #GList of #GInetAddress, or %NULL on error. You @@ -60351,7 +57524,6 @@ done with it. (You can use g_resolver_free_addresses() to do this.) associated IP address(es), and eventually calls @callback, which must call g_resolver_lookup_by_name_finish() to get the result. See g_resolver_lookup_by_name() for more details. - @@ -60385,7 +57557,6 @@ g_resolver_lookup_by_name_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a #GList of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() @@ -60409,7 +57580,6 @@ for more details. This differs from g_resolver_lookup_by_name() in that you can modify the lookup behavior with @flags. For example this can be used to limit results with #G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY. - a non-empty #GList of #GInetAddress, or %NULL on error. You @@ -60443,7 +57613,6 @@ done with it. (You can use g_resolver_free_addresses() to do this.) associated IP address(es), and eventually calls @callback, which must call g_resolver_lookup_by_name_with_flags_finish() to get the result. See g_resolver_lookup_by_name() for more details. - @@ -60481,7 +57650,6 @@ g_resolver_lookup_by_name_with_flags_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a #GList of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() @@ -60512,7 +57680,6 @@ a value from #GResolverError and %NULL will be returned. If @cancellable is non-%NULL, it can be used to cancel the operation, in which case @error (if non-%NULL) will be set to %G_IO_ERROR_CANCELLED. - a non-empty #GList of #GVariant, or %NULL on error. You must free each of the records and the list @@ -60546,7 +57713,6 @@ g_variant_unref() to do this.) @rrname, and eventually calls @callback, which must call g_resolver_lookup_records_finish() to get the final result. See g_resolver_lookup_records() for more details. - @@ -60586,7 +57752,6 @@ records contain. If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a non-empty #GList of #GVariant, or %NULL on error. You must free each of the records and the list @@ -60608,7 +57773,6 @@ g_variant_unref() to do this.) - @@ -60627,7 +57791,6 @@ g_variant_unref() to do this.) - @@ -60656,7 +57819,6 @@ g_resolver_lookup_service_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a non-empty #GList of #GSrvTarget, or %NULL on error. See g_resolver_lookup_service() for more @@ -60677,7 +57839,6 @@ details. - @@ -60697,7 +57858,6 @@ a value from #GResolverError. If @cancellable is non-%NULL, it can be used to cancel the operation, in which case @error (if non-%NULL) will be set to %G_IO_ERROR_CANCELLED. - a hostname (either ASCII-only, or in ASCII-encoded form), or %NULL on error. @@ -60722,7 +57882,6 @@ operation, in which case @error (if non-%NULL) will be set to Begins asynchronously reverse-resolving @address to determine its associated hostname, and eventually calls @callback, which must call g_resolver_lookup_by_address_finish() to get the final result. - @@ -60756,7 +57915,6 @@ g_resolver_lookup_by_address_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a hostname (either ASCII-only, or in ASCII-encoded form), or %NULL on error. @@ -60797,7 +57955,6 @@ operation, in which case @error (if non-%NULL) will be set to If you are planning to connect to a socket on the resolved IP address, it may be easier to create a #GNetworkAddress and use its #GSocketConnectable interface. - a non-empty #GList of #GInetAddress, or %NULL on error. You @@ -60827,7 +57984,6 @@ done with it. (You can use g_resolver_free_addresses() to do this.) associated IP address(es), and eventually calls @callback, which must call g_resolver_lookup_by_name_finish() to get the result. See g_resolver_lookup_by_name() for more details. - @@ -60861,7 +58017,6 @@ g_resolver_lookup_by_name_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a #GList of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() @@ -60885,7 +58040,6 @@ for more details. This differs from g_resolver_lookup_by_name() in that you can modify the lookup behavior with @flags. For example this can be used to limit results with #G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY. - a non-empty #GList of #GInetAddress, or %NULL on error. You @@ -60919,7 +58073,6 @@ done with it. (You can use g_resolver_free_addresses() to do this.) associated IP address(es), and eventually calls @callback, which must call g_resolver_lookup_by_name_with_flags_finish() to get the result. See g_resolver_lookup_by_name() for more details. - @@ -60957,7 +58110,6 @@ g_resolver_lookup_by_name_with_flags_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a #GList of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() @@ -60988,7 +58140,6 @@ a value from #GResolverError and %NULL will be returned. If @cancellable is non-%NULL, it can be used to cancel the operation, in which case @error (if non-%NULL) will be set to %G_IO_ERROR_CANCELLED. - a non-empty #GList of #GVariant, or %NULL on error. You must free each of the records and the list @@ -61022,7 +58173,6 @@ g_variant_unref() to do this.) @rrname, and eventually calls @callback, which must call g_resolver_lookup_records_finish() to get the final result. See g_resolver_lookup_records() for more details. - @@ -61062,7 +58212,6 @@ records contain. If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a non-empty #GList of #GVariant, or %NULL on error. You must free each of the records and the list @@ -61105,7 +58254,6 @@ operation, in which case @error (if non-%NULL) will be set to If you are planning to connect to the service, it is usually easier to create a #GNetworkService and use its #GSocketConnectable interface. - a non-empty #GList of #GSrvTarget, or %NULL on error. You must free each of the targets and the @@ -61144,7 +58292,6 @@ this.) @callback, which must call g_resolver_lookup_service_finish() to get the final result. See g_resolver_lookup_service() for more details. - @@ -61186,7 +58333,6 @@ g_resolver_lookup_service_async(). If the DNS resolution failed, @error (if non-%NULL) will be set to a value from #GResolverError. If the operation was cancelled, @error will be set to %G_IO_ERROR_CANCELLED. - a non-empty #GList of #GSrvTarget, or %NULL on error. See g_resolver_lookup_service() for more @@ -61216,7 +58362,6 @@ caching or "pinning"; it can implement its own #GResolver that calls the original default resolver for DNS operations, and implements its own cache policies on top of that, and then set itself as the default resolver for all later code to use. - @@ -61242,13 +58387,11 @@ configuration has changed. - - @@ -61261,7 +58404,6 @@ configuration has changed. - a non-empty #GList of #GInetAddress, or %NULL on error. You @@ -61289,7 +58431,6 @@ done with it. (You can use g_resolver_free_addresses() to do this.) - @@ -61319,7 +58460,6 @@ done with it. (You can use g_resolver_free_addresses() to do this.) - a #GList of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() @@ -61342,7 +58482,6 @@ for more details. - a hostname (either ASCII-only, or in ASCII-encoded form), or %NULL on error. @@ -61366,7 +58505,6 @@ for more details. - @@ -61396,7 +58534,6 @@ for more details. - a hostname (either ASCII-only, or in ASCII-encoded form), or %NULL on error. @@ -61416,7 +58553,6 @@ form), or %NULL on error. - @@ -61437,7 +58573,6 @@ form), or %NULL on error. - @@ -61462,7 +58597,6 @@ form), or %NULL on error. - a non-empty #GList of #GSrvTarget, or %NULL on error. See g_resolver_lookup_service() for more @@ -61485,7 +58619,6 @@ details. - a non-empty #GList of #GVariant, or %NULL on error. You must free each of the records and the list @@ -61517,7 +58650,6 @@ g_variant_unref() to do this.) - @@ -61551,7 +58683,6 @@ g_variant_unref() to do this.) - a non-empty #GList of #GVariant, or %NULL on error. You must free each of the records and the list @@ -61575,7 +58706,6 @@ g_variant_unref() to do this.) - @@ -61609,7 +58739,6 @@ g_variant_unref() to do this.) - a #GList of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() @@ -61632,7 +58761,6 @@ for more details. - a non-empty #GList of #GInetAddress, or %NULL on error. You @@ -61880,7 +59008,6 @@ version will be used instead. Whiteouts are not currently supported. Substitutions must start with a slash, and must not contain a trailing slash before the '='. The path after the slash should ideally be absolute, but this is not strictly required. It is possible to overlay the location of a single resource with an individual file. - Creates a GResource from a reference to the binary resource bundle. This will keep a reference to @data while the resource lives, so @@ -61894,7 +59021,6 @@ Otherwise this function will internally create a copy of the memory since GLib 2.56, or in older versions fail and exit the process. If @data is empty or corrupt, %G_RESOURCE_ERROR_INTERNAL will be returned. - a new #GResource, or %NULL on error @@ -61910,7 +59036,6 @@ If @data is empty or corrupt, %G_RESOURCE_ERROR_INTERNAL will be returned. Registers the resource with the process-global set of resources. Once a resource is registered the files in it can be accessed with the global resource lookup functions like g_resources_lookup_data(). - @@ -61923,7 +59048,6 @@ with the global resource lookup functions like g_resources_lookup_data(). Unregisters the resource from the process-global set of resources. - @@ -61943,7 +59067,6 @@ If @path is invalid or does not exist in the #GResource, %G_RESOURCE_ERROR_NOT_FOUND will be returned. @lookup_flags controls the behaviour of the lookup. - an array of constant strings @@ -61970,7 +59093,6 @@ If @path is invalid or does not exist in the #GResource, if found returns information about it. @lookup_flags controls the behaviour of the lookup. - %TRUE if the file was found. %FALSE if there were errors @@ -62015,7 +59137,6 @@ in the program binary. For compressed files we allocate memory on the heap and automatically uncompress the data. @lookup_flags controls the behaviour of the lookup. - #GBytes or %NULL on error. Free the returned object with g_bytes_unref() @@ -62041,7 +59162,6 @@ the heap and automatically uncompress the data. returns a #GInputStream that lets you read the data. @lookup_flags controls the behaviour of the lookup. - #GInputStream or %NULL on error. Free the returned object with g_object_unref() @@ -62065,7 +59185,6 @@ returns a #GInputStream that lets you read the data. Atomically increments the reference count of @resource by one. This function is MT-safe and may be called from any thread. - The passed in #GResource @@ -62082,7 +59201,6 @@ function is MT-safe and may be called from any thread. reference count drops to 0, all memory allocated by the resource is released. This function is MT-safe and may be called from any thread. - @@ -62104,7 +59222,6 @@ If @filename is empty or the data in it is corrupt, %G_RESOURCE_ERROR_INTERNAL will be returned. If @filename doesn’t exist, or there is an error in reading it, an error from g_mapped_file_new() will be returned. - a new #GResource, or %NULL on error @@ -62151,35 +59268,30 @@ bundle. - - - - - @@ -62187,305 +59299,261 @@ bundle. Extension point for #GSettingsBackend functionality. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -62506,10 +59574,8 @@ truncated. #GSeekable on resizable streams is approximately the same as POSIX lseek() on a normal file. Seeking past the end and writing data will usually cause the stream to resize by introducing zero bytes. - Tests if the stream supports the #GSeekableIface. - %TRUE if @seekable can be seeked. %FALSE otherwise. @@ -62524,7 +59590,6 @@ usually cause the stream to resize by introducing zero bytes. Tests if the length of the stream can be adjusted with g_seekable_truncate(). - %TRUE if the stream can be truncated, %FALSE otherwise. @@ -62551,7 +59616,6 @@ Any operation that would result in a negative offset will fail. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -62579,7 +59643,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Tells the current position within the stream. - the offset from the beginning of the buffer. @@ -62601,7 +59664,6 @@ triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an operation was partially finished when the operation was cancelled the partial result will be returned, without an error. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -62625,7 +59687,6 @@ partial result will be returned, without an error. Tests if the stream supports the #GSeekableIface. - %TRUE if @seekable can be seeked. %FALSE otherwise. @@ -62640,7 +59701,6 @@ partial result will be returned, without an error. Tests if the length of the stream can be adjusted with g_seekable_truncate(). - %TRUE if the stream can be truncated, %FALSE otherwise. @@ -62667,7 +59727,6 @@ Any operation that would result in a negative offset will fail. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -62695,7 +59754,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. Tells the current position within the stream. - the offset from the beginning of the buffer. @@ -62717,7 +59775,6 @@ triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an operation was partially finished when the operation was cancelled the partial result will be returned, without an error. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -62742,14 +59799,12 @@ partial result will be returned, without an error. Provides an interface for implementing seekable functionality on I/O Streams. - The parent interface. - the offset from the beginning of the buffer. @@ -62764,7 +59819,6 @@ partial result will be returned, without an error. - %TRUE if @seekable can be seeked. %FALSE otherwise. @@ -62779,7 +59833,6 @@ partial result will be returned, without an error. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -62808,7 +59861,6 @@ partial result will be returned, without an error. - %TRUE if the stream can be truncated, %FALSE otherwise. @@ -62823,7 +59875,6 @@ partial result will be returned, without an error. - %TRUE if successful. If an error has occurred, this function will return %FALSE and set @error @@ -63135,7 +60186,6 @@ which are specified in `gsettings_ENUM_FILES`. This will generate a automatically included in the schema compilation, install and uninstall rules. It should not be committed to version control or included in `EXTRA_DIST`. - Creates a new #GSettings object with the schema specified by @schema_id. @@ -63150,7 +60200,6 @@ Signals on the newly created #GSettings object will be dispatched via the thread-default #GMainContext in effect at the time of the call to g_settings_new(). The new #GSettings will hold a reference on the context. See g_main_context_push_thread_default(). - a new #GSettings object @@ -63186,7 +60235,6 @@ If @path is %NULL then the path from the schema is used. It is an error if @path is %NULL and the schema has no path of its own or if @path is non-%NULL and not equal to the path that the schema does have. - a new #GSettings object @@ -63215,7 +60263,6 @@ settings from a database other than the usual one. For example, it may make sense to pass a backend corresponding to the "defaults" settings database on the system to get a settings object that modifies the system default settings instead of the settings for this user. - a new #GSettings object @@ -63237,7 +60284,6 @@ settings instead of the settings for this user. This is a mix of g_settings_new_with_backend() and g_settings_new_with_path(). - a new #GSettings object @@ -63271,7 +60317,6 @@ has an explicitly specified path. It is a programmer error if @path is not a valid path. A valid path begins and ends with '/' and does not contain two consecutive '/' characters. - a new #GSettings object @@ -63290,7 +60335,6 @@ characters. Deprecated. Use g_settings_schema_source_list_schemas() instead - a list of relocatable #GSettings schemas that are available, in no defined order. The list must @@ -63306,7 +60350,6 @@ characters. If you used g_settings_list_schemas() to check for the presence of a particular schema, use g_settings_schema_source_lookup() instead of your whole loop. - a list of #GSettings schemas that are available, in no defined order. The list must not be @@ -63327,7 +60370,6 @@ This call will block until all of the writes have made it to the backend. Since the mainloop is not running, no change notifications will be dispatched during this call (but some may be queued by the time the call is done). - @@ -63338,7 +60380,6 @@ time the call is done). Note that bindings are automatically removed when the object is finalized, so it is rarely necessary to call this function. - @@ -63354,7 +60395,6 @@ function. - @@ -63371,7 +60411,6 @@ function. - @@ -63385,7 +60424,6 @@ function. - @@ -63399,7 +60437,6 @@ function. - @@ -63417,7 +60454,6 @@ function. function does nothing unless @settings is in 'delay-apply' mode; see g_settings_delay(). In the normal case settings are always applied immediately. - @@ -63449,7 +60485,6 @@ Note that the lifecycle of the binding is tied to @object, and that you can have only one binding per object property. If you bind the same property twice on the same object, the second binding overrides the first one. - @@ -63487,7 +60522,6 @@ Note that the lifecycle of the binding is tied to @object, and that you can have only one binding per object property. If you bind the same property twice on the same object, the second binding overrides the first one. - @@ -63550,7 +60584,6 @@ Note that the lifecycle of the binding is tied to @object, and that you can have only one binding per object property. If you bind the same property twice on the same object, the second binding overrides the first one. - @@ -63592,7 +60625,6 @@ For boolean-valued keys, action activations take no parameter and result in the toggling of the value. For all other types, activations take the new value for the key (which must have the correct type). - a new #GAction @@ -63612,7 +60644,6 @@ correct type). Changes the #GSettings object into 'delay-apply' mode. In this mode, changes to @settings are not immediately propagated to the backend, but kept locally until g_settings_apply() is called. - @@ -63632,7 +60663,6 @@ g_variant_get(). It is a programmer error to give a @key that isn't contained in the schema for @settings or for the #GVariantType of @format to mismatch the type given in the schema. - @@ -63662,7 +60692,6 @@ A convenience variant of g_settings_get() for booleans. It is a programmer error to give a @key that isn't specified as having a boolean type in the schema for @settings. - a boolean @@ -63685,7 +60714,6 @@ having a boolean type in the schema for @settings. The schema for the child settings object must have been declared in the schema of @settings using a <child> element. - a 'child' settings object @@ -63723,7 +60751,6 @@ the default value was before the user set it. It is a programmer error to give a @key that isn't contained in the schema for @settings. - the default value @@ -63746,7 +60773,6 @@ A convenience variant of g_settings_get() for doubles. It is a programmer error to give a @key that isn't specified as having a 'double' type in the schema for @settings. - a double @@ -63775,7 +60801,6 @@ schema for @settings or is not marked as an enumerated type. If the value stored in the configuration database is not a valid value for the enumerated type then this function will return the default value. - the enum value @@ -63804,7 +60829,6 @@ schema for @settings or is not marked as a flags type. If the value stored in the configuration database is not a valid value for the flags type then this function will return the default value. - the flags value @@ -63823,7 +60847,6 @@ value. Returns whether the #GSettings object has any unapplied changes. This can only be the case if it is in 'delayed-apply' mode. - %TRUE if @settings has unapplied changes @@ -63842,7 +60865,6 @@ A convenience variant of g_settings_get() for 32-bit integers. It is a programmer error to give a @key that isn't specified as having a int32 type in the schema for @settings. - an integer @@ -63865,7 +60887,6 @@ A convenience variant of g_settings_get() for 64-bit integers. It is a programmer error to give a @key that isn't specified as having a int64 type in the schema for @settings. - a 64-bit integer @@ -63909,7 +60930,6 @@ The result parameter for the @mapping function is pointed to a to each invocation of @mapping. The final value of that #gpointer is what is returned by this function. %NULL is valid; it is returned just as any other value would be. - the result, which may be %NULL @@ -63937,7 +60957,6 @@ just as any other value would be. Queries the range of a key. Use g_settings_schema_key_get_range() instead. - @@ -63959,7 +60978,6 @@ A convenience variant of g_settings_get() for strings. It is a programmer error to give a @key that isn't specified as having a string type in the schema for @settings. - a newly-allocated string @@ -63980,7 +60998,6 @@ having a string type in the schema for @settings. It is a programmer error to give a @key that isn't specified as having an array of strings type in the schema for @settings. - a newly-allocated, %NULL-terminated array of strings, the value that @@ -64008,7 +61025,6 @@ integers. It is a programmer error to give a @key that isn't specified as having a uint32 type in the schema for @settings. - an unsigned integer @@ -64032,7 +61048,6 @@ integers. It is a programmer error to give a @key that isn't specified as having a uint64 type in the schema for @settings. - a 64-bit unsigned integer @@ -64067,7 +61082,6 @@ for providing indication that a particular value has been changed. It is a programmer error to give a @key that isn't contained in the schema for @settings. - the user's value, if set @@ -64088,7 +61102,6 @@ schema for @settings. It is a programmer error to give a @key that isn't contained in the schema for @settings. - a new #GVariant @@ -64106,7 +61119,6 @@ schema for @settings. Finds out if a key can be written or not - %TRUE if the key @name is writable @@ -64134,7 +61146,6 @@ may still be useful there for introspection reasons, however. You should free the return value with g_strfreev() when you are done with it. - a list of the children on @settings, in no defined order @@ -64159,7 +61170,6 @@ function is intended for introspection reasons. You should free the return value with g_strfreev() when you are done with it. Use g_settings_schema_list_keys() instead. - a list of the keys on @settings, in no defined order @@ -64178,7 +61188,6 @@ with it. Checks if the given @value is of the correct type and within the permitted range for @key. Use g_settings_schema_key_range_check() instead. - %TRUE if @value is valid for @key @@ -64204,7 +61213,6 @@ permitted range for @key. This call resets the key, as much as possible, to its default value. That might be the value specified in the schema or the one set by the administrator. - @@ -64226,7 +61234,6 @@ g_settings_delay(). In the normal case settings are always applied immediately. Change notifications will be emitted for affected keys. - @@ -64246,7 +61253,6 @@ g_variant_new(). It is a programmer error to give a @key that isn't contained in the schema for @settings or for the #GVariantType of @format to mismatch the type given in the schema. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64278,7 +61284,6 @@ A convenience variant of g_settings_set() for booleans. It is a programmer error to give a @key that isn't specified as having a boolean type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64306,7 +61311,6 @@ A convenience variant of g_settings_set() for doubles. It is a programmer error to give a @key that isn't specified as having a 'double' type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64338,7 +61342,6 @@ schema for @settings or is not marked as an enumerated type, or for After performing the write, accessing @key directly with g_settings_get_string() will return the 'nick' associated with @value. - %TRUE, if the set succeeds @@ -64370,7 +61373,6 @@ to contain any bits that are not value for the named type. After performing the write, accessing @key directly with g_settings_get_strv() will return an array of 'nicks'; one for each bit in @value. - %TRUE, if the set succeeds @@ -64397,7 +61399,6 @@ A convenience variant of g_settings_set() for 32-bit integers. It is a programmer error to give a @key that isn't specified as having a int32 type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64425,7 +61426,6 @@ A convenience variant of g_settings_set() for 64-bit integers. It is a programmer error to give a @key that isn't specified as having a int64 type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64453,7 +61453,6 @@ A convenience variant of g_settings_set() for strings. It is a programmer error to give a @key that isn't specified as having a string type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64482,7 +61481,6 @@ A convenience variant of g_settings_set() for string arrays. If It is a programmer error to give a @key that isn't specified as having an array of strings type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64513,7 +61511,6 @@ integers. It is a programmer error to give a @key that isn't specified as having a uint32 type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64542,7 +61539,6 @@ integers. It is a programmer error to give a @key that isn't specified as having a uint64 type in the schema for @settings. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64571,7 +61567,6 @@ schema for @settings or for @value to have the incorrect type, per the schema. If @value is floating then this function consumes the reference. - %TRUE if setting the key succeeded, %FALSE if the key was not writable @@ -64776,7 +61771,6 @@ implementations, but does not carry the same stability guarantees as the public GIO API. For this reason, you have to define the C preprocessor symbol %G_SETTINGS_ENABLE_BACKEND before including `gio/gsettingsbackend.h`. - Calculate the longest common prefix of all keys in a tree and write out an array of the key names relative to that prefix and, @@ -64785,7 +61779,6 @@ optionally, the value to store at each of those keys. You must free the value returned in @path, @keys and @values using g_free(). You should not attempt to free or unref the contents of @keys or @values. - @@ -64820,14 +61813,12 @@ the default by setting the `GSETTINGS_BACKEND` environment variable to the name of a settings backend. The user gets a reference to the backend. - the default #GSettingsBackend - @@ -64841,7 +61832,6 @@ The user gets a reference to the backend. - @@ -64855,7 +61845,6 @@ The user gets a reference to the backend. - @@ -64875,7 +61864,6 @@ The user gets a reference to the backend. - @@ -64892,7 +61880,6 @@ The user gets a reference to the backend. - @@ -64909,7 +61896,6 @@ The user gets a reference to the backend. - @@ -64923,7 +61909,6 @@ The user gets a reference to the backend. - @@ -64934,7 +61919,6 @@ The user gets a reference to the backend. - @@ -64948,7 +61932,6 @@ The user gets a reference to the backend. - @@ -64968,7 +61951,6 @@ The user gets a reference to the backend. - @@ -65007,7 +61989,6 @@ g_settings_backend_write()). In the case that this call is in response to a call to g_settings_backend_write() then @origin_tag must be set to the same value that was passed to that call. - @@ -65030,7 +62011,6 @@ value that was passed to that call. This call is a convenience wrapper. It gets the list of changes from @tree, computes the longest common prefix and calls g_settings_backend_changed(). - @@ -65071,7 +62051,6 @@ case g_settings_backend_changed() is definitely preferred). For efficiency reasons, the implementation should strive for @path to be as long as possible (ie: the longest common prefix of all of the keys that were changed) but this is not strictly required. - @@ -65118,7 +62097,6 @@ be as long as possible (ie: the longest common prefix of all of the keys that were changed) but this is not strictly required. As an example, if this function is called with the path of "/" then every single key in the application will be notified of a possible change. - @@ -65143,7 +62121,6 @@ changed. Since GSettings performs no locking operations for itself, this call will always be made in response to external events. - @@ -65163,7 +62140,6 @@ will always be made in response to external events. Since GSettings performs no locking operations for itself, this call will always be made in response to external events. - @@ -65187,13 +62163,11 @@ will always be made in response to external events. Class structure for #GSettingsBackend. - - @@ -65215,7 +62189,6 @@ will always be made in response to external events. - @@ -65231,7 +62204,6 @@ will always be made in response to external events. - @@ -65253,7 +62225,6 @@ will always be made in response to external events. - @@ -65272,7 +62243,6 @@ will always be made in response to external events. - @@ -65291,7 +62261,6 @@ will always be made in response to external events. - @@ -65307,7 +62276,6 @@ will always be made in response to external events. - @@ -65323,7 +62291,6 @@ will always be made in response to external events. - @@ -65336,7 +62303,6 @@ will always be made in response to external events. - @@ -65352,7 +62318,6 @@ will always be made in response to external events. - @@ -65410,7 +62375,6 @@ directions. The type for the function that is used to convert from #GSettings to an object property. The @value is already initialized to hold values of the appropriate type. - %TRUE if the conversion succeeded, %FALSE in case of an error @@ -65433,7 +62397,6 @@ of the appropriate type. The type for the function that is used to convert an object property value to a #GVariant for storing it in #GSettings. - a new #GVariant holding the data from @value, or %NULL in case of an error @@ -65455,13 +62418,11 @@ value to a #GVariant for storing it in #GSettings. - - @@ -65477,7 +62438,6 @@ value to a #GVariant for storing it in #GSettings. - @@ -65493,7 +62453,6 @@ value to a #GVariant for storing it in #GSettings. - @@ -65509,7 +62468,6 @@ value to a #GVariant for storing it in #GSettings. - @@ -65543,7 +62501,6 @@ is not in the right format) then %FALSE should be returned. If @value is %NULL then it means that the mapping function is being given a "last chance" to successfully return a valid value. %TRUE must be returned in this case. - %TRUE if the conversion succeeded, %FALSE in case of an error @@ -65658,10 +62615,8 @@ It's also possible that the plugin system expects the schema source files (ie: .gschema.xml files) instead of a gschemas.compiled file. In that case, the plugin loading system must compile the schemas for itself before attempting to create the settings source. - Get the ID of @schema. - the ID @@ -65678,7 +62633,6 @@ itself before attempting to create the settings source. It is a programmer error to request a key that does not exist. See g_settings_schema_list_keys(). - the #GSettingsSchemaKey for @name @@ -65704,7 +62658,6 @@ database: those located at the path returned by this function. Relocatable schemas can be referenced by other schemas and can therefore describe multiple sets of keys at different locations. For relocatable schemas, this function will return %NULL. - the path of the schema, or %NULL @@ -65718,7 +62671,6 @@ relocatable schemas, this function will return %NULL. Checks if @schema has a key named @name. - %TRUE if such a key exists @@ -65739,7 +62691,6 @@ relocatable schemas, this function will return %NULL. You should free the return value with g_strfreev() when you are done with it. - a list of the children on @settings, in no defined order @@ -65760,7 +62711,6 @@ with it. You should probably not be calling this function from "normal" code (since you should already know what keys are in your schema). This function is intended for introspection reasons. - a list of the keys on @schema, in no defined order @@ -65777,7 +62727,6 @@ function is intended for introspection reasons. Increase the reference count of @schema, returning a new reference. - a new reference to @schema @@ -65791,7 +62740,6 @@ function is intended for introspection reasons. Decrease the reference count of @schema, possibly freeing it. - @@ -65806,13 +62754,11 @@ function is intended for introspection reasons. #GSettingsSchemaKey is an opaque data structure and can only be accessed using the following functions. - Gets the default value for @key. Note that this is the default value according to the schema. System administrator defaults and lockdown are not visible via this API. - the default value for the key @@ -65839,7 +62785,6 @@ This function is slow. The summary and description information for the schemas is not stored in the compiled schema database so this function has to parse all of the source XML files in the schema directory. - the description for @key, or %NULL @@ -65853,7 +62798,6 @@ directory. Gets the name of @key. - the name of @key. @@ -65902,7 +62846,6 @@ forms may be added to the possibilities described above. You should free the returned value with g_variant_unref() when it is no longer needed. - a #GVariant describing the range @@ -65928,7 +62871,6 @@ This function is slow. The summary and description information for the schemas is not stored in the compiled schema database so this function has to parse all of the source XML files in the schema directory. - the summary for @key, or %NULL @@ -65942,7 +62884,6 @@ directory. Gets the #GVariantType of @key. - the type of @key @@ -65960,7 +62901,6 @@ permitted range for @key. It is a programmer error if @value is not of the correct type -- you must check for this first. - %TRUE if @value is valid for @key @@ -65978,7 +62918,6 @@ must check for this first. Increase the reference count of @key, returning a new reference. - a new reference to @key @@ -65992,7 +62931,6 @@ must check for this first. Decrease the reference count of @key, possibly freeing it. - @@ -66006,7 +62944,6 @@ must check for this first. This is an opaque structure type. You may not access it directly. - Attempts to create a new schema source corresponding to the contents of the given directory. @@ -66039,7 +62976,6 @@ from the @parent. For this second reason, except in very unusual situations, the @parent should probably be given as the default schema source, as returned by g_settings_schema_source_get_default(). - @@ -66071,7 +63007,6 @@ use g_settings_new_with_path(). Do not call this function from normal programs. This is designed for use by database editors, commandline tools, etc. - @@ -66111,7 +63046,6 @@ If the schema isn't found directly in @source and @recursive is %TRUE then the parent sources will also be checked. If the schema isn't found, %NULL is returned. - a new #GSettingsSchema @@ -66133,7 +63067,6 @@ If the schema isn't found, %NULL is returned. Increase the reference count of @source, returning a new reference. - a new reference to @source @@ -66147,7 +63080,6 @@ If the schema isn't found, %NULL is returned. Decrease the reference count of @source, possibly freeing it. - @@ -66172,7 +63104,6 @@ from different directories, depending on which directories were given in `XDG_DATA_DIRS` and `GSETTINGS_SCHEMA_DIR`. For this reason, all lookups performed against the default source should probably be done recursively. - the default schema source @@ -66191,7 +63122,6 @@ See also #GtkAction. The created action is stateless. See g_simple_action_new_stateful() to create an action that has state. - a new #GSimpleAction @@ -66215,7 +63145,6 @@ All future state values must have the same #GVariantType as the initial @state. If the @state #GVariant is floating, it is consumed. - a new #GSimpleAction @@ -66244,7 +63173,6 @@ have its state changed from outside callers. This should only be called by the implementor of the action. Users of the action should not attempt to modify its enabled flag. - @@ -66270,7 +63198,6 @@ property. Instead, they should call g_action_change_state() to request the change. If the @value GVariant is floating, it is consumed. - @@ -66290,7 +63217,6 @@ If the @value GVariant is floating, it is consumed. See g_action_get_state_hint() for more information about action state hints. - @@ -66404,12 +63330,10 @@ It could set it to any value at all, or take some other action. #GSimpleActionGroup is a hash table filled with #GAction objects, implementing the #GActionGroup and #GActionMap interfaces. - Creates a new, empty, #GSimpleActionGroup. - a new #GSimpleActionGroup @@ -66419,7 +63343,6 @@ implementing the #GActionGroup and #GActionMap interfaces. A convenience function for creating multiple #GSimpleAction instances and adding them to the action group. Use g_action_map_add_action_entries() - @@ -66453,7 +63376,6 @@ If the action group already contains an action with the same name as The action group takes its own reference on @action. Use g_action_map_add_action() - @@ -66473,7 +63395,6 @@ The action group takes its own reference on @action. If no such action exists, returns %NULL. Use g_action_map_lookup_action() - a #GAction, or %NULL @@ -66494,7 +63415,6 @@ If no such action exists, returns %NULL. If no action of this name is in the group then nothing happens. Use g_action_map_remove_action() - @@ -66517,7 +63437,6 @@ If no action of this name is in the group then nothing happens. - @@ -66696,7 +63615,6 @@ baker_bake_cake_finish (Baker *self, return g_object_ref (cake); } ]| - Creates a #GSimpleAsyncResult. @@ -66710,7 +63628,6 @@ probably should) then you should provide the user's cancellable to g_simple_async_result_set_check_cancellable() immediately after this function returns. Use g_task_new() instead. - a #GSimpleAsyncResult. @@ -66737,7 +63654,6 @@ this function returns. Creates a new #GSimpleAsyncResult with a set error. Use g_task_new() and g_task_return_new_error() instead. - a #GSimpleAsyncResult. @@ -66776,7 +63692,6 @@ this function returns. Creates a #GSimpleAsyncResult from an error condition. Use g_task_new() and g_task_return_error() instead. - a #GSimpleAsyncResult. @@ -66804,7 +63719,6 @@ this function returns. Creates a #GSimpleAsyncResult from an error condition, and takes over the caller's ownership of @error, so the caller does not need to free it anymore. Use g_task_new() and g_task_return_error() instead. - a #GSimpleAsyncResult @@ -66842,7 +63756,6 @@ which this function is called). (Alternatively, if either @source_tag or @result's source tag is %NULL, then the source tag check is skipped.) Use #GTask and g_task_is_valid() instead. - #TRUE if all checks passed or #FALSE if any failed. @@ -66871,7 +63784,6 @@ g_simple_async_result_complete_in_idle(). Calling this function takes a reference to @simple for as long as is needed to complete the call. Use #GTask instead. - @@ -66891,7 +63803,6 @@ of the thread that @simple was initially created in Calling this function takes a reference to @simple for as long as is needed to complete the call. Use #GTask instead. - @@ -66905,7 +63816,6 @@ is needed to complete the call. Gets the operation result boolean from within the asynchronous result. Use #GTask and g_task_propagate_boolean() instead. - %TRUE if the operation's result was %TRUE, %FALSE if the operation's result was %FALSE. @@ -66921,7 +63831,6 @@ is needed to complete the call. Gets a pointer result as returned by the asynchronous function. Use #GTask and g_task_propagate_pointer() instead. - a pointer from the result. @@ -66936,7 +63845,6 @@ is needed to complete the call. Gets a gssize from the asynchronous result. Use #GTask and g_task_propagate_int() instead. - a gssize returned from the asynchronous function. @@ -66951,7 +63859,6 @@ is needed to complete the call. Gets the source tag for the #GSimpleAsyncResult. Use #GTask and g_task_get_source_tag() instead. - a #gpointer to the source object for the #GSimpleAsyncResult. @@ -66971,7 +63878,6 @@ If the #GCancellable given to a prior call to g_simple_async_result_set_check_cancellable() is cancelled then this function will return %TRUE with @dest set appropriately. Use #GTask instead. - %TRUE if the error was propagated to @dest. %FALSE otherwise. @@ -66991,7 +63897,6 @@ the result to the appropriate main loop. Calling this function takes a reference to @simple for as long as is needed to run the job and report its completion. Use #GTask and g_task_run_in_thread() instead. - @@ -67031,7 +63936,6 @@ already been sent as an idle to the main context to be dispatched). The checking described above is done regardless of any call to the unrelated g_simple_async_result_set_handle_cancellation() function. Use #GTask instead. - @@ -67049,7 +63953,6 @@ unrelated g_simple_async_result_set_handle_cancellation() function. Sets an error within the asynchronous result without a #GError. Use #GTask and g_task_return_new_error() instead. - @@ -67080,7 +63983,6 @@ unrelated g_simple_async_result_set_handle_cancellation() function. Sets an error within the asynchronous result without a #GError. Unless writing a binding, see g_simple_async_result_set_error(). Use #GTask and g_task_return_error() instead. - @@ -67110,7 +64012,6 @@ Unless writing a binding, see g_simple_async_result_set_error(). Sets the result from a #GError. Use #GTask and g_task_return_error() instead. - @@ -67131,7 +64032,6 @@ Unless writing a binding, see g_simple_async_result_set_error(). This function has nothing to do with g_simple_async_result_set_check_cancellable(). It only refers to the #GCancellable passed to g_simple_async_result_run_in_thread(). - @@ -67149,7 +64049,6 @@ g_simple_async_result_set_check_cancellable(). It only refers to the Sets the operation result to a boolean within the asynchronous result. Use #GTask and g_task_return_boolean() instead. - @@ -67167,7 +64066,6 @@ g_simple_async_result_set_check_cancellable(). It only refers to the Sets the operation result within the asynchronous result to a pointer. Use #GTask and g_task_return_pointer() instead. - @@ -67190,7 +64088,6 @@ g_simple_async_result_set_check_cancellable(). It only refers to the Sets the operation result within the asynchronous result to the given @op_res. Use #GTask and g_task_return_int() instead. - @@ -67209,7 +64106,6 @@ the given @op_res. Sets the result from @error, and takes over the caller's ownership of @error, so the caller does not need to free it any more. Use #GTask and g_task_return_error() instead. - @@ -67231,7 +64127,6 @@ of @error, so the caller does not need to free it any more. Simple thread function that runs an asynchronous operation and checks for cancellation. - @@ -67262,7 +64157,6 @@ to take advantage of the methods provided by #GIOStream. Creates a new #GSimpleIOStream wrapping @input_stream and @output_stream. See also #GIOStream. - a new #GSimpleIOStream instance. @@ -67294,7 +64188,6 @@ Calling request or release will result in errors. Creates a new #GPermission instance that represents an action that is either always or never allowed. - the #GSimplePermission, as a #GPermission @@ -67316,14 +64209,12 @@ proxies, and a list of hosts that proxies should not be used for. can be used as the base class for another proxy resolver implementation, or it can be created and used manually, such as with g_socket_client_set_proxy_resolver(). - Creates a new #GSimpleProxyResolver. See #GSimpleProxyResolver:default-proxy and #GSimpleProxyResolver:ignore-hosts for more details on how the arguments are interpreted. - a new #GSimpleProxyResolver @@ -67349,7 +64240,6 @@ via g_simple_proxy_resolver_set_uri_proxy(). If @default_proxy starts with "socks://", #GSimpleProxyResolver will treat it as referring to all three of the socks5, socks4a, and socks4 proxy types. - @@ -67369,7 +64259,6 @@ the socks5, socks4a, and socks4 proxy types. See #GSimpleProxyResolver:ignore-hosts for more details on how the @ignore_hosts argument is interpreted. - @@ -67394,7 +64283,6 @@ As with #GSimpleProxyResolver:default-proxy, if @proxy starts with "socks://", #GSimpleProxyResolver will treat it as referring to all three of the socks5, socks4a, and socks4 proxy types. - @@ -67470,13 +64358,11 @@ commonly used by other applications. - - @@ -67484,7 +64370,6 @@ commonly used by other applications. - @@ -67492,7 +64377,6 @@ commonly used by other applications. - @@ -67500,7 +64384,6 @@ commonly used by other applications. - @@ -67508,7 +64391,6 @@ commonly used by other applications. - @@ -67570,7 +64452,6 @@ if it tries to write to %stdout after it has been closed. Like most other APIs in GLib, #GSocket is not inherently thread safe. To use a #GSocket concurrently from multiple threads, you must implement your own locking. - @@ -67587,7 +64468,6 @@ the family and type. The protocol id is passed directly to the operating system, so you can use protocols not listed in #GSocketProtocol if you know the protocol number used for it. - a #GSocket or %NULL on error. Free the returned object with g_object_unref(). @@ -67622,7 +64502,6 @@ caller must close @fd themselves. Since GLib 2.46, it is no longer a fatal error to call this on a non-socket descriptor. Instead, a GError will be set with code %G_IO_ERROR_FAILED - a #GSocket or %NULL on error. Free the returned object with g_object_unref(). @@ -67646,7 +64525,6 @@ must be listening for incoming connections (g_socket_listen()). If there are no outstanding connections then the operation will block or return %G_IO_ERROR_WOULD_BLOCK if non-blocking I/O is enabled. To be notified of an incoming connection, wait for the %G_IO_IN condition. - a new #GSocket, or %NULL on error. Free the returned object with g_object_unref(). @@ -67687,7 +64565,6 @@ time. In particular, you can have several UDP sockets bound to the same address, and they will all receive all of the multicast and broadcast packets sent to that address. (The behavior of unicast UDP packets to an address with multiple listeners is not defined.) - %TRUE on success, %FALSE on error. @@ -67711,7 +64588,6 @@ UDP packets to an address with multiple listeners is not defined.) Checks and resets the pending connect error for the socket. This is used to check for errors when g_socket_connect() is used in non-blocking mode. - %TRUE if no error, %FALSE otherwise, setting @error to the error @@ -67753,7 +64629,6 @@ connection, after which the server can safely call g_socket_close(). g_tcp_connection_set_graceful_disconnect(). But of course, this only works if the client will close its connection after the server does.) - %TRUE on success, %FALSE on error @@ -67783,7 +64658,6 @@ It is meaningless to specify %G_IO_ERR or %G_IO_HUP in condition; these conditions will always be set in the output if they are true. This call never blocks. - the @GIOCondition mask of the current state @@ -67816,7 +64690,6 @@ Note that although @timeout_us is in microseconds for consistency with other GLib APIs, this function actually only has millisecond resolution, and the behavior is undefined if @timeout_us is not an exact number of milliseconds. - %TRUE if the condition was met, %FALSE otherwise @@ -67851,7 +64724,6 @@ the appropriate value (%G_IO_ERROR_CANCELLED or %G_IO_ERROR_TIMED_OUT). See also g_socket_condition_timed_wait(). - %TRUE if the condition was met, %FALSE otherwise @@ -67888,7 +64760,6 @@ non-blocking I/O is enabled. Then %G_IO_ERROR_PENDING is returned and the user can be notified of the connection finishing by waiting for the G_IO_OUT condition. The result of the connection must then be checked with g_socket_check_connect_result(). - %TRUE if connected, %FALSE on error. @@ -67911,7 +64782,6 @@ checked with g_socket_check_connect_result(). Creates a #GSocketConnection subclass of the right type for @socket. - a #GSocketConnection @@ -67944,7 +64814,6 @@ occurs, the source will then trigger anyway, reporting %G_IO_IN or %G_IO_OUT depending on @condition. However, @socket will have been marked as having had a timeout, and so the next #GSocket I/O method you call will then fail with a %G_IO_ERROR_TIMED_OUT. - a newly allocated %GSource, free with g_source_unref(). @@ -67977,7 +64846,6 @@ of the incoming packet, it is better to just do a g_socket_receive() with a buffer of that size, rather than calling g_socket_get_available_bytes() first and then doing a receive of exactly the right size. - the number of bytes that can be read from the socket without blocking or truncating, or -1 on error. @@ -67993,7 +64861,6 @@ without blocking or truncating, or -1 on error. Gets the blocking mode of the socket. For details on blocking I/O, see g_socket_set_blocking(). - %TRUE if blocking I/O is used, %FALSE otherwise. @@ -68009,7 +64876,6 @@ see g_socket_set_blocking(). Gets the broadcast setting on @socket; if %TRUE, it is possible to send packets to broadcast addresses. - the broadcast setting on @socket @@ -68042,7 +64908,6 @@ Other ways to obtain credentials from a foreign peer includes the #GUnixCredentialsMessage type and g_unix_connection_send_credentials() / g_unix_connection_receive_credentials() functions. - %NULL if @error is set, otherwise a #GCredentials object that must be freed with g_object_unref(). @@ -68057,7 +64922,6 @@ that must be freed with g_object_unref(). Gets the socket family of the socket. - a #GSocketFamily @@ -68075,7 +64939,6 @@ is a socket file descriptor, and on Windows this is a Winsock2 SOCKET handle. This may be useful for doing platform specific or otherwise unusual operations on the socket. - the file descriptor of the socket. @@ -68090,7 +64953,6 @@ on the socket. Gets the keepalive mode of the socket. For details on this, see g_socket_set_keepalive(). - %TRUE if keepalive is active, %FALSE otherwise. @@ -68105,7 +64967,6 @@ see g_socket_set_keepalive(). Gets the listen backlog setting of the socket. For details on this, see g_socket_set_listen_backlog(). - the maximum number of pending connections. @@ -68121,7 +64982,6 @@ see g_socket_set_listen_backlog(). Try to get the local address of a bound socket. This is only useful if the socket has been bound to a local address, either explicitly or implicitly when connecting. - a #GSocketAddress or %NULL on error. Free the returned object with g_object_unref(). @@ -68138,7 +64998,6 @@ either explicitly or implicitly when connecting. Gets the multicast loopback setting on @socket; if %TRUE (the default), outgoing multicast packets will be looped back to multicast listeners on the same host. - the multicast loopback setting on @socket @@ -68153,7 +65012,6 @@ multicast listeners on the same host. Gets the multicast time-to-live setting on @socket; see g_socket_set_multicast_ttl() for more details. - the multicast time-to-live setting on @socket @@ -68179,7 +65037,6 @@ headers. Note that even for socket options that are a single byte in size, @value is still a pointer to a #gint variable, not a #guchar; g_socket_get_option() will handle the conversion internally. - success or failure. On failure, @error will be set, and the system error value (`errno` or WSAGetLastError()) will still @@ -68208,7 +65065,6 @@ g_socket_get_option() will handle the conversion internally. Gets the socket protocol id the socket was created with. In case the protocol is unknown, -1 is returned. - a protocol id, or -1 if unknown @@ -68223,7 +65079,6 @@ In case the protocol is unknown, -1 is returned. Try to get the remote address of a connected socket. This is only useful for connection oriented sockets that have been connected. - a #GSocketAddress or %NULL on error. Free the returned object with g_object_unref(). @@ -68238,7 +65093,6 @@ useful for connection oriented sockets that have been connected. Gets the socket type of the socket. - a #GSocketType @@ -68253,7 +65107,6 @@ useful for connection oriented sockets that have been connected. Gets the timeout setting of the socket. For details on this, see g_socket_set_timeout(). - the timeout in seconds @@ -68268,7 +65121,6 @@ g_socket_set_timeout(). Gets the unicast time-to-live setting on @socket; see g_socket_set_ttl() for more details. - the time-to-live setting on @socket @@ -68282,7 +65134,6 @@ g_socket_set_ttl() for more details. Checks whether a socket is closed. - %TRUE if socket is closed, %FALSE otherwise @@ -68302,7 +65153,6 @@ If using g_socket_shutdown(), this function will return %TRUE until the socket has been shut down for reading and writing. If you do a non-blocking connect, this function will not return %TRUE until after you call g_socket_check_connect_result(). - %TRUE if socket is connected, %FALSE otherwise. @@ -68329,7 +65179,6 @@ with a %G_IO_ERROR_NOT_SUPPORTED error. To bind to a given source-specific multicast address, use g_socket_join_multicast_group_ssm() instead. - %TRUE on success, %FALSE on error. @@ -68369,7 +65218,6 @@ with a %G_IO_ERROR_NOT_SUPPORTED error. Note that this function can be called multiple times for the same @group with different @source_specific in order to receive multicast packets from more than one source. - %TRUE on success, %FALSE on error. @@ -68404,7 +65252,6 @@ unicast messages after calling this. To unbind to a given source-specific multicast address, use g_socket_leave_multicast_group_ssm() instead. - %TRUE on success, %FALSE on error. @@ -68435,7 +65282,6 @@ when you joined the group). @socket remains bound to its address and port, and can still receive unicast messages after calling this. - %TRUE on success, %FALSE on error. @@ -68469,7 +65315,6 @@ g_socket_bind(). To set the maximum amount of outstanding clients, use g_socket_set_listen_backlog(). - %TRUE on success, %FALSE on error. @@ -68505,7 +65350,6 @@ returned. To be notified when data is available, wait for the %G_IO_IN condition. On error -1 is returned and @error is set accordingly. - Number of bytes read, or 0 if the connection was closed by the peer, or -1 on error @@ -68541,7 +65385,6 @@ source address of the received packet. @address is owned by the caller. See g_socket_receive() for additional information. - Number of bytes read, or 0 if the connection was closed by the peer, or -1 on error @@ -68634,7 +65477,6 @@ returned. To be notified when data is available, wait for the %G_IO_IN condition. On error -1 is returned and @error is set accordingly. - Number of bytes read, or 0 if the connection was closed by the peer, or -1 on error @@ -68733,7 +65575,6 @@ g_socket_receive_messages() will return 0 (with no error set). On error -1 is returned and @error is set accordingly. An error will only be returned if zero messages could be received; otherwise the number of messages successfully received before the error will be returned. - number of messages received, or -1 on error. Note that the number of messages received may be smaller than @num_messages if in non-blocking @@ -68773,7 +65614,6 @@ messages successfully received before the error will be returned. This behaves exactly the same as g_socket_receive(), except that the choice of blocking or non-blocking behavior is determined by the @blocking argument rather than by @socket's properties. - Number of bytes read, or 0 if the connection was closed by the peer, or -1 on error @@ -68820,7 +65660,6 @@ notified of a %G_IO_OUT condition. (On Windows in particular, this is very common due to the way the underlying APIs work.) On error -1 is returned and @error is set accordingly. - Number of bytes written (which may be less than @size), or -1 on error @@ -68886,7 +65725,6 @@ notified of a %G_IO_OUT condition. (On Windows in particular, this is very common due to the way the underlying APIs work.) On error -1 is returned and @error is set accordingly. - Number of bytes written (which may be less than @size), or -1 on error @@ -68941,7 +65779,6 @@ rather than by @socket's properties. On error %G_POLLABLE_RETURN_FAILED is returned and @error is set accordingly, or if the socket is currently not writable %G_POLLABLE_RETURN_WOULD_BLOCK is returned. @bytes_written will contain 0 in both cases. - %G_POLLABLE_RETURN_OK if all data was successfully written, %G_POLLABLE_RETURN_WOULD_BLOCK if the socket is currently not writable, or @@ -69032,7 +65869,6 @@ very common due to the way the underlying APIs work.) On error -1 is returned and @error is set accordingly. An error will only be returned if zero messages could be sent; otherwise the number of messages successfully sent before the error will be returned. - number of messages sent, or -1 on error. Note that the number of messages sent may be smaller than @num_messages if the socket is @@ -69072,7 +65908,6 @@ successfully sent before the error will be returned. g_socket_connect()). See g_socket_send() for additional information. - Number of bytes written (which may be less than @size), or -1 on error @@ -69108,7 +65943,6 @@ on error This behaves exactly the same as g_socket_send(), except that the choice of blocking or non-blocking behavior is determined by the @blocking argument rather than by @socket's properties. - Number of bytes written (which may be less than @size), or -1 on error @@ -69150,7 +65984,6 @@ with a %G_IO_ERROR_WOULD_BLOCK error. All sockets are created in blocking mode. However, note that the platform level socket is always non-blocking, and blocking mode is a GSocket level feature. - @@ -69168,7 +66001,6 @@ is a GSocket level feature. Sets whether @socket should allow sending to broadcast addresses. This is %FALSE by default. - @@ -69200,7 +66032,6 @@ normally be at least two hours. Most commonly, you would set this flag on a server socket if you want to allow clients to remain idle for long periods of time, but also want to ensure that connections are eventually garbage-collected if clients crash or become unreachable. - @@ -69223,7 +66054,6 @@ on time then the new connections will be refused. Note that this must be called before g_socket_listen() and has no effect if called after that. - @@ -69242,7 +66072,6 @@ effect if called after that. Sets whether outgoing multicast packets will be received by sockets listening on that multicast address on the same host. This is %TRUE by default. - @@ -69262,7 +66091,6 @@ by default. Sets the time-to-live for outgoing multicast datagrams on @socket. By default, this is 1, meaning that multicast packets will not leave the local network. - @@ -69287,7 +66115,6 @@ header pulls in system headers that will define most of the standard/portable socket options. For unusual socket protocols or platform-dependent options, you may need to include additional headers. - success or failure. On failure, @error will be set, and the system error value (`errno` or WSAGetLastError()) will still @@ -69334,7 +66161,6 @@ on their own. Note that if an I/O operation is interrupted by a signal, this may cause the timeout to be reset. - @@ -69352,7 +66178,6 @@ cause the timeout to be reset. Sets the time-to-live for outgoing unicast packets on @socket. By default the platform-specific default value is used. - @@ -69382,7 +66207,6 @@ One example where it is useful to shut down only one side of a connection is graceful disconnect for TCP connections where you close the sending side, then wait for the other side to close the connection, thus ensuring that the other side saw all sent data. - %TRUE on success, %FALSE on error @@ -69412,7 +66236,6 @@ information. No other types of sockets are currently considered as being capable of speaking IPv4. - %TRUE if this socket can be used with IPv4. @@ -69482,12 +66305,10 @@ of speaking IPv4. #GSocketAddress is the equivalent of struct sockaddr in the BSD sockets API. This is an abstract class; use #GInetSocketAddress for internet sockets, or #GUnixSocketAddress for UNIX domain sockets. - Creates a #GSocketAddress subclass corresponding to the native struct sockaddr @native. - a new #GSocketAddress if @native could successfully be converted, otherwise %NULL @@ -69506,7 +66327,6 @@ struct sockaddr @native. Gets the socket family type of @address. - the socket family type of @address @@ -69522,7 +66342,6 @@ struct sockaddr @native. Gets the size of @address's native struct sockaddr. You can use this to allocate memory to pass to g_socket_address_to_native(). - the size of the native struct sockaddr that @address represents @@ -69542,7 +66361,6 @@ be passed to low-level functions like connect() or bind(). If not enough space is available, a %G_IO_ERROR_NO_SPACE error is returned. If the address type is not known on the system then a %G_IO_ERROR_NOT_SUPPORTED error is returned. - %TRUE if @dest was filled in, %FALSE on error @@ -69566,7 +66384,6 @@ struct sockaddr Gets the socket family type of @address. - the socket family type of @address @@ -69582,7 +66399,6 @@ struct sockaddr Gets the size of @address's native struct sockaddr. You can use this to allocate memory to pass to g_socket_address_to_native(). - the size of the native struct sockaddr that @address represents @@ -69602,7 +66418,6 @@ be passed to low-level functions like connect() or bind(). If not enough space is available, a %G_IO_ERROR_NO_SPACE error is returned. If the address type is not known on the system then a %G_IO_ERROR_NOT_SUPPORTED error is returned. - %TRUE if @dest was filled in, %FALSE on error @@ -69632,13 +66447,11 @@ struct sockaddr - - the socket family type of @address @@ -69653,7 +66466,6 @@ struct sockaddr - the size of the native struct sockaddr that @address represents @@ -69669,7 +66481,6 @@ struct sockaddr - %TRUE if @dest was filled in, %FALSE on error @@ -69708,7 +66519,6 @@ Each #GSocketAddressEnumerator can only be enumerated once. Once g_socket_address_enumerator_next() has returned %NULL, further enumeration with that #GSocketAddressEnumerator is not possible, and it can be unreffed. - Retrieves the next #GSocketAddress from @enumerator. Note that this may block for some amount of time. (Eg, a #GNetworkAddress may need @@ -69723,7 +66533,6 @@ in *@error. However, if the first call to g_socket_address_enumerator_next() succeeds, then any further internal errors (other than @cancellable being triggered) will be ignored. - a #GSocketAddress (owned by the caller), or %NULL on error (in which case *@error will be set) or if there are no @@ -69747,7 +66556,6 @@ and then calls @callback, which must call g_socket_address_enumerator_next_finish() to get the result. It is an error to call this multiple times before the previous callback has finished. - @@ -69776,7 +66584,6 @@ It is an error to call this multiple times before the previous callback has fini g_socket_address_enumerator_next_async(). See g_socket_address_enumerator_next() for more information about error handling. - a #GSocketAddress (owned by the caller), or %NULL on error (in which case *@error will be set) or if there are no @@ -69808,7 +66615,6 @@ in *@error. However, if the first call to g_socket_address_enumerator_next() succeeds, then any further internal errors (other than @cancellable being triggered) will be ignored. - a #GSocketAddress (owned by the caller), or %NULL on error (in which case *@error will be set) or if there are no @@ -69832,7 +66638,6 @@ and then calls @callback, which must call g_socket_address_enumerator_next_finish() to get the result. It is an error to call this multiple times before the previous callback has finished. - @@ -69861,7 +66666,6 @@ It is an error to call this multiple times before the previous callback has fini g_socket_address_enumerator_next_async(). See g_socket_address_enumerator_next() for more information about error handling. - a #GSocketAddress (owned by the caller), or %NULL on error (in which case *@error will be set) or if there are no @@ -69885,13 +66689,11 @@ error handling. Class structure for #GSocketAddressEnumerator. - - a #GSocketAddress (owned by the caller), or %NULL on error (in which case *@error will be set) or if there are no @@ -69912,7 +66714,6 @@ error handling. - @@ -69939,7 +66740,6 @@ error handling. - a #GSocketAddress (owned by the caller), or %NULL on error (in which case *@error will be set) or if there are no @@ -69960,13 +66760,11 @@ error handling. - - @@ -69974,7 +66772,6 @@ error handling. - @@ -69982,7 +66779,6 @@ error handling. - @@ -69990,7 +66786,6 @@ error handling. - @@ -69998,7 +66793,6 @@ error handling. - @@ -70006,7 +66800,6 @@ error handling. - @@ -70014,7 +66807,6 @@ error handling. - @@ -70022,7 +66814,6 @@ error handling. - @@ -70030,7 +66821,6 @@ error handling. - @@ -70038,7 +66828,6 @@ error handling. - @@ -70059,10 +66848,8 @@ it will be a #GTcpConnection. As #GSocketClient is a lightweight object, you don't need to cache it. You can just create a new one any time you need one. - Creates a new #GSocketClient with the default options. - a #GSocketClient. Free the returned object with g_object_unref(). @@ -70070,7 +66857,6 @@ can just create a new one any time you need one. - @@ -70109,7 +66895,6 @@ be use as generic socket proxy through the HTTP CONNECT method. When the proxy is detected as being an application proxy, TLS handshake will be skipped. This is required to let the application do the proxy specific handshake. - @@ -70143,7 +66928,6 @@ g_socket_client_set_socket_type(). If a local address is specified with g_socket_client_set_local_address() the socket will be bound to this address before connecting. - a #GSocketConnection on success, %NULL on error. @@ -70169,7 +66953,6 @@ socket will be bound to this address before connecting. When the operation is finished @callback will be called. You can then call g_socket_client_connect_finish() to get the result of the operation. - @@ -70198,7 +66981,6 @@ the result of the operation. Finishes an async connect operation. See g_socket_client_connect_async() - a #GSocketConnection on success, %NULL on error. @@ -70245,7 +67027,6 @@ reference to it when finished with it. In the event of any failure (DNS error, service not found, no hosts connectable) %NULL is returned and @error (if non-%NULL) is set accordingly. - a #GSocketConnection on success, %NULL on error. @@ -70275,7 +67056,6 @@ accordingly. When the operation is finished @callback will be called. You can then call g_socket_client_connect_to_host_finish() to get the result of the operation. - @@ -70308,7 +67088,6 @@ the result of the operation. Finishes an async connect operation. See g_socket_client_connect_to_host_async() - a #GSocketConnection on success, %NULL on error. @@ -70339,7 +67118,6 @@ reference to it when finished with it. In the event of any failure (DNS error, service not found, no hosts connectable) %NULL is returned and @error (if non-%NULL) is set accordingly. - a #GSocketConnection if successful, or %NULL on error @@ -70366,7 +67144,6 @@ accordingly. This is the asynchronous version of g_socket_client_connect_to_service(). - @@ -70399,7 +67176,6 @@ g_socket_client_connect_to_service(). Finishes an async connect operation. See g_socket_client_connect_to_service_async() - a #GSocketConnection on success, %NULL on error. @@ -70437,7 +67213,6 @@ reference to it when finished with it. In the event of any failure (DNS error, service not found, no hosts connectable) %NULL is returned and @error (if non-%NULL) is set accordingly. - a #GSocketConnection on success, %NULL on error. @@ -70467,7 +67242,6 @@ accordingly. When the operation is finished @callback will be called. You can then call g_socket_client_connect_to_uri_finish() to get the result of the operation. - @@ -70500,7 +67274,6 @@ the result of the operation. Finishes an async connect operation. See g_socket_client_connect_to_uri_async() - a #GSocketConnection on success, %NULL on error. @@ -70518,7 +67291,6 @@ the result of the operation. Gets the proxy enable state; see g_socket_client_set_enable_proxy() - whether proxying is enabled @@ -70534,7 +67306,6 @@ the result of the operation. Gets the socket family of the socket client. See g_socket_client_set_family() for details. - a #GSocketFamily @@ -70550,7 +67321,6 @@ See g_socket_client_set_family() for details. Gets the local address of the socket client. See g_socket_client_set_local_address() for details. - a #GSocketAddress or %NULL. Do not free. @@ -70566,7 +67336,6 @@ See g_socket_client_set_local_address() for details. Gets the protocol name type of the socket client. See g_socket_client_set_protocol() for details. - a #GSocketProtocol @@ -70582,7 +67351,6 @@ See g_socket_client_set_protocol() for details. Gets the #GProxyResolver being used by @client. Normally, this will be the resolver returned by g_proxy_resolver_get_default(), but you can override it with g_socket_client_set_proxy_resolver(). - The #GProxyResolver being used by @client. @@ -70599,7 +67367,6 @@ can override it with g_socket_client_set_proxy_resolver(). Gets the socket type of the socket client. See g_socket_client_set_socket_type() for details. - a #GSocketFamily @@ -70615,7 +67382,6 @@ See g_socket_client_set_socket_type() for details. Gets the I/O timeout time for sockets created by @client. See g_socket_client_set_timeout() for details. - the timeout in seconds @@ -70630,7 +67396,6 @@ See g_socket_client_set_timeout() for details. Gets whether @client creates TLS connections. See g_socket_client_set_tls() for details. - whether @client uses TLS @@ -70645,7 +67410,6 @@ g_socket_client_set_tls() for details. Gets the TLS validation flags used creating TLS connections via @client. - the TLS validation flags @@ -70664,7 +67428,6 @@ proxy server. When enabled (the default), #GSocketClient will use a needed, and automatically do the necessary proxy negotiation. See also g_socket_client_set_proxy_resolver(). - @@ -70688,7 +67451,6 @@ family. This might be useful for instance if you want to force the local connection to be an ipv4 socket, even though the address might be an ipv6 mapped to ipv4 address. - @@ -70711,7 +67473,6 @@ specified address (if not %NULL) before connecting. This is useful if you want to ensure that the local side of the connection is on a specific port, or on a specific interface. - @@ -70733,7 +67494,6 @@ protocol. If @protocol is %G_SOCKET_PROTOCOL_DEFAULT that means to use the default protocol for the socket family and type. - @@ -70756,7 +67516,6 @@ default proxy settings. Note that whether or not the proxy resolver is actually used depends on the setting of #GSocketClient:enable-proxy, which is not changed by this function (but which is %TRUE by default) - @@ -70779,7 +67538,6 @@ type. It doesn't make sense to specify a type of %G_SOCKET_TYPE_DATAGRAM, as GSocketClient is used for connection oriented services. - @@ -70801,7 +67559,6 @@ time in seconds, or 0 for no timeout (the default). The timeout value affects the initial connection attempt as well, so setting this may cause calls to g_socket_client_connect(), etc, to fail with %G_IO_ERROR_TIMED_OUT. - @@ -70835,7 +67592,6 @@ setting a client-side certificate to use, or connecting to the emitted with %G_SOCKET_CLIENT_TLS_HANDSHAKING, which will give you a chance to see the #GTlsClientConnection before the handshake starts. - @@ -70853,7 +67609,6 @@ starts. Sets the TLS validation flags used when creating TLS connections via @client. The default value is %G_TLS_CERTIFICATE_VALIDATE_ALL. - @@ -70972,13 +67727,11 @@ the future; unrecognized @event values should be ignored. - - @@ -71000,7 +67753,6 @@ the future; unrecognized @event values should be ignored. - @@ -71008,7 +67760,6 @@ the future; unrecognized @event values should be ignored. - @@ -71016,7 +67767,6 @@ the future; unrecognized @event values should be ignored. - @@ -71024,7 +67774,6 @@ the future; unrecognized @event values should be ignored. - @@ -71132,10 +67881,8 @@ connect_to_host (const char *hostname, } } ]| - Creates a #GSocketAddressEnumerator for @connectable. - a new #GSocketAddressEnumerator. @@ -71155,7 +67902,6 @@ to via a proxy. If @connectable does not implement g_socket_connectable_proxy_enumerate(), this will fall back to calling g_socket_connectable_enumerate(). - a new #GSocketAddressEnumerator. @@ -71175,7 +67921,6 @@ user. If the #GSocketConnectable implementation does not support string formatting, the implementation’s type name will be returned as a fallback. - the formatted string @@ -71189,7 +67934,6 @@ the implementation’s type name will be returned as a fallback. Creates a #GSocketAddressEnumerator for @connectable. - a new #GSocketAddressEnumerator. @@ -71209,7 +67953,6 @@ to via a proxy. If @connectable does not implement g_socket_connectable_proxy_enumerate(), this will fall back to calling g_socket_connectable_enumerate(). - a new #GSocketAddressEnumerator. @@ -71229,7 +67972,6 @@ user. If the #GSocketConnectable implementation does not support string formatting, the implementation’s type name will be returned as a fallback. - the formatted string @@ -71245,14 +67987,12 @@ the implementation’s type name will be returned as a fallback. Provides an interface for returning a #GSocketAddressEnumerator and #GProxyAddressEnumerator - The parent interface. - a new #GSocketAddressEnumerator. @@ -71267,7 +68007,6 @@ and #GProxyAddressEnumerator - a new #GSocketAddressEnumerator. @@ -71282,7 +68021,6 @@ and #GProxyAddressEnumerator - the formatted string @@ -71313,13 +68051,11 @@ family/type/protocol using g_socket_connection_factory_register_type(). To close a #GSocketConnection, use g_io_stream_close(). Closing both substreams of the #GIOStream separately will not close the underlying #GSocket. - Looks up the #GType to be used when creating socket connections on sockets with the specified @family, @type and @protocol_id. If no type is registered, the #GSocketConnection base type is returned. - a #GType @@ -71344,7 +68080,6 @@ If no type is registered, the #GSocketConnection base type is returned. sockets with the specified @family, @type and @protocol. If no type is registered, the #GSocketConnection base type is returned. - @@ -71369,7 +68104,6 @@ If no type is registered, the #GSocketConnection base type is returned. Connect @connection to the specified remote address. - %TRUE if the connection succeeded, %FALSE on error @@ -71396,7 +68130,6 @@ This clears the #GSocket:blocking flag on @connection's underlying socket if it is currently set. Use g_socket_connection_connect_finish() to retrieve the result. - @@ -71425,7 +68158,6 @@ Use g_socket_connection_connect_finish() to retrieve the result. Gets the result of a g_socket_connection_connect_async() call. - %TRUE if the connection succeeded, %FALSE on error @@ -71443,7 +68175,6 @@ Use g_socket_connection_connect_finish() to retrieve the result. Try to get the local address of a socket connection. - a #GSocketAddress or %NULL on error. Free the returned object with g_object_unref(). @@ -71465,7 +68196,6 @@ g_socket_client_connect_async(), during emission of address that will be used for the connection. This allows applications to print e.g. "Connecting to example.com (10.42.77.3)...". - a #GSocketAddress or %NULL on error. Free the returned object with g_object_unref(). @@ -71482,7 +68212,6 @@ applications to print e.g. "Connecting to example.com Gets the underlying #GSocket object of the connection. This can be useful if you want to do something unusual on it not supported by the #GSocketConnection APIs. - a #GSocket or %NULL on error. @@ -71497,7 +68226,6 @@ not supported by the #GSocketConnection APIs. Checks if @connection is connected. This is equivalent to calling g_socket_is_connected() on @connection's underlying #GSocket. - whether @connection is connected @@ -71520,13 +68248,11 @@ g_socket_is_connected() on @connection's underlying #GSocket. - - @@ -71534,7 +68260,6 @@ g_socket_is_connected() on @connection's underlying #GSocket. - @@ -71542,7 +68267,6 @@ g_socket_is_connected() on @connection's underlying #GSocket. - @@ -71550,7 +68274,6 @@ g_socket_is_connected() on @connection's underlying #GSocket. - @@ -71558,7 +68281,6 @@ g_socket_is_connected() on @connection's underlying #GSocket. - @@ -71566,7 +68288,6 @@ g_socket_is_connected() on @connection's underlying #GSocket. - @@ -71597,7 +68318,6 @@ To extend the set of control messages that can be received, subclass this class and implement the deserialize method. Also, make sure your class is registered with the GType typesystem before calling g_socket_receive_message() to read such a message. - Tries to deserialize a socket control message of a given @level and @type. This will ask all known (to GType) subclasses @@ -71606,7 +68326,6 @@ of message and if so deserialize it into a #GSocketControlMessage. If there is no implementation for this kind of control message, %NULL will be returned. - the deserialized message or %NULL @@ -71635,7 +68354,6 @@ will be returned. Returns the "level" (i.e. the originating protocol) of the control message. This is often SOL_SOCKET. - an integer describing the level @@ -71650,7 +68368,6 @@ This is often SOL_SOCKET. Returns the space required for the control message, not including headers or alignment. - The number of bytes required. @@ -71663,7 +68380,6 @@ headers or alignment. - @@ -71680,7 +68396,6 @@ message. @data is guaranteed to have enough space to fit the size returned by g_socket_control_message_get_size() on this object. - @@ -71698,7 +68413,6 @@ object. Returns the "level" (i.e. the originating protocol) of the control message. This is often SOL_SOCKET. - an integer describing the level @@ -71713,7 +68427,6 @@ This is often SOL_SOCKET. Returns the protocol specific type of the control message. For instance, for UNIX fd passing this would be SCM_RIGHTS. - an integer describing the type of control message @@ -71728,7 +68441,6 @@ For instance, for UNIX fd passing this would be SCM_RIGHTS. Returns the space required for the control message, not including headers or alignment. - The number of bytes required. @@ -71747,7 +68459,6 @@ message. @data is guaranteed to have enough space to fit the size returned by g_socket_control_message_get_size() on this object. - @@ -71771,13 +68482,11 @@ object. Class structure for #GSocketControlMessage. - - The number of bytes required. @@ -71792,7 +68501,6 @@ object. - an integer describing the level @@ -71807,7 +68515,6 @@ object. - @@ -71820,7 +68527,6 @@ object. - @@ -71838,7 +68544,6 @@ object. - @@ -71860,7 +68565,6 @@ object. - @@ -71868,7 +68572,6 @@ object. - @@ -71876,7 +68579,6 @@ object. - @@ -71884,7 +68586,6 @@ object. - @@ -71892,7 +68593,6 @@ object. - @@ -71934,19 +68634,16 @@ internally. If you want to implement a network server, also look at #GSocketService and #GThreadedSocketService which are subclasses of #GSocketListener that make this even easier. - Creates a new #GSocketListener with no sockets to listen for. New listeners can be added with e.g. g_socket_listener_add_address() or g_socket_listener_add_inet_port(). - a new #GSocketListener. - @@ -71957,7 +68654,6 @@ or g_socket_listener_add_inet_port(). - @@ -71985,7 +68681,6 @@ to the listener. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GSocketConnection on success, %NULL on error. @@ -72011,7 +68706,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished @callback will be called. You can then call g_socket_listener_accept_socket() to get the result of the operation. - @@ -72036,7 +68730,6 @@ to get the result of the operation. Finishes an async accept operation. See g_socket_listener_accept_async() - a #GSocketConnection on success, %NULL on error. @@ -72071,7 +68764,6 @@ to the listener. If @cancellable is not %NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - a #GSocket on success, %NULL on error. @@ -72097,7 +68789,6 @@ was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. When the operation is finished @callback will be called. You can then call g_socket_listener_accept_socket_finish() to get the result of the operation. - @@ -72122,7 +68813,6 @@ to get the result of the operation. Finishes an async accept operation. See g_socket_listener_accept_socket_async() - a #GSocket on success, %NULL on error. @@ -72166,7 +68856,6 @@ requested, belongs to the caller and must be freed. Call g_socket_listener_close() to stop listening on @address; this will not be done automatically when you drop your final reference to @listener, as references may be held internally. - %TRUE on success, %FALSE on error. @@ -72209,7 +68898,6 @@ but don't care about the specific port number. to accept to identify this particular source, which is useful if you're listening on multiple addresses and do different things depending on what address is connected to. - the port number, or 0 in case of failure. @@ -72238,7 +68926,6 @@ different things depending on what address is connected to. Call g_socket_listener_close() to stop listening on @port; this will not be done automatically when you drop your final reference to @listener, as references may be held internally. - %TRUE on success, %FALSE on error. @@ -72272,7 +68959,6 @@ The @socket will not be automatically closed when the @listener is finalized unless the listener held the final reference to the socket. Before GLib 2.42, the @socket was automatically closed on finalization of the @listener, even if references to it were held elsewhere. - %TRUE on success, %FALSE on error. @@ -72294,7 +68980,6 @@ if references to it were held elsewhere. Closes all the sockets in the listener. - @@ -72311,7 +68996,6 @@ before adding any sockets, addresses or ports to the #GSocketListener (for example, by calling g_socket_listener_add_inet_port()) to be effective. See g_socket_set_listen_backlog() for details - @@ -72357,13 +69041,11 @@ the order they happen in is undefined. Class structure for #GSocketListener. - - @@ -72376,7 +69058,6 @@ the order they happen in is undefined. - @@ -72395,7 +69076,6 @@ the order they happen in is undefined. - @@ -72403,7 +69083,6 @@ the order they happen in is undefined. - @@ -72411,7 +69090,6 @@ the order they happen in is undefined. - @@ -72419,7 +69097,6 @@ the order they happen in is undefined. - @@ -72427,7 +69104,6 @@ the order they happen in is undefined. - @@ -72532,7 +69208,6 @@ of the thread it is created in, and is not threadsafe in general. However, the calls to start and stop the service are thread-safe so these can be used from threads that handle incoming clients. - Creates a new #GSocketService with no sockets to listen for. New listeners can be added with e.g. g_socket_listener_add_address() @@ -72541,14 +69216,12 @@ or g_socket_listener_add_inet_port(). New services are created active, there is no need to call g_socket_service_start(), unless g_socket_service_stop() has been called before. - a new #GSocketService. - @@ -72569,7 +69242,6 @@ called before. service will accept new clients that connect, while a non-active service will let connecting clients queue up until the service is started. - %TRUE if the service is active, %FALSE otherwise @@ -72589,7 +69261,6 @@ g_socket_service_stop(). This call is thread-safe, so it may be called from a thread handling an incoming client request. - @@ -72616,7 +69287,6 @@ will happen automatically when the #GSocketService is finalized.) This must be called before calling g_socket_listener_close() as the socket service will start accepting connections immediately when a new socket is added. - @@ -72664,13 +69334,11 @@ so you need to ref it yourself if you are planning to use it. Class structure for #GSocketService. - - @@ -72689,7 +69357,6 @@ so you need to ref it yourself if you are planning to use it. - @@ -72697,7 +69364,6 @@ so you need to ref it yourself if you are planning to use it. - @@ -72705,7 +69371,6 @@ so you need to ref it yourself if you are planning to use it. - @@ -72713,7 +69378,6 @@ so you need to ref it yourself if you are planning to use it. - @@ -72721,7 +69385,6 @@ so you need to ref it yourself if you are planning to use it. - @@ -72729,7 +69392,6 @@ so you need to ref it yourself if you are planning to use it. - @@ -72742,7 +69404,6 @@ so you need to ref it yourself if you are planning to use it. This is the function type of the callback used for the #GSource returned by g_socket_create_source(). - it should return %FALSE if the source should be removed. @@ -72795,13 +69456,11 @@ for a given service. However, if you are simply planning to connect to the remote service, you can use #GNetworkService's #GSocketConnectable interface and not need to worry about #GSrvTarget at all. - Creates a new #GSrvTarget with the given parameters. You should not need to use this; normally #GSrvTargets are created by #GResolver. - a new #GSrvTarget. @@ -72827,7 +69486,6 @@ created by #GResolver. Copies @target - a copy of @target @@ -72841,7 +69499,6 @@ created by #GResolver. Frees @target - @@ -72857,7 +69514,6 @@ created by #GResolver. this to the user, you should use g_hostname_is_ascii_encoded() to check if it contains encoded Unicode segments, and use g_hostname_to_unicode() to convert it if it does.) - @target's hostname @@ -72871,7 +69527,6 @@ g_hostname_to_unicode() to convert it if it does.) Gets @target's port - @target's port @@ -72887,7 +69542,6 @@ g_hostname_to_unicode() to convert it if it does.) Gets @target's priority. You should not need to look at this; #GResolver already sorts the targets according to the algorithm in RFC 2782. - @target's priority @@ -72903,7 +69557,6 @@ RFC 2782. Gets @target's weight. You should not need to look at this; #GResolver already sorts the targets according to the algorithm in RFC 2782. - @target's weight @@ -72917,7 +69570,6 @@ RFC 2782. Sorts @targets in place according to the algorithm in RFC 2782. - the head of the sorted list. @@ -72937,7 +69589,6 @@ RFC 2782. #GStaticResource is an opaque data structure and can only be accessed using the following functions. - @@ -72959,7 +69610,6 @@ using the following functions. This is normally used by code generated by [glib-compile-resources][glib-compile-resources] and is not typically used by other code. - @@ -72976,7 +69626,6 @@ and is not typically used by other code. This is normally used by code generated by [glib-compile-resources][glib-compile-resources] and is not typically used by other code. - a #GResource @@ -72995,7 +69644,6 @@ GStaticResource. This is normally used by code generated by [glib-compile-resources][glib-compile-resources] and is not typically used by other code. - @@ -73071,7 +69719,6 @@ stdout/stderr will be inherited from the parent. You can use @flags to control this behavior. The argument list must be terminated with %NULL. - A newly created #GSubprocess, or %NULL on error (and @error will be set) @@ -73100,7 +69747,6 @@ The argument list must be terminated with %NULL. Create a new process with the given flags and argument list. The argument list is expected to be %NULL-terminated. - A newly created #GSubprocess, or %NULL on error (and @error will be set) @@ -73161,7 +69807,6 @@ starting this function, since they may be left in strange states, even if the operation was cancelled. You should especially not attempt to interact with the pipes while the operation is in progress (either from another thread or if using the asynchronous version). - %TRUE if successful @@ -73192,7 +69837,6 @@ attempt to interact with the pipes while the operation is in progress Asynchronous version of g_subprocess_communicate(). Complete invocation with g_subprocess_communicate_finish(). - @@ -73221,7 +69865,6 @@ invocation with g_subprocess_communicate_finish(). Complete an invocation of g_subprocess_communicate_async(). - @@ -73250,7 +69893,6 @@ process as UTF-8, and returns it as a regular NUL terminated string. On error, @stdout_buf and @stderr_buf will be set to undefined values and should not be used. - @@ -73280,7 +69922,6 @@ should not be used. Asynchronous version of g_subprocess_communicate_utf8(). Complete invocation with g_subprocess_communicate_utf8_finish(). - @@ -73309,7 +69950,6 @@ invocation with g_subprocess_communicate_utf8_finish(). Complete an invocation of g_subprocess_communicate_utf8_async(). - @@ -73340,7 +69980,6 @@ however, you can use g_subprocess_wait() to monitor the status of the process after calling this function. On Unix, this function sends %SIGKILL. - @@ -73360,7 +69999,6 @@ This is equivalent to the system WEXITSTATUS macro. It is an error to call this function before g_subprocess_wait() and unless g_subprocess_get_if_exited() returned %TRUE. - the exit status @@ -73376,7 +70014,6 @@ unless g_subprocess_get_if_exited() returned %TRUE. On UNIX, returns the process ID as a decimal string. On Windows, returns the result of GetProcessId() also as a string. If the subprocess has terminated, this will return %NULL. - the subprocess identifier, or %NULL if the subprocess has terminated @@ -73397,7 +70034,6 @@ This is equivalent to the system WIFEXITED macro. It is an error to call this function before g_subprocess_wait() has returned. - %TRUE if the case of a normal exit @@ -73416,7 +70052,6 @@ This is equivalent to the system WIFSIGNALED macro. It is an error to call this function before g_subprocess_wait() has returned. - %TRUE if the case of termination due to a signal @@ -73440,7 +70075,6 @@ followed by g_subprocess_get_exit_status(). It is an error to call this function before g_subprocess_wait() has returned. - the (meaningless) waitpid() exit status from the kernel @@ -73458,7 +70092,6 @@ returned. The process must have been created with %G_SUBPROCESS_FLAGS_STDERR_PIPE. - the stderr pipe @@ -73476,7 +70109,6 @@ to the stdin of @subprocess. The process must have been created with %G_SUBPROCESS_FLAGS_STDIN_PIPE. - the stdout pipe @@ -73494,7 +70126,6 @@ The process must have been created with The process must have been created with %G_SUBPROCESS_FLAGS_STDOUT_PIPE. - the stdout pipe @@ -73513,7 +70144,6 @@ way of the exit() system call or return from main(). It is an error to call this function before g_subprocess_wait() has returned. - %TRUE if the process exited cleanly with a exit status of 0 @@ -73533,7 +70163,6 @@ This is equivalent to the system WTERMSIG macro. It is an error to call this function before g_subprocess_wait() and unless g_subprocess_get_if_signaled() returned %TRUE. - the signal causing termination @@ -73553,7 +70182,6 @@ This API is race-free. If the subprocess has terminated, it will not be signalled. This API is not available on Windows. - @@ -73580,7 +70208,6 @@ abnormal termination. See g_subprocess_wait_check() for that. Cancelling @cancellable doesn't kill the subprocess. Call g_subprocess_force_exit() if it is desirable. - %TRUE on success, %FALSE if @cancellable was cancelled @@ -73600,7 +70227,6 @@ g_subprocess_force_exit() if it is desirable. Wait for the subprocess to terminate. This is the asynchronous version of g_subprocess_wait(). - @@ -73625,7 +70251,6 @@ This is the asynchronous version of g_subprocess_wait(). Combines g_subprocess_wait() with g_spawn_check_exit_status(). - %TRUE on success, %FALSE if process exited abnormally, or @cancellable was cancelled @@ -73646,7 +70271,6 @@ This is the asynchronous version of g_subprocess_wait(). Combines g_subprocess_wait_async() with g_spawn_check_exit_status(). This is the asynchronous version of g_subprocess_wait_check(). - @@ -73672,7 +70296,6 @@ This is the asynchronous version of g_subprocess_wait_check(). Collects the result of a previous call to g_subprocess_wait_check_async(). - %TRUE if successful, or %FALSE with @error set @@ -73691,7 +70314,6 @@ g_subprocess_wait_check_async(). Collects the result of a previous call to g_subprocess_wait_async(). - %TRUE if successful, or %FALSE with @error set @@ -73783,7 +70405,6 @@ a similar configuration. The launcher is created with the default options. A copy of the environment of the calling process is made at the time of this call and will be used as the environment that the process is launched in. - @@ -73800,7 +70421,6 @@ environment of processes launched from this launcher. On UNIX, the returned string can be an arbitrary byte string. On Windows, it will be UTF-8. - the value of the environment variable, %NULL if unset @@ -73831,7 +70451,6 @@ given. %NULL can be given as @child_setup to disable the functionality. Child setup functions are only available on UNIX. - @@ -73860,7 +70479,6 @@ with. By default processes are launched with the current working directory of the launching process at the time of launch. - @@ -73895,7 +70513,6 @@ etc.) before launching the subprocess. On UNIX, all strings in this array can be arbitrary byte strings. On Windows, they should be in UTF-8. - @@ -73926,7 +70543,6 @@ handle a particular stdio stream (eg: specifying both You may also not set a flag that conflicts with a previous call to a function like g_subprocess_launcher_set_stdin_file_path() or g_subprocess_launcher_take_stdout_fd(). - @@ -73956,7 +70572,6 @@ You may not set a stderr file path if a stderr fd is already set or if the launcher flags contain any flags directing stderr elsewhere. This feature is only available on UNIX. - @@ -73982,7 +70597,6 @@ You may not set a stdin file path if a stdin fd is already set or if the launcher flags contain any flags directing stdin elsewhere. This feature is only available on UNIX. - @@ -74008,7 +70622,6 @@ You may not set a stdout file path if a stdout fd is already set or if the launcher flags contain any flags directing stdout elsewhere. This feature is only available on UNIX. - @@ -74030,7 +70643,6 @@ processes launched from this launcher. On UNIX, both the variable's name and value can be arbitrary byte strings, except that the variable's name cannot contain '='. On Windows, they should be in UTF-8. - @@ -74056,7 +70668,6 @@ On Windows, they should be in UTF-8. Creates a #GSubprocess given a provided varargs list of arguments. - A new #GSubprocess, or %NULL on error (and @error will be set) @@ -74082,7 +70693,6 @@ On Windows, they should be in UTF-8. Creates a #GSubprocess given a provided array of arguments. - A new #GSubprocess, or %NULL on error (and @error will be set) @@ -74113,7 +70723,6 @@ descriptor in the child. An example use case is GNUPG, which has a command line argument --passphrase-fd providing a file descriptor number where it expects the passphrase to be written. - @@ -74149,7 +70758,6 @@ You may not set a stderr fd if a stderr file path is already set or if the launcher flags contain any flags directing stderr elsewhere. This feature is only available on UNIX. - @@ -74183,7 +70791,6 @@ You may not set a stdin fd if a stdin file path is already set or if the launcher flags contain any flags directing stdin elsewhere. This feature is only available on UNIX. - @@ -74216,7 +70823,6 @@ You may not set a stdout fd if a stdout file path is already set or if the launcher flags contain any flags directing stdout elsewhere. This feature is only available on UNIX. - @@ -74237,7 +70843,6 @@ processes launched from this launcher. On UNIX, the variable's name can be an arbitrary byte string not containing '='. On Windows, it should be in UTF-8. - @@ -74258,119 +70863,102 @@ containing '='. On Windows, it should be in UTF-8. - - - - - - - - - - - - - - - - - @@ -74379,88 +70967,75 @@ containing '='. On Windows, it should be in UTF-8. Extension point for TLS functionality via #GTlsBackend. See [Extending GIO][extending-gio]. - - - - - - - - - - - - - @@ -74469,101 +71044,86 @@ See [Extending GIO][extending-gio]. The purpose used to verify the client certificate in a TLS connection. Used by TLS servers. - The purpose used to verify the server certificate in a TLS connection. This is the most common purpose in use. Used by TLS clients. - - - - - - - - - - - - - - @@ -75065,7 +71625,6 @@ in several ways: having come from the `_async()` wrapper function (for "short-circuit" results, such as when passing 0 to g_input_stream_read_async()). - Creates a #GTask acting on @source_object, which will eventually be @@ -75084,7 +71643,6 @@ simplified handling in cases where cancellation may imply that other objects that the task depends on have been destroyed. If you do not want this behavior, you can use g_task_set_check_cancellable() to change it. - a #GTask. @@ -75113,7 +71671,6 @@ g_task_set_check_cancellable() to change it. Checks that @result is a #GTask, and that @source_object is its source object (or that @source_object is %NULL and @result has no source object). This can be used in g_return_if_fail() checks. - %TRUE if @result and @source_object are valid, %FALSE if not @@ -75140,7 +71697,6 @@ check if the result there is tagged as having been created by the wrapper method, and deal with it appropriately if so. See also g_task_report_new_error(). - @@ -75178,7 +71734,6 @@ having been created by the wrapper method, and deal with it appropriately if so. See also g_task_report_error(). - @@ -75228,7 +71783,6 @@ It will set the @source’s name to the task’s name (as set with g_task_set_name()), if one has been set. This takes a reference on @task until @source is destroyed. - @@ -75249,7 +71803,6 @@ This takes a reference on @task until @source is destroyed. Gets @task's #GCancellable - @task's #GCancellable @@ -75264,7 +71817,6 @@ This takes a reference on @task until @source is destroyed. Gets @task's check-cancellable flag. See g_task_set_check_cancellable() for more details. - @@ -75279,7 +71831,6 @@ g_task_set_check_cancellable() for more details. Gets the value of #GTask:completed. This changes from %FALSE to %TRUE after the task’s callback is invoked, and will return %FALSE if called from inside the callback. - %TRUE if the task has completed, %FALSE otherwise. @@ -75299,7 +71850,6 @@ at the point when @task was created). This will always return a non-%NULL value, even if the task's context is the default #GMainContext. - @task's #GMainContext @@ -75313,7 +71863,6 @@ context is the default #GMainContext. Gets @task’s name. See g_task_set_name(). - @task’s name, or %NULL @@ -75327,7 +71876,6 @@ context is the default #GMainContext. Gets @task's priority - @task's priority @@ -75342,7 +71890,6 @@ context is the default #GMainContext. Gets @task's return-on-cancel flag. See g_task_set_return_on_cancel() for more details. - @@ -75356,7 +71903,6 @@ g_task_set_return_on_cancel() for more details. Gets the source object from @task. Like g_async_result_get_source_object(), but does not ref the object. - @task's source object, or %NULL @@ -75370,7 +71916,6 @@ g_async_result_get_source_object(), but does not ref the object. Gets @task's source tag. See g_task_set_source_tag(). - @task's source tag @@ -75384,7 +71929,6 @@ g_async_result_get_source_object(), but does not ref the object. Gets @task's `task_data`. - @task's `task_data`. @@ -75398,7 +71942,6 @@ g_async_result_get_source_object(), but does not ref the object. Tests if @task resulted in an error. - %TRUE if the task resulted in an error, %FALSE otherwise. @@ -75418,7 +71961,6 @@ instead return %FALSE and set @error. Since this method transfers ownership of the return value (or error) to the caller, you may only call it once. - the task result, or %FALSE on error @@ -75438,7 +71980,6 @@ instead return -1 and set @error. Since this method transfers ownership of the return value (or error) to the caller, you may only call it once. - the task result, or -1 on error @@ -75459,7 +72000,6 @@ instead return %NULL and set @error. Since this method transfers ownership of the return value (or error) to the caller, you may only call it once. - the task result, or %NULL on error @@ -75482,7 +72022,6 @@ instead set @error and return %FALSE. Since this method transfers ownership of the return value (or error) to the caller, you may only call it once. - %TRUE if @task succeeded, %FALSE on error. @@ -75502,7 +72041,6 @@ error) to the caller, you may only call it once. Sets @task's result to @result and completes the task (see g_task_return_pointer() for more discussion of exactly what this means). - @@ -75529,7 +72067,6 @@ Call g_error_copy() on the error if you need to keep a local copy as well. See also g_task_return_new_error(). - @@ -75549,7 +72086,6 @@ See also g_task_return_new_error(). @task's error accordingly and completes the task (see g_task_return_pointer() for more discussion of exactly what this means). - %TRUE if @task has been cancelled, %FALSE if not @@ -75565,7 +72101,6 @@ means). Sets @task's result to @result and completes the task (see g_task_return_pointer() for more discussion of exactly what this means). - @@ -75587,7 +72122,6 @@ g_task_return_pointer() for more discussion of exactly what this means). See also g_task_return_error(). - @@ -75633,7 +72167,6 @@ Note that since the task may be completed before returning from g_task_return_pointer(), you cannot assume that @result is still valid after calling this, unless you are still holding another reference on it. - @@ -75662,7 +72195,6 @@ with a value of %NULL will be used for the result. This is a very generic low-level method intended primarily for use by language bindings; for C code, g_task_return_pointer() and the like will normally be much easier to use. - @@ -75691,7 +72223,6 @@ g_task_run_in_thread(), you should not assume that it will always do this. If you have a very large number of tasks to run, but don't want them to all run at once, you should only queue a limited number of them at a time. - @@ -75723,7 +72254,6 @@ g_task_run_in_thread_sync(), you should not assume that it will always do this. If you have a very large number of tasks to run, but don't want them to all run at once, you should only queue a limited number of them at a time. - @@ -75753,7 +72283,6 @@ via g_task_return_error_if_cancelled()). If you are using g_task_set_return_on_cancel() as well, then you must leave check-cancellable set %TRUE. - @@ -75779,7 +72308,6 @@ name of the #GSource used for idle completion of the task. This function may only be called before the @task is first used in a thread other than the one it was constructed in. - @@ -75802,7 +72330,6 @@ This will affect the priority of #GSources created with g_task_attach_source() and the scheduling of tasks run in threads, and can also be explicitly retrieved later via g_task_get_priority(). - @@ -75846,7 +72373,6 @@ If the task's #GCancellable is already cancelled before you call g_task_run_in_thread()/g_task_run_in_thread_sync(), then the #GTaskThreadFunc will still be run (for consistency), but the task will also be completed right away. - %TRUE if @task's return-on-cancel flag was changed to match @return_on_cancel. %FALSE if @task has already been @@ -75872,7 +72398,6 @@ doing the tagging) and then later check it using g_task_get_source_tag() (or g_async_result_is_tagged()) in the task's "finish" function, to figure out if the response came from a particular place. - @@ -75889,7 +72414,6 @@ particular place. Sets @task's task data (freeing the existing task data, if any). - @@ -75940,7 +72464,6 @@ g_task_set_return_on_cancel() for more details. Other than in that case, @task will be completed when the #GTaskThreadFunc returns, not when it calls a `g_task_return_` function. - @@ -75966,11 +72489,9 @@ Other than in that case, @task will be completed when the This is the subclass of #GSocketConnection that is created for TCP/IP sockets. - Checks if graceful disconnects are used. See g_tcp_connection_set_graceful_disconnect(). - %TRUE if graceful disconnect is used on close, %FALSE otherwise @@ -75992,7 +72513,6 @@ all the outstanding data to the other end, or get an error reported. However, it also means we have to wait for all the data to reach the other side and for it to acknowledge this by closing the socket, which may take a while. For this reason it is disabled by default. - @@ -76018,7 +72538,6 @@ take a while. For this reason it is disabled by default. - @@ -76032,10 +72551,8 @@ based on a #GSocket, but which is not actually a #GSocketConnection. This is used by #GSocketClient so that it can always return a #GSocketConnection, even when the connection it has actually created is not directly a #GSocketConnection. - Wraps @base_io_stream and @socket together as a #GSocketConnection. - the new #GSocketConnection. @@ -76053,7 +72570,6 @@ actually created is not directly a #GSocketConnection. Gets @conn's base #GIOStream - @conn's base #GIOStream @@ -76076,7 +72592,6 @@ actually created is not directly a #GSocketConnection. - @@ -76159,7 +72674,6 @@ do the following in the directory holding schemas: ]| Create a new #GTestDBus object. - a new #GTestDBus. @@ -76178,7 +72692,6 @@ won't use user's session bus. This is useful for unit tests that want to verify behaviour when no session bus is running. It is not necessary to call this if unit test already calls g_test_dbus_up() before acquiring the session bus. - @@ -76186,7 +72699,6 @@ g_test_dbus_up() before acquiring the session bus. Add a path where dbus-daemon will look up .service files. This can't be called after g_test_dbus_up(). - @@ -76207,7 +72719,6 @@ called after g_test_dbus_up(). This will wait for the singleton returned by g_bus_get() or g_bus_get_sync() to be destroyed. This is done to ensure that the next unit test won't get a leaked singleton from this test. - @@ -76222,7 +72733,6 @@ leaked singleton from this test. Get the address on which dbus-daemon is running. If g_test_dbus_up() has not been called yet, %NULL is returned. This can be used with g_dbus_connection_new_for_address(). - the address of the bus, or %NULL. @@ -76236,7 +72746,6 @@ g_dbus_connection_new_for_address(). Get the flags of the #GTestDBus object. - the value of #GTestDBus:flags property @@ -76255,7 +72764,6 @@ Unlike g_test_dbus_down(), this won't verify the #GDBusConnection singleton returned by g_bus_get() or g_bus_get_sync() is destroyed. Unit tests wanting to verify behaviour after the session bus has been stopped can use this function but should still call g_test_dbus_down() when done. - @@ -76275,7 +72783,6 @@ g_test_dbus_down() must be called in its teardown callback. If this function is called from unit test's main(), then g_test_dbus_down() must be called after g_test_run(). - @@ -76305,11 +72812,9 @@ not provide actual pixmaps for icons, just the icon names. Ideally something like gtk_icon_theme_choose_icon() should be used to resolve the list of names so that fallback icons work nicely with themes that inherit other themes. - Creates a new themed icon for @iconname. - a new #GThemedIcon. @@ -76323,7 +72828,6 @@ themes that inherit other themes. Creates a new themed icon for @iconnames. - a new #GThemedIcon @@ -76358,7 +72862,6 @@ const char *names[] = { icon1 = g_themed_icon_new_from_names (names, 4); icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio"); ]| - a new #GThemedIcon. @@ -76375,7 +72878,6 @@ icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio"); Note that doing so invalidates the hash computed by prior calls to g_icon_hash(). - @@ -76392,7 +72894,6 @@ to g_icon_hash(). Gets the names of icons from within @icon. - a list of icon names. @@ -76411,7 +72912,6 @@ to g_icon_hash(). Note that doing so invalidates the hash computed by prior calls to g_icon_hash(). - @@ -76474,11 +72974,9 @@ new connections when all threads are busy. As with #GSocketService, you may connect to #GThreadedSocketService::run, or subclass and override the default handler. - Creates a new #GThreadedSocketService with no listeners. Listeners must be added with one of the #GSocketListener "add" methods. - a new #GSocketService. @@ -76492,7 +72990,6 @@ must be added with one of the #GSocketListener "add" methods. - @@ -76539,13 +73036,11 @@ not return until the connection is closed. - - @@ -76564,7 +73059,6 @@ not return until the connection is closed. - @@ -76572,7 +73066,6 @@ not return until the connection is closed. - @@ -76580,7 +73073,6 @@ not return until the connection is closed. - @@ -76588,7 +73080,6 @@ not return until the connection is closed. - @@ -76596,7 +73087,6 @@ not return until the connection is closed. - @@ -76620,10 +73110,8 @@ not return until the connection is closed. TLS (Transport Layer Security, aka SSL) and DTLS backend. - Gets the default #GTlsBackend for the system. - a #GTlsBackend @@ -76631,7 +73119,6 @@ not return until the connection is closed. Gets the default #GTlsDatabase used to verify TLS connections. - the default database, which should be unreffed when done. @@ -76647,7 +73134,6 @@ not return until the connection is closed. Checks if DTLS is supported. DTLS support may not be available even if TLS support is available, and vice-versa. - whether DTLS is supported @@ -76662,7 +73148,6 @@ support is available, and vice-versa. Checks if TLS is supported; if this returns %FALSE for the default #GTlsBackend, it means no "real" TLS backend is available. - whether or not TLS is supported @@ -76676,7 +73161,6 @@ support is available, and vice-versa. Gets the #GType of @backend's #GTlsCertificate implementation. - the #GType of @backend's #GTlsCertificate implementation. @@ -76691,7 +73175,6 @@ support is available, and vice-versa. Gets the #GType of @backend's #GTlsClientConnection implementation. - the #GType of @backend's #GTlsClientConnection implementation. @@ -76706,7 +73189,6 @@ support is available, and vice-versa. Gets the default #GTlsDatabase used to verify TLS connections. - the default database, which should be unreffed when done. @@ -76721,7 +73203,6 @@ support is available, and vice-versa. Gets the #GType of @backend’s #GDtlsClientConnection implementation. - the #GType of @backend’s #GDtlsClientConnection implementation, or %G_TYPE_INVALID if this backend doesn’t support DTLS. @@ -76736,7 +73217,6 @@ support is available, and vice-versa. Gets the #GType of @backend’s #GDtlsServerConnection implementation. - the #GType of @backend’s #GDtlsServerConnection implementation, or %G_TYPE_INVALID if this backend doesn’t support DTLS. @@ -76751,7 +73231,6 @@ support is available, and vice-versa. Gets the #GType of @backend's #GTlsFileDatabase implementation. - the #GType of backend's #GTlsFileDatabase implementation. @@ -76765,7 +73244,6 @@ support is available, and vice-versa. Gets the #GType of @backend's #GTlsServerConnection implementation. - the #GType of @backend's #GTlsServerConnection implementation. @@ -76787,7 +73265,6 @@ modified. Setting a %NULL default database will reset to using the system default database as if g_tls_backend_set_default_database() had never been called. - @@ -76805,7 +73282,6 @@ database as if g_tls_backend_set_default_database() had never been called. Checks if DTLS is supported. DTLS support may not be available even if TLS support is available, and vice-versa. - whether DTLS is supported @@ -76820,7 +73296,6 @@ support is available, and vice-versa. Checks if TLS is supported; if this returns %FALSE for the default #GTlsBackend, it means no "real" TLS backend is available. - whether or not TLS is supported @@ -76835,14 +73310,12 @@ support is available, and vice-versa. Provides an interface for describing TLS-related types. - The parent interface. - whether or not TLS is supported @@ -76857,7 +73330,6 @@ support is available, and vice-versa. - @@ -76865,7 +73337,6 @@ support is available, and vice-versa. - @@ -76873,7 +73344,6 @@ support is available, and vice-versa. - @@ -76881,7 +73351,6 @@ support is available, and vice-versa. - @@ -76889,7 +73358,6 @@ support is available, and vice-versa. - the default database, which should be unreffed when done. @@ -76905,7 +73373,6 @@ support is available, and vice-versa. - whether DTLS is supported @@ -76920,7 +73387,6 @@ support is available, and vice-versa. - @@ -76928,7 +73394,6 @@ support is available, and vice-versa. - @@ -76941,7 +73406,6 @@ This can represent either a certificate only (eg, the certificate received by a client from a server), or the combination of a certificate and a private key (which is needed when acting as a #GTlsServerConnection). - Creates a #GTlsCertificate from the PEM-encoded data in @file. The returned certificate will be the first certificate found in @file. As @@ -76956,7 +73420,6 @@ still be returned. If @file cannot be read or parsed, the function will return %NULL and set @error. Otherwise, this behaves like g_tls_certificate_new_from_pem(). - the new certificate, or %NULL on error @@ -76983,7 +73446,6 @@ still be returned. If either file cannot be read or parsed, the function will return %NULL and set @error. Otherwise, this behaves like g_tls_certificate_new_from_pem(). - the new certificate, or %NULL on error @@ -77016,7 +73478,6 @@ file) and the #GTlsCertificate:issuer property of each certificate will be set accordingly if the verification succeeds. If any certificate in the chain cannot be verified, the first certificate in the file will still be returned. - the new certificate, or %NULL if @data is invalid @@ -77038,7 +73499,6 @@ data in @file. If @file cannot be read or parsed, the function will return %NULL and set @error. If @file does not contain any PEM-encoded certificates, this will return an empty list and not set @error. - a #GList containing #GTlsCertificate objects. You must free the list @@ -77074,7 +73534,6 @@ value. (All other #GTlsCertificateFlags values will always be set or unset as appropriate.) - the appropriate #GTlsCertificateFlags @@ -77096,7 +73555,6 @@ as appropriate.) Gets the #GTlsCertificate representing @cert's issuer, if known - The certificate of @cert's issuer, or %NULL if @cert is self-signed or signed with an unknown @@ -77116,7 +73574,6 @@ The raw DER byte data of the two certificates are checked for equality. This has the effect that two certificates may compare equal even if their #GTlsCertificate:issuer, #GTlsCertificate:private-key, or #GTlsCertificate:private-key-pem properties differ. - whether the same or not @@ -77152,7 +73609,6 @@ value. (All other #GTlsCertificateFlags values will always be set or unset as appropriate.) - the appropriate #GTlsCertificateFlags @@ -77228,13 +73684,11 @@ tool to convert PKCS#8 keys to PKCS#1. - - the appropriate #GTlsCertificateFlags @@ -77364,7 +73818,6 @@ binding type is not currently implemented. #GTlsClientConnection is the client-side subclass of #GTlsConnection, representing a client-side TLS connection. - Creates a new #GTlsClientConnection wrapping @base_io_stream (which @@ -77374,7 +73827,6 @@ communicate with the server identified by @server_identity. See the documentation for #GTlsConnection:base-io-stream for restrictions on when application code can run operations on the @base_io_stream after this function has returned. - the new #GTlsClientConnection, or %NULL on error @@ -77420,7 +73872,6 @@ from the server, provided a ticket is available that has not previously been used for session resumption, since session ticket reuse would be a privacy weakness. Using this function causes the ticket to be copied without regard for privacy considerations. - @@ -77464,7 +73915,6 @@ from the server, provided a ticket is available that has not previously been used for session resumption, since session ticket reuse would be a privacy weakness. Using this function causes the ticket to be copied without regard for privacy considerations. - @@ -77487,7 +73937,6 @@ Otherwise, it will be %NULL. Each item in the list is a #GByteArray which contains the complete subject DN of the certificate authority. - the list of CA DNs. You should unref each element with g_byte_array_unref() and then @@ -77507,7 +73956,6 @@ the free the list with g_list_free(). Gets @conn's expected server identity - a #GSocketConnectable describing the expected server identity, or %NULL if the expected identity is not @@ -77525,7 +73973,6 @@ known. SSL 3.0 is no longer supported. See g_tls_client_connection_set_use_ssl3() for details. SSL 3.0 is insecure. - %FALSE @@ -77539,7 +73986,6 @@ g_tls_client_connection_set_use_ssl3() for details. Gets @conn's validation flags - the validation flags @@ -77556,7 +74002,6 @@ g_tls_client_connection_set_use_ssl3() for details. servers on virtual hosts which certificate to present, and also to let @conn know what name to look for in the certificate when performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled. - @@ -77583,7 +74028,6 @@ acceptable. Since GLib 2.64, this function does nothing. SSL 3.0 is insecure. - @@ -77602,7 +74046,6 @@ Since GLib 2.64, this function does nothing. Sets @conn's validation flags, to override the default set of checks performed when validating a server certificate. By default, %G_TLS_CERTIFICATE_VALIDATE_ALL is used. - @@ -77662,14 +74105,12 @@ overrides the default via #GTlsConnection::accept-certificate. vtable for a #GTlsClientConnection implementation. - The parent interface. - @@ -77693,9 +74134,7 @@ subclasses, #GTlsClientConnection and #GTlsServerConnection, implement client-side and server-side TLS, respectively. For DTLS (Datagram TLS) support, see #GDtlsConnection. - - @@ -77712,7 +74151,6 @@ For DTLS (Datagram TLS) support, see #GDtlsConnection. - @@ -77762,7 +74200,6 @@ function manually is not recommended. #GTlsConnection::accept_certificate may be emitted during the handshake. - success or failure @@ -77781,7 +74218,6 @@ handshake. Asynchronously performs a TLS handshake on @conn. See g_tls_connection_handshake() for more information. - @@ -77811,7 +74247,6 @@ g_tls_connection_handshake() for more information. Finish an asynchronous TLS handshake operation. See g_tls_connection_handshake() for more information. - %TRUE on success, %FALSE on failure, in which case @error will be set. @@ -77831,7 +74266,6 @@ case @error will be set. Used by #GTlsConnection implementations to emit the #GTlsConnection::accept-certificate signal. - %TRUE if one of the signal handlers has returned %TRUE to accept @peer_cert @@ -77855,7 +74289,6 @@ case @error will be set. Gets @conn's certificate, as set by g_tls_connection_set_certificate(). - @conn's certificate, or %NULL @@ -77881,7 +74314,6 @@ is supported by the TLS backend). It does not guarantee that the data will be available though. That could happen if TLS connection does not support @type or the binding data is not available yet due to additional negotiation or input required. - %TRUE on success, %FALSE otherwise @@ -77907,7 +74339,6 @@ negotiation or input required. Gets the certificate database that @conn uses to verify peer certificates. See g_tls_connection_set_database(). - the certificate database that @conn uses or %NULL @@ -77923,7 +74354,6 @@ peer certificates. See g_tls_connection_set_database(). Get the object that will be used to interact with the user. It will be used for things like prompting the user for passwords. If %NULL is returned, then no user interaction will occur for this connection. - The interaction object. @@ -77943,7 +74373,6 @@ If the peer did not use the ALPN extension, or did not advertise a protocol that matched one of @conn's protocols, or the TLS backend does not support ALPN, then this will be %NULL. See g_tls_connection_set_advertised_protocols(). - the negotiated protocol, or %NULL @@ -77959,7 +74388,6 @@ g_tls_connection_set_advertised_protocols(). Gets @conn's peer's certificate after the handshake has completed or failed. (It is not set during the emission of #GTlsConnection::accept-certificate.) - @conn's peer's certificate, or %NULL @@ -77975,7 +74403,6 @@ or failed. (It is not set during the emission of Gets the errors associated with validating @conn's peer's certificate, after the handshake has completed or failed. (It is not set during the emission of #GTlsConnection::accept-certificate.) - @conn's peer's certificate errors @@ -77993,7 +74420,6 @@ g_tls_connection_set_rehandshake_mode() for details. Changing the rehandshake mode is no longer required for compatibility. Also, rehandshaking has been removed from the TLS protocol in TLS 1.3. - %G_TLS_REHANDSHAKE_SAFELY @@ -78009,7 +74435,6 @@ g_tls_connection_set_rehandshake_mode() for details. Tests whether or not @conn expects a proper TLS close notification when the connection is closed. See g_tls_connection_set_require_close_notify() for details. - %TRUE if @conn requires a proper TLS close notification. @@ -78026,7 +74451,6 @@ notification. Gets whether @conn uses the system certificate database to verify peer certificates. See g_tls_connection_set_use_system_certdb(). Use g_tls_connection_get_database() instead - whether @conn uses the system certificate database @@ -78070,7 +74494,6 @@ function manually is not recommended. #GTlsConnection::accept_certificate may be emitted during the handshake. - success or failure @@ -78089,7 +74512,6 @@ handshake. Asynchronously performs a TLS handshake on @conn. See g_tls_connection_handshake() for more information. - @@ -78119,7 +74541,6 @@ g_tls_connection_handshake() for more information. Finish an asynchronous TLS handshake operation. See g_tls_connection_handshake() for more information. - %TRUE on success, %FALSE on failure, in which case @error will be set. @@ -78147,7 +74568,6 @@ of @protocols will disable ALPN negotiation. See [IANA TLS ALPN Protocol IDs](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids) for a list of registered protocol IDs. - @@ -78184,7 +74604,6 @@ or without a certificate; in that case, if you don't provide a certificate, you can tell that the server requested one by the fact that g_tls_client_connection_get_accepted_cas() will return non-%NULL.) - @@ -78208,7 +74627,6 @@ peer certificate validation will always set the #GTlsConnection::accept-certificate will always be emitted on client-side connections, unless that bit is not set in #GTlsClientConnection:validation-flags). - @@ -78230,7 +74648,6 @@ for things like prompting the user for passwords. The @interaction argument will normally be a derived subclass of #GTlsInteraction. %NULL can also be provided if no user interaction should occur for this connection. - @@ -78253,7 +74670,6 @@ rekey operations. Changing the rehandshake mode is no longer required for compatibility. Also, rehandshaking has been removed from the TLS protocol in TLS 1.3. - @@ -78296,7 +74712,6 @@ setting of this property. If you explicitly want to do an unclean close, you can close @conn's #GTlsConnection:base-io-stream rather than closing @conn itself, but note that this may only be done when no other operations are pending on @conn or the base I/O stream. - @@ -78320,7 +74735,6 @@ peer certificate validation will always set the client-side connections, unless that bit is not set in #GTlsClientConnection:validation-flags). Use g_tls_connection_set_database() instead - @@ -78469,13 +74883,11 @@ no one else overrides it. - - @@ -78494,7 +74906,6 @@ no one else overrides it. - success or failure @@ -78513,7 +74924,6 @@ no one else overrides it. - @@ -78543,7 +74953,6 @@ no one else overrides it. - %TRUE on success, %FALSE on failure, in which case @error will be set. @@ -78563,7 +74972,6 @@ case @error will be set. - @@ -78601,7 +75009,6 @@ All implementations are required to be fully thread-safe. Most common client applications will not directly interact with #GTlsDatabase. It is used internally by #GTlsConnection. - Create a handle string for the certificate. The database will only be able to create a handle for certificates that originate from the database. In @@ -78611,7 +75018,6 @@ will be returned. This handle should be stable across various instances of the application, and between applications. If a certificate is modified in the database, then it is not guaranteed that this handle will continue to point to it. - a newly allocated string containing the handle. @@ -78641,7 +75047,6 @@ this database, then %NULL will be returned. This function can block, use g_tls_database_lookup_certificate_for_handle_async() to perform the lookup operation asynchronously. - a newly allocated #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -78673,7 +75078,6 @@ the lookup operation asynchronously. Asynchronously look up a certificate by its handle in the database. See g_tls_database_lookup_certificate_for_handle() for more information. - @@ -78714,7 +75118,6 @@ g_tls_database_lookup_certificate_for_handle() for more information. If the handle is no longer valid, or does not point to a certificate in this database, then %NULL will be returned. - a newly allocated #GTlsCertificate object. Use g_object_unref() to release the certificate. @@ -78740,7 +75143,6 @@ into a chain. This function can block, use g_tls_database_lookup_certificate_issuer_async() to perform the lookup operation asynchronously. - a newly allocated issuer #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -78772,7 +75174,6 @@ or %NULL. Use g_object_unref() to release the certificate. Asynchronously look up the issuer of @certificate in the database. See g_tls_database_lookup_certificate_issuer() for more information. - @@ -78810,7 +75211,6 @@ g_tls_database_lookup_certificate_issuer() for more information. Finish an asynchronous lookup issuer operation. See g_tls_database_lookup_certificate_issuer() for more information. - a newly allocated issuer #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -78832,7 +75232,6 @@ or %NULL. Use g_object_unref() to release the certificate. This function can block, use g_tls_database_lookup_certificates_issued_by_async() to perform the lookup operation asynchronously. - a newly allocated list of #GTlsCertificate objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list. @@ -78872,7 +75271,6 @@ g_tls_database_lookup_certificates_issued_by() for more information. The database may choose to hold a reference to the issuer byte array for the duration of of this asynchronous operation. The byte array should not be modified during this time. - @@ -78912,7 +75310,6 @@ this time. Finish an asynchronous lookup of certificates. See g_tls_database_lookup_certificates_issued_by() for more information. - a newly allocated list of #GTlsCertificate objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list. @@ -78969,7 +75366,6 @@ but found to be invalid. This function can block, use g_tls_database_verify_chain_async() to perform the verification operation asynchronously. - the appropriate #GTlsCertificateFlags which represents the result of verification. @@ -79010,7 +75406,6 @@ result of verification. Asynchronously determines the validity of a certificate chain after looking up and adding any missing certificates to the chain. See g_tls_database_verify_chain() for more information. - @@ -79065,7 +75460,6 @@ before it completes) then the return value will be %G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set accordingly. @error is not set when @chain is successfully analyzed but found to be invalid. - the appropriate #GTlsCertificateFlags which represents the result of verification. @@ -79091,7 +75485,6 @@ will be returned. This handle should be stable across various instances of the application, and between applications. If a certificate is modified in the database, then it is not guaranteed that this handle will continue to point to it. - a newly allocated string containing the handle. @@ -79121,7 +75514,6 @@ this database, then %NULL will be returned. This function can block, use g_tls_database_lookup_certificate_for_handle_async() to perform the lookup operation asynchronously. - a newly allocated #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -79153,7 +75545,6 @@ the lookup operation asynchronously. Asynchronously look up a certificate by its handle in the database. See g_tls_database_lookup_certificate_for_handle() for more information. - @@ -79194,7 +75585,6 @@ g_tls_database_lookup_certificate_for_handle() for more information. If the handle is no longer valid, or does not point to a certificate in this database, then %NULL will be returned. - a newly allocated #GTlsCertificate object. Use g_object_unref() to release the certificate. @@ -79220,7 +75610,6 @@ into a chain. This function can block, use g_tls_database_lookup_certificate_issuer_async() to perform the lookup operation asynchronously. - a newly allocated issuer #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -79252,7 +75641,6 @@ or %NULL. Use g_object_unref() to release the certificate. Asynchronously look up the issuer of @certificate in the database. See g_tls_database_lookup_certificate_issuer() for more information. - @@ -79290,7 +75678,6 @@ g_tls_database_lookup_certificate_issuer() for more information. Finish an asynchronous lookup issuer operation. See g_tls_database_lookup_certificate_issuer() for more information. - a newly allocated issuer #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -79312,7 +75699,6 @@ or %NULL. Use g_object_unref() to release the certificate. This function can block, use g_tls_database_lookup_certificates_issued_by_async() to perform the lookup operation asynchronously. - a newly allocated list of #GTlsCertificate objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list. @@ -79352,7 +75738,6 @@ g_tls_database_lookup_certificates_issued_by() for more information. The database may choose to hold a reference to the issuer byte array for the duration of of this asynchronous operation. The byte array should not be modified during this time. - @@ -79392,7 +75777,6 @@ this time. Finish an asynchronous lookup of certificates. See g_tls_database_lookup_certificates_issued_by() for more information. - a newly allocated list of #GTlsCertificate objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list. @@ -79449,7 +75833,6 @@ but found to be invalid. This function can block, use g_tls_database_verify_chain_async() to perform the verification operation asynchronously. - the appropriate #GTlsCertificateFlags which represents the result of verification. @@ -79490,7 +75873,6 @@ result of verification. Asynchronously determines the validity of a certificate chain after looking up and adding any missing certificates to the chain. See g_tls_database_verify_chain() for more information. - @@ -79545,7 +75927,6 @@ before it completes) then the return value will be %G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set accordingly. @error is not set when @chain is successfully analyzed but found to be invalid. - the appropriate #GTlsCertificateFlags which represents the result of verification. @@ -79573,13 +75954,11 @@ result of verification. The class for #GTlsDatabase. Derived classes should implement the various virtual methods. _async and _finish methods have a default implementation that runs the corresponding sync method in a thread. - - the appropriate #GTlsCertificateFlags which represents the result of verification. @@ -79619,7 +75998,6 @@ result of verification. - @@ -79665,7 +76043,6 @@ result of verification. - the appropriate #GTlsCertificateFlags which represents the result of verification. @@ -79685,7 +76062,6 @@ result of verification. - a newly allocated string containing the handle. @@ -79705,7 +76081,6 @@ handle. - a newly allocated #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -79737,7 +76112,6 @@ handle. - @@ -79775,7 +76149,6 @@ handle. - a newly allocated #GTlsCertificate object. Use g_object_unref() to release the certificate. @@ -79795,7 +76168,6 @@ Use g_object_unref() to release the certificate. - a newly allocated issuer #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -79827,7 +76199,6 @@ or %NULL. Use g_object_unref() to release the certificate. - @@ -79865,7 +76236,6 @@ or %NULL. Use g_object_unref() to release the certificate. - a newly allocated issuer #GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate. @@ -79885,7 +76255,6 @@ or %NULL. Use g_object_unref() to release the certificate. - a newly allocated list of #GTlsCertificate objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list. @@ -79921,7 +76290,6 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele - @@ -79961,7 +76329,6 @@ objects. Use g_object_unref() on each certificate, and g_list_free() on the rele - a newly allocated list of #GTlsCertificate objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list. @@ -80056,14 +76423,12 @@ TLS-related routine. #GTlsFileDatabase is implemented by #GTlsDatabase objects which load their certificate information from a file. It is an interface which TLS library specific subtypes implement. - Creates a new #GTlsFileDatabase which uses anchor certificate authorities in @anchors to verify certificate chains. The certificates in @anchors must be PEM encoded. - the new #GTlsFileDatabase, or %NULL on error @@ -80086,7 +76451,6 @@ via the g_tls_database_verify_chain() operation. Provides an interface for #GTlsFileDatabase implementations. - The parent interface. @@ -80118,7 +76482,6 @@ like to support by overriding those virtual methods in their class initialization function. Any interactions not implemented will return %G_TLS_INTERACTION_UNHANDLED. If a derived class implements an async method, it must also implement the corresponding finish method. - Run synchronous interaction to ask the user for a password. In general, g_tls_interaction_invoke_ask_password() should be used instead of this @@ -80133,7 +76496,6 @@ If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. - The status of the ask password interaction. @@ -80169,7 +76531,6 @@ contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. Certain implementations may not support immediate cancellation. - @@ -80206,7 +76567,6 @@ to g_tls_interaction_ask_password() will have its password filled in. If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. - The status of the ask password interaction. @@ -80239,7 +76599,6 @@ If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. - The status of the request certificate interaction. @@ -80272,7 +76631,6 @@ Derived subclasses usually implement a certificate selector, although they may also choose to provide a certificate from elsewhere. @callback will be called when the operation completes. Alternatively the user may abort this certificate request, which will usually abort the TLS connection. - @@ -80314,7 +76672,6 @@ passed to g_tls_interaction_request_certificate_async() will have had its If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. - The status of the request certificate interaction. @@ -80344,7 +76701,6 @@ If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. - The status of the ask password interaction. @@ -80380,7 +76736,6 @@ contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. Certain implementations may not support immediate cancellation. - @@ -80417,7 +76772,6 @@ to g_tls_interaction_ask_password() will have its password filled in. If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. - The status of the ask password interaction. @@ -80453,7 +76807,6 @@ If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. - The status of the ask password interaction. @@ -80494,7 +76847,6 @@ If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. - The status of the certificate request interaction. @@ -80535,7 +76887,6 @@ If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may not support immediate cancellation. - The status of the request certificate interaction. @@ -80568,7 +76919,6 @@ Derived subclasses usually implement a certificate selector, although they may also choose to provide a certificate from elsewhere. @callback will be called when the operation completes. Alternatively the user may abort this certificate request, which will usually abort the TLS connection. - @@ -80610,7 +76960,6 @@ passed to g_tls_interaction_request_certificate_async() will have had its If the interaction is cancelled by the cancellation object, or by the user then %G_TLS_INTERACTION_FAILED will be returned with an error that contains a %G_IO_ERROR_CANCELLED error code. - The status of the request certificate interaction. @@ -80648,13 +76997,11 @@ and the asynchronous methods to display modeless dialogs. If the user cancels an interaction, then the result should be %G_TLS_INTERACTION_FAILED and the error should be set with a domain of %G_IO_ERROR and code of %G_IO_ERROR_CANCELLED. - - The status of the ask password interaction. @@ -80677,7 +77024,6 @@ If the user cancels an interaction, then the result should be - @@ -80707,7 +77053,6 @@ If the user cancels an interaction, then the result should be - The status of the ask password interaction. @@ -80726,7 +77071,6 @@ If the user cancels an interaction, then the result should be - The status of the request certificate interaction. @@ -80753,7 +77097,6 @@ If the user cancels an interaction, then the result should be - @@ -80787,7 +77130,6 @@ If the user cancels an interaction, then the result should be - The status of the request certificate interaction. @@ -80831,10 +77173,8 @@ when finishing an interaction request. Holds a password used in TLS. - Create a new #GTlsPassword object. - The newly allocated password object @@ -80851,7 +77191,6 @@ when finishing an interaction request. - @@ -80867,7 +77206,6 @@ filled in with the length of the password value. (Note that the password value is not nul-terminated, so you can only pass %NULL for @length in contexts where you know the password will have a certain fixed length.) - The password value (owned by the password object). @@ -80893,7 +77231,6 @@ Specify the @length, for a non-nul-terminated password. Pass -1 as @length if using a nul-terminated password, and @length will be calculated automatically. (Note that the terminating nul is not considered part of the password in this case.) - @@ -80920,7 +77257,6 @@ considered part of the password in this case.) Get a description string about what the password will be used for. - The description of the password. @@ -80934,7 +77270,6 @@ considered part of the password in this case.) Get flags about the password. - The flags about the password. @@ -80952,7 +77287,6 @@ filled in with the length of the password value. (Note that the password value is not nul-terminated, so you can only pass %NULL for @length in contexts where you know the password will have a certain fixed length.) - The password value (owned by the password object). @@ -80972,7 +77306,6 @@ certain fixed length.) Get a user readable translated warning. Usually this warning is a representation of the password flags returned from g_tls_password_get_flags(). - The warning. @@ -80986,7 +77319,6 @@ g_tls_password_get_flags(). Set a description string about what the password will be used for. - @@ -81003,7 +77335,6 @@ g_tls_password_get_flags(). Set flags about the password. - @@ -81026,7 +77357,6 @@ Specify the @length, for a non-nul-terminated password. Pass -1 as @length if using a nul-terminated password, and @length will be calculated automatically. (Note that the terminating nul is not considered part of the password in this case.) - @@ -81057,7 +77387,6 @@ Specify the @length, for a non-nul-terminated password. Pass -1 as @length if using a nul-terminated password, and @length will be calculated automatically. (Note that the terminating nul is not considered part of the password in this case.) - @@ -81086,7 +77415,6 @@ considered part of the password in this case.) Set a user readable translated warning. Usually this warning is a representation of the password flags returned from g_tls_password_get_flags(). - @@ -81119,13 +77447,11 @@ g_tls_password_get_flags(). Class structure for #GTlsPassword. - - The password value (owned by the password object). @@ -81144,7 +77470,6 @@ g_tls_password_get_flags(). - @@ -81172,7 +77497,6 @@ g_tls_password_get_flags(). - @@ -81228,7 +77552,6 @@ g_tls_connection_set_rehandshake_mode(). #GTlsServerConnection is the server-side subclass of #GTlsConnection, representing a server-side TLS connection. - Creates a new #GTlsServerConnection wrapping @base_io_stream (which @@ -81237,7 +77560,6 @@ must have pollable input and output streams). See the documentation for #GTlsConnection:base-io-stream for restrictions on when application code can run operations on the @base_io_stream after this function has returned. - the new #GTlsServerConnection, or %NULL on error @@ -81263,168 +77585,144 @@ rehandshake with a different mode from the initial handshake. vtable for a #GTlsServerConnection implementation. - The parent interface. - - - - - - - - - - - - - - - - - - - - - - - @@ -81440,7 +77738,6 @@ functionality like passing file descriptors. Note that `<gio/gunixconnection.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - Receives credentials from the sending end of the connection. The sending end has to call g_unix_connection_send_credentials() (or @@ -81460,7 +77757,6 @@ This method can be expected to be available on the following platforms: Other ways to exchange credentials with a foreign peer includes the #GUnixCredentialsMessage type and g_socket_get_credentials() function. - Received credentials on success (free with g_object_unref()), %NULL if @error is set. @@ -81485,7 +77781,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_unix_connection_receive_credentials_finish() to get the result of the operation. - @@ -81511,7 +77806,6 @@ g_unix_connection_receive_credentials_finish() to get the result of the operatio Finishes an asynchronous receive credentials operation started with g_unix_connection_receive_credentials_async(). - a #GCredentials, or %NULL on error. Free the returned object with g_object_unref(). @@ -81536,7 +77830,6 @@ to work. As well as reading the fd this also reads a single byte from the stream, as this is required for fd passing to work on some implementations. - a file descriptor on success, -1 on error. @@ -81572,7 +77865,6 @@ This method can be expected to be available on the following platforms: Other ways to exchange credentials with a foreign peer includes the #GUnixCredentialsMessage type and g_socket_get_credentials() function. - %TRUE on success, %FALSE if @error is set. @@ -81596,7 +77888,6 @@ the synchronous version of this call. When the operation is finished, @callback will be called. You can then call g_unix_connection_send_credentials_finish() to get the result of the operation. - @@ -81622,7 +77913,6 @@ g_unix_connection_send_credentials_finish() to get the result of the operation.< Finishes an asynchronous send credentials operation started with g_unix_connection_send_credentials_async(). - %TRUE if the operation was successful, otherwise %FALSE. @@ -81646,7 +77936,6 @@ to accept the file descriptor. As well as sending the fd this also writes a single byte to the stream, as this is required for fd passing to work on some implementations. - a %TRUE on success, %NULL on error. @@ -81674,7 +77963,6 @@ implementations. - @@ -81694,10 +77982,8 @@ g_unix_connection_send_credentials() and g_unix_connection_receive_credentials(). To receive credentials of a foreign process connected to a socket, use g_socket_get_credentials(). - Creates a new #GUnixCredentialsMessage with credentials matching the current processes. - a new #GUnixCredentialsMessage @@ -81705,7 +77991,6 @@ g_socket_get_credentials(). Creates a new #GUnixCredentialsMessage holding @credentials. - a new #GUnixCredentialsMessage @@ -81719,7 +78004,6 @@ g_socket_get_credentials(). Checks if passing #GCredentials on a #GSocket is supported on this platform. - %TRUE if supported, %FALSE otherwise @@ -81727,7 +78011,6 @@ g_socket_get_credentials(). Gets the credentials stored in @message. - A #GCredentials instance. Do not free, it is owned by @message. @@ -81752,13 +78035,11 @@ g_socket_get_credentials(). Class structure for #GUnixCredentialsMessage. - - @@ -81766,7 +78047,6 @@ g_socket_get_credentials(). - @@ -81787,10 +78067,8 @@ and received using g_socket_receive_message(). Note that `<gio/gunixfdlist.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - Creates a new #GUnixFDList containing no file descriptors. - a new #GUnixFDList @@ -81805,7 +78083,6 @@ the caller. Each file descriptor in the array should be set to close-on-exec. If @n_fds is -1 then @fds must be terminated with -1. - a new #GUnixFDList @@ -81836,7 +78113,6 @@ system-wide file descriptor limit. The index of the file descriptor in the list is returned. If you use this index with g_unix_fd_list_get() then you will receive back a duplicated copy of the same file descriptor. - the index of the appended fd in case of success, else -1 (and @error is set) @@ -81866,7 +78142,6 @@ when you are done. A possible cause of failure is exceeding the per-process or system-wide file descriptor limit. - the file descriptor, or -1 in case of error @@ -81885,7 +78160,6 @@ system-wide file descriptor limit. Gets the length of @list (ie: the number of file descriptors contained within). - the length of @list @@ -81911,7 +78185,6 @@ terminated with -1. This function never returns %NULL. In case there are no file descriptors contained in @list, an empty array is returned. - an array of file descriptors @@ -81950,7 +78223,6 @@ terminated with -1. This function never returns %NULL. In case there are no file descriptors contained in @list, an empty array is returned. - an array of file descriptors @@ -81978,13 +78250,11 @@ descriptors contained in @list, an empty array is returned. - - @@ -81992,7 +78262,6 @@ descriptors contained in @list, an empty array is returned. - @@ -82000,7 +78269,6 @@ descriptors contained in @list, an empty array is returned. - @@ -82008,7 +78276,6 @@ descriptors contained in @list, an empty array is returned. - @@ -82016,7 +78283,6 @@ descriptors contained in @list, an empty array is returned. - @@ -82040,11 +78306,9 @@ g_unix_connection_receive_fd(). Note that `<gio/gunixfdmessage.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - Creates a new #GUnixFDMessage containing an empty file descriptor list. - a new #GUnixFDMessage @@ -82052,7 +78316,6 @@ list. Creates a new #GUnixFDMessage containing @list. - a new #GUnixFDMessage @@ -82073,7 +78336,6 @@ when @message is finalized. A possible cause of failure is exceeding the per-process or system-wide file descriptor limit. - %TRUE in case of success, else %FALSE (and @error is set) @@ -82093,7 +78355,6 @@ system-wide file descriptor limit. Gets the #GUnixFDList contained in @message. This function does not return a reference to the caller, but the returned list is valid for the lifetime of @message. - the #GUnixFDList from @message @@ -82123,7 +78384,6 @@ terminated with -1. This function never returns %NULL. In case there are no file descriptors contained in @message, an empty array is returned. - an array of file descriptors @@ -82154,13 +78414,11 @@ descriptors contained in @message, an empty array is returned. - - @@ -82168,7 +78426,6 @@ descriptors contained in @message, an empty array is returned. - @@ -82188,7 +78445,6 @@ to doing asynchronous I/O in another thread.) Note that `<gio/gunixinputstream.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - @@ -82196,7 +78452,6 @@ file when using it. If @close_fd is %TRUE, the file descriptor will be closed when the stream is closed. - a new #GUnixInputStream @@ -82215,7 +78470,6 @@ when the stream is closed. Returns whether the file descriptor of @stream will be closed when the stream is closed. - %TRUE if the file descriptor is closed when done @@ -82229,7 +78483,6 @@ closed when the stream is closed. Return the UNIX file descriptor that the stream reads from. - The file descriptor of @stream @@ -82244,7 +78497,6 @@ closed when the stream is closed. Sets whether the file descriptor of @stream shall be closed when the stream is closed. - @@ -82275,13 +78527,11 @@ when the stream is closed. - - @@ -82289,7 +78539,6 @@ when the stream is closed. - @@ -82297,7 +78546,6 @@ when the stream is closed. - @@ -82305,7 +78553,6 @@ when the stream is closed. - @@ -82313,7 +78560,6 @@ when the stream is closed. - @@ -82326,18 +78572,15 @@ when the stream is closed. Defines a Unix mount entry (e.g. <filename>/media/cdrom</filename>). This corresponds roughly to a mtab entry. - Watches #GUnixMounts for changes. - Deprecated alias for g_unix_mount_monitor_get(). This function was never a true constructor, which is why it was renamed. Use g_unix_mount_monitor_get() instead. - a #GUnixMountMonitor. @@ -82353,7 +78596,6 @@ entries). You must only call g_object_unref() on the return value from under the same main context as you called this function. - the #GUnixMountMonitor. @@ -82368,7 +78610,6 @@ circumstances. Since @mount_monitor is a singleton, it also meant that calling this function would have side effects for other users of the monitor. This function does nothing. Don't call it. - @@ -82403,10 +78644,8 @@ the monitor. Defines a Unix mount point (e.g. <filename>/dev</filename>). This corresponds roughly to a fstab entry. - Compares two unix mount points. - 1, 0 or -1 if @mount1 is greater than, equal to, or less than @mount2, respectively. @@ -82425,7 +78664,6 @@ or less than @mount2, respectively. Makes a copy of @mount_point. - a new #GUnixMountPoint @@ -82439,7 +78677,6 @@ or less than @mount2, respectively. Frees a unix mount point. - @@ -82452,7 +78689,6 @@ or less than @mount2, respectively. Gets the device path for a unix mount point. - a string containing the device path. @@ -82466,7 +78702,6 @@ or less than @mount2, respectively. Gets the file system type for the mount point. - a string containing the file system type. @@ -82480,7 +78715,6 @@ or less than @mount2, respectively. Gets the mount path for a unix mount point. - a string containing the mount path. @@ -82494,7 +78728,6 @@ or less than @mount2, respectively. Gets the options for the mount point. - a string containing the options. @@ -82508,7 +78741,6 @@ or less than @mount2, respectively. Guesses whether a Unix mount point can be ejected. - %TRUE if @mount_point is deemed to be ejectable. @@ -82522,7 +78754,6 @@ or less than @mount2, respectively. Guesses the icon of a Unix mount point. - a #GIcon @@ -82537,7 +78768,6 @@ or less than @mount2, respectively. Guesses the name of a Unix mount point. The result is a translated string. - A newly allocated string that must be freed with g_free() @@ -82552,7 +78782,6 @@ The result is a translated string. Guesses the symbolic icon of a Unix mount point. - a #GIcon @@ -82566,7 +78795,6 @@ The result is a translated string. Checks if a unix mount point is a loopback device. - %TRUE if the mount point is a loopback. %FALSE otherwise. @@ -82580,7 +78808,6 @@ The result is a translated string. Checks if a unix mount point is read only. - %TRUE if a mount point is read only. @@ -82594,7 +78821,6 @@ The result is a translated string. Checks if a unix mount point is mountable by the user. - %TRUE if the mount point is user mountable. @@ -82613,7 +78839,6 @@ changed since with g_unix_mount_points_changed_since(). If more mount points have the same mount path, the last matching mount point is returned. - a #GUnixMountPoint, or %NULL if no match is found. @@ -82641,7 +78866,6 @@ to doing asynchronous I/O in another thread.) Note that `<gio/gunixoutputstream.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - @@ -82649,7 +78873,6 @@ when using it. If @close_fd, is %TRUE, the file descriptor will be closed when the output stream is destroyed. - a new #GOutputStream @@ -82668,7 +78891,6 @@ the output stream is destroyed. Returns whether the file descriptor of @stream will be closed when the stream is closed. - %TRUE if the file descriptor is closed when done @@ -82682,7 +78904,6 @@ closed when the stream is closed. Return the UNIX file descriptor that the stream writes to. - The file descriptor of @stream @@ -82697,7 +78918,6 @@ closed when the stream is closed. Sets whether the file descriptor of @stream shall be closed when the stream is closed. - @@ -82728,13 +78948,11 @@ when the stream is closed. - - @@ -82742,7 +78960,6 @@ when the stream is closed. - @@ -82750,7 +78967,6 @@ when the stream is closed. - @@ -82758,7 +78974,6 @@ when the stream is closed. - @@ -82766,7 +78981,6 @@ when the stream is closed. - @@ -82791,14 +79005,12 @@ to see if abstract names are supported. Note that `<gio/gunixsocketaddress.h>` belongs to the UNIX-specific GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file when using it. - Creates a new #GUnixSocketAddress for @path. To create abstract socket addresses, on systems that support that, use g_unix_socket_address_new_abstract(). - a new #GUnixSocketAddress @@ -82814,7 +79026,6 @@ use g_unix_socket_address_new_abstract(). Creates a new %G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED #GUnixSocketAddress for @path. Use g_unix_socket_address_new_with_type(). - a new #GUnixSocketAddress @@ -82864,7 +79075,6 @@ length of @path. when connecting to a server created by another process, you must use the appropriate type corresponding to how that process created its listening socket. - a new #GUnixSocketAddress @@ -82888,7 +79098,6 @@ its listening socket. Checks if abstract UNIX domain socket names are supported. - %TRUE if supported, %FALSE otherwise @@ -82896,7 +79105,6 @@ its listening socket. Gets @address's type. - a #GUnixSocketAddressType @@ -82911,7 +79119,6 @@ its listening socket. Tests if @address is abstract. Use g_unix_socket_address_get_address_type() - %TRUE if the address is abstract, %FALSE otherwise @@ -82930,7 +79137,6 @@ Guaranteed to be zero-terminated, but an abstract socket may contain embedded zeros, and thus you should use g_unix_socket_address_get_path_len() to get the true length of this string. - the path for @address @@ -82946,7 +79152,6 @@ of this string. Gets the length of @address's path. For details, see g_unix_socket_address_get_path(). - the length of the path @@ -82984,7 +79189,6 @@ abstract addresses. - @@ -83024,14 +79228,12 @@ pass an appropriate smaller length to bind() or connect(). This is - - @@ -83040,25 +79242,21 @@ pass an appropriate smaller length to bind() or connect(). This is Extension point for #GVfs functionality. See [Extending GIO][extending-gio]. - - - - @@ -83074,44 +79272,36 @@ This is intended to be used by applications to classify #GVolume instances into different sections - for example a file manager or file chooser can use this information to show `network` volumes under a "Network" heading and `device` volumes under a "Devices" heading. - The string used to obtain a Hal UDI with g_volume_get_identifier(). Do not use, HAL is deprecated. - The string used to obtain a filesystem label with g_volume_get_identifier(). - The string used to obtain a NFS mount with g_volume_get_identifier(). - The string used to obtain a Unix device path with g_volume_get_identifier(). - The string used to obtain a UUID with g_volume_get_identifier(). - - - @@ -83120,11 +79310,9 @@ a "Network" heading and `device` volumes under a "Devices" heading. Extension point for volume monitor functionality. See [Extending GIO][extending-gio]. - - @@ -83132,10 +79320,8 @@ See [Extending GIO][extending-gio]. Entry point for using GIO functionality. - Gets the default #GVfs for the system. - a #GVfs. @@ -83143,14 +79329,12 @@ See [Extending GIO][extending-gio]. Gets the local #GVfs for the system. - a #GVfs. - @@ -83164,7 +79348,6 @@ See [Extending GIO][extending-gio]. - @@ -83179,7 +79362,6 @@ See [Extending GIO][extending-gio]. Gets a #GFile for @path. - a #GFile. Free the returned object with g_object_unref(). @@ -83202,7 +79384,6 @@ See [Extending GIO][extending-gio]. This operation never fails, but the returned object might not support any I/O operation if the URI is malformed or if the URI scheme is not supported. - a #GFile. Free the returned object with g_object_unref(). @@ -83221,7 +79402,6 @@ is malformed or if the URI scheme is not supported. Gets a list of URI schemes supported by @vfs. - a %NULL-terminated array of strings. The returned array belongs to GIO and must @@ -83239,7 +79419,6 @@ is malformed or if the URI scheme is not supported. Checks if the VFS is active. - %TRUE if construction of the @vfs was successful and it is now active. @@ -83253,7 +79432,6 @@ is malformed or if the URI scheme is not supported. - @@ -83285,7 +79463,6 @@ is malformed or if the URI scheme is not supported. - @@ -83302,7 +79479,6 @@ is malformed or if the URI scheme is not supported. - @@ -83316,7 +79492,6 @@ is malformed or if the URI scheme is not supported. - @@ -83342,7 +79517,6 @@ is malformed or if the URI scheme is not supported. This operation never fails, but the returned object might not support any I/O operations if the @parse_name cannot be parsed by the #GVfs module. - a #GFile for the given @parse_name. Free the returned object with g_object_unref(). @@ -83361,7 +79535,6 @@ be parsed by the #GVfs module. Gets a #GFile for @path. - a #GFile. Free the returned object with g_object_unref(). @@ -83384,7 +79557,6 @@ be parsed by the #GVfs module. This operation never fails, but the returned object might not support any I/O operation if the URI is malformed or if the URI scheme is not supported. - a #GFile. Free the returned object with g_object_unref(). @@ -83403,7 +79575,6 @@ is malformed or if the URI scheme is not supported. Gets a list of URI schemes supported by @vfs. - a %NULL-terminated array of strings. The returned array belongs to GIO and must @@ -83421,7 +79592,6 @@ is malformed or if the URI scheme is not supported. Checks if the VFS is active. - %TRUE if construction of the @vfs was successful and it is now active. @@ -83438,7 +79608,6 @@ is malformed or if the URI scheme is not supported. This operation never fails, but the returned object might not support any I/O operations if the @parse_name cannot be parsed by the #GVfs module. - a #GFile for the given @parse_name. Free the returned object with g_object_unref(). @@ -83476,7 +79645,6 @@ g_vfs_register_uri_scheme() or g_vfs_unregister_uri_scheme(). It's an error to call this function twice with the same scheme. To unregister a custom URI scheme, use g_vfs_unregister_uri_scheme(). - %TRUE if @scheme was successfully registered, or %FALSE if a handler for @scheme already exists. @@ -83525,7 +79693,6 @@ a custom URI scheme, use g_vfs_unregister_uri_scheme(). Unregisters the URI handler for @scheme previously registered with g_vfs_register_uri_scheme(). - %TRUE if @scheme was successfully unregistered, or %FALSE if a handler for @scheme does not exist. @@ -83547,13 +79714,11 @@ g_vfs_register_uri_scheme(). - - %TRUE if construction of the @vfs was successful and it is now active. @@ -83569,7 +79734,6 @@ g_vfs_register_uri_scheme(). - a #GFile. Free the returned object with g_object_unref(). @@ -83589,7 +79753,6 @@ g_vfs_register_uri_scheme(). - a #GFile. Free the returned object with g_object_unref(). @@ -83609,7 +79772,6 @@ g_vfs_register_uri_scheme(). - a %NULL-terminated array of strings. The returned array belongs to GIO and must @@ -83628,7 +79790,6 @@ g_vfs_register_uri_scheme(). - a #GFile for the given @parse_name. Free the returned object with g_object_unref(). @@ -83648,7 +79809,6 @@ g_vfs_register_uri_scheme(). - @@ -83682,7 +79842,6 @@ g_vfs_register_uri_scheme(). - @@ -83698,7 +79857,6 @@ g_vfs_register_uri_scheme(). - @@ -83723,7 +79881,6 @@ g_vfs_register_uri_scheme(). - @@ -83739,7 +79896,6 @@ g_vfs_register_uri_scheme(). - @@ -83758,7 +79914,6 @@ g_vfs_register_uri_scheme(). - @@ -83774,7 +79929,6 @@ g_vfs_register_uri_scheme(). - @@ -83782,7 +79936,6 @@ g_vfs_register_uri_scheme(). - @@ -83790,7 +79943,6 @@ g_vfs_register_uri_scheme(). - @@ -83798,7 +79950,6 @@ g_vfs_register_uri_scheme(). - @@ -83806,7 +79957,6 @@ g_vfs_register_uri_scheme(). - @@ -83814,7 +79964,6 @@ g_vfs_register_uri_scheme(). - @@ -83828,7 +79977,6 @@ implementation. The client should return a reference to the new file that has been created for @uri, or %NULL to continue with the default implementation. - a #GFile for @identifier. @@ -83891,10 +80039,8 @@ when the gvfs hal volume monitor is in use. Other volume monitors will generally be able to provide the #G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE identifier, which can be used to obtain a hal device by means of libhal_manager_find_device_string_match(). - Checks if a volume can be ejected. - %TRUE if the @volume can be ejected. %FALSE otherwise @@ -83908,7 +80054,6 @@ libhal_manager_find_device_string_match(). Checks if a volume can be mounted. - %TRUE if the @volume can be mounted. %FALSE otherwise @@ -83921,7 +80066,6 @@ libhal_manager_find_device_string_match(). - @@ -83936,7 +80080,6 @@ libhal_manager_find_device_string_match(). finished by calling g_volume_eject_finish() with the @volume and #GAsyncResult returned in the @callback. Use g_volume_eject_with_operation() instead. - @@ -83967,7 +80110,6 @@ and #GAsyncResult returned in the @callback. Finishes ejecting a volume. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. Use g_volume_eject_with_operation_finish() instead. - %TRUE, %FALSE if operation failed @@ -83987,7 +80129,6 @@ and #GAsyncResult returned in the @callback. Ejects a volume. This is an asynchronous operation, and is finished by calling g_volume_eject_with_operation_finish() with the @volume and #GAsyncResult data returned in the @callback. - @@ -84022,7 +80163,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a volume. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the volume was successfully ejected. %FALSE otherwise @@ -84041,7 +80181,6 @@ and #GAsyncResult data returned in the @callback. Gets the kinds of [identifiers][volume-identifier] that @volume has. Use g_volume_get_identifier() to obtain the identifiers themselves. - a %NULL-terminated array of strings containing kinds of identifiers. Use g_strfreev() to free. @@ -84083,7 +80222,6 @@ will always be %TRUE. Activation roots are typically used in #GVolumeMonitor implementations to find the underlying mount to shadow, see g_mount_is_shadowed() for more details. - the activation root of @volume or %NULL. Use g_object_unref() to free. @@ -84098,7 +80236,6 @@ g_mount_is_shadowed() for more details. Gets the drive for the @volume. - a #GDrive or %NULL if @volume is not associated with a drive. The returned object should be unreffed @@ -84114,7 +80251,6 @@ g_mount_is_shadowed() for more details. Gets the icon for @volume. - a #GIcon. The returned object should be unreffed with g_object_unref() @@ -84132,7 +80268,6 @@ g_mount_is_shadowed() for more details. Gets the identifier of the given kind for @volume. See the [introduction][volume-identifier] for more information about volume identifiers. - a newly allocated string containing the requested identifier, or %NULL if the #GVolume @@ -84152,7 +80287,6 @@ information about volume identifiers. Gets the mount for the @volume. - a #GMount or %NULL if @volume isn't mounted. The returned object should be unreffed with g_object_unref() @@ -84168,7 +80302,6 @@ information about volume identifiers. Gets the name of @volume. - the name for the given @volume. The returned string should be freed with g_free() when no longer needed. @@ -84183,7 +80316,6 @@ information about volume identifiers. Gets the sort key for @volume, if any. - Sorting key for @volume or %NULL if no such key is available @@ -84197,7 +80329,6 @@ information about volume identifiers. Gets the symbolic icon for @volume. - a #GIcon. The returned object should be unreffed with g_object_unref() @@ -84216,7 +80347,6 @@ information about volume identifiers. the file system UUID for the volume in question and should be considered an opaque string. Returns %NULL if there is no UUID available. - the UUID for @volume or %NULL if no UUID can be computed. @@ -84239,7 +80369,6 @@ If the mount operation succeeded, g_volume_get_mount() on @volume is guaranteed to return the mount right after calling this function; there's no need to listen for the 'mount-added' signal on #GVolumeMonitor. - %TRUE, %FALSE if operation failed @@ -84259,7 +80388,6 @@ function; there's no need to listen for the 'mount-added' signal on Mounts a volume. This is an asynchronous operation, and is finished by calling g_volume_mount_finish() with the @volume and #GAsyncResult returned in the @callback. - @@ -84291,7 +80419,6 @@ and #GAsyncResult returned in the @callback. - @@ -84303,7 +80430,6 @@ and #GAsyncResult returned in the @callback. Returns whether the volume should be automatically mounted. - %TRUE if the volume should be automatically mounted @@ -84317,7 +80443,6 @@ and #GAsyncResult returned in the @callback. Checks if a volume can be ejected. - %TRUE if the @volume can be ejected. %FALSE otherwise @@ -84331,7 +80456,6 @@ and #GAsyncResult returned in the @callback. Checks if a volume can be mounted. - %TRUE if the @volume can be mounted. %FALSE otherwise @@ -84348,7 +80472,6 @@ and #GAsyncResult returned in the @callback. finished by calling g_volume_eject_finish() with the @volume and #GAsyncResult returned in the @callback. Use g_volume_eject_with_operation() instead. - @@ -84379,7 +80502,6 @@ and #GAsyncResult returned in the @callback. Finishes ejecting a volume. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. Use g_volume_eject_with_operation_finish() instead. - %TRUE, %FALSE if operation failed @@ -84399,7 +80521,6 @@ and #GAsyncResult returned in the @callback. Ejects a volume. This is an asynchronous operation, and is finished by calling g_volume_eject_with_operation_finish() with the @volume and #GAsyncResult data returned in the @callback. - @@ -84434,7 +80555,6 @@ and #GAsyncResult data returned in the @callback. Finishes ejecting a volume. If any errors occurred during the operation, @error will be set to contain the errors and %FALSE will be returned. - %TRUE if the volume was successfully ejected. %FALSE otherwise @@ -84453,7 +80573,6 @@ and #GAsyncResult data returned in the @callback. Gets the kinds of [identifiers][volume-identifier] that @volume has. Use g_volume_get_identifier() to obtain the identifiers themselves. - a %NULL-terminated array of strings containing kinds of identifiers. Use g_strfreev() to free. @@ -84495,7 +80614,6 @@ will always be %TRUE. Activation roots are typically used in #GVolumeMonitor implementations to find the underlying mount to shadow, see g_mount_is_shadowed() for more details. - the activation root of @volume or %NULL. Use g_object_unref() to free. @@ -84510,7 +80628,6 @@ g_mount_is_shadowed() for more details. Gets the drive for the @volume. - a #GDrive or %NULL if @volume is not associated with a drive. The returned object should be unreffed @@ -84526,7 +80643,6 @@ g_mount_is_shadowed() for more details. Gets the icon for @volume. - a #GIcon. The returned object should be unreffed with g_object_unref() @@ -84544,7 +80660,6 @@ g_mount_is_shadowed() for more details. Gets the identifier of the given kind for @volume. See the [introduction][volume-identifier] for more information about volume identifiers. - a newly allocated string containing the requested identifier, or %NULL if the #GVolume @@ -84564,7 +80679,6 @@ information about volume identifiers. Gets the mount for the @volume. - a #GMount or %NULL if @volume isn't mounted. The returned object should be unreffed with g_object_unref() @@ -84580,7 +80694,6 @@ information about volume identifiers. Gets the name of @volume. - the name for the given @volume. The returned string should be freed with g_free() when no longer needed. @@ -84595,7 +80708,6 @@ information about volume identifiers. Gets the sort key for @volume, if any. - Sorting key for @volume or %NULL if no such key is available @@ -84609,7 +80721,6 @@ information about volume identifiers. Gets the symbolic icon for @volume. - a #GIcon. The returned object should be unreffed with g_object_unref() @@ -84628,7 +80739,6 @@ information about volume identifiers. the file system UUID for the volume in question and should be considered an opaque string. Returns %NULL if there is no UUID available. - the UUID for @volume or %NULL if no UUID can be computed. @@ -84647,7 +80757,6 @@ available. Mounts a volume. This is an asynchronous operation, and is finished by calling g_volume_mount_finish() with the @volume and #GAsyncResult returned in the @callback. - @@ -84686,7 +80795,6 @@ If the mount operation succeeded, g_volume_get_mount() on @volume is guaranteed to return the mount right after calling this function; there's no need to listen for the 'mount-added' signal on #GVolumeMonitor. - %TRUE, %FALSE if operation failed @@ -84704,7 +80812,6 @@ function; there's no need to listen for the 'mount-added' signal on Returns whether the volume should be automatically mounted. - %TRUE if the volume should be automatically mounted @@ -84733,14 +80840,12 @@ release them so the object can be finalized. Interface for implementing operations for mountable volumes. - The parent interface. - @@ -84753,7 +80858,6 @@ release them so the object can be finalized. - @@ -84766,7 +80870,6 @@ release them so the object can be finalized. - the name for the given @volume. The returned string should be freed with g_free() when no longer needed. @@ -84782,7 +80885,6 @@ release them so the object can be finalized. - a #GIcon. The returned object should be unreffed with g_object_unref() @@ -84799,7 +80901,6 @@ release them so the object can be finalized. - the UUID for @volume or %NULL if no UUID can be computed. @@ -84817,7 +80918,6 @@ release them so the object can be finalized. - a #GDrive or %NULL if @volume is not associated with a drive. The returned object should be unreffed @@ -84834,7 +80934,6 @@ release them so the object can be finalized. - a #GMount or %NULL if @volume isn't mounted. The returned object should be unreffed with g_object_unref() @@ -84851,7 +80950,6 @@ release them so the object can be finalized. - %TRUE if the @volume can be mounted. %FALSE otherwise @@ -84866,7 +80964,6 @@ release them so the object can be finalized. - %TRUE if the @volume can be ejected. %FALSE otherwise @@ -84881,7 +80978,6 @@ release them so the object can be finalized. - @@ -84915,7 +81011,6 @@ release them so the object can be finalized. - %TRUE, %FALSE if operation failed @@ -84934,7 +81029,6 @@ release them so the object can be finalized. - @@ -84964,7 +81058,6 @@ release them so the object can be finalized. - %TRUE, %FALSE if operation failed @@ -84983,7 +81076,6 @@ release them so the object can be finalized. - a newly allocated string containing the requested identifier, or %NULL if the #GVolume @@ -85004,7 +81096,6 @@ release them so the object can be finalized. - a %NULL-terminated array of strings containing kinds of identifiers. Use g_strfreev() to free. @@ -85022,7 +81113,6 @@ release them so the object can be finalized. - %TRUE if the volume should be automatically mounted @@ -85037,7 +81127,6 @@ release them so the object can be finalized. - the activation root of @volume or %NULL. Use g_object_unref() to free. @@ -85053,7 +81142,6 @@ release them so the object can be finalized. - @@ -85088,7 +81176,6 @@ release them so the object can be finalized. - %TRUE if the volume was successfully ejected. %FALSE otherwise @@ -85107,7 +81194,6 @@ release them so the object can be finalized. - Sorting key for @volume or %NULL if no such key is available @@ -85122,7 +81208,6 @@ release them so the object can be finalized. - a #GIcon. The returned object should be unreffed with g_object_unref() @@ -85150,7 +81235,6 @@ thread-default-context active. In order to receive updates about volumes and mounts monitored through GVFS, a main loop must be running. - This function should be called by any #GVolumeMonitor implementation when a new #GMount object is created that is not @@ -85185,7 +81269,6 @@ implementations should instead create shadow mounts with the URI of the mount they intend to adopt. See the proxy volume monitor in gvfs for an example of this. Also see g_mount_is_shadowed(), g_mount_shadow() and g_mount_unshadow() functions. - the #GVolume object that is the parent for @mount or %NULL if no wants to adopt the #GMount. @@ -85200,7 +81283,6 @@ if no wants to adopt the #GMount. Gets the volume monitor used by gio. - a reference to the #GVolumeMonitor used by gio. Call g_object_unref() when done with it. @@ -85208,7 +81290,6 @@ if no wants to adopt the #GMount. - @@ -85222,7 +81303,6 @@ if no wants to adopt the #GMount. - @@ -85236,7 +81316,6 @@ if no wants to adopt the #GMount. - @@ -85250,7 +81329,6 @@ if no wants to adopt the #GMount. - @@ -85264,7 +81342,6 @@ if no wants to adopt the #GMount. - @@ -85282,7 +81359,6 @@ if no wants to adopt the #GMount. The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - a #GList of connected #GDrive objects. @@ -85298,7 +81374,6 @@ its elements have been unreffed with g_object_unref(). Finds a #GMount object by its UUID (see g_mount_get_uuid()) - a #GMount or %NULL if no such mount is available. Free the returned object with g_object_unref(). @@ -85320,7 +81395,6 @@ its elements have been unreffed with g_object_unref(). The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - a #GList of #GMount objects. @@ -85336,7 +81410,6 @@ its elements have been unreffed with g_object_unref(). Finds a #GVolume object by its UUID (see g_volume_get_uuid()) - a #GVolume or %NULL if no such volume is available. Free the returned object with g_object_unref(). @@ -85358,7 +81431,6 @@ its elements have been unreffed with g_object_unref(). The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - a #GList of #GVolume objects. @@ -85373,7 +81445,6 @@ its elements have been unreffed with g_object_unref(). - @@ -85387,7 +81458,6 @@ its elements have been unreffed with g_object_unref(). - @@ -85401,7 +81471,6 @@ its elements have been unreffed with g_object_unref(). - @@ -85415,7 +81484,6 @@ its elements have been unreffed with g_object_unref(). - @@ -85429,7 +81497,6 @@ its elements have been unreffed with g_object_unref(). - @@ -85443,7 +81510,6 @@ its elements have been unreffed with g_object_unref(). - @@ -85457,7 +81523,6 @@ its elements have been unreffed with g_object_unref(). - @@ -85475,7 +81540,6 @@ its elements have been unreffed with g_object_unref(). The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - a #GList of connected #GDrive objects. @@ -85491,7 +81555,6 @@ its elements have been unreffed with g_object_unref(). Finds a #GMount object by its UUID (see g_mount_get_uuid()) - a #GMount or %NULL if no such mount is available. Free the returned object with g_object_unref(). @@ -85513,7 +81576,6 @@ its elements have been unreffed with g_object_unref(). The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - a #GList of #GMount objects. @@ -85529,7 +81591,6 @@ its elements have been unreffed with g_object_unref(). Finds a #GVolume object by its UUID (see g_volume_get_uuid()) - a #GVolume or %NULL if no such volume is available. Free the returned object with g_object_unref(). @@ -85551,7 +81612,6 @@ its elements have been unreffed with g_object_unref(). The returned list should be freed with g_list_free(), after its elements have been unreffed with g_object_unref(). - a #GList of #GVolume objects. @@ -85720,13 +81780,11 @@ GIO was used to unmount. - - @@ -85742,7 +81800,6 @@ GIO was used to unmount. - @@ -85758,7 +81815,6 @@ GIO was used to unmount. - @@ -85774,7 +81830,6 @@ GIO was used to unmount. - @@ -85790,7 +81845,6 @@ GIO was used to unmount. - @@ -85806,7 +81860,6 @@ GIO was used to unmount. - @@ -85822,7 +81875,6 @@ GIO was used to unmount. - @@ -85838,7 +81890,6 @@ GIO was used to unmount. - @@ -85854,7 +81905,6 @@ GIO was used to unmount. - @@ -85870,7 +81920,6 @@ GIO was used to unmount. - @@ -85886,7 +81935,6 @@ GIO was used to unmount. - @@ -85894,7 +81942,6 @@ GIO was used to unmount. - a #GList of connected #GDrive objects. @@ -85911,7 +81958,6 @@ GIO was used to unmount. - a #GList of #GVolume objects. @@ -85928,7 +81974,6 @@ GIO was used to unmount. - a #GList of #GMount objects. @@ -85945,7 +81990,6 @@ GIO was used to unmount. - a #GVolume or %NULL if no such volume is available. Free the returned object with g_object_unref(). @@ -85965,7 +82009,6 @@ GIO was used to unmount. - a #GMount or %NULL if no such mount is available. Free the returned object with g_object_unref(). @@ -85985,7 +82028,6 @@ GIO was used to unmount. - @@ -86001,7 +82043,6 @@ GIO was used to unmount. - @@ -86017,7 +82058,6 @@ GIO was used to unmount. - @@ -86033,7 +82073,6 @@ GIO was used to unmount. - @@ -86041,7 +82080,6 @@ GIO was used to unmount. - @@ -86049,7 +82087,6 @@ GIO was used to unmount. - @@ -86057,7 +82094,6 @@ GIO was used to unmount. - @@ -86065,7 +82101,6 @@ GIO was used to unmount. - @@ -86073,7 +82108,6 @@ GIO was used to unmount. - @@ -86081,42 +82115,36 @@ GIO was used to unmount. - - - - - - @@ -86124,11 +82152,9 @@ GIO was used to unmount. Zlib decompression - Creates a new #GZlibCompressor. - a new #GZlibCompressor @@ -86146,7 +82172,6 @@ GIO was used to unmount. Returns the #GZlibCompressor:file-info property. - a #GFileInfo, or %NULL @@ -86167,7 +82192,6 @@ the GZIP header of the compressed data. Note: it is an error to call this function while a compression is in progress; it may only be called immediately after creation of @compressor, or after resetting it with g_converter_reset(). - @@ -86196,7 +82220,6 @@ and modification time from the file info to the GZIP header. - @@ -86216,11 +82239,9 @@ and #GZlibCompressor. Zlib decompression - Creates a new #GZlibDecompressor. - a new #GZlibDecompressor @@ -86238,7 +82259,6 @@ of compressed data processed by @compressor, or %NULL if @decompressor's #GZlibDecompressor:format property is not %G_ZLIB_COMPRESSOR_FORMAT_GZIP, or the header data was not fully processed yet, or it not present in the data stream at all. - a #GFileInfo, or %NULL @@ -86262,7 +82282,6 @@ fully processed, is not present at all, or the compressor's - @@ -86275,7 +82294,6 @@ plus '-' and '.'. The empty string is not a valid action name. It is an error to call this function with a non-utf8 @action_name. @action_name must not be %NULL. - %TRUE if @action_name is valid @@ -86312,7 +82330,6 @@ two sets of parens, for example: "app.action((1,2,3))". A string target can be specified this way as well: "app.action('target')". For strings, this third format must be used if * target value is empty or contains characters other than alphanumerics, '-' and '.'. - %TRUE if successful, else %FALSE with @error set @@ -86343,7 +82360,6 @@ and @target_value by that function. See that function for the types of strings that will be printed by this function. - a detailed format string @@ -86367,7 +82383,6 @@ Note that for @commandline, the quoting rules of the Exec key of the are applied. For example, if the @commandline contains percent-encoded URIs, the percent-character must be doubled in order to prevent it from being swallowed by Exec key unquoting. See the specification for exact quoting rules. - new #GAppInfo for given command. @@ -86396,7 +82411,6 @@ For desktop files, this includes applications that have of `OnlyShowIn` or `NotShowIn`. See g_app_info_should_show(). The returned list does not include applications which have the `Hidden` key set. - a newly allocated #GList of references to #GAppInfos. @@ -86409,7 +82423,6 @@ the `Hidden` key set. including the recommended and fallback #GAppInfos. See g_app_info_get_recommended_for_type() and g_app_info_get_fallback_for_type(). - #GList of #GAppInfos for given @content_type or %NULL on error. @@ -86426,7 +82439,6 @@ g_app_info_get_fallback_for_type(). Gets the default #GAppInfo for a given content type. - #GAppInfo for given @content_type or %NULL on error. @@ -86449,7 +82461,6 @@ g_app_info_get_fallback_for_type(). the given URI scheme. A URI scheme is the initial part of the URI, up to but not including the ':', e.g. "http", "ftp" or "sip". - #GAppInfo for given @uri_scheme or %NULL on error. @@ -86466,7 +82477,6 @@ of the URI, up to but not including the ':', e.g. "http", Gets a list of fallback #GAppInfos for a given content type, i.e. those applications which claim to support the given content type by MIME type subclassing and not directly. - #GList of #GAppInfos for given @content_type or %NULL on error. @@ -86488,7 +82498,6 @@ and not by MIME type subclassing. Note that the first application of the list is the last used one, i.e. the last one for which g_app_info_set_as_last_used_for_type() has been called. - #GList of #GAppInfos for given @content_type or %NULL on error. @@ -86512,7 +82521,6 @@ required. The D-Bus–activated applications don't have to be started if your application terminates too soon after this function. To prevent this, use g_app_info_launch_default_for_uri_async() instead. - %TRUE on success, %FALSE on error. @@ -86539,7 +82547,6 @@ dialog to the user. This is also useful if you want to be sure that the D-Bus–activated applications are really started before termination and if you are interested in receiving error information from their activation. - @@ -86568,7 +82575,6 @@ in receiving error information from their activation. Finishes an asynchronous launch-default-for-uri operation. - %TRUE if the launch was successful, %FALSE if @error is set @@ -86586,7 +82592,6 @@ g_app_info_set_as_default_for_type(), g_app_info_set_as_default_for_extension(), g_app_info_add_supports_type() or g_app_info_remove_supports_type(). - @@ -86606,7 +82611,6 @@ then call g_async_initable_new_finish() to get the new object and check for any errors. Use g_object_new_with_properties() and g_async_initable_init_async() instead. See #GParameter for more information. - @@ -86650,7 +82654,6 @@ then call g_bus_get_finish() to get the result of the operation. This is an asynchronous failable function. See g_bus_get_sync() for the synchronous version. - @@ -86684,7 +82687,6 @@ g_dbus_connection_new_for_address(). Note that the returned #GDBusConnection object will (usually) have the #GDBusConnection:exit-on-close property set to %TRUE. - a #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). @@ -86715,7 +82717,6 @@ g_dbus_connection_new_for_address(). Note that the returned #GDBusConnection object will (usually) have the #GDBusConnection:exit-on-close property set to %TRUE. - a #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). @@ -86782,7 +82783,6 @@ This behavior makes it very simple to write applications that wants to [own names][gdbus-owning-names] and export objects. Simply register objects to be exported in @bus_acquired_handler and unregister the objects (if any) in @name_lost_handler. - an identifier (never 0) that can be used with g_bus_unown_name() to stop owning the name. @@ -86826,7 +82826,6 @@ unregister the objects (if any) in @name_lost_handler. Like g_bus_own_name() but takes a #GDBusConnection instead of a #GBusType. - an identifier (never 0) that can be used with g_bus_unown_name() to stop owning the name @@ -86866,7 +82865,6 @@ unregister the objects (if any) in @name_lost_handler. Version of g_bus_own_name_on_connection() using closures instead of callbacks for easier binding in other languages. - an identifier (never 0) that can be used with g_bus_unown_name() to stop owning the name. @@ -86900,7 +82898,6 @@ callbacks for easier binding in other languages. Version of g_bus_own_name() using closures instead of callbacks for easier binding in other languages. - an identifier (never 0) that can be used with g_bus_unown_name() to stop owning the name. @@ -86945,7 +82942,6 @@ this function has returned. You should continue to iterate the #GMainContext until the #GDestroyNotify function passed to g_bus_own_name() is called, in order to avoid memory leaks through callbacks queued on the #GMainContext after it’s stopped being iterated. - @@ -86965,7 +82961,6 @@ this function has returned. You should continue to iterate the #GMainContext until the #GDestroyNotify function passed to g_bus_watch_name() is called, in order to avoid memory leaks through callbacks queued on the #GMainContext after it’s stopped being iterated. - @@ -87006,7 +83001,6 @@ to take action when a certain [name exists][gdbus-watching-names]. Basically, the application should create object proxies in @name_appeared_handler and destroy them again (if any) in @name_vanished_handler. - An identifier (never 0) that can be used with g_bus_unwatch_name() to stop watching the name. @@ -87046,7 +83040,6 @@ g_bus_unwatch_name() to stop watching the name. Like g_bus_watch_name() but takes a #GDBusConnection instead of a #GBusType. - An identifier (never 0) that can be used with g_bus_unwatch_name() to stop watching the name. @@ -87086,7 +83079,6 @@ g_bus_unwatch_name() to stop watching the name. Version of g_bus_watch_name_on_connection() using closures instead of callbacks for easier binding in other languages. - An identifier (never 0) that can be used with g_bus_unwatch_name() to stop watching the name. @@ -87120,7 +83112,6 @@ to not exist or %NULL. Version of g_bus_watch_name() using closures instead of callbacks for easier binding in other languages. - An identifier (never 0) that can be used with g_bus_unwatch_name() to stop watching the name. @@ -87154,7 +83145,6 @@ to not exist or %NULL. Checks if a content type can be executable. Note that for instance things like text files can be executables (i.e. scripts and batch files). - %TRUE if the file type corresponds to a type that can be executable, %FALSE otherwise. @@ -87169,7 +83159,6 @@ things like text files can be executables (i.e. scripts and batch files). Compares two content types for equality. - %TRUE if the two strings are identical or equivalent, %FALSE otherwise. @@ -87188,7 +83177,6 @@ things like text files can be executables (i.e. scripts and batch files). Tries to find a content type based on the mime type name. - Newly allocated string with content type or %NULL. Free with g_free() @@ -87203,7 +83191,6 @@ things like text files can be executables (i.e. scripts and batch files). Gets the human readable description of the content type. - a short description of the content type @type. Free the returned string with g_free() @@ -87222,7 +83209,6 @@ things like text files can be executables (i.e. scripts and batch files). See the [shared-mime-info](http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec) specification for more on the generic icon name. - the registered generic icon name for the given @type, or %NULL if unknown. Free with g_free() @@ -87237,7 +83223,6 @@ specification for more on the generic icon name. Gets the icon for a content type. - #GIcon corresponding to the content type. Free the returned object with g_object_unref() @@ -87253,7 +83238,6 @@ specification for more on the generic icon name. Get the list of directories which MIME data is loaded from. See g_content_type_set_mime_dirs() for details. - %NULL-terminated list of directories to load MIME data from, including any `mime/` subdirectory, @@ -87265,7 +83249,6 @@ g_content_type_set_mime_dirs() for details. Gets the mime type for the content type, if one is registered. - the registered mime type for the given @type, or %NULL if unknown; free with g_free(). @@ -87280,7 +83263,6 @@ g_content_type_set_mime_dirs() for details. Gets the symbolic icon for a content type. - symbolic #GIcon corresponding to the content type. Free the returned object with g_object_unref() @@ -87298,7 +83280,6 @@ g_content_type_set_mime_dirs() for details. uncertain, @result_uncertain will be set to %TRUE. Either @filename or @data may be %NULL, in which case the guess will be based solely on the other argument. - a string indicating a guessed content type for the given data. Free with g_free() @@ -87339,7 +83320,6 @@ specification for more on x-content types. This function is useful in the implementation of g_mount_guess_content_type(). - an %NULL-terminated array of zero or more content types. Free with g_strfreev() @@ -87356,7 +83336,6 @@ g_mount_guess_content_type(). Determines if @type is a subset of @supertype. - %TRUE if @type is a kind of @supertype, %FALSE otherwise. @@ -87376,7 +83355,6 @@ g_mount_guess_content_type(). Determines if @type is a subset of @mime_type. Convenience wrapper around g_content_type_is_a(). - %TRUE if @type is a kind of @mime_type, %FALSE otherwise. @@ -87398,7 +83376,6 @@ Convenience wrapper around g_content_type_is_a(). On UNIX this is the "application/octet-stream" mimetype, while on win32 it is "*" and on OSX it is a dynamic type or octet-stream. - %TRUE if the type is the unknown type. @@ -87434,7 +83411,6 @@ with @dirs set to %NULL before calling g_test_init(), for instance: return g_test_run (); ]| - @@ -87453,7 +83429,6 @@ with @dirs set to %NULL before calling g_test_init(), for instance: Gets a list of strings containing all the registered content types known to the system. The list and its data should be freed using `g_list_free_full (list, g_free)`. - list of the registered content types @@ -87470,7 +83445,6 @@ For instance, if @string is `/run/bus-for-:0`, this function would return `/run/bus-for-%3A0`, which could be used in a D-Bus address like `unix:nonce-tcp:host=127.0.0.1,port=42,noncefile=/run/bus-for-%3A0`. - a copy of @string with all non-optionally-escaped bytes escaped @@ -87491,7 +83465,6 @@ platform specific mechanisms. The returned address will be in the [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses). - a valid D-Bus address string for @bus_type or %NULL if @error is set @@ -87520,7 +83493,6 @@ the operation. This is an asynchronous failable function. See g_dbus_address_get_stream_sync() for the synchronous version. - @@ -87545,7 +83517,6 @@ g_dbus_address_get_stream_sync() for the synchronous version. Finishes an operation started with g_dbus_address_get_stream(). - A #GIOStream or %NULL if @error is set. @@ -87569,7 +83540,6 @@ of the D-Bus authentication conversation. @address must be in the This is a synchronous failable function. See g_dbus_address_get_stream() for the asynchronous version. - A #GIOStream or %NULL if @error is set. @@ -87593,7 +83563,6 @@ g_dbus_address_get_stream() for the asynchronous version. Looks up the value of an annotation. The cost of this function is O(n) in number of annotations. - The value or %NULL if not found. Do not free, it is owned by @annotations. @@ -87623,7 +83592,6 @@ on the wire back to a #GError using g_dbus_error_new_for_dbus_error(). This function is typically only used in object mappings to put a #GError on the wire. Regular applications should not use it. - A D-Bus error name (never %NULL). Free with g_free(). @@ -87642,7 +83610,6 @@ This function is guaranteed to return a D-Bus error name for all #GErrors returned from functions handling remote method calls (e.g. g_dbus_connection_call_finish()) unless g_dbus_error_strip_remote_error() has been used on @error. - an allocated string or %NULL if the D-Bus error name could not be found. Free with g_free(). @@ -87658,7 +83625,6 @@ g_dbus_error_strip_remote_error() has been used on @error. Checks if @error represents an error received via D-Bus from a remote peer. If so, use g_dbus_error_get_remote_error() to get the name of the error. - %TRUE if @error represents an error from a remote peer, %FALSE otherwise. @@ -87698,7 +83664,6 @@ returned #GError using the g_dbus_error_get_remote_error() function This function is typically only used in object mappings to prepare #GError instances for applications. Regular applications should not use it. - An allocated #GError. Free with g_error_free(). @@ -87725,7 +83690,6 @@ it. This is typically done in the routine that returns the #GQuark for an error domain. - %TRUE if the association was created, %FALSE if it already exists. @@ -87748,7 +83712,6 @@ exists. Helper function for associating a #GError error domain with D-Bus error names. - @@ -87780,7 +83743,6 @@ message field in @error will correspond exactly to what was received on the wire. This is typically used when presenting errors to the end user. - %TRUE if information was stripped, %FALSE otherwise. @@ -87794,7 +83756,6 @@ This is typically used when presenting errors to the end user. Destroys an association previously set up with g_dbus_error_register_error(). - %TRUE if the association was destroyed, %FALSE if it wasn't found. @@ -87820,7 +83781,6 @@ e.g. g_dbus_connection_new(). See the D-Bus specification regarding what strings are valid D-Bus GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). - A valid D-Bus GUID. Free with g_free(). @@ -87855,7 +83815,6 @@ returned (e.g. 0 for scalar types, the empty string for string types, See the g_dbus_gvariant_to_gvalue() function for how to convert a #GVariant to a #GValue. - A #GVariant (never floating) of #GVariantType @type holding the data from @gvalue or %NULL in case of failure. Free with @@ -87885,7 +83844,6 @@ variant, tuple, dict entry) will be converted to a #GValue containing that The conversion never fails - a valid #GValue is always returned in @out_gvalue. - @@ -87907,7 +83865,6 @@ The conversion never fails - a valid #GValue is always returned in This doesn't check if @string is actually supported by #GDBusServer or #GDBusConnection - use g_dbus_is_supported_address() to do more checks. - %TRUE if @string is a valid D-Bus address, %FALSE otherwise. @@ -87924,7 +83881,6 @@ checks. See the D-Bus specification regarding what strings are valid D-Bus GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). - %TRUE if @string is a guid, %FALSE otherwise. @@ -87938,7 +83894,6 @@ GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). Checks if @string is a valid D-Bus interface name. - %TRUE if valid, %FALSE otherwise. @@ -87952,7 +83907,6 @@ GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). Checks if @string is a valid D-Bus member (e.g. signal or method) name. - %TRUE if valid, %FALSE otherwise. @@ -87966,7 +83920,6 @@ GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). Checks if @string is a valid D-Bus bus name (either unique or well-known). - %TRUE if valid, %FALSE otherwise. @@ -87983,7 +83936,6 @@ GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). transports in @string and that key/value pairs for each transport are valid. See the specification of the [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses). - %TRUE if @string is a valid D-Bus address that is supported by this library, %FALSE if @error is set. @@ -87998,7 +83950,6 @@ supported by this library, %FALSE if @error is set. Checks if @string is a valid D-Bus unique bus name. - %TRUE if valid, %FALSE otherwise. @@ -88013,7 +83964,6 @@ supported by this library, %FALSE if @error is set. Creates a new #GDtlsClientConnection wrapping @base_socket which is assumed to communicate with the server identified by @server_identity. - the new #GDtlsClientConnection, or %NULL on error @@ -88032,7 +83982,6 @@ assumed to communicate with the server identified by @server_identity. Creates a new #GDtlsServerConnection wrapping @base_socket. - the new #GDtlsServerConnection, or %NULL on error @@ -88117,7 +84066,6 @@ the commandline. #GApplication also uses UTF-8 but g_application_command_line_create_file_for_arg() may be more useful for you there. It is also always possible to use this function with #GOptionContext arguments of type %G_OPTION_ARG_FILENAME. - a new #GFile. Free the returned object with g_object_unref(). @@ -88142,7 +84090,6 @@ This is useful if the commandline argument was given in a context other than the invocation of the current process. See also g_application_command_line_create_file_for_arg(). - a new #GFile @@ -88162,7 +84109,6 @@ See also g_application_command_line_create_file_for_arg(). Constructs a #GFile for a given path. This operation never fails, but the returned object might not support any I/O operation if @path is malformed. - a new #GFile for the given @path. Free the returned object with g_object_unref(). @@ -88181,7 +84127,6 @@ operation if @path is malformed. fails, but the returned object might not support any I/O operation if @uri is malformed or if the uri type is not supported. - a new #GFile for the given @uri. Free the returned object with g_object_unref(). @@ -88205,7 +84150,6 @@ directory components. If it is %NULL, a default template is used. Unlike the other #GFile constructors, this will return %NULL if a temporary file could not be created. - a new #GFile. Free the returned object with g_object_unref(). @@ -88228,7 +84172,6 @@ a temporary file could not be created. given by g_file_get_parse_name()). This operation never fails, but the returned object might not support any I/O operation if the @parse_name cannot be parsed. - a new #GFile. @@ -88600,7 +84543,6 @@ decompresses data compressed with zlib. Deserializes a #GIcon previously serialized using g_icon_serialize(). - a #GIcon, or %NULL when deserialization fails. @@ -88614,7 +84556,6 @@ decompresses data compressed with zlib. Gets a hash for an icon. - a #guint containing a hash for the @icon, suitable for use in a #GHashTable or similar data structure. @@ -88634,7 +84575,6 @@ use in a #GHashTable or similar data structure. If your application or library provides one or more #GIcon implementations you need to ensure that each #GType is registered with the type system prior to calling g_icon_new_for_string(). - An object implementing the #GIcon interface or %NULL if @error is set. @@ -88653,7 +84593,6 @@ similar to g_object_newv() but also initializes the object and returns %NULL, setting an error on failure. Use g_object_new_with_properties() and g_initable_init() instead. See #GParameter for more information. - a newly allocated #GObject, or %NULL on error @@ -88688,7 +84627,6 @@ specific value instead). As %errno is global and may be modified by intermediate function calls, you should save its value as soon as the call which sets it - #GIOErrorEnum value for the given errno.h error number. @@ -88713,7 +84651,6 @@ calls, you should save its value as soon as the call which sets it If @type has already been registered as an extension for this extension point, the existing #GIOExtension object is returned. - a #GIOExtension object for #GType @@ -88739,7 +84676,6 @@ extension point, the existing #GIOExtension object is returned. Looks up an existing extension point. - the #GIOExtensionPoint, or %NULL if there is no registered extension point with the given name. @@ -88754,7 +84690,6 @@ extension point, the existing #GIOExtension object is returned. Registers an extension point. - the new #GIOExtensionPoint. This object is owned by GIO and should not be freed. @@ -88773,7 +84708,6 @@ extension point, the existing #GIOExtension object is returned. If don't require all modules to be initialized (and thus registering all gtypes) then you can use g_io_modules_scan_all_in_directory() which allows delayed/lazy loading of modules. - a list of #GIOModules loaded from the directory, @@ -88799,7 +84733,6 @@ which allows delayed/lazy loading of modules. If don't require all modules to be initialized (and thus registering all gtypes) then you can use g_io_modules_scan_all_in_directory() which allows delayed/lazy loading of modules. - a list of #GIOModules loaded from the directory, @@ -88835,7 +84768,6 @@ g_io_extension_point_get_extension_by_name(). If you need to guarantee that all types are loaded in all the modules, use g_io_modules_load_all_in_directory(). - @@ -88859,7 +84791,6 @@ g_io_extension_point_get_extension_by_name(). If you need to guarantee that all types are loaded in all the modules, use g_io_modules_load_all_in_directory(). - @@ -88883,7 +84814,6 @@ g_io_scheduler_push_job(). You should never call this function, since you don't know how other libraries in your program might be making use of gioscheduler. - @@ -88898,7 +84828,6 @@ If @cancellable is not %NULL, it can be used to cancel the I/O job by calling g_cancellable_cancel() or by calling g_io_scheduler_cancel_all_jobs(). use #GThreadPool or g_task_run_in_thread() - @@ -88976,7 +84905,6 @@ The backend reads default values from a keyfile called `defaults` in the directory specified by the #GKeyfileSettingsBackend:defaults-dir property, and a list of locked keys from a text file with the name `locks` in the same location. - a keyfile-backed #GSettingsBackend @@ -88999,7 +84927,6 @@ the same location. Gets a reference to the default #GMemoryMonitor for the system. - a new reference to the default #GMemoryMonitor @@ -89011,7 +84938,6 @@ the same location. This backend allows changes to settings, but does not write them to any backing storage, so the next time you run your application, the memory backend will start out with the default values again. - a newly created #GSettingsBackend @@ -89019,7 +84945,6 @@ the memory backend will start out with the default values again. Gets the default #GNetworkMonitor for the system. - a #GNetworkMonitor @@ -89030,7 +84955,6 @@ the memory backend will start out with the default values again. calls WSAStartup()). GLib will call this itself if it is needed, so you only need to call it if you directly call system networking functions (without calling any GLib networking functions first). - @@ -89040,7 +84964,6 @@ functions (without calling any GLib networking functions first). This backend does not allow changes to settings, so all settings will always have their default values. - a newly created #GSettingsBackend @@ -89052,7 +84975,6 @@ implementations. Creates a new #GSource that expects a callback of type #GPollableSourceFunc. The new source does not actually do anything on its own; use g_source_add_child_source() to add other sources to it to cause it to trigger. - the new #GSource. @@ -89069,7 +84991,6 @@ sources to it to cause it to trigger. implementations. Creates a new #GSource, as with g_pollable_source_new(), but also attaching @child_source (with a dummy callback), and @cancellable, if they are non-%NULL. - the new #GSource. @@ -89100,7 +85021,6 @@ If @blocking is %FALSE, then @stream must be a #GPollableInputStream for which g_pollable_input_stream_can_poll() returns %TRUE, or else the behavior is undefined. If @blocking is %TRUE, then @stream does not need to be a #GPollableInputStream. - the number of bytes read, or -1 on error. @@ -89142,7 +85062,6 @@ If @blocking is %FALSE, then @stream must be a g_pollable_output_stream_can_poll() returns %TRUE or else the behavior is undefined. If @blocking is %TRUE, then @stream does not need to be a #GPollableOutputStream. - the number of bytes written, or -1 on error. @@ -89192,7 +85111,6 @@ As with g_pollable_stream_write(), if @blocking is %FALSE, then g_pollable_output_stream_can_poll() returns %TRUE or else the behavior is undefined. If @blocking is %TRUE, then @stream does not need to be a #GPollableOutputStream. - %TRUE on success, %FALSE if there was an error @@ -89231,7 +85149,6 @@ need to be a #GPollableOutputStream. Find the `gio-proxy` extension point for a proxy implementation that supports the specified protocol. - return a #GProxy or NULL if protocol is not supported. @@ -89246,7 +85163,6 @@ the specified protocol. Gets the default #GProxyResolver for the system. - the default #GProxyResolver. @@ -89277,7 +85193,6 @@ If @filename is empty or the data in it is corrupt, %G_RESOURCE_ERROR_INTERNAL will be returned. If @filename doesn’t exist, or there is an error in reading it, an error from g_mapped_file_new() will be returned. - a new #GResource, or %NULL on error @@ -89296,7 +85211,6 @@ The return result is a %NULL terminated list of strings which should be released with g_strfreev(). @lookup_flags controls the behaviour of the lookup. - an array of constant strings @@ -89319,7 +85233,6 @@ be released with g_strfreev(). globally registered resources and if found returns information about it. @lookup_flags controls the behaviour of the lookup. - %TRUE if the file was found. %FALSE if there were errors @@ -89360,7 +85273,6 @@ in the program binary. For compressed files we allocate memory on the heap and automatically uncompress the data. @lookup_flags controls the behaviour of the lookup. - #GBytes or %NULL on error. Free the returned object with g_bytes_unref() @@ -89383,7 +85295,6 @@ globally registered resources and returns a #GInputStream that lets you read the data. @lookup_flags controls the behaviour of the lookup. - #GInputStream or %NULL on error. Free the returned object with g_object_unref() @@ -89404,7 +85315,6 @@ that lets you read the data. Registers the resource with the process-global set of resources. Once a resource is registered the files in it can be accessed with the global resource lookup functions like g_resources_lookup_data(). - @@ -89417,7 +85327,6 @@ with the global resource lookup functions like g_resources_lookup_data(). Unregisters the resource from the process-global set of resources. - @@ -89442,7 +85351,6 @@ from different directories, depending on which directories were given in `XDG_DATA_DIRS` and `GSETTINGS_SCHEMA_DIR`. For this reason, all lookups performed against the default source should probably be done recursively. - the default schema source @@ -89453,7 +85361,6 @@ recursively. directly setting the contents of the #GAsyncResult with the given error information. Use g_task_report_error(). - @@ -89493,7 +85400,6 @@ information. g_simple_async_report_error_in_idle(), but takes a #GError rather than building a new one. Use g_task_report_error(). - @@ -89521,7 +85427,6 @@ than building a new one. g_simple_async_report_gerror_in_idle(), but takes over the caller's ownership of @error, so the caller does not have to free it any more. Use g_task_report_error(). - @@ -89546,7 +85451,6 @@ ownership of @error, so the caller does not have to free it any more. Sorts @targets in place according to the algorithm in RFC 2782. - the head of the sorted list. @@ -89564,7 +85468,6 @@ ownership of @error, so the caller does not have to free it any more. Gets the default #GTlsBackend for the system. - a #GTlsBackend @@ -89585,7 +85488,6 @@ communicate with the server identified by @server_identity. See the documentation for #GTlsConnection:base-io-stream for restrictions on when application code can run operations on the @base_io_stream after this function has returned. - the new #GTlsClientConnection, or %NULL on error @@ -89614,7 +85516,6 @@ this function has returned. in @anchors to verify certificate chains. The certificates in @anchors must be PEM encoded. - the new #GTlsFileDatabase, or %NULL on error @@ -89634,7 +85535,6 @@ must have pollable input and output streams). See the documentation for #GTlsConnection:base-io-stream for restrictions on when application code can run operations on the @base_io_stream after this function has returned. - the new #GTlsServerConnection, or %NULL on error @@ -89656,7 +85556,6 @@ this function has returned. OS. This is primarily used for hiding mountable and mounted volumes that only are used in the OS and has little to no relevance to the casual user. - %TRUE if @mount_path is considered an implementation detail of the OS. @@ -89677,7 +85576,6 @@ administrators at a shell; rather than something that should, for example, appear in a GUI. For example, the Linux `/proc` filesystem. The list of device paths considered ‘system’ ones may change over time. - %TRUE if @device_path is considered an implementation detail of the OS. @@ -89698,7 +85596,6 @@ administrators at a shell; rather than something that should, for example, appear in a GUI. For example, the Linux `/proc` filesystem. The list of file system types considered ‘system’ ones may change over time. - %TRUE if @fs_type is considered an implementation detail of the OS. @@ -89717,7 +85614,6 @@ if the mounts have changed since with g_unix_mounts_changed_since(). If more mounts have the same mount path, the last matching mount is returned. - a #GUnixMountEntry. @@ -89735,7 +85631,6 @@ is returned. Compares two unix mounts. - 1, 0 or -1 if @mount1 is greater than, equal to, or less than @mount2, respectively. @@ -89754,7 +85649,6 @@ or less than @mount2, respectively. Makes a copy of @mount_entry. - a new #GUnixMountEntry @@ -89773,7 +85667,6 @@ if the mounts have changed since with g_unix_mounts_changed_since(). If more mounts have the same mount path, the last matching mount is returned. - a #GUnixMountEntry. @@ -89791,7 +85684,6 @@ is returned. Frees a unix mount. - @@ -89804,7 +85696,6 @@ is returned. Gets the device path for a unix mount. - a string containing the device path. @@ -89818,7 +85709,6 @@ is returned. Gets the filesystem type for the unix mount. - a string containing the file system type. @@ -89832,7 +85722,6 @@ is returned. Gets the mount path for a unix mount. - the mount path for @mount_entry. @@ -89850,7 +85739,6 @@ is returned. This is similar to g_unix_mount_point_get_options(), but it takes a #GUnixMountEntry as an argument. - a string containing the options, or %NULL if not available. @@ -89870,7 +85758,6 @@ mounts created by bind operation, or btrfs subvolumes. For example, the root path is equal to "/" for mount created by "mount /dev/sda1 /mnt/foo" and "/bar" for "mount --bind /mnt/foo/bar /mnt/bar". - a string containing the root, or %NULL if not supported. @@ -89884,7 +85771,6 @@ For example, the root path is equal to "/" for mount created by Guesses whether a Unix mount can be ejected. - %TRUE if @mount_entry is deemed to be ejectable. @@ -89898,7 +85784,6 @@ For example, the root path is equal to "/" for mount created by Guesses the icon of a Unix mount. - a #GIcon @@ -89913,7 +85798,6 @@ For example, the root path is equal to "/" for mount created by Guesses the name of a Unix mount. The result is a translated string. - A newly allocated string that must be freed with g_free() @@ -89928,7 +85812,6 @@ The result is a translated string. Guesses whether a Unix mount should be displayed in the UI. - %TRUE if @mount_entry is deemed to be displayable. @@ -89942,7 +85825,6 @@ The result is a translated string. Guesses the symbolic icon of a Unix mount. - a #GIcon @@ -89956,7 +85838,6 @@ The result is a translated string. Checks if a unix mount is mounted read only. - %TRUE if @mount_entry is read only. @@ -89975,7 +85856,6 @@ g_unix_is_mount_path_system_internal() on @mount_entry’s properties. The definition of what a ‘system’ mount entry is may change over time as new file system types and device paths are ignored. - %TRUE if the unix mount is for a system path. @@ -89994,7 +85874,6 @@ changed since with g_unix_mount_points_changed_since(). If more mount points have the same mount path, the last matching mount point is returned. - a #GUnixMountPoint, or %NULL if no match is found. @@ -90013,7 +85892,6 @@ is found. Checks if the unix mount points have changed since a given unix time. - %TRUE if the mount points have changed since @time. @@ -90030,7 +85908,6 @@ is found. If @time_read is set, it will be filled with the mount timestamp, allowing for checking if the mounts have changed with g_unix_mount_points_changed_since(). - a #GList of the UNIX mountpoints. @@ -90047,7 +85924,6 @@ g_unix_mount_points_changed_since(). Checks if the unix mounts have changed since a given unix time. - %TRUE if the mounts have changed since @time. @@ -90064,7 +85940,6 @@ g_unix_mount_points_changed_since(). If @time_read is set, it will be filled with the mount timestamp, allowing for checking if the mounts have changed with g_unix_mounts_changed_since(). - a #GList of the UNIX mounts. diff --git a/gir-files/Gst-1.0.gir b/gir-files/Gst-1.0.gir index ec08a8f8c..3ffc78bc6 100644 --- a/gir-files/Gst-1.0.gir +++ b/gir-files/Gst-1.0.gir @@ -11,47 +11,39 @@ and/or use gtk-doc annotations. --> A datatype to hold the handle to an outstanding sync or async clock callback. - A datatype to hold a time, measured in nanoseconds. - A datatype to hold a time difference, measured in nanoseconds. - A type defining the type of an element factory. - - - - - @@ -59,12 +51,10 @@ and/or use gtk-doc annotations. --> The allocator name for the default system memory allocator - Parameters to control the allocation of memory - flags to control allocation @@ -90,7 +80,6 @@ and/or use gtk-doc annotations. --> Create a copy of @params. Free-function: gst_allocation_params_free - a new ##GstAllocationParams, free with gst_allocation_params_free(). @@ -105,7 +94,6 @@ gst_allocation_params_free(). Free @params - @@ -118,7 +106,6 @@ gst_allocation_params_free(). Initialize @params to its default values - @@ -142,11 +129,9 @@ default allocator. New memory can be created with gst_memory_new_wrapped() that wraps the memory allocated elsewhere. - Find a previously registered allocator with @name. When @name is %NULL, the default allocator will be returned. - a #GstAllocator or %NULL when the allocator with @name was not registered. Use gst_object_unref() @@ -163,7 +148,6 @@ to release the allocator after usage. Registers the memory @allocator with @name. This function takes ownership of @allocator. - @@ -194,7 +178,6 @@ When @allocator is %NULL, the default allocator will be used. The alignment in @params is given as a bitmask so that @align + 1 equals the amount of bytes to align to. For example, to align to 8 bytes, use an alignment of 7. - a new #GstMemory. @@ -216,7 +199,6 @@ use an alignment of 7. Free @memory that was previously allocated with gst_allocator_alloc(). - @@ -247,7 +229,6 @@ When @allocator is %NULL, the default allocator will be used. The alignment in @params is given as a bitmask so that @align + 1 equals the amount of bytes to align to. For example, to align to 8 bytes, use an alignment of 7. - a new #GstMemory. @@ -269,7 +250,6 @@ use an alignment of 7. Free @memory that was previously allocated with gst_allocator_alloc(). - @@ -286,7 +266,6 @@ use an alignment of 7. Set the default allocator. This function takes ownership of @allocator. - @@ -344,14 +323,12 @@ use an alignment of 7. The #GstAllocator is used to create new memory. - Object parent class - a new #GstMemory. @@ -374,7 +351,6 @@ use an alignment of 7. - @@ -405,17 +381,13 @@ use an alignment of 7. first flag that can be used for custom purposes - - - + The #GstAtomicQueue object implements a queue that can be used from multiple threads without performing any blocking operations. - Create a new atomic queue instance. @initial_size will be rounded up to the nearest power of 2 and used as the initial size of the queue. - a new #GstAtomicQueue @@ -429,7 +401,6 @@ nearest power of 2 and used as the initial size of the queue. Get the amount of items in the queue. - the number of elements in the queue. @@ -443,7 +414,6 @@ nearest power of 2 and used as the initial size of the queue. Peek the head element of the queue without removing it from the queue. - the head element of @queue or %NULL when the queue is empty. @@ -458,7 +428,6 @@ nearest power of 2 and used as the initial size of the queue. Get the head element of the queue. - the head element of @queue or %NULL when the queue is empty. @@ -473,7 +442,6 @@ the queue is empty. Append @data to the tail of the queue. - @@ -490,7 +458,6 @@ the queue is empty. Increase the refcount of @queue. - @@ -503,7 +470,6 @@ the queue is empty. Unref @queue and free the memory when the refcount reaches 0. - @@ -516,14 +482,12 @@ the queue is empty. - - @@ -531,7 +495,6 @@ the queue is empty. Gets the list with children in a bin. - a #GstBin @@ -540,7 +503,6 @@ the queue is empty. Gets the children cookie that watches the children list. - a #GstBin @@ -548,14 +510,12 @@ the queue is empty. - - @@ -564,7 +524,6 @@ the queue is empty. Check if @bin will resync its state change when elements are added and removed. - A #GstBin @@ -573,7 +532,6 @@ removed. Gets the number of children in a bin. - a #GstBin @@ -581,14 +539,12 @@ removed. - - @@ -597,13 +553,11 @@ removed. Combination of all possible fields that can be copied with gst_buffer_copy_into(). - Combination of all possible metadata fields that can be copied with gst_buffer_copy_into(). - @@ -611,7 +565,6 @@ gst_buffer_copy_into(). of the data in the buffer. This is the timestamp when the media should be decoded or processed otherwise. Value will be %GST_CLOCK_TIME_NONE if the dts is unknown. - a #GstBuffer.: @@ -620,7 +573,6 @@ Value will be %GST_CLOCK_TIME_NONE if the dts is unknown. Tests if the dts is known. - a #GstBuffer @@ -630,7 +582,6 @@ Value will be %GST_CLOCK_TIME_NONE if the dts is unknown. Returns the buffer decoding timestamp (dts) if valid, else the buffer presentation time (pts) - a #GstBuffer.: @@ -640,7 +591,6 @@ presentation time (pts) The duration in nanoseconds (as a #GstClockTime) of the data in the buffer. Value will be %GST_CLOCK_TIME_NONE if the duration is unknown. - a #GstBuffer. @@ -649,7 +599,6 @@ Value will be %GST_CLOCK_TIME_NONE if the duration is unknown. Tests if the duration is known. - a #GstBuffer @@ -658,7 +607,6 @@ Value will be %GST_CLOCK_TIME_NONE if the duration is unknown. A flags word containing #GstBufferFlags flags set on this buffer. - a #GstBuffer. @@ -667,7 +615,6 @@ Value will be %GST_CLOCK_TIME_NONE if the duration is unknown. Gives the status of a specific flag on a buffer. - a #GstBuffer. @@ -679,7 +626,6 @@ Value will be %GST_CLOCK_TIME_NONE if the duration is unknown. Sets a buffer flag on a buffer. - a #GstBuffer. @@ -691,7 +637,6 @@ Value will be %GST_CLOCK_TIME_NONE if the duration is unknown. Clears a buffer flag. - a #GstBuffer. @@ -703,7 +648,6 @@ Value will be %GST_CLOCK_TIME_NONE if the duration is unknown. Tests if the buffer marks a discontinuity in the stream. - a #GstBuffer @@ -711,14 +655,12 @@ Value will be %GST_CLOCK_TIME_NONE if the duration is unknown. - - @@ -726,7 +668,6 @@ Value will be %GST_CLOCK_TIME_NONE if the duration is unknown. The offset in the source file of the beginning of this buffer. - a #GstBuffer. @@ -735,7 +676,6 @@ Value will be %GST_CLOCK_TIME_NONE if the duration is unknown. The offset in the source file of the end of this buffer. - a #GstBuffer. @@ -744,7 +684,6 @@ Value will be %GST_CLOCK_TIME_NONE if the duration is unknown. Tests if the end offset is known. - a #GstBuffer @@ -753,7 +692,6 @@ Value will be %GST_CLOCK_TIME_NONE if the duration is unknown. Tests if the start offset is known. - a #GstBuffer @@ -762,32 +700,27 @@ Value will be %GST_CLOCK_TIME_NONE if the duration is unknown. Constant for no-offset return results. - - - - - @@ -796,7 +729,6 @@ Value will be %GST_CLOCK_TIME_NONE if the duration is unknown. Check if the bufferpool is flushing. Subclasses might want to check the state of the pool in the acquire function. - a GstBufferPool @@ -808,7 +740,6 @@ state of the pool in the acquire function. of the data in the buffer. This is the timestamp when the media should be presented to the user. Value will be %GST_CLOCK_TIME_NONE if the pts is unknown. - a #GstBuffer.: @@ -817,7 +748,6 @@ Value will be %GST_CLOCK_TIME_NONE if the pts is unknown. Tests if the pts is known. - a #GstBuffer @@ -825,28 +755,24 @@ Value will be %GST_CLOCK_TIME_NONE if the pts is unknown. - - - - @@ -949,11 +875,9 @@ depending on the event type. If all the elements return %TRUE, the bin will also return %TRUE, else %FALSE is returned. If no elements of the required type are in the bin, the event handler will return %TRUE. - Creates a new bin with the given name. - a new #GstBin @@ -966,7 +890,6 @@ handler will return %TRUE. - @@ -980,7 +903,6 @@ handler will return %TRUE. - @@ -997,7 +919,6 @@ handler will return %TRUE. - @@ -1014,7 +935,6 @@ handler will return %TRUE. - @@ -1025,7 +945,6 @@ handler will return %TRUE. - @@ -1039,7 +958,6 @@ handler will return %TRUE. - @@ -1053,7 +971,6 @@ handler will return %TRUE. - @@ -1067,7 +984,6 @@ handler will return %TRUE. - @@ -1094,7 +1010,6 @@ before the element is added to the bin. > The bin or pipeline will not take care of this for you. MT safe. - %TRUE if the element could be added, %FALSE if the bin does not want to accept the element. @@ -1115,7 +1030,6 @@ the bin does not want to accept the element. Adds a %NULL-terminated list of elements to a bin. This function is equivalent to calling gst_bin_add() for each member of the list. The return value of each gst_bin_add() is ignored. - @@ -1140,7 +1054,6 @@ direction within the specified bin and returns an unlinked pad if one is found, or %NULL otherwise. If a pad is found, the caller owns a reference to it and should use gst_object_unref() on the pad when it is not needed any longer. - unlinked pad of the given direction, %NULL. @@ -1165,7 +1078,6 @@ all elements that implement the interface, use gst_bin_iterate_all_by_interface(). This function recurses into child bins. MT safe. Caller owns returned reference. - A #GstElement inside the bin implementing the interface @@ -1189,7 +1101,6 @@ function recurses into child bins. Returns %NULL if no element with the given name is found in the bin. MT safe. Caller owns returned reference. - the #GstElement with the given name, or %NULL @@ -1214,7 +1125,6 @@ Returns %NULL if: - no element with the given name is found in the bin MT safe. Caller owns returned reference. - the #GstElement with the given name, or %NULL @@ -1235,7 +1145,6 @@ name, or %NULL Return the suppressed flags of the bin. MT safe. - the bin's suppressed #GstElementFlags. @@ -1253,7 +1162,6 @@ The function recurses inside child bins. The iterator will yield a series of #GstElement that should be unreffed after use. MT safe. Caller owns returned value. - a #GstIterator of #GstElement for all elements in the bin with the given element factory name, @@ -1278,7 +1186,6 @@ The function recurses inside child bins. The iterator will yield a series of #GstElement that should be unreffed after use. MT safe. Caller owns returned value. - a #GstIterator of #GstElement for all elements in the bin implementing the given interface, @@ -1300,7 +1207,6 @@ MT safe. Caller owns returned value. Gets an iterator for the elements in this bin. MT safe. Caller owns returned value. - a #GstIterator of #GstElement, or %NULL @@ -1318,7 +1224,6 @@ or %NULL This iterator recurses into GstBin children. MT safe. Caller owns returned value. - a #GstIterator of #GstElement, or %NULL @@ -1336,7 +1241,6 @@ or %NULL #GST_ELEMENT_FLAG_SINK flag set. MT safe. Caller owns returned value. - a #GstIterator of #GstElement, or %NULL @@ -1358,7 +1262,6 @@ This function is used internally to perform the state changes of the bin elements and for clock selection. MT safe. Caller owns returned value. - a #GstIterator of #GstElement, or %NULL @@ -1376,7 +1279,6 @@ or %NULL #GST_ELEMENT_FLAG_SOURCE flag set. MT safe. Caller owns returned value. - a #GstIterator of #GstElement, or %NULL @@ -1398,7 +1300,6 @@ is posted on the bus. This function simply emits the 'do-latency' signal so any custom latency calculations will be performed. - %TRUE if the latency could be queried and reconfigured. @@ -1422,7 +1323,6 @@ If the element's pads are linked to other pads, the pads will be unlinked before the element is removed from the bin. MT safe. - %TRUE if the element could be removed, %FALSE if the bin does not want to remove the element. @@ -1442,7 +1342,6 @@ the bin does not want to remove the element. Remove a list of elements from a bin. This function is equivalent to calling gst_bin_remove() with each member of the list. - @@ -1468,7 +1367,6 @@ When suppressed flags are set, those specified flags will not be propagated to the bin. MT safe. - @@ -1486,7 +1384,6 @@ MT safe. Synchronizes the state of every child of @bin with the state of @bin. See also gst_element_sync_state_with_parent(). - %TRUE if syncing the state was successful for all children, otherwise %FALSE. @@ -1657,7 +1554,6 @@ added to any bin inside this bin, so it will also be called if a new child was added to a sub-bin of this bin. #GstBin implementations that override this message should chain up to the parent class implementation so the #GstBin::deep-element-added signal is emitted on all parents. - bin parent class @@ -1667,7 +1563,6 @@ this message should chain up to the parent class implementation so the - @@ -1683,7 +1578,6 @@ this message should chain up to the parent class implementation so the - @@ -1699,7 +1593,6 @@ this message should chain up to the parent class implementation so the - @@ -1715,7 +1608,6 @@ this message should chain up to the parent class implementation so the - @@ -1731,7 +1623,6 @@ this message should chain up to the parent class implementation so the - @@ -1747,7 +1638,6 @@ this message should chain up to the parent class implementation so the - @@ -1760,7 +1650,6 @@ this message should chain up to the parent class implementation so the - @@ -1779,7 +1668,6 @@ this message should chain up to the parent class implementation so the - @@ -1820,9 +1708,7 @@ and (un)set using GST_OBJECT_FLAG_SET () and GST_OBJECT_FLAG_UNSET (). Derived classes can use this as first value in a list of flags. - - - + A fundamental type that describes a 64-bit bitmask @@ -1915,7 +1801,6 @@ Typically, #GstParentBufferMeta is used when the child buffer is directly using the #GstMemory of the parent buffer, and wants to prevent the parent buffer from being returned to a buffer pool until the #GstMemory is available for re-use. (Since: 1.6) - the parent structure @@ -1958,7 +1843,6 @@ for re-use. (Since: 1.6) Creates a newly allocated buffer without any data. MT safe. - the new #GstBuffer. @@ -1974,7 +1858,6 @@ When @allocator is %NULL, the default memory allocator will be used. Note that when @size == 0, the buffer will not have memory associated with it. MT safe. - a new #GstBuffer, or %NULL if the memory couldn't be allocated. @@ -2001,7 +1884,6 @@ MT safe. with g_free and will be marked writable. MT safe. - a new #GstBuffer @@ -2024,7 +1906,6 @@ MT safe. @bytes cannot be %NULL and the resulting buffer will be marked as read only. MT safe. - a new #GstBuffer wrapping @bytes @@ -2045,7 +1926,6 @@ When the buffer is destroyed, @notify will be called with @user_data. The prefix/padding must be filled with 0 if @flags contains #GST_MEMORY_FLAG_ZERO_PREFIXED and #GST_MEMORY_FLAG_ZERO_PADDED respectively. - a new #GstBuffer @@ -2085,7 +1965,6 @@ The prefix/padding must be filled with 0 if @flags contains Add metadata for @info to @buffer using the parameters in @params. - the metadata for the api in @info on @buffer. @@ -2108,7 +1987,6 @@ The prefix/padding must be filled with 0 if @flags contains Add a #GstParentBufferMeta to @buffer that holds a reference on @ref until the buffer is freed. - The #GstParentBufferMeta that was added to the buffer @@ -2126,7 +2004,6 @@ The prefix/padding must be filled with 0 if @flags contains Attaches protection metadata to a #GstBuffer. - a pointer to the added #GstProtectionMeta if successful; %NULL if unsuccessful. @@ -2150,7 +2027,6 @@ unsuccessful. Add a #GstReferenceTimestampMeta to @buffer that holds a @timestamp and optionally @duration based on a specific timestamp @reference. See the documentation of #GstReferenceTimestampMeta for details. - The #GstReferenceTimestampMeta that was added to the buffer @@ -2177,7 +2053,6 @@ documentation of #GstReferenceTimestampMeta for details. Append all the memory from @buf2 to @buf1. The result buffer will contain a concatenation of the memory of @buf1 and @buf2. - the new #GstBuffer that contains the memory of the two source buffers. @@ -2200,7 +2075,6 @@ ownership of @mem and thus doesn't increase its refcount. This function is identical to gst_buffer_insert_memory() with an index of -1. See gst_buffer_insert_memory() for more details. - @@ -2219,7 +2093,6 @@ See gst_buffer_insert_memory() for more details. Append @size bytes at @offset from @buf2 to @buf1. The result buffer will contain a concatenation of the memory of @buf1 and the requested region of @buf2. - the new #GstBuffer that contains the memory of the two source buffers. @@ -2250,7 +2123,6 @@ data to a newly allocated memory if needed (if the type of memory requires it), otherwise the underlying data is just referenced. Check gst_buffer_copy_deep() if you want to force the data to be copied to newly allocated memory. - a new copy of @buf. @@ -2265,7 +2137,6 @@ to be copied to newly allocated memory. Create a copy of the given buffer. This will make a newly allocated copy of the data the source buffer contains. - a new copy of @buf. @@ -2284,7 +2155,6 @@ If @dest already contains memory and @flags contains GST_BUFFER_COPY_MEMORY, the memory from @src will be appended to @dest. @flags indicate which fields will be copied. - %TRUE if the copying succeeded, %FALSE otherwise. @@ -2323,7 +2193,6 @@ duration and offset end fields are also copied. If not they will be set to #GST_CLOCK_TIME_NONE and #GST_BUFFER_OFFSET_NONE. MT safe. - the new #GstBuffer or %NULL if the arguments were invalid. @@ -2352,7 +2221,6 @@ MT safe. Copy @size bytes starting from @offset in @buffer to @dest. - The amount of bytes extracted. This value can be lower than @size when @buffer did not contain enough data. @@ -2383,7 +2251,6 @@ MT safe. Extracts a copy of at most @size bytes the data at @offset into newly-allocated memory. @dest must be freed using g_free() when done. - @@ -2415,7 +2282,6 @@ newly-allocated memory. @dest must be freed using g_free() when done. Copy @size bytes from @src to @buffer at @offset. - The amount of bytes copied. This value can be lower than @size when @buffer did not contain enough data. @@ -2453,7 +2319,6 @@ the number of bytes to skip in the memory block at @idx to get to the byte for @offset. @size can be -1 to get all the memory blocks after @idx. - %TRUE when @size bytes starting from @offset could be found in @buffer and @idx, @length and @skip will be filled. @@ -2492,7 +2357,6 @@ for @offset. @func can modify the passed meta pointer or its contents. The return value of @func define if this function returns or if the remaining metadata items in the buffer should be skipped. - %FALSE when @func returned %FALSE for one of the metadata. @@ -2515,7 +2379,6 @@ in the buffer should be skipped. Get all the memory block in @buffer. The memory blocks will be merged into one large #GstMemory. - a #GstMemory that contains the merged memory. Use gst_memory_unref () after usage. @@ -2530,7 +2393,6 @@ Use gst_memory_unref () after usage. Get the #GstBufferFlags flags set on this buffer. - the flags set on this buffer. @@ -2544,7 +2406,6 @@ Use gst_memory_unref () after usage. Get the memory block at index @idx in @buffer. - a #GstMemory that contains the data of the memory block at @idx. Use gst_memory_unref () after usage. @@ -2566,7 +2427,6 @@ memory block at @idx. Use gst_memory_unref () after usage. be merged into one large #GstMemory. If @length is -1, all memory starting from @idx is merged. - a #GstMemory that contains the merged data of @length blocks starting at @idx. Use gst_memory_unref () after usage. @@ -2593,7 +2453,6 @@ returned. If multiple metadata with the given @api are attached to this buffer only the first one is returned. To handle multiple metadata with a given API use gst_buffer_iterate_meta() or gst_buffer_foreach_meta() instead and check the meta->info.api member for the API type. - the metadata for @api on @buffer. @@ -2611,7 +2470,6 @@ and check the meta->info.api member for the API type. - number of metas of type @api_type on @buffer. @@ -2633,7 +2491,6 @@ and check the meta->info.api member for the API type. subset of @reference. Buffers can contain multiple #GstReferenceTimestampMeta metadata items. - the #GstReferenceTimestampMeta or %NULL when there is no such metadata on @buffer. @@ -2652,7 +2509,6 @@ is no such metadata on @buffer. Get the total size of the memory blocks in @buffer. - total size of the memory blocks in @buffer. @@ -2672,7 +2528,6 @@ first memory block in @buffer and @maxsize will contain the sum of the size and @offset and the amount of extra padding on the last memory block. @offset and @maxsize can be used to resize the buffer memory blocks with gst_buffer_resize(). - total size of the memory blocks in @buffer. @@ -2701,7 +2556,6 @@ and @offset and the amount of extra padding on the memory block at @idx + @length -1. @offset and @maxsize can be used to resize the buffer memory blocks with gst_buffer_resize_range(). - total size of @length memory blocks starting at @idx in @buffer. @@ -2731,7 +2585,6 @@ gst_buffer_resize_range(). Gives the status of a specific flag on a buffer. - %TRUE if all flags in @flags are found on @buffer. @@ -2754,7 +2607,6 @@ of @mem and thus doesn't increase its refcount. Only gst_buffer_get_max_memory() can be added to a buffer. If more memory is added, existing memory blocks will automatically be merged to make room for the new memory. - @@ -2778,7 +2630,6 @@ the new memory. Note that this function does not check if @buffer is writable, use gst_buffer_is_writable() to check that if needed. - %TRUE if all memory blocks in @buffer are writable @@ -2797,7 +2648,6 @@ gst_buffer_is_writable() to check that if needed. Note that this function does not check if @buffer is writable, use gst_buffer_is_writable() to check that if needed. - %TRUE if the memory range is writable @@ -2822,7 +2672,6 @@ gst_buffer_is_writable() to check that if needed. to %NULL, the first metadata is returned. @state will be updated with an opaque state pointer - The next #GstMeta or %NULL when there are no more items. @@ -2845,7 +2694,6 @@ according to @state. If @state points to %NULL, the first metadata of type @meta_api_type is returned. @state will be updated with an opaque state pointer - The next #GstMeta of type @meta_api_type or %NULL when there are no more items. @@ -2880,7 +2728,6 @@ buffer memory will then also be replaced with this writable copy. The memory in @info should be unmapped with gst_buffer_unmap() after usage. - %TRUE if the map succeeded and @info contains valid data. @@ -2914,7 +2761,6 @@ automatically be created and returned. The readonly copy of the buffer memory will then also be replaced with this writable copy. The memory in @info should be unmapped with gst_buffer_unmap() after usage. - %TRUE if the map succeeded and @info contains valid data. @@ -2945,7 +2791,6 @@ data. Compare @size bytes starting from @offset in @buffer with the memory in @mem. - 0 if the memory is equal. @@ -2973,7 +2818,6 @@ data. Fill @buf with @size bytes with @val starting from @offset. - The amount of bytes filled. This value can be lower than @size when @buffer did not contain enough data. @@ -3001,7 +2845,6 @@ data. Get the amount of memory blocks that this buffer has. This amount is never larger than what gst_buffer_get_max_memory() returns. - the number of memory blocks this buffer is made of. @@ -3017,7 +2860,6 @@ larger than what gst_buffer_get_max_memory() returns. Get the memory block at @idx in @buffer. The memory block stays valid until the memory block in @buffer is removed, replaced or merged, typically with any call that modifies the memory in @buffer. - the #GstMemory at @idx. @@ -3039,7 +2881,6 @@ ownership of @mem and thus doesn't increase its refcount. This function is identical to gst_buffer_insert_memory() with an index of 0. See gst_buffer_insert_memory() for more details. - @@ -3062,7 +2903,6 @@ of @buf and its metadata, see gst_buffer_is_writable(). It is important to note that keeping additional references to GstBuffer instances can potentially increase the number of memcpy operations in a pipeline. - @buf @@ -3076,7 +2916,6 @@ of memcpy operations in a pipeline. Remove all the memory blocks in @buffer. - @@ -3089,7 +2928,6 @@ of memcpy operations in a pipeline. Remove the memory block in @b at index @i. - @@ -3108,7 +2946,6 @@ of memcpy operations in a pipeline. Remove @length memory blocks in @buffer starting from @idx. @length can be -1, in which case all memory starting from @idx is removed. - @@ -3129,7 +2966,6 @@ of memcpy operations in a pipeline. Remove the metadata for @meta on @buffer. - %TRUE if the metadata existed and was removed, %FALSE if no such metadata was on @buffer. @@ -3148,7 +2984,6 @@ metadata was on @buffer. Replaces all memory in @buffer with @mem. - @@ -3165,7 +3000,6 @@ metadata was on @buffer. Replaces the memory block at index @idx in @buffer with @mem. - @@ -3191,7 +3025,6 @@ If @length is -1, all memory starting from @idx will be removed and replaced with @mem. @buffer should be writable. - @@ -3216,7 +3049,6 @@ replaced with @mem. Set the offset and total size of the memory blocks in @buffer. - @@ -3238,7 +3070,6 @@ replaced with @mem. Set the total size of the @length memory blocks starting at @idx in @buffer - %TRUE if resizing succeeded, %FALSE otherwise. @@ -3268,7 +3099,6 @@ replaced with @mem. Sets one or more buffer flags on a buffer. - %TRUE if @flags were successfully set on buffer. @@ -3286,7 +3116,6 @@ replaced with @mem. Set the total size of the memory blocks in @buffer. - @@ -3303,7 +3132,6 @@ replaced with @mem. Release the memory previously mapped with gst_buffer_map(). - @@ -3321,7 +3149,6 @@ replaced with @mem. Decreases the refcount of the buffer. If the refcount reaches 0, the buffer with the associated metadata and memory will be freed. - @@ -3334,7 +3161,6 @@ with the associated metadata and memory will be freed. Clears one or more buffer flags. - true if @flags is successfully cleared from buffer. @@ -3356,7 +3182,6 @@ compile time constant that can be queried with the function. When more memory blocks are added, existing memory blocks will be merged together to make room for the new block. - the maximum amount of memory blocks that a buffer can hold. @@ -3369,7 +3194,6 @@ in some cases), and the reference counts are updated appropriately (the old buffer is unreffed, the new is reffed). Either @nbuf or the #GstBuffer pointed to by @obuf may be %NULL. - %TRUE when @obuf was different from @nbuf. @@ -3497,7 +3321,6 @@ When this function returns %TRUE, the next meta will be returned. When %FALSE is returned, gst_buffer_foreach_meta() will return. When @meta is set to %NULL, the item will be removed from the buffer. - %FALSE when gst_buffer_foreach_meta() should stop @@ -3526,13 +3349,11 @@ using a gst_buffer_list_insert(). Buffer lists can be pushed on a srcpad with gst_pad_push_list(). This is interesting when multiple buffers need to be pushed in one go because it can reduce the amount of overhead for pushing each buffer individually. - Creates a new, empty #GstBufferList. The caller is responsible for unreffing the returned #GstBufferList. Free-function: gst_buffer_list_unref - the new #GstBufferList. gst_buffer_list_unref() after usage. @@ -3545,7 +3366,6 @@ the returned #GstBufferList. The list will have @size space preallocated so that memory reallocations can be avoided. Free-function: gst_buffer_list_unref - the new #GstBufferList. gst_buffer_list_unref() after usage. @@ -3561,7 +3381,6 @@ Free-function: gst_buffer_list_unref Calculates the size of the data contained in buffer list by adding the size of all buffers. - the size of the data contained in buffer list in bytes. @@ -3577,7 +3396,6 @@ size of all buffers. Create a shallow copy of the given buffer list. This will make a newly allocated copy of the source list with copies of buffer pointers. The refcount of buffers pointed to will be increased by one. - a new copy of @list. @@ -3592,7 +3410,6 @@ refcount of buffers pointed to will be increased by one. Create a copy of the given buffer list. This will make a newly allocated copy of the buffer that the source buffer list contains. - a new copy of @list. @@ -3610,7 +3427,6 @@ copy of the buffer that the source buffer list contains. @func can modify the passed buffer pointer or its contents. The return value of @func define if this function returns or if the remaining buffers in the list should be skipped. - %TRUE when @func returned %TRUE for each buffer in @list or when @list is empty. @@ -3636,7 +3452,6 @@ the list should be skipped. You must make sure that @idx does not exceed the number of buffers available. - the buffer at @idx in @group or %NULL when there is no buffer. The buffer remains valid as @@ -3659,7 +3474,6 @@ buffers available. You must make sure that @idx does not exceed the number of buffers available. - the buffer at @idx in @group. The returned buffer remains valid as long as @list is valid and @@ -3682,7 +3496,6 @@ buffers available. this new buffer. A -1 value for @idx will append the buffer at the end. - @@ -3703,7 +3516,6 @@ A -1 value for @idx will append the buffer at the end. Returns the number of buffers in @list. - the number of buffers in the buffer list @@ -3722,7 +3534,6 @@ Note that the refcount affects the writability of @list and its data, see gst_buffer_list_make_writable(). It is important to note that keeping additional references to GstBufferList instances can potentially increase the number of memcpy operations in a pipeline. - @list @@ -3737,7 +3548,6 @@ the number of memcpy operations in a pipeline. Remove @length buffers starting from @idx in @list. The following buffers are moved to close the gap. - @@ -3759,7 +3569,6 @@ are moved to close the gap. Decreases the refcount of the buffer list. If the refcount reaches 0, the buffer list will be freed. - @@ -3782,7 +3591,6 @@ When @buffer is set to %NULL, the item will be removed from the bufferlist. When @buffer has been made writable, the new buffer reference can be assigned to @buffer. This function is responsible for unreffing the old buffer when removing or modifying. - %FALSE when gst_buffer_list_foreach() should stop @@ -3840,10 +3648,8 @@ all buffers are returned to the pool they will be freed. Use gst_object_unref() to release the reference to a bufferpool. If the refcount of the pool reaches 0, the pool will be freed. - Creates a new #GstBufferPool instance. - a new #GstBufferPool instance @@ -3854,7 +3660,6 @@ refcount of the pool reaches 0, the pool will be freed. the specified option on the buffers that it allocates. The supported options by @pool can be retrieved with gst_buffer_pool_get_options(). - @@ -3871,7 +3676,6 @@ The supported options by @pool can be retrieved with gst_buffer_pool_get_options Get the @allocator and @params from @config. - %TRUE, if the values are set. @@ -3894,7 +3698,6 @@ The supported options by @pool can be retrieved with gst_buffer_pool_get_options Parse an available @config and get the option at @index of the options API array. - a #gchar of the option at @index. @@ -3912,7 +3715,6 @@ array. Get the configuration values from @config. - %TRUE if all parameters could be fetched. @@ -3942,7 +3744,6 @@ array. Check if @config contains @option. - %TRUE if the options array contains @option. @@ -3961,7 +3762,6 @@ array. Retrieve the number of values currently stored in the options array of the @config structure. - the options array size as a #guint. @@ -3986,7 +3786,6 @@ with the values that it is able to do. Some pools are, for example, not able to operate with different allocators or cannot allocate with the values specified in @params. Use gst_buffer_pool_get_config() to get the currently used values. - @@ -4007,7 +3806,6 @@ used values. Configure @config with the given parameters. - @@ -4043,7 +3841,6 @@ returns %FALSE. This expects that @caps haven't changed and that This does not check if options or allocator parameters are still valid, won't check if size have changed, since changing the size is valid to adapt padding. - %TRUE, if the parameters are valid in this context. @@ -4077,7 +3874,6 @@ can hold a pointer to the new buffer. @params can be %NULL or contain optional parameters to influence the allocation. - a #GstFlowReturn such as %GST_FLOW_FLUSHING when the pool is inactive. @@ -4099,7 +3895,6 @@ inactive. - @@ -4116,7 +3911,6 @@ inactive. - @@ -4127,7 +3921,6 @@ inactive. - @@ -4138,7 +3931,6 @@ inactive. - @@ -4155,7 +3947,6 @@ inactive. Get a %NULL terminated array of string with supported bufferpool options for @pool. An option would typically be enabled with gst_buffer_pool_config_add_option(). - a %NULL terminated array of strings. @@ -4176,7 +3967,6 @@ gst_buffer_pool_config_add_option(). This function is usually called automatically when the last ref on @buffer disappears. - @@ -4192,7 +3982,6 @@ disappears. - @@ -4222,7 +4011,6 @@ If the parameters in @config can not be set exactly, this function returns then be retrieved and refined with gst_buffer_pool_get_config(). This function takes ownership of @config. - %TRUE when the configuration could be set. @@ -4239,7 +4027,6 @@ This function takes ownership of @config. - @@ -4250,7 +4037,6 @@ This function takes ownership of @config. - @@ -4266,7 +4052,6 @@ can hold a pointer to the new buffer. @params can be %NULL or contain optional parameters to influence the allocation. - a #GstFlowReturn such as %GST_FLOW_FLUSHING when the pool is inactive. @@ -4291,7 +4076,6 @@ inactive. Get a copy of the current configuration of the pool. This configuration can either be modified and used for the gst_buffer_pool_set_config() call or it must be freed after usage. - a copy of the current configuration of @pool. use gst_structure_free() after usage or gst_buffer_pool_set_config(). @@ -4308,7 +4092,6 @@ gst_structure_free() after usage or gst_buffer_pool_set_config(). Get a %NULL terminated array of string with supported bufferpool options for @pool. An option would typically be enabled with gst_buffer_pool_config_add_option(). - a %NULL terminated array of strings. @@ -4325,7 +4108,6 @@ gst_buffer_pool_config_add_option(). Check if the bufferpool supports @option. - %TRUE if the buffer pool contains @option. @@ -4344,7 +4126,6 @@ gst_buffer_pool_config_add_option(). Check if @pool is active. A pool can be activated with the gst_buffer_pool_set_active() call. - %TRUE when the pool is active. @@ -4362,7 +4143,6 @@ gst_buffer_pool_set_active() call. This function is usually called automatically when the last ref on @buffer disappears. - @@ -4387,7 +4167,6 @@ the configuration of the pool. Deactivating will free the resources again when there are no outstanding buffers. When there are outstanding buffers, they will be freed as soon as they are all returned to the pool. - %FALSE when the pool was not configured or when preallocation of the buffers failed. @@ -4421,7 +4200,6 @@ If the parameters in @config can not be set exactly, this function returns then be retrieved and refined with gst_buffer_pool_get_config(). This function takes ownership of @config. - %TRUE when the configuration could be set. @@ -4440,7 +4218,6 @@ This function takes ownership of @config. Enable or disable the flushing state of a @pool without freeing or allocating buffers. - @@ -4498,7 +4275,6 @@ allocation of the buffer. The default implementation ignores the @start and @stop members but other implementations can use this extra information to decide what buffer to return. - the format of @start and @stop @@ -4523,14 +4299,12 @@ return. The GstBufferPool class. - Object parent class - a %NULL terminated array of strings. @@ -4548,7 +4322,6 @@ return. - %TRUE when the configuration could be set. @@ -4567,7 +4340,6 @@ return. - @@ -4580,7 +4352,6 @@ return. - @@ -4593,7 +4364,6 @@ return. - a #GstFlowReturn such as %GST_FLOW_FLUSHING when the pool is inactive. @@ -4617,7 +4387,6 @@ inactive. - @@ -4636,7 +4405,6 @@ inactive. - @@ -4652,7 +4420,6 @@ inactive. - @@ -4670,7 +4437,6 @@ inactive. - @@ -4686,7 +4452,6 @@ inactive. - @@ -4699,7 +4464,6 @@ inactive. - @@ -4716,9 +4480,7 @@ inactive. - - - + The different types of buffering methods. @@ -4774,17 +4536,14 @@ Every #GstPipeline has one bus. Note that a #GstPipeline will set its bus into flushing state when changing from READY to NULL state. - Creates a new #GstBus instance. - a new #GstBus instance - @@ -4798,7 +4557,6 @@ from READY to NULL state. - @@ -4826,7 +4584,6 @@ responsible for calling gst_bus_remove_signal_watch() as many times as this function is called. MT safe. - @@ -4855,7 +4612,6 @@ There can only be a single bus watch per bus, you must remove any signal watch before you can set another type of watch. MT safe. - @@ -4891,7 +4647,6 @@ The bus watch will take its own reference to the @bus, so it is safe to unref @bus using gst_object_unref() after setting the bus watch. MT safe. - The event source id or 0 if @bus already got an event source. @@ -4935,7 +4690,6 @@ The bus watch will take its own reference to the @bus, so it is safe to unref @bus using gst_object_unref() after setting the bus watch. MT safe. - The event source id or 0 if @bus already got an event source. @@ -4966,7 +4720,6 @@ MT safe. A helper #GstBusFunc that can be used to convert all asynchronous messages into signals. - %TRUE @@ -4990,7 +4743,6 @@ into signals. Create watch for this bus. The GSource will be dispatched whenever a message is on the bus. After the GSource is dispatched, the message is popped off the bus and unreffed. - a #GSource that can be added to a mainloop. @@ -5014,7 +4766,6 @@ the same as gst_object_ref() that which calls enable should also call disable. MT safe. - @@ -5044,7 +4795,6 @@ comes from the thread of whatever object posted the message; the "message" signal is marshalled to the main thread via the main loop. MT safe. - @@ -5064,7 +4814,6 @@ Whenever a message is available, the POLLIN / %G_IO_IN event is set. Warning: NEVER read or write anything to the returned fd but only use it for getting notifications via g_poll() or similar and then use the normal GstBus API, e.g. gst_bus_pop(). - @@ -5082,7 +4831,6 @@ GstBus API, e.g. gst_bus_pop(). Check if there are pending messages on the bus that should be handled. - %TRUE if there are messages on the bus to be handled, %FALSE otherwise. @@ -5101,7 +4849,6 @@ MT safe. Peek the message on the top of the bus' queue. The message will remain on the bus' message queue. A reference is returned, and needs to be unreffed by the caller. - the #GstMessage that is on the bus, or %NULL if the bus is empty. @@ -5150,7 +4897,6 @@ For 0 timeouts use gst_bus_pop_filtered() instead of this function; for other short timeouts use gst_bus_timed_pop_filtered(); everything else is better handled by setting up an asynchronous bus watch and doing things from there. - the message that was received, or %NULL if the poll timed out. The message is taken from the @@ -5177,7 +4923,6 @@ indefinitely. Get a message from the bus. - the #GstMessage that is on the bus, or %NULL if the bus is empty. The message is taken from @@ -5200,7 +4945,6 @@ the bus that do not match @type and that have been posted before the first message that does match @type. If there is no message matching @type on the bus, all messages will be discarded. It is not possible to use message enums beyond #GST_MESSAGE_EXTENDED in the @events mask. - the next #GstMessage matching @type that is on the bus, or %NULL if the bus is empty or there @@ -5224,7 +4968,6 @@ MT safe. Post a message on the given bus. Ownership of the message is taken by the bus. - %TRUE if the message could be posted, %FALSE if the bus is flushing. @@ -5246,7 +4989,6 @@ MT safe. Removes a signal watch previously added with gst_bus_add_signal_watch(). MT safe. - @@ -5259,7 +5001,6 @@ MT safe. Removes an installed bus watch from @bus. - %TRUE on success or %FALSE if @bus has no event source. @@ -5277,7 +5018,6 @@ references to the message origin objects. Will flush future messages until gst_bus_set_flushing() sets @flushing to %FALSE. MT safe. - @@ -5302,7 +5042,6 @@ functions. Before 1.16.3 it was not possible to replace an existing handler and clearing an existing handler with %NULL was not thread-safe. - @@ -5328,7 +5067,6 @@ clearing an existing handler with %NULL was not thread-safe. A helper GstBusSyncHandler that can be used to convert all synchronous messages into signals. - GST_BUS_PASS @@ -5354,7 +5092,6 @@ messages into signals. If @timeout is 0, this function behaves like gst_bus_pop(). If @timeout is #GST_CLOCK_TIME_NONE, this function will block forever until a message was posted on the bus. - the #GstMessage that is on the bus after the specified timeout or %NULL if the bus is empty @@ -5383,7 +5120,6 @@ match the mask provided). If @timeout is 0, this function behaves like gst_bus_pop_filtered(). If @timeout is #GST_CLOCK_TIME_NONE, this function will block forever until a matching message was posted on the bus. - a #GstMessage matching the filter in @types, or %NULL if no matching message was found on @@ -5455,13 +5191,11 @@ gst_bus_enable_sync_message_emission() before. - - @@ -5477,7 +5211,6 @@ gst_bus_enable_sync_message_emission() before. - @@ -5516,7 +5249,6 @@ function so it should not be freed in the function. Note that this function is used as a GSourceFunc which means that returning %FALSE will remove the GSource from the mainloop. - %FALSE if the event source should be removed. @@ -5536,9 +5268,7 @@ Note that this function is used as a GSourceFunc which means that returning - - - + Handler will be invoked synchronously, when a new message has been injected into the bus. This function is mostly used internally. Only one sync handler @@ -5546,7 +5276,6 @@ can be attached to a given bus. If the handler returns GST_BUS_DROP, it should unref the message, else the message should not be unreffed by the sync handler. - #GstBusSyncReply stating what to do with the message @@ -5583,7 +5312,6 @@ message should not be unreffed by the sync handler. named parent_class that points to the (duh!) parent class. Note that this macro is not to be used with things that return something, use the _WITH_DEFAULT version for that - the name of the class cast macro for the parent type @@ -5599,7 +5327,6 @@ the _WITH_DEFAULT version for that Same as GST_CALL_PARENT(), but in case there is no implementation, it evaluates to @def_return. - the name of the class cast macro for the parent type @@ -5616,44 +5343,37 @@ evaluates to @def_return. - - - - - - A flags word containing #GstCapsFlags flags set on this caps. - a #GstCaps. @@ -5662,7 +5382,6 @@ evaluates to @def_return. Gives the status of a specific flag on a caps. - a #GstCaps. @@ -5674,7 +5393,6 @@ evaluates to @def_return. Sets a caps flag on a caps. - a #GstCaps. @@ -5686,7 +5404,6 @@ evaluates to @def_return. Clears a caps flag. - a #GstCaps. @@ -5699,7 +5416,6 @@ evaluates to @def_return. Convenience macro that checks if the number of structures in the given caps is exactly one. - the #GstCaps instance to check @@ -5708,7 +5424,6 @@ is exactly one. Get access to the reference count field of the caps - a #GstCaps @@ -5717,7 +5432,6 @@ is exactly one. Get the reference count value of the caps. - a #GstCaps @@ -5729,7 +5443,6 @@ is exactly one. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically. - category to use @@ -5751,7 +5464,6 @@ category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically. - category to use @@ -5773,7 +5485,6 @@ character, a newline character will be added automatically. Check whether a GStreamer version equal to or greater than major.minor.micro is present. - a number indicating the major version @@ -5787,35 +5498,30 @@ major.minor.micro is present. - - - - - @@ -5824,7 +5530,6 @@ major.minor.micro is present. Calculate a difference between two clock times as a #GstClockTimeDiff. The difference is calculated as @e - @s. - the first time @@ -5836,7 +5541,6 @@ The difference is calculated as @e - @s. Cast to a clock entry - the entry to cast @@ -5846,7 +5550,6 @@ The difference is calculated as @e - @s. Get the owner clock of the entry Use gst_clock_id_get_clock() instead. - the entry to query @@ -5855,7 +5558,6 @@ The difference is calculated as @e - @s. Get the interval of this periodic entry - the entry to query @@ -5864,7 +5566,6 @@ The difference is calculated as @e - @s. The status of the entry - the entry to query @@ -5873,7 +5574,6 @@ The difference is calculated as @e - @s. Get the requested time of this entry - the entry to query @@ -5882,7 +5582,6 @@ The difference is calculated as @e - @s. Get the type of the clock entry - the entry to query @@ -5891,7 +5590,6 @@ The difference is calculated as @e - @s. Gets the #GstClockFlags clock flags. - the clock to query @@ -5899,7 +5597,6 @@ The difference is calculated as @e - @s. - @@ -5907,7 +5604,6 @@ The difference is calculated as @e - @s. Tests if a given #GstClockTimeDiff of #gint64 represents a valid defined time. - signed clock time to validate @@ -5916,7 +5612,6 @@ The difference is calculated as @e - @s. Tests if a given #GstClockTime represents a valid defined time. - clock time to validate @@ -5925,67 +5620,57 @@ The difference is calculated as @e - @s. Constant to define an undefined clock time. - - - - - - - - - - @@ -6026,7 +5711,6 @@ has limited support for nested #GstCaps / #GstStructure fields. It can only support one level of nesting. Using more levels will lead to unexpected behavior when using serialization features, such as gst_caps_to_string() or gst_value_serialize() and their counterparts. - the parent type @@ -6034,7 +5718,6 @@ gst_value_serialize() and their counterparts. Creates a new #GstCaps that indicates that it is compatible with any media format. - the new #GstCaps @@ -6045,7 +5728,6 @@ any media format. #GstCaps contains no media formats. The #GstCaps is guaranteed to be writable. Caller is responsible for unreffing the returned caps. - the new #GstCaps @@ -6055,7 +5737,6 @@ Caller is responsible for unreffing the returned caps. Creates a new #GstCaps that contains one #GstStructure with name @media_type. Caller is responsible for unreffing the returned caps. - the new #GstCaps @@ -6071,7 +5752,6 @@ Caller is responsible for unreffing the returned caps. Creates a new #GstCaps and adds all the structures listed as arguments. The list must be %NULL-terminated. The structures are not copied; the returned #GstCaps owns the structures. - the new #GstCaps @@ -6091,7 +5771,6 @@ are not copied; the returned #GstCaps owns the structures. Creates a new #GstCaps and adds all the structures listed as arguments. The list must be %NULL-terminated. The structures are not copied; the returned #GstCaps owns the structures. - the new #GstCaps @@ -6112,7 +5791,6 @@ are not copied; the returned #GstCaps owns the structures. structure is defined by the arguments, which have the same format as gst_structure_new(). Caller is responsible for unreffing the returned caps. - the new #GstCaps @@ -6136,7 +5814,6 @@ Caller is responsible for unreffing the returned caps. Appends the structures contained in @caps2 to @caps1. The structures in @caps2 are not copied -- they are transferred to @caps1, and then @caps2 is freed. If either caps is ANY, the resulting caps will be ANY. - @@ -6154,7 +5831,6 @@ freed. If either caps is ANY, the resulting caps will be ANY. Appends @structure to @caps. The structure is not copied; @caps becomes the owner of @structure. - @@ -6172,7 +5848,6 @@ becomes the owner of @structure. Appends @structure with @features to @caps. The structure is not copied; @caps becomes the owner of @structure. - @@ -6194,7 +5869,6 @@ becomes the owner of @structure. Tries intersecting @caps1 and @caps2 and reports whether the result would not be empty - %TRUE if intersection would be not empty @@ -6219,7 +5893,6 @@ followed by a gst_caps_make_writable(). If you only want to hold on to a reference to the data, you should use gst_caps_ref(). When you are finished with the caps, call gst_caps_unref() on it. - the new #GstCaps @@ -6234,7 +5907,6 @@ When you are finished with the caps, call gst_caps_unref() on it. Creates a new #GstCaps and appends a copy of the nth structure contained in @caps. - the new #GstCaps @@ -6257,7 +5929,6 @@ structure and features. In contrast to gst_caps_filter_and_map_in_place(), the structure and features are removed from the caps if %FALSE is returned from the function. The caps must be mutable. - @@ -6290,7 +5961,6 @@ structure. If @caps are empty caps then then returned caps will be the empty too and contain no structure at all. Calling this function with any caps is not allowed. - the fixated caps @@ -6306,7 +5976,6 @@ Calling this function with any caps is not allowed. Calls the provided function once for each structure and caps feature in the #GstCaps. The function must not modify the fields. Also see gst_caps_map_in_place() and gst_caps_filter_and_map_in_place(). - %TRUE if the supplied function returns %TRUE for each call, %FALSE otherwise. @@ -6342,7 +6011,6 @@ gst_caps_features_add(). You do not need to free or unref the structure returned, it belongs to the #GstCaps. - a pointer to the #GstCapsFeatures corresponding to @index @@ -6361,7 +6029,6 @@ belongs to the #GstCaps. Gets the number of structures contained in @caps. - the number of structures that @caps contains @@ -6388,7 +6055,6 @@ gst_structure_set(). You do not need to free or unref the structure returned, it belongs to the #GstCaps. - a pointer to the #GstStructure corresponding to @index @@ -6408,7 +6074,6 @@ belongs to the #GstCaps. Creates a new #GstCaps that contains all the formats that are common to both @caps1 and @caps2. Defaults to %GST_CAPS_INTERSECT_ZIG_ZAG mode. - the new #GstCaps @@ -6428,7 +6093,6 @@ to both @caps1 and @caps2. Defaults to %GST_CAPS_INTERSECT_ZIG_ZAG mode. Creates a new #GstCaps that contains all the formats that are common to both @caps1 and @caps2, the order is defined by the #GstCapsIntersectMode used. - the new #GstCaps @@ -6452,7 +6116,6 @@ used. A given #GstCaps structure is always compatible with another if every media format that is in the first is also contained in the second. That is, @caps1 is a subset of @caps2. - %TRUE if @caps1 is a subset of @caps2. @@ -6470,7 +6133,6 @@ second. That is, @caps1 is a subset of @caps2. Determines if @caps represents any media format. - %TRUE if @caps represents any format. @@ -6484,7 +6146,6 @@ second. That is, @caps1 is a subset of @caps2. Determines if @caps represents no media formats. - %TRUE if @caps represents no formats. @@ -6498,7 +6159,6 @@ second. That is, @caps1 is a subset of @caps2. Checks if the given caps represent the same set of caps. - %TRUE if both caps are equal. @@ -6517,7 +6177,6 @@ second. That is, @caps1 is a subset of @caps2. Tests if two #GstCaps are equal. This function only works on fixed #GstCaps. - %TRUE if the arguments represent the same format @@ -6537,7 +6196,6 @@ second. That is, @caps1 is a subset of @caps2. Fixed #GstCaps describe exactly one format, that is, they have exactly one structure, and each field in the structure describes a fixed type. Examples of non-fixed types are GST_TYPE_INT_RANGE and GST_TYPE_LIST. - %TRUE if @caps is fixed @@ -6551,7 +6209,6 @@ Examples of non-fixed types are GST_TYPE_INT_RANGE and GST_TYPE_LIST. Checks if the given caps are exactly the same set of caps. - %TRUE if both caps are strictly equal. @@ -6569,7 +6226,6 @@ Examples of non-fixed types are GST_TYPE_INT_RANGE and GST_TYPE_LIST. Checks if all caps represented by @subset are also represented by @superset. - %TRUE if @subset is a subset of @superset @@ -6588,7 +6244,6 @@ Examples of non-fixed types are GST_TYPE_INT_RANGE and GST_TYPE_LIST. Checks if @structure is a subset of @caps. See gst_caps_is_subset() for more information. - %TRUE if @structure is a subset of @caps @@ -6607,7 +6262,6 @@ for more information. Checks if @structure is a subset of @caps. See gst_caps_is_subset() for more information. - %TRUE if @structure is a subset of @caps @@ -6631,7 +6285,6 @@ for more information. Calls the provided function once for each structure and caps feature in the #GstCaps. In contrast to gst_caps_foreach(), the function may modify but not delete the structures and features. The caps must be mutable. - %TRUE if the supplied function returns %TRUE for each call, %FALSE otherwise. @@ -6657,7 +6310,6 @@ delete the structures and features. The caps must be mutable. expressed by @caps1. The structures in @caps2 are not copied -- they are transferred to a writable copy of @caps1, and then @caps2 is freed. If either caps is ANY, the resulting caps will be ANY. - the merged caps. @@ -6675,7 +6327,6 @@ If either caps is ANY, the resulting caps will be ANY. Appends @structure to @caps if its not already expressed by @caps. - the merged caps. @@ -6693,7 +6344,6 @@ If either caps is ANY, the resulting caps will be ANY. Appends @structure with @features to @caps if its not already expressed by @caps. - the merged caps. @@ -6721,7 +6371,6 @@ If either caps is ANY, the resulting caps will be ANY. This function takes ownership of @caps and will call gst_caps_make_writable() on it so you must not use @caps afterwards unless you keep an additional reference to it with gst_caps_ref(). - the normalized #GstCaps @@ -6742,7 +6391,6 @@ change. This means its structures won't change, etc. To use a #GstCaps object, you must always have a refcount on it -- either the one made implicitly by e.g. gst_caps_new_simple(), or via taking one explicitly with this function. - the same #GstCaps object. @@ -6757,7 +6405,6 @@ this function. removes the structure with the given index from the list of structures contained in @caps. - @@ -6774,7 +6421,6 @@ contained in @caps. Sets the #GstCapsFeatures @features for the structure at @index. - @@ -6795,7 +6441,6 @@ contained in @caps. Sets the #GstCapsFeatures @features for all the structures of @caps. - @@ -6813,7 +6458,6 @@ contained in @caps. Sets fields in a #GstCaps. The arguments must be passed in the same manner as gst_structure_set(), and be %NULL-terminated. - @@ -6835,7 +6479,6 @@ manner as gst_structure_set(), and be %NULL-terminated. Sets fields in a #GstCaps. The arguments must be passed in the same manner as gst_structure_set(), and be %NULL-terminated. - @@ -6858,7 +6501,6 @@ manner as gst_structure_set(), and be %NULL-terminated. Sets the given @field on all structures of @caps to the given @value. This is a convenience function for calling gst_structure_set_value() on all structures of @caps. - @@ -6888,7 +6530,6 @@ on it if necessary, so you must not use @caps afterwards unless you keep an additional reference to it with gst_caps_ref(). This method does not preserve the original order of @caps. - The simplified caps. @@ -6903,7 +6544,6 @@ This method does not preserve the original order of @caps. Retrieves the structure with the given index from the list of structures contained in @caps. The caller becomes the owner of the returned structure. - a pointer to the #GstStructure corresponding to @index. @@ -6924,7 +6564,6 @@ contained in @caps. The caller becomes the owner of the returned structure.Subtracts the @subtrahend from the @minuend. > This function does not work reliably if optional properties for caps > are included on one caps and omitted on the other. - the resulting caps @@ -6952,7 +6591,6 @@ This prints the caps in human readable form. The current implementation of serialization will lead to unexpected results when there are nested #GstCaps / #GstStructure deeper than one level. - a newly allocated string representing @caps. @@ -6975,7 +6613,6 @@ additional reference to it with gst_caps_ref(). Note that it is not guaranteed that the returned caps have exactly one structure. If @caps is any or empty caps then then returned caps will be the same and contain no structure at all. - truncated caps @@ -6990,7 +6627,6 @@ the same and contain no structure at all. Unref a #GstCaps and and free all its structures and the structures' values when the refcount reaches 0. - @@ -7006,7 +6642,6 @@ structures' values when the refcount reaches 0. The current implementation of serialization will lead to unexpected results when there are nested #GstCaps / #GstStructure deeper than one level. - a newly allocated #GstCaps @@ -7025,7 +6660,6 @@ in some cases), and the reference counts are updated appropriately (the old caps is unreffed, the new is reffed). Either @new_caps or the #GstCaps pointed to by @old_caps may be %NULL. - %TRUE if @new_caps was different from @old_caps @@ -7047,7 +6681,6 @@ Either @new_caps or the #GstCaps pointed to by @old_caps may be %NULL. Modifies a pointer to a #GstCaps to point to a different #GstCaps. This function is similar to gst_caps_replace() except that it takes ownership of @new_caps. - %TRUE if @new_caps was different from @old_caps @@ -7085,13 +6718,11 @@ Examples for caps features would be the requirement of a specific #GstMemory types or the requirement of having a specific #GstMeta on the buffer. Features are given as a string of the format "memory:GstMemoryTypeName" or "meta:GstMetaAPIName". - Creates a new #GstCapsFeatures with the given features. The last argument must be %NULL. Free-function: gst_caps_features_free - a new, empty #GstCapsFeatures @@ -7113,7 +6744,6 @@ to any other #GstCapsFeatures but caps with these are unfixed. Free-function: gst_caps_features_free - a new, ANY #GstCapsFeatures @@ -7123,7 +6753,6 @@ Free-function: gst_caps_features_free Creates a new, empty #GstCapsFeatures. Free-function: gst_caps_features_free - a new, empty #GstCapsFeatures @@ -7134,7 +6763,6 @@ Free-function: gst_caps_features_free The last argument must be 0. Free-function: gst_caps_features_free - a new, empty #GstCapsFeatures @@ -7154,7 +6782,6 @@ Free-function: gst_caps_features_free Creates a new #GstCapsFeatures with the given features. Free-function: gst_caps_features_free - a new, empty #GstCapsFeatures @@ -7174,7 +6801,6 @@ Free-function: gst_caps_features_free Creates a new #GstCapsFeatures with the given features. Free-function: gst_caps_features_free - a new, empty #GstCapsFeatures @@ -7192,7 +6818,6 @@ Free-function: gst_caps_features_free Adds @feature to @features. - @@ -7209,7 +6834,6 @@ Free-function: gst_caps_features_free Adds @feature to @features. - @@ -7226,7 +6850,6 @@ Free-function: gst_caps_features_free Check if @features contains @feature. - %TRUE if @features contains @feature. @@ -7244,7 +6867,6 @@ Free-function: gst_caps_features_free Check if @features contains @feature. - %TRUE if @features contains @feature. @@ -7264,7 +6886,6 @@ Free-function: gst_caps_features_free Duplicates a #GstCapsFeatures and all its values. Free-function: gst_caps_features_free - a new #GstCapsFeatures. @@ -7279,7 +6900,6 @@ Free-function: gst_caps_features_free Frees a #GstCapsFeatures and all its values. The caps features must not have a parent when this function is called. - @@ -7292,7 +6912,6 @@ have a parent when this function is called. Returns the @i-th feature of @features. - The @i-th feature of @features. @@ -7310,7 +6929,6 @@ have a parent when this function is called. Returns the @i-th feature of @features. - The @i-th feature of @features. @@ -7328,7 +6946,6 @@ have a parent when this function is called. Returns the number of features in @features. - The number of features in @features. @@ -7342,7 +6959,6 @@ have a parent when this function is called. Check if @features is %GST_CAPS_FEATURES_ANY. - %TRUE if @features is %GST_CAPS_FEATURES_ANY. @@ -7356,7 +6972,6 @@ have a parent when this function is called. Check if @features1 and @features2 are equal. - %TRUE if @features1 and @features2 are equal. @@ -7374,7 +6989,6 @@ have a parent when this function is called. Removes @feature from @features. - @@ -7391,7 +7005,6 @@ have a parent when this function is called. Removes @feature from @features. - @@ -7411,7 +7024,6 @@ have a parent when this function is called. determine whether a caps features is mutable or not. This function should only be called by code implementing parent objects of #GstCapsFeatures, as described in the MT Refcounting section of the design documents. - %TRUE if the parent refcount could be set. @@ -7437,7 +7049,6 @@ GST_LOG ("features is %" GST_PTR_FORMAT, features); This prints the features in human readable form. Free-function: g_free - a pointer to string allocated by g_malloc(). g_free() after usage. @@ -7454,7 +7065,6 @@ Free-function: g_free Creates a #GstCapsFeatures from a string representation. Free-function: gst_caps_features_free - a new #GstCapsFeatures or %NULL when the string could not be parsed. Free with @@ -7473,7 +7083,6 @@ Free-function: gst_caps_features_free A function that will be called in gst_caps_filter_and_map_in_place(). The function may modify @features and @structure, and both will be removed from the caps if %FALSE is returned. - %TRUE if the features and structure should be preserved, %FALSE if it should be removed. @@ -7504,7 +7113,6 @@ removed from the caps if %FALSE is returned. A function that will be called in gst_caps_foreach(). The function may not modify @features or @structure. - %TRUE if the foreach operation should continue, %FALSE if the foreach operation should stop with %FALSE. @@ -7555,7 +7163,6 @@ would be [A, B], maintaining the first caps priority on the intersection. A function that will be called in gst_caps_map_in_place(). The function may modify @features and @structure. - %TRUE if the map operation should continue, %FALSE if the map operation should stop with %FALSE. @@ -7590,10 +7197,8 @@ parent element by using gst_child_proxy_get() and gst_child_proxy_set(). Property names are written as "child-name::property-name". The whole naming scheme is recursive. Thus "child1::child2::property" is valid too, if "child1" and "child2" implement the #GstChildProxy interface. - Emits the "child-added" signal. - @@ -7614,7 +7219,6 @@ scheme is recursive. Thus "child1::child2::property" is valid too, if Emits the "child-removed" signal. - @@ -7635,7 +7239,6 @@ scheme is recursive. Thus "child1::child2::property" is valid too, if Fetches a child by its number. - the child object or %NULL if not found (index too high). Unref after usage. @@ -7660,7 +7263,6 @@ MT safe. This virtual method has a default implementation that uses #GstObject together with gst_object_get_name(). If the interface is to be used with #GObjects, this methods needs to be overridden. - the child object or %NULL if not found. Unref after usage. @@ -7681,7 +7283,6 @@ MT safe. Gets the number of child objects this parent contains. - the number of child objects @@ -7697,7 +7298,6 @@ MT safe. Emits the "child-added" signal. - @@ -7718,7 +7318,6 @@ MT safe. Emits the "child-removed" signal. - @@ -7739,7 +7338,6 @@ MT safe. Gets properties of the parent object and its children. - @@ -7760,7 +7358,6 @@ MT safe. Fetches a child by its number. - the child object or %NULL if not found (index too high). Unref after usage. @@ -7785,7 +7382,6 @@ MT safe. This virtual method has a default implementation that uses #GstObject together with gst_object_get_name(). If the interface is to be used with #GObjects, this methods needs to be overridden. - the child object or %NULL if not found. Unref after usage. @@ -7806,7 +7402,6 @@ MT safe. Gets the number of child objects this parent contains. - the number of child objects @@ -7823,7 +7418,6 @@ MT safe. Gets a single property using the GstChildProxy mechanism. You are responsible for freeing it by calling g_value_unset() - @@ -7844,7 +7438,6 @@ You are responsible for freeing it by calling g_value_unset() Gets properties of the parent object and its children. - @@ -7867,7 +7460,6 @@ You are responsible for freeing it by calling g_value_unset() Looks up which object and #GParamSpec would be effected by the given @name. MT safe. - %TRUE if @target and @pspec could be found. %FALSE otherwise. In that case the values for @pspec and @target are not modified. Unref @target after @@ -7897,7 +7489,6 @@ usage. For plain GObjects @target is the same as @object. Sets properties of the parent object and its children. - @@ -7918,7 +7509,6 @@ usage. For plain GObjects @target is the same as @object. Sets a single property using the GstChildProxy mechanism. - @@ -7939,7 +7529,6 @@ usage. For plain GObjects @target is the same as @object. Sets properties of the parent object and its children. - @@ -7993,14 +7582,12 @@ usage. For plain GObjects @target is the same as @object. #GstChildProxy interface. - parent interface type. - the child object or %NULL if not found. Unref after usage. @@ -8022,7 +7609,6 @@ MT safe. - the child object or %NULL if not found (index too high). Unref after usage. @@ -8044,7 +7630,6 @@ MT safe. - the number of child objects @@ -8061,7 +7646,6 @@ MT safe. - @@ -8083,7 +7667,6 @@ MT safe. - @@ -8182,11 +7765,9 @@ The #GstClock:timeout property defines the interval to sample the master clock and run the calibration functions. #GstClock:window-size defines the number of samples to use when calibrating and #GstClock:window-threshold defines the minimum number of samples before the calibration is performed. - Compares the two #GstClockID instances. This function can be used as a GCompareFunc when sorting ids. - negative value if a < b; zero if a = b; positive value if a > b @@ -8206,7 +7787,6 @@ MT safe. This function returns the underlying clock. - a #GstClock or %NULL when the underlying clock has been freed. Unref after usage. @@ -8223,7 +7803,6 @@ MT safe. Get the time of the clock ID - the time of the given clock id. @@ -8239,7 +7818,6 @@ MT safe. Increase the refcount of given @id. - The same #GstClockID with increased refcount. @@ -8258,7 +7836,6 @@ MT safe. #GstClockID will be freed. MT safe. - @@ -8276,7 +7853,6 @@ After this call, @id cannot be used anymore to receive sync or async notifications, you need to create a new #GstClockID. MT safe. - @@ -8292,7 +7868,6 @@ MT safe. @clock can be NULL, in which case the return value indicates whether the underlying clock has been freed. If this is the case, the @id is no longer usable and should be freed. - whether the clock @id uses the same underlying #GstClock @clock. @@ -8324,7 +7899,6 @@ Positive values indicate how late @id was relative to the clock (in which case this function will return #GST_CLOCK_EARLY). Negative values indicate how much time was spent waiting on the clock before this function returned. - the result of the blocking wait. #GST_CLOCK_EARLY will be returned if the current clock time is past the time of @id, #GST_CLOCK_OK if @@ -8355,7 +7929,6 @@ be called when the time of @id has been reached. The callback @func can be invoked from any thread, either provided by the core or from a streaming thread. The application should be prepared for this. - the result of the non blocking wait. @@ -8382,7 +7955,6 @@ MT safe. - @@ -8401,7 +7973,6 @@ MT safe. Gets the current internal time of the given clock. The time is returned unadjusted for the offset and the rate. - the internal time of the clock. Or GST_CLOCK_TIME_NONE when given invalid input. @@ -8419,7 +7990,6 @@ MT safe. Get the accuracy of the clock. The accuracy of the clock is the granularity of the values returned by gst_clock_get_time(). - the resolution of the clock in units of #GstClockTime. @@ -8434,7 +8004,6 @@ MT safe. - @@ -8448,7 +8017,6 @@ MT safe. - @@ -8465,7 +8033,6 @@ MT safe. - @@ -8489,7 +8056,6 @@ correlation coefficient of the interpolation. A value of 1.0 means a perfect regression was performed. This value can be used to control the sampling frequency of the master and slave clocks. - %TRUE if enough observations were added to run the regression algorithm. @@ -8523,7 +8089,6 @@ estimation, without updating the internal calibration. The caller can then take the results and call gst_clock_set_calibration() with the values, or some modified version of them. - @@ -8569,7 +8134,6 @@ that the returned time is increasing. This function should be called with the clock's OBJECT_LOCK held and is mainly used by clock subclasses. This function is the reverse of gst_clock_unadjust_unlocked(). - the converted time of the clock. @@ -8593,7 +8157,6 @@ current calibration parameters, but doesn't ensure a monotonically increasing result as gst_clock_adjust_unlocked() does. Note: The @clock parameter is unused and can be NULL - the converted time of the clock. @@ -8634,7 +8197,6 @@ gst_clock_set_calibration() for more information. caller is not interested in the values. MT safe. - @@ -8664,7 +8226,6 @@ MT safe. Gets the current internal time of the given clock. The time is returned unadjusted for the offset and the rate. - the internal time of the clock. Or GST_CLOCK_TIME_NONE when given invalid input. @@ -8682,7 +8243,6 @@ MT safe. Get the master clock that @clock is slaved to or %NULL when the clock is not slaved to any master clock. - a master #GstClock or %NULL when this clock is not slaved to a master clock. Unref after @@ -8701,7 +8261,6 @@ MT safe. Get the accuracy of the clock. The accuracy of the clock is the granularity of the values returned by gst_clock_get_time(). - the resolution of the clock in units of #GstClockTime. @@ -8719,7 +8278,6 @@ MT safe. Gets the current time of the given clock. The time is always monotonically increasing and adjusted according to the current offset and rate. - the time of the clock. Or GST_CLOCK_TIME_NONE when given invalid input. @@ -8736,7 +8294,6 @@ MT safe. Get the amount of time that master and slave clocks are sampled. - the interval between samples. @@ -8752,7 +8309,6 @@ MT safe. Checks if the clock is currently synced. This returns if GST_CLOCK_FLAG_NEEDS_STARTUP_SYNC is not set on the clock. - %TRUE if the clock is currently synced @@ -8771,7 +8327,6 @@ will then be fired with the given @interval. @id should be unreffed after usage. Free-function: gst_clock_id_unref - a #GstClockID that can be used to request the time notification. @@ -8800,7 +8355,6 @@ notification at the requested time. The single shot id should be unreffed after usage. Free-function: gst_clock_id_unref - a #GstClockID that can be used to request the time notification. @@ -8822,7 +8376,6 @@ MT safe. Reinitializes the provided periodic @id to the provided start time and interval. Does not modify the reference count. - %TRUE if the GstClockID could be reinitialized to the provided @time, else %FALSE. @@ -8871,7 +8424,6 @@ move the clock backwards, gst_clock_get_time() will report the previous value until the clock catches up. MT safe. - @@ -8910,7 +8462,6 @@ calibration values with gst_clock_get_calibration(). @master can be %NULL in which case @clock will not be slaved anymore. It will however keep reporting its time adjusted with the last configured rate and time offsets. - %TRUE if the clock is capable of being slaved to a master clock. Trying to set a master on a clock without the @@ -8936,7 +8487,6 @@ with different accuracy at the expense of more resource usage. There is normally no need to change the default resolution of a clock. The resolution of a clock can only be changed if the clock has the #GST_CLOCK_FLAG_CAN_SET_RESOLUTION flag set. - the new resolution of the clock. @@ -8958,7 +8508,6 @@ thread waiting in gst_clock_wait_for_sync(). This function must only be called if GST_CLOCK_FLAG_NEEDS_STARTUP_SYNC is set on the clock, and is intended to be called by subclasses only. - @@ -8976,7 +8525,6 @@ is set on the clock, and is intended to be called by subclasses only. Set the amount of time, in nanoseconds, to sample master and slave clocks - @@ -8994,7 +8542,6 @@ clocks Reinitializes the provided single shot @id to the provided time. Does not modify the reference count. - %TRUE if the GstClockID could be reinitialized to the provided @time, else %FALSE. @@ -9022,7 +8569,6 @@ This function should be called with the clock's OBJECT_LOCK held and is mainly used by clock subclasses. This function is the reverse of gst_clock_adjust_unlocked(). - the internal time of the clock corresponding to @external. @@ -9045,7 +8591,6 @@ same calculation as gst_clock_unadjust_unlocked() when called using the current calibration parameters. Note: The @clock parameter is unused and can be NULL - the converted time of the clock. @@ -9087,7 +8632,6 @@ For asynchronous waiting, the GstClock::synced signal can be used. This returns immediately with TRUE if GST_CLOCK_FLAG_NEEDS_STARTUP_SYNC is not set on the clock, or if the clock is already synced. - %TRUE if waiting was successful, or %FALSE on timeout @@ -9143,7 +8687,6 @@ the application's main thread. The function prototype of the callback. - %TRUE or %FALSE (currently unused) @@ -9170,14 +8713,12 @@ the application's main thread. GStreamer clock class. Override the vmethods to implement the clock functionality. - the parent class structure - @@ -9196,7 +8737,6 @@ functionality. - the resolution of the clock in units of #GstClockTime. @@ -9213,7 +8753,6 @@ MT safe. - the internal time of the clock. Or GST_CLOCK_TIME_NONE when given invalid input. @@ -9231,7 +8770,6 @@ MT safe. - @@ -9250,7 +8788,6 @@ MT safe. - @@ -9266,7 +8803,6 @@ MT safe. - @@ -9291,7 +8827,6 @@ MT safe. an entry. Note that GstClockEntry should be treated as an opaque structure. It must not be extended or allocated using a custom allocator. - reference counter (read-only) @@ -9369,9 +8904,7 @@ not be extended or allocated using a custom allocator. subclasses can add additional flags starting from this flag - - - + The return value of a clock operation. @@ -9445,10 +8978,8 @@ A persistent #GstContext is kept in elements when they reach %GST_STATE_NULL, non-persistent ones will be removed. Also, a non-persistent context won't override a previous persistent context set to an element. - Create a new context. - The new context. @@ -9466,7 +8997,6 @@ context set to an element. Get the type of @context. - The type of the context. @@ -9480,7 +9010,6 @@ context set to an element. Access the structure of the context. - The structure of the context. The structure is still owned by the context, which means that you should not modify it, @@ -9496,7 +9025,6 @@ free it and that the pointer becomes invalid when you free the context. Checks if @context has @context_type. - %TRUE if @context has @context_type. @@ -9514,7 +9042,6 @@ free it and that the pointer becomes invalid when you free the context. Check if @context is persistent. - %TRUE if the context is persistent. @@ -9528,7 +9055,6 @@ free it and that the pointer becomes invalid when you free the context. Get a writable version of the structure. - The structure of the context. The structure is still owned by the context, which means that you should not free it and @@ -9549,7 +9075,6 @@ This function checks if @context is writable. properties. Such an object is taking one or more #GstControlSource instances, combines them and maps the resulting value to the type and value range of the bound property. - Gets a number of #GValues for the given controlled property starting at the requested time. The array @values need to hold enough space for @n_values of @@ -9557,7 +9082,6 @@ requested time. The array @values need to hold enough space for @n_values of This function is useful if one wants to e.g. draw a graph of the control curve or apply a control curve sample by sample. - %TRUE if the given array could be filled, %FALSE otherwise @@ -9589,7 +9113,6 @@ curve or apply a control curve sample by sample. Gets the value for the given controlled property at the requested time. - the GValue of the property at the given time, or %NULL if the property isn't controlled. @@ -9617,7 +9140,6 @@ curve or apply a control curve sample by sample. The values are unboxed and ready to be used. The similar function gst_control_binding_get_g_value_array() returns the array as #GValues and is more suitable for bindings. - %TRUE if the given array could be filled, %FALSE otherwise @@ -9653,7 +9175,6 @@ handle them and for the given timestamp. If this function fails, it is most likely the application developers fault. Most probably the control sources are not setup correctly. - %TRUE if the controller value could be applied to the object property, %FALSE otherwise @@ -9685,7 +9206,6 @@ requested time. The array @values need to hold enough space for @n_values of This function is useful if one wants to e.g. draw a graph of the control curve or apply a control curve sample by sample. - %TRUE if the given array could be filled, %FALSE otherwise @@ -9717,7 +9237,6 @@ curve or apply a control curve sample by sample. Gets the value for the given controlled property at the requested time. - the GValue of the property at the given time, or %NULL if the property isn't controlled. @@ -9745,7 +9264,6 @@ curve or apply a control curve sample by sample. The values are unboxed and ready to be used. The similar function gst_control_binding_get_g_value_array() returns the array as #GValues and is more suitable for bindings. - %TRUE if the given array could be filled, %FALSE otherwise @@ -9777,7 +9295,6 @@ more suitable for bindings. Check if the control binding is disabled. - %TRUE if the binding is inactive @@ -9792,7 +9309,6 @@ more suitable for bindings. This function is used to disable a control binding for some time, i.e. gst_object_sync_values() will do nothing. - @@ -9814,7 +9330,6 @@ handle them and for the given timestamp. If this function fails, it is most likely the application developers fault. Most probably the control sources are not setup correctly. - %TRUE if the controller value could be applied to the object property, %FALSE otherwise @@ -9863,9 +9378,7 @@ property, %FALSE otherwise - - @@ -9879,14 +9392,12 @@ property, %FALSE otherwise The class structure of #GstControlBinding. - Parent class - %TRUE if the controller value could be applied to the object property, %FALSE otherwise @@ -9914,7 +9425,6 @@ property, %FALSE otherwise - the GValue of the property at the given time, or %NULL if the property isn't controlled. @@ -9934,7 +9444,6 @@ or %NULL if the property isn't controlled. - %TRUE if the given array could be filled, %FALSE otherwise @@ -9967,7 +9476,6 @@ or %NULL if the property isn't controlled. - %TRUE if the given array could be filled, %FALSE otherwise @@ -10007,7 +9515,6 @@ or %NULL if the property isn't controlled. FIXME(2.0): remove, this is unused - @@ -10023,9 +9530,7 @@ or %NULL if the property isn't controlled. - - - + The #GstControlSource is a base class for control value sources that could be used to get timestamp-value pairs. A control source essentially is a @@ -10040,10 +9545,8 @@ For implementing a new #GstControlSource one has to implement #GstControlSourceGetValue and #GstControlSourceGetValueArray functions. These are then used by gst_control_source_get_value() and gst_control_source_get_value_array() to get values for specific timestamps. - Gets the value for this #GstControlSource at a given timestamp. - %FALSE if the value couldn't be returned, %TRUE otherwise. @@ -10066,7 +9569,6 @@ gst_control_source_get_value_array() to get values for specific timestamps. Gets an array of values for for this #GstControlSource. Values that are undefined contain NANs. - %TRUE if the given array could be filled, %FALSE otherwise @@ -10115,7 +9617,6 @@ undefined contain NANs. The class structure of #GstControlSource. - Parent class @@ -10128,7 +9629,6 @@ undefined contain NANs. Function for returning a value for a given timestamp. - %TRUE if the value was successfully calculated. @@ -10150,7 +9650,6 @@ undefined contain NANs. Function for returning an array of values for starting at a given timestamp. - %TRUE if the values were successfully calculated. @@ -10237,7 +9736,6 @@ this functionality yet. - @@ -10253,7 +9751,6 @@ directly without converting it first. The macro is only active if the environment variable GST_DEBUG_DUMP_DOT_DIR is set to a basepath (e.g. /tmp), and the GStreamer debugging subsystem is enabled (i.e., no use of `./configure --disable-gst-debug') - the top-level pipeline that should be analyzed @@ -10270,7 +9767,6 @@ enabled (i.e., no use of `./configure --disable-gst-debug') This works like GST_DEBUG_BIN_TO_DOT_FILE(), but adds the current timestamp to the filename, so that it can be used to take multiple snapshots. - the top-level pipeline that should be analyzed @@ -10287,7 +9783,6 @@ to the filename, so that it can be used to take multiple snapshots. Defines a GstDebugCategory variable. This macro expands to nothing if debugging is disabled. - the category @@ -10297,7 +9792,6 @@ This macro expands to nothing if debugging is disabled. Declares a GstDebugCategory variable as extern. Use in header files. This macro expands to nothing if debugging is disabled. - the category @@ -10317,7 +9811,6 @@ GST_DEBUG_CATEGORY_STATIC (GST_CAT_PERFORMANCE); GST_DEBUG_CATEGORY_INIT (gst_myplugin_debug, "myplugin", 0, "nice element"); GST_DEBUG_CATEGORY_GET (GST_CAT_PERFORMANCE, "GST_PERFORMANCE"); ]| - the category to initialize. @@ -10348,7 +9841,6 @@ the default threshold. > common prefix followed by an underscore for all your categories. GStreamer > uses the GST prefix so GStreamer categories look like "GST_STATES". Be sure > to include uppercase letters. - the category to initialize. @@ -10367,7 +9859,6 @@ the default threshold. Defines a static GstDebugCategory variable. This macro expands to nothing if debugging is disabled. - the category @@ -10375,17 +9866,14 @@ This macro expands to nothing if debugging is disabled. - - Register a pointer to a function with its name, so it can later be used by GST_DEBUG_FUNCPTR_NAME(). - pointer to the function to register @@ -10398,7 +9886,6 @@ GST_DEBUG_FUNCPTR(). If not, it returns a description of the pointer. This macro returns a constant string which must not be modified or freed by the caller. - address of the function of which to look up the name @@ -10408,7 +9895,6 @@ freed by the caller. Evaluates to 2 strings, that describe the pad. Often used in debugging statements. - The pad to debug. @@ -10420,7 +9906,6 @@ statements. GST_DEBUG_FUNCPTR_NAME(). Use this variant of #GST_DEBUG_FUNCPTR if you do not need to use @ptr. - pointer to the function to register @@ -10429,7 +9914,6 @@ Use this variant of #GST_DEBUG_FUNCPTR if you do not need to use @ptr. Define a new mini-object type with the given name - name of the new type in CamelCase @@ -10440,126 +9924,108 @@ Use this variant of #GST_DEBUG_FUNCPTR if you do not need to use @ptr. - - - - - - - - - - - - - - - - - - @@ -10572,7 +10038,6 @@ Use this variant of #GST_DEBUG_FUNCPTR if you do not need to use @ptr. Date information is handled using the proleptic Gregorian calendar. Provides basic creation functions and accessor functions to its fields. - Creates a new #GstDateTime using the date and times in the gregorian calendar in the supplied timezone. @@ -10590,7 +10055,6 @@ if @month == -1, then #GstDateTime will created only for @year. If so on. Free-function: gst_date_time_unref - the newly created #GstDateTime @@ -10630,7 +10094,6 @@ Free-function: gst_date_time_unref Creates a new #GstDateTime from a #GDateTime object. Free-function: gst_date_time_unref - a newly created #GstDateTime, or %NULL on error @@ -10654,7 +10117,6 @@ If no date is provided, it is assumed to be "today" in the timezone provided (if any), otherwise UTC. Free-function: gst_date_time_unref - a newly created #GstDateTime, or %NULL on error @@ -10672,7 +10134,6 @@ or %NULL on error @secs. The #GstDateTime is in the local timezone. Free-function: gst_date_time_unref - the newly created #GstDateTime @@ -10687,7 +10148,6 @@ Free-function: gst_date_time_unref Creates a new #GstDateTime using the time since Jan 1, 1970 specified by @usecs. The #GstDateTime is in the local timezone. - a newly created #GstDateTime @@ -10704,7 +10164,6 @@ Free-function: gst_date_time_unref @secs. The #GstDateTime is in the UTC timezone. Free-function: gst_date_time_unref - the newly created #GstDateTime @@ -10719,7 +10178,6 @@ Free-function: gst_date_time_unref Creates a new #GstDateTime using the time since Jan 1, 1970 specified by @usecs. The #GstDateTime is in UTC. - a newly created #GstDateTime @@ -10749,7 +10207,6 @@ If @hour is -1, then the #GstDateTime created will only contain @year and case @minute and @seconds should also be -1. Free-function: gst_date_time_unref - the newly created #GstDateTime @@ -10785,7 +10242,6 @@ Free-function: gst_date_time_unref Creates a new #GstDateTime representing the current date and time. Free-function: gst_date_time_unref - the newly created #GstDateTime which should be freed with gst_date_time_unref(). @@ -10797,7 +10253,6 @@ Free-function: gst_date_time_unref coordinated time. Free-function: gst_date_time_unref - the newly created #GstDateTime which should be freed with gst_date_time_unref(). @@ -10811,7 +10266,6 @@ in the local timezone. @year should be from 1 to 9999. Free-function: gst_date_time_unref - the newly created #GstDateTime @@ -10833,7 +10287,6 @@ If value is -1 then all over value will be ignored. For example if @month == -1, then #GstDateTime will created only for @year. Free-function: gst_date_time_unref - the newly created #GstDateTime @@ -10862,7 +10315,6 @@ if @month == -1, then #GstDateTime will created only for @year. If so on. Free-function: gst_date_time_unref - the newly created #GstDateTime @@ -10885,7 +10337,6 @@ Free-function: gst_date_time_unref Returns the day of the month of this #GstDateTime. Call gst_date_time_has_day() before, to avoid warnings. - The day of this #GstDateTime @@ -10901,7 +10352,6 @@ Call gst_date_time_has_day() before, to avoid warnings. Retrieves the hour of the day represented by @datetime in the gregorian calendar. The return is in the range of 0 to 23. Call gst_date_time_has_time() before, to avoid warnings. - the hour of the day @@ -10916,7 +10366,6 @@ Call gst_date_time_has_time() before, to avoid warnings. Retrieves the fractional part of the seconds in microseconds represented by @datetime in the gregorian calendar. - the microsecond of the second @@ -10932,7 +10381,6 @@ Call gst_date_time_has_time() before, to avoid warnings. Retrieves the minute of the hour represented by @datetime in the gregorian calendar. Call gst_date_time_has_time() before, to avoid warnings. - the minute of the hour @@ -10947,7 +10395,6 @@ Call gst_date_time_has_time() before, to avoid warnings. Returns the month of this #GstDateTime. January is 1, February is 2, etc.. Call gst_date_time_has_month() before, to avoid warnings. - The month of this #GstDateTime @@ -10963,7 +10410,6 @@ Call gst_date_time_has_month() before, to avoid warnings. Retrieves the second of the minute represented by @datetime in the gregorian calendar. Call gst_date_time_has_time() before, to avoid warnings. - the second represented by @datetime @@ -10980,7 +10426,6 @@ Call gst_date_time_has_time() before, to avoid warnings. by @datetime represents. Timezones ahead (to the east) of UTC have positive values, timezones before (to the west) of UTC have negative values. If @datetime represents UTC time, then the offset is zero. - the offset from UTC in hours @@ -10995,7 +10440,6 @@ If @datetime represents UTC time, then the offset is zero. Returns the year of this #GstDateTime Call gst_date_time_has_year() before, to avoid warnings. - The year of this #GstDateTime @@ -11008,7 +10452,6 @@ Call gst_date_time_has_year() before, to avoid warnings. - %TRUE if @datetime<!-- -->'s day field is set, otherwise %FALSE @@ -11021,7 +10464,6 @@ Call gst_date_time_has_year() before, to avoid warnings. - %TRUE if @datetime<!-- -->'s month field is set, otherwise %FALSE @@ -11034,7 +10476,6 @@ Call gst_date_time_has_year() before, to avoid warnings. - %TRUE if @datetime<!-- -->'s second field is set, otherwise %FALSE @@ -11047,7 +10488,6 @@ Call gst_date_time_has_year() before, to avoid warnings. - %TRUE if @datetime<!-- -->'s hour and minute fields are set, otherwise %FALSE @@ -11061,7 +10501,6 @@ Call gst_date_time_has_year() before, to avoid warnings. - %TRUE if @datetime<!-- -->'s year field is set (which should always be the case), otherwise %FALSE @@ -11076,7 +10515,6 @@ Call gst_date_time_has_year() before, to avoid warnings. Atomically increments the reference count of @datetime by one. - the reference @datetime @@ -11092,7 +10530,6 @@ Call gst_date_time_has_year() before, to avoid warnings. Creates a new #GDateTime from a fully defined #GstDateTime object. Free-function: g_date_time_unref - a newly created #GDateTime, or %NULL on error @@ -11109,7 +10546,6 @@ Free-function: g_date_time_unref Create a minimal string compatible with ISO-8601. Possible output formats are (for example): 2012, 2012-06, 2012-06-23, 2012-06-23T23:30Z, 2012-06-23T23:30+0100, 2012-06-23T23:30:59Z, 2012-06-23T23:30:59+0100 - a newly allocated string formatted according to ISO 8601 and only including the datetime fields that are @@ -11127,7 +10563,6 @@ are (for example): 2012, 2012-06, 2012-06-23, 2012-06-23T23:30Z, Atomically decrements the reference count of @datetime by one. When the reference count reaches zero, the structure is freed. - @@ -11142,7 +10577,6 @@ reference count reaches zero, the structure is freed. This is the struct that describes the categories. Once initialized with #GST_DEBUG_CATEGORY_INIT, its values can't be changed anymore. - @@ -11158,7 +10592,6 @@ reference count reaches zero, the structure is freed. Removes and frees the category and all associated resources. This function can easily cause memory corruption, don't use it. - @@ -11172,7 +10605,6 @@ reference count reaches zero, the structure is freed. Returns the color of a debug category used when printing output in this category. - the color of the category. @@ -11186,7 +10618,6 @@ category. Returns the description of a debug category. - the description of the category. @@ -11200,7 +10631,6 @@ category. Returns the name of a debug category. - the name of the category. @@ -11214,7 +10644,6 @@ category. Returns the threshold of a #GstDebugCategory. - the #GstDebugLevel that is used as threshold. @@ -11232,7 +10661,6 @@ will only be output if the threshold is lower or equal to the level of the debugging message. Use this function to set the threshold back to where it was after using gst_debug_category_set_threshold(). - @@ -11250,7 +10678,6 @@ debugging message. > Do not use this function in production code, because other functions may > change the threshold of categories as side effect. It is however a nice > function to use when debugging (even from gdb). - @@ -11341,7 +10768,6 @@ debugging categories to make them stand out in debugging output. we define this to avoid a compiler warning regarding a cast from a function pointer to a void pointer (see https://bugzilla.gnome.org/show_bug.cgi?id=309253) - @@ -11436,7 +10862,6 @@ message is, the greater the probability that the debugging system outputs it. Get the string representation of a debugging level - the name @@ -11450,11 +10875,9 @@ message is, the greater the probability that the debugging system outputs it. - Gets the string representation of a #GstDebugMessage. This function is used in debug handlers to extract the message. - the string representation of a #GstDebugMessage. @@ -11474,11 +10897,9 @@ representing the media types it can produce or handle. #GstDevice are created by #GstDeviceProvider objects which can be aggregated by #GstDeviceMonitor objects. - Creates the element with all of the required parameters set to use this device. - a new #GstElement configured to use this device @@ -11503,7 +10924,6 @@ using gst_device_create_element(). Note: This should only be implemented for elements can change their device in the PLAYING state. - %TRUE if the element could be reconfigured to use this device, %FALSE otherwise. @@ -11523,7 +10943,6 @@ device in the PLAYING state. Creates the element with all of the required parameters set to use this device. - a new #GstElement configured to use this device @@ -11543,7 +10962,6 @@ create a unique name. Getter for the #GstCaps that this device supports. - The #GstCaps supported by this device. Unref with gst_caps_unref() when done. @@ -11560,7 +10978,6 @@ gst_caps_unref() when done. Gets the "class" of a device. This is a "/" separated list of classes that represent this device. They are a subset of the classes of the #GstDeviceProvider that produced this device. - The device class. Free with g_free() after use. @@ -11574,7 +10991,6 @@ classes of the #GstDeviceProvider that produced this device. Gets the user-friendly name of the device. - The device name. Free with g_free() after use. @@ -11588,7 +11004,6 @@ classes of the #GstDeviceProvider that produced this device. Gets the extra properties of a device. - The extra properties or %NULL when there are none. Free with gst_structure_free() after use. @@ -11603,7 +11018,6 @@ classes of the #GstDeviceProvider that produced this device. Check if @device matches all of the given classes - %TRUE if @device matches. @@ -11622,7 +11036,6 @@ classes of the #GstDeviceProvider that produced this device. Check if @factory matches all of the given classes - %TRUE if @device matches. @@ -11648,7 +11061,6 @@ using gst_device_create_element(). Note: This should only be implemented for elements can change their device in the PLAYING state. - %TRUE if the element could be reconfigured to use this device, %FALSE otherwise. @@ -11697,14 +11109,12 @@ device in the PLAYING state. The class structure for a #GstDevice object. - The parent #GstObjectClass structure. - a new #GstElement configured to use this device @@ -11725,7 +11135,6 @@ create a unique name. - %TRUE if the element could be reconfigured to use this device, %FALSE otherwise. @@ -11811,10 +11220,8 @@ The basic use pattern of a device monitor is as follows: return monitor; } ]| - Create a new #GstDeviceMonitor - a new device monitor. @@ -11832,7 +11239,6 @@ The #GstCaps supported by the device as returned by gst_device_get_caps() are not intersected with caps filters added using this function. Filters must be added before the #GstDeviceMonitor is started. - The id of the new filter or 0 if no provider matched the filter's classes. @@ -11855,7 +11261,6 @@ Filters must be added before the #GstDeviceMonitor is started. Gets the #GstBus of this #GstDeviceMonitor - a #GstBus @@ -11870,7 +11275,6 @@ Filters must be added before the #GstDeviceMonitor is started. Gets a list of devices from all of the relevant monitors. This may actually probe the hardware if the monitor is not currently started. - a #GList of #GstDevice @@ -11889,7 +11293,6 @@ probe the hardware if the monitor is not currently started. Get a list of the currently selected device provider factories. This - A list of device provider factory names that are currently being @@ -11908,7 +11311,6 @@ This Get if @monitor is currently showing all devices, even those from hidden providers. - %TRUE when all devices will be shown. @@ -11923,7 +11325,6 @@ providers. Removes a filter from the #GstDeviceMonitor using the id that was returned by gst_device_monitor_add_filter(). - %TRUE of the filter id was valid, %FALSE otherwise @@ -11942,7 +11343,6 @@ by gst_device_monitor_add_filter(). Set if all devices should be visible, even those devices from hidden providers. Setting @show_all to true might show some devices multiple times. - @@ -11961,7 +11361,6 @@ providers. Setting @show_all to true might show some devices multiple times.Starts monitoring the devices, one this has succeeded, the %GST_MESSAGE_DEVICE_ADDED and %GST_MESSAGE_DEVICE_REMOVED messages will be emitted on the bus when the list of devices changes. - %TRUE if the device monitoring could be started @@ -11975,7 +11374,6 @@ will be emitted on the bus when the list of devices changes. Stops monitoring the devices. - @@ -12004,7 +11402,6 @@ will be emitted on the bus when the list of devices changes. Opaque device monitor class structure. - the parent #GstObjectClass structure @@ -12015,12 +11412,8 @@ will be emitted on the bus when the list of devices changes. - - - - - - + + A #GstDeviceProvider subclass is provided by a plugin that handles devices if there is a way to programmatically list connected devices. It can also @@ -12031,11 +11424,9 @@ normally provide a single subclass for all devices. Applications would normally use a #GstDeviceMonitor to monitor devices from all relevant providers. - Create a new device providerfactory capable of instantiating objects of the @type and add the factory to @plugin. - %TRUE, if the registering succeeded, %FALSE on error @@ -12061,7 +11452,6 @@ from all relevant providers. - @@ -12086,7 +11476,6 @@ number of times. After this function has been called, gst_device_provider_get_devices() will return the same objects that have been received from the #GST_MESSAGE_DEVICE_ADDED messages and will no longer probe. - %TRUE if the device providering could be started @@ -12102,7 +11491,6 @@ return the same objects that have been received from the Decreases the use-count by one. If the use count reaches zero, this #GstDeviceProvider will stop providering the devices. This needs to be called the same number of times that gst_device_provider_start() was called. - @@ -12114,7 +11502,6 @@ called the same number of times that gst_device_provider_start() was called. - @@ -12132,7 +11519,6 @@ This is for use by subclasses. @device's reference count will be incremented, and any floating reference will be removed (see gst_object_ref_sink()). - @@ -12153,7 +11539,6 @@ will be removed (see gst_object_ref_sink()). the application know that the device was modified. #GstDevice is immutable for MT. safety purposes so this is an "atomic" way of letting the application know when a device was modified. - @@ -12176,7 +11561,6 @@ know when a device was modified. a device has been removed. This is for use by subclasses. - @@ -12193,7 +11577,6 @@ This is for use by subclasses. Gets the #GstBus of this #GstDeviceProvider - a #GstBus @@ -12211,7 +11594,6 @@ probe the hardware if the provider is not currently started. If the provider has been started, this will returned the same #GstDevice objedcts that have been returned by the #GST_MESSAGE_DEVICE_ADDED messages. - a #GList of #GstDevice @@ -12228,7 +11610,6 @@ objedcts that have been returned by the #GST_MESSAGE_DEVICE_ADDED messages. Retrieves the factory that was used to create this device provider. - the #GstDeviceProviderFactory used for creating this device provider. no refcounting is needed. @@ -12244,7 +11625,6 @@ objedcts that have been returned by the #GST_MESSAGE_DEVICE_ADDED messages. Get the provider factory names of the #GstDeviceProvider instances that are hidden by @provider. - a list of hidden providers factory names or %NULL when @@ -12262,7 +11642,6 @@ are hidden by @provider. Get metadata with @key in @provider. - the metadata for @key. @@ -12284,7 +11663,6 @@ are hidden by @provider. This function is used when @provider will also provide the devices reported by provider factory @name. A monitor should stop monitoring the device provider with @name to avoid duplicate devices. - @@ -12312,7 +11690,6 @@ number of times. After this function has been called, gst_device_provider_get_devices() will return the same objects that have been received from the #GST_MESSAGE_DEVICE_ADDED messages and will no longer probe. - %TRUE if the device providering could be started @@ -12328,7 +11705,6 @@ return the same objects that have been received from the Decreases the use-count by one. If the use count reaches zero, this #GstDeviceProvider will stop providering the devices. This needs to be called the same number of times that gst_device_provider_start() was called. - @@ -12346,7 +11722,6 @@ This function is used when @provider will no longer provide the devices reported by provider factory @name. A monitor should start monitoring the devices from provider factory @name in order to see all devices again. - @@ -12402,7 +11777,6 @@ all devices again. The structure of the base #GstDeviceProviderClass - the parent #GstObjectClass structure @@ -12414,7 +11788,6 @@ all devices again. - @@ -12429,7 +11802,6 @@ all devices again. - %TRUE if the device providering could be started @@ -12444,7 +11816,6 @@ all devices again. - @@ -12466,7 +11837,6 @@ all devices again. Set @key with @value as metadata in @klass. - @@ -12492,7 +11862,6 @@ Same as gst_device_provider_class_add_metadata(), but @value must be a static st or an inlined string, as it will not be copied. (GStreamer plugins will be made resident once loaded, so this function can be used even from dynamically loaded plugins.) - @@ -12513,7 +11882,6 @@ dynamically loaded plugins.) Get metadata with @key in @klass. - the metadata for @key. @@ -12533,7 +11901,6 @@ dynamically loaded plugins.) Sets the detailed information for a #GstDeviceProviderClass. > This function is for use in _class_init functions only. - @@ -12574,7 +11941,6 @@ Same as gst_device_provider_class_set_metadata(), but @longname, @classification @description, and @author must be static strings or inlined strings, as they will not be copied. (GStreamer plugins will be made resident once loaded, so this function can be used even from dynamically loaded plugins.) - @@ -12616,11 +11982,9 @@ Use the gst_device_provider_factory_find() and gst_device_provider_factory_get() functions to create device provider instances or use gst_device_provider_factory_get_by_name() as a convenient shortcut. - Search for an device provider factory of the given name. Refs the returned device provider factory; caller is responsible for unreffing. - #GstDeviceProviderFactory if found, %NULL otherwise @@ -12636,7 +12000,6 @@ found, %NULL otherwise Returns the device provider of the type defined by the given device provider factory. - a #GstDeviceProvider or %NULL if unable to create device provider @@ -12652,7 +12015,6 @@ if unable to create device provider Get a list of factories with a rank greater or equal to @minrank. The list of factories is returned by decreasing rank. - a #GList of #GstDeviceProviderFactory device providers. Use @@ -12671,7 +12033,6 @@ gst_plugin_feature_list_free() after usage. Returns the device provider of the type defined by the given device providerfactory. - the #GstDeviceProvider or %NULL if the device provider couldn't be created @@ -12688,7 +12049,6 @@ if the device provider couldn't be created Get the #GType for device providers managed by this factory. The type can only be retrieved if the device provider factory is loaded, which can be assured with gst_plugin_feature_load(). - the #GType for device providers managed by this factory. @@ -12702,7 +12062,6 @@ assured with gst_plugin_feature_load(). Get the metadata on @factory with @key. - the metadata with @key on @factory or %NULL when there was no metadata with the given @key. @@ -12721,7 +12080,6 @@ when there was no metadata with the given @key. Get the available keys for the metadata on @factory. - a %NULL-terminated array of key strings, or %NULL when there is no @@ -12739,7 +12097,6 @@ metadata. Free with g_strfreev() when no longer needed. Check if @factory matches all of the given @classes - %TRUE if @factory matches or if @classes is %NULL. @@ -12758,7 +12115,6 @@ metadata. Free with g_strfreev() when no longer needed. Check if @factory matches all of the given classes - %TRUE if @factory matches. @@ -12780,11 +12136,8 @@ metadata. Free with g_strfreev() when no longer needed. The opaque #GstDeviceProviderFactoryClass data structure. - - - - + A fundamental type that describes a #gdouble range @@ -12808,9 +12161,7 @@ plugin_init (GstPlugin * plugin) return gst_dynamic_type_register (plugin, GST_TYPE_CUSTOM_CAPS_FIELD); } ]| - - @@ -12821,11 +12172,8 @@ plugin_init (GstPlugin * plugin) - - - + - @@ -12835,7 +12183,6 @@ plugin_init (GstPlugin * plugin) Get the message bus of this element. This is not thread-safe by default (i.e. you will have to make sure the object lock is taken yourself). If in doubt use gst_element_get_bus() instead. - A #GstElement to query @@ -12843,14 +12190,12 @@ If in doubt use gst_element_get_bus() instead. - - @@ -12860,7 +12205,6 @@ If in doubt use gst_element_get_bus() instead. Get the clock of this element.This is not thread-safe by default (i.e. you will have to make sure it is safe yourself). If in doubt use gst_element_get_clock() instead. - A #GstElement to query @@ -12871,7 +12215,6 @@ If in doubt use gst_element_get_clock() instead. Utility function that elements can use in case they encountered a fatal data processing error. The pipeline will post an error message and the application will be requested to stop further media processing. - the element that generates the error @@ -12896,7 +12239,6 @@ application will be requested to stop further media processing. Utility function that elements can use in case they encountered a fatal data processing error. The pipeline will post an error message and the application will be requested to stop further media processing. - the element that generates the error @@ -12923,155 +12265,121 @@ application will be requested to stop further media processing. - - - - - - - - - - Elements interacting with hardware devices should specify this classifier in their metadata. You may need to put the element in "READY" state to test if the hardware is present in the system. - - - - - - - - - - - Elements of any of the defined GST_ELEMENT_FACTORY_LIST types - All sinks handling audio, video or image media types - All encoders handling audio media types - All elements used to 'decode' streams (decoders, demuxers, parsers, depayloaders) - - - - - - - - - - @@ -13080,58 +12388,45 @@ the hardware is present in the system. Note: Do not use this if you wish to not filter against any of the defined media types. If you wish to do this, simply don't specify any GST_ELEMENT_FACTORY_TYPE_MEDIA flag. - - - - - - - - - - - All encoders handling video or image media types - Utility function that elements can use in case they encountered a fatal data processing error due to wrong flow processing. - the element that generates the error @@ -13142,7 +12437,6 @@ data processing error due to wrong flow processing. - @@ -13153,7 +12447,6 @@ data processing error due to wrong flow processing. the application of something noteworthy that is not an error. The pipeline will post a info message and the application will be informed. - the element that generates the information @@ -13181,7 +12474,6 @@ The pipeline will post a info message and the application will be informed. Optional name, type, value triplets may be supplied, and will be stored in the associated GstStructure. NULL terminator required. - the element that generates the information @@ -13210,7 +12502,6 @@ in the associated GstStructure. NULL terminator required. Check if the element is in the locked state and therefore will ignore state changes from its parent object. - A #GstElement to query @@ -13218,7 +12509,6 @@ changes from its parent object. - @@ -13228,45 +12518,38 @@ changes from its parent object. Name and contact details of the author(s). Use \n to separate multiple author details. E.g: "Joe Bloggs &lt;joe.blogs at foo.com&gt;" - Sentence describing the purpose of the element. E.g: "Write stream to a file" - Set uri pointing to user documentation. Applications can use this to show help for e.g. effects to users. - Elements that bridge to certain other products can include an icon of that used product. Application can show the icon in menus/selectors to help identifying specific elements. - String describing the type of element, as an unordered list separated with slashes ('/'). See draft-klass.txt of the design docs for more details and common types. E.g: "Sink/File" - The long English name of the element. E.g. "File Sink" - Gets the name of this element. This is not thread-safe by default (i.e. you will have to make sure the object lock is taken yourself). If in doubt use gst_element_get_name() instead. - A #GstElement to query @@ -13275,7 +12558,6 @@ If in doubt use gst_element_get_name() instead. Get the pads of this elements. - A #GstElement to query @@ -13286,7 +12568,6 @@ If in doubt use gst_element_get_name() instead. Get the parent object of this element. This is not thread-safe by default (i.e. you will have to make sure the object lock is taken yourself). If in doubt use gst_object_get_parent() instead. - A #GstElement to query @@ -13296,7 +12577,6 @@ If in doubt use gst_object_get_parent() instead. This macro returns the start_time of the @elem. The start_time is the running_time of the pipeline when the element went to PAUSED. - a #GstElement to return the start time for. @@ -13307,7 +12587,6 @@ running_time of the pipeline when the element went to PAUSED. Utility function that elements can use in case they encountered a non-fatal data processing problem. The pipeline will post a warning message and the application will be informed. - the element that generates the warning @@ -13332,7 +12611,6 @@ application will be informed. Utility function that elements can use in case they encountered a non-fatal data processing problem. The pipeline will post a warning message and the application will be informed. - the element that generates the warning @@ -13361,18 +12639,15 @@ application will be informed. Builds a string using errno describing the previously failed system call. To be used as the debug argument in #GST_ELEMENT_ERROR. - - - @@ -13380,7 +12655,6 @@ call. To be used as the debug argument in #GST_ELEMENT_ERROR. Check if an event can travel downstream. - the event to query @@ -13389,7 +12663,6 @@ call. To be used as the debug argument in #GST_ELEMENT_ERROR. Check if an event is serialized with the data stream. - the event to query @@ -13398,7 +12671,6 @@ call. To be used as the debug argument in #GST_ELEMENT_ERROR. Check if an event is sticky on the pads. - the event to query @@ -13407,7 +12679,6 @@ call. To be used as the debug argument in #GST_ELEMENT_ERROR. Check if an event can travel upstream. - the event to query @@ -13417,7 +12688,6 @@ call. To be used as the debug argument in #GST_ELEMENT_ERROR. when making custom event types, use this macro with the num and the given flags - the event number to create @@ -13428,12 +12698,10 @@ the given flags - The sequence number of @event. - the event to query @@ -13443,7 +12711,6 @@ the given flags Get the #GstClockTime timestamp of the event. This is the time when the event was created. - the event to query @@ -13452,7 +12719,6 @@ was created. Get the #GstEventType of the event. - the event to query @@ -13461,12 +12727,10 @@ was created. The same thing as #GST_EVENT_TYPE_UPSTREAM | #GST_EVENT_TYPE_DOWNSTREAM. - Get a constant string representation of the #GstEventType of the event. - the event to query @@ -13523,10 +12787,8 @@ element with gst_element_set_clock(). Note that clock selection and distribution is normally handled by the toplevel #GstPipeline so the clock functions are only to be used in very specific situations. - Creates an element for handling the given URI. - a new element or %NULL if none could be created @@ -13550,7 +12812,6 @@ could be created Create a new elementfactory capable of instantiating objects of the @type and add the factory to @plugin. - %TRUE, if the registering succeeded, %FALSE on error @@ -13577,7 +12838,6 @@ could be created Gets a string representing the given state change result. - a string with the name of the state result. @@ -13592,7 +12852,6 @@ could be created Gets a string representing the given state. - a string with the name of the state. @@ -13609,7 +12868,6 @@ could be created This function must be called with STATE_LOCK held and is mainly used internally. - the #GstStateChangeReturn of the state transition. @@ -13646,7 +12904,6 @@ This mostly happens for live sources that only produce data in some sink elements might not be able to complete their state change because an element is not producing data to complete the preroll. When setting the element to playing, the preroll will complete and playback will start. - %GST_STATE_CHANGE_SUCCESS if the element has no more pending state and the last state change succeeded, %GST_STATE_CHANGE_ASYNC if the @@ -13688,7 +12945,6 @@ the element is done initializing its pads. This function emits the #GstElement::no-more-pads signal. MT safe. - @@ -13700,7 +12956,6 @@ MT safe. - @@ -13714,7 +12969,6 @@ MT safe. - @@ -13731,7 +12985,6 @@ MT safe. Post a message on the element's #GstBus. This function takes ownership of the message; if you want to access the message after this call, you should add an additional reference before calling. - %TRUE if the message was successfully posted. The function returns %FALSE if the element did not have a bus. @@ -13754,7 +13007,6 @@ MT safe. Get the clock provided by the given element. > An element is only required to provide a clock in the PAUSED > state. Some elements can provide a clock in other states. - the GstClock provided by the element or %NULL if no clock could be provided. Unref after usage. @@ -13777,7 +13029,6 @@ forwards the query to a random srcpad or to the peer of a random linked sinkpad of this element. Please note that some queries might need a running pipeline to work. - %TRUE if the query could be performed. @@ -13796,7 +13047,6 @@ MT safe. - @@ -13815,7 +13065,6 @@ Pad templates can be looked up using gst_element_factory_get_static_pad_templates(). The pad should be released with gst_element_release_request_pad(). - requested #GstPad if found, otherwise %NULL. Release after usage. @@ -13851,7 +13100,6 @@ This function takes ownership of the provided event so you should gst_event_ref() it if you want to reuse the event after this call. MT safe. - %TRUE if the event was handled. Events that trigger a preroll (such as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE. @@ -13873,7 +13121,6 @@ as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE. For internal use only, unless you're testing elements. MT safe. - @@ -13892,7 +13139,6 @@ MT safe. Sets the clock for the element. This function increases the refcount on the clock. Any previously set clock on the object is unreffed. - %TRUE if the element accepted the clock. An element can refuse a clock when it, for example, is not able to slave its internal clock to the @@ -13916,7 +13162,6 @@ MT safe. Sets the context of the element. Increases the refcount of the context. MT safe. - @@ -13945,7 +13190,6 @@ of the state change or it can wait for a %GST_MESSAGE_ASYNC_DONE or State changes to %GST_STATE_READY or %GST_STATE_NULL never return #GST_STATE_CHANGE_ASYNC. - Result of the state change using #GstStateChangeReturn. @@ -13964,7 +13208,6 @@ MT safe. - @@ -13991,7 +13234,6 @@ something is wrong. This function should be called with the STATE_LOCK held. MT safe. - @@ -14012,7 +13254,6 @@ state. The pad and the element should be unlocked when calling this function. This function will emit the #GstElement::pad-added signal on the element. - %TRUE if the pad could be added. This function can fail when a pad with the same name already existed or the pad already had another @@ -14033,7 +13274,6 @@ MT safe. - a watch id, which can be used in connection with gst_element_remove_property_notify_watch() to remove the watch again. @@ -14056,7 +13296,6 @@ MT safe. - a watch id, which can be used in connection with gst_element_remove_property_notify_watch() to remove the watch again. @@ -14089,7 +13328,6 @@ deadlocks in many situations, as they might involve waiting for the streaming thread to shut down from this very streaming thread. MT safe. - @@ -14117,7 +13355,6 @@ MT safe. This function must be called with STATE_LOCK held and is mainly used internally. - the #GstStateChangeReturn of the state transition. @@ -14147,7 +13384,6 @@ This method is used internally and should normally not be called by plugins or applications. This function must be called with STATE_LOCK held. - The result of the commit state change. @@ -14169,7 +13405,6 @@ MT safe. Creates a pad for each pad template that is always available. This function is only useful during object initialization of subclasses of #GstElement. - @@ -14187,7 +13422,6 @@ one of the calls to @func returns %FALSE in which case we will stop iterating pads and return early. If new pads are added or pads are removed while pads are being iterated, this will not be taken into account until next time this function is used. - %FALSE if @element had no pads or if one of the calls to @func returned %FALSE. @@ -14215,7 +13449,6 @@ unless one of the calls to @func returns %FALSE in which case we will stop iterating pads and return early. If new sink pads are added or sink pads are removed while the sink pads are being iterated, this will not be taken into account until next time this function is used. - %FALSE if @element had no sink pads or if one of the calls to @func returned %FALSE. @@ -14243,7 +13476,6 @@ unless one of the calls to @func returns %FALSE in which case we will stop iterating pads and return early. If new source pads are added or source pads are removed while the source pads are being iterated, this will not be taken into account until next time this function is used. - %FALSE if @element had no source pads or if one of the calls to @func returned %FALSE. @@ -14269,7 +13501,6 @@ into account until next time this function is used. absolute time of the clock when this element was last put to PLAYING. Subtracting the base time from the clock time gives the running time of the element. - the base time of the element. @@ -14286,7 +13517,6 @@ MT safe. Returns the bus of the element. Note that only a #GstPipeline will provide a bus for the application. - the element's #GstBus. unref after usage. @@ -14307,7 +13537,6 @@ last set with gst_element_set_clock(). Elements in a pipeline will only have their clock set when the pipeline is in the PLAYING state. - the #GstClock of the element. unref after usage. @@ -14329,7 +13558,6 @@ cases. This function will first attempt to find a compatible unlinked ALWAYS pad, and if none can be found, it will request a compatible REQUEST pad by looking at the templates of @element. - the #GstPad to which a link can be made, or %NULL if one cannot be found. gst_object_unref() @@ -14354,7 +13582,6 @@ at the templates of @element. Retrieves a pad template from @element that is compatible with @compattempl. Pads from compatible templates can be linked together. - a compatible #GstPadTemplate, or %NULL if none was found. No unreferencing is necessary. @@ -14376,7 +13603,6 @@ Pads from compatible templates can be linked together. Gets the context with @context_type set on the element or NULL. MT safe. - A #GstContext or NULL @@ -14394,7 +13620,6 @@ MT safe. Gets the context with @context_type set on the element or NULL. - A #GstContext or NULL @@ -14414,7 +13639,6 @@ MT safe. Gets the contexts set on the element. MT safe. - List of #GstContext @@ -14431,7 +13655,6 @@ MT safe. Returns the current clock time of the element, as in, the time of the element's clock, or GST_CLOCK_TIME_NONE if there is no clock. - the clock time of the element, or GST_CLOCK_TIME_NONE if there is no clock. @@ -14448,7 +13671,6 @@ no clock. Returns the running time of the element. The running time is the element's clock time minus its base time. Will return GST_CLOCK_TIME_NONE if the element has no clock, or if its base time has not been set. - the running time of the element, or GST_CLOCK_TIME_NONE if the element has no clock or its base time has not been set. @@ -14463,7 +13685,6 @@ element has no clock or its base time has not been set. Retrieves the factory that was used to create this element. - the #GstElementFactory used for creating this element or %NULL if element has not been registered (static element). no refcounting is needed. @@ -14478,7 +13699,6 @@ element has no clock or its base time has not been set. Get metadata with @key in @klass. - the metadata for @key. @@ -14496,7 +13716,6 @@ element has no clock or its base time has not been set. Retrieves a padtemplate from @element with the given name. - the #GstPadTemplate with the given name, or %NULL if none was found. No unreferencing is @@ -14517,7 +13736,6 @@ element has no clock or its base time has not been set. Retrieves a list of the pad templates associated with @element. The list must not be modified by the calling code. - the #GList of pad templates. @@ -14540,7 +13758,6 @@ gst_element_release_request_pad(). This method is slower than manually getting the pad template and calling gst_element_request_pad() if the pads should have a specific name (e.g. @name is "src_1" instead of "src_\%u"). - requested #GstPad if found, otherwise %NULL. Release after usage. @@ -14565,7 +13782,6 @@ Usually the start_time is managed by a toplevel element such as #GstPipeline. MT safe. - the start time of the element. @@ -14598,7 +13814,6 @@ This mostly happens for live sources that only produce data in some sink elements might not be able to complete their state change because an element is not producing data to complete the preroll. When setting the element to playing, the preroll will complete and playback will start. - %GST_STATE_CHANGE_SUCCESS if the element has no more pending state and the last state change succeeded, %GST_STATE_CHANGE_ASYNC if the @@ -14633,7 +13848,6 @@ MT safe. Retrieves a pad from @element by name. This version only retrieves already-existing (i.e. 'static') pads. - the requested #GstPad if found, otherwise %NULL. unref after usage. @@ -14660,7 +13874,6 @@ This way you can leave currently unused elements inside bins. Just lock their state before changing the state from #GST_STATE_NULL. MT safe. - %TRUE, if the element's state is locked. @@ -14679,7 +13892,6 @@ gst_element_iterate_src_pads() or gst_element_iterate_sink_pads(). The order of pads returned by the iterator will be the order in which the pads were added to the element. - the #GstIterator of #GstPad. @@ -14698,7 +13910,6 @@ MT safe. The order of pads returned by the iterator will be the order in which the pads were added to the element. - the #GstIterator of #GstPad. @@ -14717,7 +13928,6 @@ MT safe. The order of pads returned by the iterator will be the order in which the pads were added to the element. - the #GstIterator of #GstPad. @@ -14740,7 +13950,6 @@ If multiple links are possible, only one is established. Make sure you have added your elements to a bin or pipeline with gst_bin_add() before trying to link them. - %TRUE if the elements could be linked, %FALSE otherwise. @@ -14765,7 +13974,6 @@ If multiple links are possible, only one is established. Make sure you have added your elements to a bin or pipeline with gst_bin_add() before trying to link them. - %TRUE if the pads could be linked, %FALSE otherwise. @@ -14790,7 +13998,6 @@ gst_bin_add() before trying to link them. Chain together a series of elements. Uses gst_element_link(). Make sure you have added your elements to a bin or pipeline with gst_bin_add() before trying to link them. - %TRUE on success, %FALSE otherwise. @@ -14815,7 +14022,6 @@ gst_bin_add() before trying to link them. Side effect is that if one of the pads has no parent, it becomes a child of the parent of the other element. If they have different parents, the link fails. - %TRUE if the pads could be linked, %FALSE otherwise. @@ -14846,7 +14052,6 @@ or %NULL for any pad. is that if one of the pads has no parent, it becomes a child of the parent of the other element. If they have different parents, the link fails. If @caps is not %NULL, makes sure that the caps of the link is a subset of @caps. - %TRUE if the pads could be linked, %FALSE otherwise. @@ -14888,7 +14093,6 @@ is the same as calling gst_element_link_pads() and the recommended way of linking pads with safety checks applied. This is a convenience function for gst_pad_link_full(). - %TRUE if the pads could be linked, %FALSE otherwise. @@ -14935,7 +14139,6 @@ not in error or an async state change. This function is used internally and should normally not be called from plugins or applications. - @@ -14953,7 +14156,6 @@ plugins or applications. #GST_MESSAGE_INFO. MT safe. - @@ -15005,7 +14207,6 @@ MT safe. @type must be of #GST_MESSAGE_ERROR, #GST_MESSAGE_WARNING or #GST_MESSAGE_INFO. - @@ -15066,7 +14267,6 @@ the element is done initializing its pads. This function emits the #GstElement::no-more-pads signal. MT safe. - @@ -15081,7 +14281,6 @@ MT safe. Post a message on the element's #GstBus. This function takes ownership of the message; if you want to access the message after this call, you should add an additional reference before calling. - %TRUE if the message was successfully posted. The function returns %FALSE if the element did not have a bus. @@ -15104,7 +14303,6 @@ MT safe. Get the clock provided by the given element. > An element is only required to provide a clock in the PAUSED > state. Some elements can provide a clock in other states. - the GstClock provided by the element or %NULL if no clock could be provided. Unref after usage. @@ -15127,7 +14325,6 @@ forwards the query to a random srcpad or to the peer of a random linked sinkpad of this element. Please note that some queries might need a running pipeline to work. - %TRUE if the query could be performed. @@ -15147,7 +14344,6 @@ MT safe. Queries an element to convert @src_val in @src_format to @dest_format. - %TRUE if the query could be performed. @@ -15184,7 +14380,6 @@ will receive an ASYNC_DONE message on the pipeline bus when that is the case. If the duration changes for some reason, you will get a DURATION_CHANGED message on the pipeline bus, in which case you should re-query the duration using this function. - %TRUE if the query could be performed. @@ -15214,7 +14409,6 @@ bus when that is the case. If one repeatedly calls this function one can also create a query and reuse it in gst_element_query(). - %TRUE if the query could be performed. @@ -15244,7 +14438,6 @@ gst_element_request_pad(), gst_element_release_request_pad() needs to be followed by gst_object_unref() to free the @pad. MT safe. - @@ -15276,7 +14469,6 @@ deactivating pads. The pad and the element should be unlocked when calling this function. This function will emit the #GstElement::pad-removed signal on the element. - %TRUE if the pad could be removed. Can return %FALSE if the pad does not belong to the provided element. @@ -15296,7 +14488,6 @@ MT safe. - @@ -15317,7 +14508,6 @@ Pad templates can be looked up using gst_element_factory_get_static_pad_templates(). The pad should be released with gst_element_release_request_pad(). - requested #GstPad if found, otherwise %NULL. Release after usage. @@ -15350,7 +14540,6 @@ the parameters. The seek event is sent to the element using gst_element_send_event(). MT safe. - %TRUE if the event was handled. Flushing seeks will trigger a preroll, which will emit %GST_MESSAGE_ASYNC_DONE. @@ -15406,7 +14595,6 @@ Some elements allow for seeking in the READY state, in this case they will store the seek event and execute it when they are put to PAUSED. If the element supports seek in READY, it will always return %TRUE when it receives the event in the READY state. - %TRUE if the seek operation succeeded. Flushing seeks will trigger a preroll, which will emit %GST_MESSAGE_ASYNC_DONE. @@ -15444,7 +14632,6 @@ This function takes ownership of the provided event so you should gst_event_ref() it if you want to reuse the event after this call. MT safe. - %TRUE if the event was handled. Events that trigger a preroll (such as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE. @@ -15465,7 +14652,6 @@ as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE. Set the base time of an element. See gst_element_get_base_time(). MT safe. - @@ -15485,7 +14671,6 @@ MT safe. For internal use only, unless you're testing elements. MT safe. - @@ -15504,7 +14689,6 @@ MT safe. Sets the clock for the element. This function increases the refcount on the clock. Any previously set clock on the object is unreffed. - %TRUE if the element accepted the clock. An element can refuse a clock when it, for example, is not able to slave its internal clock to the @@ -15528,7 +14712,6 @@ MT safe. Sets the context of the element. Increases the refcount of the context. MT safe. - @@ -15552,7 +14735,6 @@ The parent bin might've just checked the flag in another thread and as the next step proceed to change the child element's state. MT safe. - %TRUE if the state was changed, %FALSE if bad parameters were given or the elements state-locking needed no change. @@ -15582,7 +14764,6 @@ itself, for example if you want to synchronize capture from multiple pipelines, and you can also ensure that the pipelines have the same clock. MT safe. - @@ -15611,7 +14792,6 @@ of the state change or it can wait for a %GST_MESSAGE_ASYNC_DONE or State changes to %GST_STATE_READY or %GST_STATE_NULL never return #GST_STATE_CHANGE_ASYNC. - Result of the state change using #GstStateChangeReturn. @@ -15632,7 +14812,6 @@ MT safe. Tries to change the state of the element to the same as its parent. If this function returns %FALSE, the state of element is undefined. - %TRUE, if the element's state could be synced to the parent's state. @@ -15652,7 +14831,6 @@ of the sink element to which they are linked. If the link has been made using gst_element_link(), it could have created an requestpad, which has to be released using gst_element_release_request_pad(). - @@ -15669,7 +14847,6 @@ requestpad, which has to be released using gst_element_release_request_pad(). Unlinks a series of elements. Uses gst_element_unlink(). - @@ -15692,7 +14869,6 @@ requestpad, which has to be released using gst_element_release_request_pad().Unlinks the two named pads of the source and destination elements. This is a convenience function for gst_pad_unlink(). - @@ -15857,7 +15033,6 @@ gst_element_set_state() or gst_element_sync_state_with_parent(). Callback prototype used in #gst_element_call_async - @@ -15875,7 +15050,6 @@ gst_element_set_state() or gst_element_sync_state_with_parent(). GStreamer element class. Override the vmethods to implement the element functionality. - the parent class structure @@ -15904,7 +15078,6 @@ functionality. - @@ -15920,7 +15093,6 @@ functionality. - @@ -15936,7 +15108,6 @@ functionality. - @@ -15950,7 +15121,6 @@ functionality. - requested #GstPad if found, otherwise %NULL. Release after usage. @@ -15980,7 +15150,6 @@ request. Can be %NULL. - @@ -15996,7 +15165,6 @@ request. Can be %NULL. - %GST_STATE_CHANGE_SUCCESS if the element has no more pending state and the last state change succeeded, %GST_STATE_CHANGE_ASYNC if the @@ -16031,7 +15199,6 @@ MT safe. - Result of the state change using #GstStateChangeReturn. @@ -16052,7 +15219,6 @@ MT safe. - the #GstStateChangeReturn of the state transition. @@ -16071,7 +15237,6 @@ MT safe. - @@ -16093,7 +15258,6 @@ MT safe. - @@ -16111,7 +15275,6 @@ MT safe. - the GstClock provided by the element or %NULL if no clock could be provided. Unref after usage. @@ -16129,7 +15292,6 @@ MT safe. - %TRUE if the element accepted the clock. An element can refuse a clock when it, for example, is not able to slave its internal clock to the @@ -16152,7 +15314,6 @@ MT safe. - %TRUE if the event was handled. Events that trigger a preroll (such as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE. @@ -16172,7 +15333,6 @@ as flushing seeks and steps) will emit %GST_MESSAGE_ASYNC_DONE. - %TRUE if the query could be performed. @@ -16193,7 +15353,6 @@ MT safe. - %TRUE if the message was successfully posted. The function returns %FALSE if the element did not have a bus. @@ -16215,7 +15374,6 @@ MT safe. - @@ -16238,7 +15396,6 @@ MT safe. Set @key with @value as metadata in @klass. - @@ -16264,7 +15421,6 @@ existing one is added the old one is replaced by the new one. @templ's reference count will be incremented, and any floating reference will be removed (see gst_object_ref_sink()) - @@ -16286,7 +15442,6 @@ Same as gst_element_class_add_metadata(), but @value must be a static string or an inlined string, as it will not be copied. (GStreamer plugins will be made resident once loaded, so this function can be used even from dynamically loaded plugins.) - @@ -16310,7 +15465,6 @@ dynamically loaded plugins.) @templ. This is mainly used in the _class_init functions of element implementations. If a pad template with the same name already exists, the old one is replaced by the new one. - @@ -16330,7 +15484,6 @@ the old one is replaced by the new one. @templ. This is mainly used in the _class_init functions of element implementations. If a pad template with the same name already exists, the old one is replaced by the new one. - @@ -16351,7 +15504,6 @@ the old one is replaced by the new one. Get metadata with @key in @klass. - the metadata for @key. @@ -16372,7 +15524,6 @@ the old one is replaced by the new one. > If you use this function in the #GInstanceInitFunc of an object class > that has subclasses, make sure to pass the g_class parameter of the > #GInstanceInitFunc here. - the #GstPadTemplate with the given name, or %NULL if none was found. No unreferencing is @@ -16396,7 +15547,6 @@ list must not be modified by the calling code. > If you use this function in the #GInstanceInitFunc of an object class > that has subclasses, make sure to pass the g_class parameter of the > #GInstanceInitFunc here. - the #GList of pad templates. @@ -16414,7 +15564,6 @@ list must not be modified by the calling code. Sets the detailed information for a #GstElementClass. > This function is for use in _class_init functions only. - @@ -16454,7 +15603,6 @@ Same as gst_element_class_set_metadata(), but @longname, @classification, @description, and @author must be static strings or inlined strings, as they will not be copied. (GStreamer plugins will be made resident once loaded, so this function can be used even from dynamically loaded plugins.) - @@ -16512,11 +15660,9 @@ The following code example shows you how to create a GstFileSrc element. g_return_if_fail (src != NULL); ... ]| - Search for an element factory of the given name. Refs the returned element factory; caller is responsible for unreffing. - #GstElementFactory if found, %NULL otherwise @@ -16536,7 +15682,6 @@ the given direction. If @subsetonly is %TRUE, then only the elements whose pads templates are a complete superset of @caps will be returned. Else any element whose pad templates caps can intersect with @caps will be returned. - a #GList of #GstElementFactory elements that match the given requisites. @@ -16571,7 +15716,6 @@ whose pad templates caps can intersect with @caps will be returned. Get a list of factories that match the given @type. Only elements with a rank greater or equal to @minrank will be returned. The list of factories is returned by decreasing rank. - a #GList of #GstElementFactory elements. Use gst_plugin_feature_list_free() after @@ -16596,7 +15740,6 @@ The list of factories is returned by decreasing rank. If name is %NULL, then the element will receive a guaranteed unique name, consisting of the element factory name and a number. If name is given, it will be given the name supplied. - new #GstElement or %NULL if unable to create element @@ -16616,7 +15759,6 @@ if unable to create element Checks if the factory can sink all possible capabilities. - %TRUE if the caps are fully compatible. @@ -16634,7 +15776,6 @@ if unable to create element Checks if the factory can sink any possible capability. - %TRUE if the caps have a common subset. @@ -16652,7 +15793,6 @@ if unable to create element Checks if the factory can src all possible capabilities. - %TRUE if the caps are fully compatible. @@ -16670,7 +15810,6 @@ if unable to create element Checks if the factory can src any possible capability. - %TRUE if the caps have a common subset. @@ -16690,7 +15829,6 @@ if unable to create element Create a new element of the type defined by the given elementfactory. It will be given the name supplied, since all elements require a name as their first argument. - new #GstElement or %NULL if the element couldn't be created @@ -16712,7 +15850,6 @@ their first argument. Get the #GType for elements managed by this factory. The type can only be retrieved if the element factory is loaded, which can be assured with gst_plugin_feature_load(). - the #GType for elements managed by this factory or 0 if the factory is not loaded. @@ -16727,7 +15864,6 @@ the factory is not loaded. Get the metadata on @factory with @key. - the metadata with @key on @factory or %NULL when there was no metadata with the given @key. @@ -16746,7 +15882,6 @@ when there was no metadata with the given @key. Get the available keys for the metadata on @factory. - a %NULL-terminated array of key strings, or %NULL when there is no @@ -16764,7 +15899,6 @@ metadata. Free with g_strfreev() when no longer needed. Gets the number of pad_templates in this factory. - the number of pad_templates @@ -16778,7 +15912,6 @@ metadata. Free with g_strfreev() when no longer needed. Gets the #GList of #GstStaticPadTemplate for this factory. - the static pad templates @@ -16798,7 +15931,6 @@ metadata. Free with g_strfreev() when no longer needed. no protocols are supported. You may not change the contents of the returned array, as it is still owned by the element factory. Use g_strdupv() to make a copy of the protocol string array if you need to. - the supported protocols or %NULL @@ -16815,7 +15947,6 @@ make a copy of the protocol string array if you need to. Gets the type of URIs the element supports or #GST_URI_UNKNOWN if none. - type of URIs this element supports @@ -16829,7 +15960,6 @@ make a copy of the protocol string array if you need to. Check if @factory implements the interface with name @interfacename. - %TRUE when @factory implement the interface. @@ -16847,7 +15977,6 @@ make a copy of the protocol string array if you need to. Check if @factory is of the given types. - %TRUE if @factory is of @type. @@ -16864,9 +15993,7 @@ make a copy of the protocol string array if you need to. - - - + The standard flags that an element may have. @@ -16894,7 +16021,6 @@ make a copy of the protocol string array if you need to. Function called for each pad when using gst_element_foreach_sink_pad(), gst_element_foreach_src_pad(), or gst_element_foreach_pad(). - %FALSE to stop iterating pads, %TRUE to continue @@ -16956,7 +16082,6 @@ the needed parameters to specify seeking time and mode. g_warning ("seek failed"); ... ]| - the parent structure @@ -16978,7 +16103,6 @@ the needed parameters to specify seeking time and mode. elements that they should provide a buffer of the specified dimensions. When the @async flag is set, a thread boundary is preferred. - a new #GstEvent @@ -17006,7 +16130,6 @@ When the @async flag is set, a thread boundary is preferred. Create a new CAPS event for @caps. The caps event can only travel downstream synchronized with the buffer flow and contains the format of the buffers that will follow after the event. - the new CAPS event. @@ -17029,7 +16152,6 @@ serialization flags. New custom events can also be created by subclassing the event type if needed. - the new custom event. @@ -17060,7 +16182,6 @@ When all sinks have posted an EOS message, an EOS message is forwarded to the application. The EOS event itself will not cause any state transitions of the pipeline. - the new EOS event. @@ -17081,7 +16202,6 @@ functions as fast as possible when this event is received. This event is typically generated after a seek to flush out all queued data in the pipeline so that the new media is played as soon as possible. - a new flush start event. @@ -17098,7 +16218,6 @@ the preceding FLUSH_START event stopped the dataflow. This event is typically generated to complete a seek and to resume dataflow. - a new flush stop event. @@ -17116,7 +16235,6 @@ equivalent to a buffer to signal that there is no data for a certain amount of time. This is useful to signal a gap to downstream elements which may wait for data, such as muxers or mixers or overlays, especially for sparse streams such as subtitle streams. - the new GAP event. @@ -17142,7 +16260,6 @@ by the @rate_multiplier factor. The flags provided replace any flags in the existing segment, for the flags within the %GST_SEGMENT_INSTANT_FLAGS set. Other GstSegmentFlags are ignored and not transferred in the event. - the new instant-rate-change event. @@ -17171,7 +16288,6 @@ The @running_time and @upstream_running_time are the same if this is the first instant-rate adjustment, but will differ for later ones to compensate for the accumulated offset due to playing at a rate different to the one indicated in the playback segments. - the new instant-rate-sync-time event. @@ -17199,7 +16315,6 @@ running time before synchronising against the clock. The latency is mostly used in live sinks and is always expressed in the time format. - a new #GstEvent @@ -17213,7 +16328,6 @@ the time format. Create a new navigation event from the given description. - a new #GstEvent @@ -17256,7 +16370,6 @@ The events returned by gst_event_new_protection() are implemented in such a way as to ensure that the most recently-pushed protection info event of a particular @origin and @system_id will be stuck to the output pad of the sending element. - a #GST_EVENT_PROTECTION event, if successful; %NULL if unsuccessful. @@ -17324,7 +16437,6 @@ result smaller than 0 is not allowed. The application can use general event probes to intercept the QoS event and implement custom application specific QoS handling. - a new QOS event. @@ -17353,7 +16465,6 @@ event and implement custom application specific QoS handling. to travel upstream and make elements renegotiate their caps or reconfigure their buffer pools. This is useful when changing properties on elements or changing the topology of the pipeline. - a new #GstEvent @@ -17391,7 +16502,6 @@ It is not possible to seek relative to the current playback position, to do this, PAUSE the pipeline, query the current playback position with #GST_QUERY_POSITION and update the playback segment current position with a #GST_SEEK_TYPE_SET to the desired position. - a new seek event. @@ -17459,7 +16569,6 @@ with @rate of 1.0 and @applied_rate of 2.0 After a segment event, the buffer stream time is calculated with: time + (TIMESTAMP(buf) - start) * ABS (rate * applied_rate) - the new SEGMENT event. @@ -17474,7 +16583,6 @@ After a segment event, the buffer stream time is calculated with: Create a new segment-done event. This event is sent by elements that finish playback of a segment as a result of a segment seek. - a new #GstEvent @@ -17501,7 +16609,6 @@ in #GST_EVENT_STREAM_START, #GST_EVENT_STREAM_COLLECTION or #GST_MESSAGE_STREAM_COLLECTION. Note: The list of @streams can not be empty. - a new select-streams event or %NULL in case of an error (like an empty streams list). @@ -17523,7 +16630,6 @@ to instruct a sink to post the message contained in the event synchronized with the stream. @name is used to store multiple sticky events on one pad. - a new #GstEvent @@ -17553,7 +16659,6 @@ the step operation. The @intermediate flag instructs the pipeline that this step operation is part of a larger step operation. - a new #GstEvent @@ -17590,7 +16695,6 @@ of streams and post #GstStreamCollection messages on the bus also send this event downstream on each pad involved in the collection, so that activation of a new collection can be tracked through the downstream data flow. - the new STREAM_COLLECTION event. @@ -17612,7 +16716,6 @@ arriving and unblock, since there won't be any more data. This event is followed by EOS at some point in the future, and is generally used when switching pads - to unblock downstream so that new pads can be exposed before sending EOS on the existing pads. - the new stream-group-done event. @@ -17646,7 +16749,6 @@ used to create a stream-id. There are no particular semantics for the stream-id, though it should be deterministic (to support stream matching) and it might be used to order streams (besides any information conveyed by stream flags). - the new STREAM_START event. @@ -17666,7 +16768,6 @@ complete medium or only to this specific stream. As the tag event is a sticky event, elements should merge tags received from upstream with a given scope with their own tags with the same scope and create a new tag event from it. - a new #GstEvent @@ -17682,7 +16783,6 @@ scope and create a new tag event from it. Generate a TOC event from the given @toc. The purpose of the TOC event is to inform elements that some kind of the TOC was found. - a new #GstEvent. @@ -17702,7 +16802,6 @@ inform elements that some kind of the TOC was found. Generate a TOC select event with the given @uid. The purpose of the TOC select event is to start playback based on the TOC's entry with the given @uid. - a new #GstEvent. @@ -17716,7 +16815,6 @@ given @uid. Copy the event using the event specific copy function. - the new event @@ -17731,7 +16829,6 @@ given @uid. Parses a segment @event and copies the #GstSegment into the location given by @segment. - @@ -17756,7 +16853,6 @@ adjusted according to the pad's offset. If the event contains any information that related to the running time, this information will need to be updated before usage with this offset. - The event's running time offset @@ -17783,7 +16879,6 @@ required. Note that events and messages share the same sequence number incrementor; two events or messages will never have the same sequence number unless that correspondence was made explicitly. - The event's sequence number. @@ -17799,7 +16894,6 @@ MT safe. Access the structure of the event. - The structure of the event. The structure is still owned by the event, which means that you should not free @@ -17818,7 +16912,6 @@ MT safe. Checks if @event has the given @name. This function is usually used to check the name of a custom event. - %TRUE if @name matches the name of the event structure. @@ -17837,7 +16930,6 @@ check the name of a custom event. Checks if @event has the given @name. This function is usually used to check the name of a custom event. - %TRUE if @name matches the name of the event structure. @@ -17855,7 +16947,6 @@ check the name of a custom event. Get the format, minsize, maxsize and async-flag in the buffersize event. - @@ -17885,7 +16976,6 @@ check the name of a custom event. Get the caps from @event. The caps remains valid as long as @event remains valid. - @@ -17902,7 +16992,6 @@ valid. Parse the FLUSH_STOP event and retrieve the @reset_time member. - @@ -17919,7 +17008,6 @@ valid. Extract timestamp and duration from a new GAP event. - @@ -17941,7 +17029,6 @@ valid. - %TRUE if a group id was set on the event and could be parsed, %FALSE otherwise. @@ -17960,7 +17047,6 @@ valid. Extract rate and flags from an instant-rate-change event. - @@ -17983,7 +17069,6 @@ valid. Extract the rate multiplier and running times from an instant-rate-sync-time event. - @@ -18011,7 +17096,6 @@ valid. Get the latency in the latency event. - @@ -18030,7 +17114,6 @@ valid. Parses an event containing protection system specific information and stores the results in @system_id, @data and @origin. The data stored in @system_id, @origin and @data are valid until @event is released. - @@ -18062,7 +17145,6 @@ from. gst_event_new_qos() for more information about the different QoS values. @timestamp will be adjusted for any pad offsets of pads it was passing through. - @@ -18091,7 +17173,6 @@ gst_event_new_qos() for more information about the different QoS values. Parses a seek @event and stores the results in the given result locations. - @@ -18133,7 +17214,6 @@ gst_event_new_qos() for more information about the different QoS values. Retrieve the trickmode interval that may have been set on a seek event with gst_event_set_seek_trickmode_interval(). - @@ -18150,7 +17230,6 @@ seek event with gst_event_set_seek_trickmode_interval(). Parses a segment @event and stores the result in the given @segment location. @segment remains valid only until the @event is freed. Don't modify the segment and make a copy if you want to modify it or store it for later use. - @@ -18167,7 +17246,6 @@ and make a copy if you want to modify it or store it for later use. Extracts the position and format from the segment done message. - @@ -18188,7 +17266,6 @@ and make a copy if you want to modify it or store it for later use. Parse the SELECT_STREAMS event and retrieve the contained streams. - @@ -18207,7 +17284,6 @@ and make a copy if you want to modify it or store it for later use. Parse the sink-message event. Unref @msg after usage. - @@ -18224,7 +17300,6 @@ and make a copy if you want to modify it or store it for later use. Parse the step event. - @@ -18258,7 +17333,6 @@ and make a copy if you want to modify it or store it for later use. Parse a stream-start @event and extract the #GstStream from it. - @@ -18275,7 +17349,6 @@ and make a copy if you want to modify it or store it for later use. Retrieve new #GstStreamCollection from STREAM_COLLECTION event @event. - @@ -18291,7 +17364,6 @@ and make a copy if you want to modify it or store it for later use. - @@ -18309,7 +17381,6 @@ and make a copy if you want to modify it or store it for later use. Parse a stream-group-done @event and store the result in the given @group_id location. - @@ -18329,7 +17400,6 @@ and make a copy if you want to modify it or store it for later use. location. The string stored in @stream_id must not be modified and will remain valid only until @event gets freed. Make a copy if you want to modify it or store it for later use. - @@ -18349,7 +17419,6 @@ modify it or store it for later use. No reference to the taglist will be returned, it remains valid only until the @event is freed. Don't modify or free the taglist, make a copy if you want to modify it or store it for later use. - @@ -18366,7 +17435,6 @@ want to modify it or store it for later use. Parse a TOC @event and store the results in the given @toc and @updated locations. - @@ -18387,7 +17455,6 @@ want to modify it or store it for later use. Parse a TOC select @event and store the results in the given @uid location. - @@ -18404,7 +17471,6 @@ want to modify it or store it for later use. Increase the refcount of this event. - @event (for convenience when doing assignments) @@ -18424,7 +17490,6 @@ each time the stream is started, resulting in different group ids each time a file is played for example. Use gst_util_group_id_next() to get a new group id. - @@ -18444,7 +17509,6 @@ Use gst_util_group_id_next() to get a new group id. gst_event_get_running_time_offset() for more information. MT safe. - @@ -18463,7 +17527,6 @@ MT safe. Sets a trickmode interval on a (writable) seek event. Elements that support TRICKMODE_KEY_UNITS seeks SHOULD use this as the minimal interval between each frame they may output. - @@ -18484,7 +17547,6 @@ event relates to other events or messages. See gst_event_get_seqnum() for more information. MT safe. - @@ -18501,7 +17563,6 @@ MT safe. Set the @stream on the stream-start @event - @@ -18517,7 +17578,6 @@ MT safe. - @@ -18534,7 +17594,6 @@ MT safe. Decrease the refcount of an event, freeing it if the refcount reaches 0. - @@ -18547,7 +17606,6 @@ MT safe. Get a writable version of the structure. - The structure of the event. The structure is still owned by the event, which means that you should not free @@ -18572,7 +17630,6 @@ in some cases), and the reference counts are updated appropriately (the old event is unreffed, the new one is reffed). Either @new_event or the #GstEvent pointed to by @old_event may be %NULL. - %TRUE if @new_event was different from @old_event @@ -18593,7 +17650,6 @@ Either @new_event or the #GstEvent pointed to by @old_event may be %NULL. Atomically replace the #GstEvent pointed to by @old_event with %NULL and return the original event. - the #GstEvent that was in @old_event @@ -18612,7 +17668,6 @@ function is similar to gst_event_replace() except that it takes ownership of @new_event. Either @new_event or the #GstEvent pointed to by @old_event may be %NULL. - %TRUE if @new_event was different from @old_event @@ -18765,7 +17820,6 @@ Specific custom events are distinguished by the name of the structure. Gets the #GstEventTypeFlags associated with @type. - a #GstEventTypeFlags. @@ -18779,7 +17833,6 @@ Specific custom events are distinguished by the name of the structure. Get a printable name for the given event type. Do not modify or free. - a reference to the static name of the event. @@ -18793,7 +17846,6 @@ Specific custom events are distinguished by the name of the structure. Get the unique quark for the given event type. - the quark associated with the event type @@ -18832,24 +17884,20 @@ gst_event_type_get_flags() function. A mask value with all bits set, for use as a GstFlagSet mask where all flag bits must match exactly - The PERCENT format is between 0 and this value - The value used to scale down the reported PERCENT format value to its real value. - Can be used together with #GST_FOURCC_FORMAT to properly output a #guint32 fourcc value in a printf\()-style text message. - a #guint32 fourcc value to output @@ -18863,7 +17911,6 @@ its real value. |[ printf ("fourcc: %" GST_FOURCC_FORMAT "\n", GST_FOURCC_ARGS (fcc)); ]| - @@ -18873,7 +17920,6 @@ mask indicating which of the bits in the field are explicitly set. Create a new sub-class of #GST_TYPE_FLAG_SET which will pretty-print the human-readable flags when serializing, for easier debugging. - @@ -18966,7 +18012,6 @@ element scope. Return the format registered with the given nick. - The format with @nick or GST_FORMAT_UNDEFINED if the format was not registered. @@ -18981,7 +18026,6 @@ if the format was not registered. Get details about the given format. - The #GstFormatDefinition for @format or %NULL on failure. @@ -18998,7 +18042,6 @@ MT safe. Get a printable name for the given format. Do not modify or free. - a reference to the static name of the format or %NULL if the format is unknown. @@ -19014,7 +18057,6 @@ or %NULL if the format is unknown. Iterate all the registered formats. The format definition is read only. - a GstIterator of #GstFormatDefinition. @@ -19023,7 +18065,6 @@ only. Create a new GstFormat based on the nick or return an already registered format with that nick. - A new GstFormat or an already registered format with the same nick. @@ -19044,7 +18085,6 @@ MT safe. Get the unique quark for the given format. - the quark associated with the format or 0 if the format is unknown. @@ -19060,7 +18100,6 @@ is unknown. A format definition - The unique id of this format @@ -19086,21 +18125,18 @@ over an integer denominator A fundamental type that describes a #GstFractionRange range - - - @@ -19111,7 +18147,6 @@ over an integer denominator gst_util_group_id_next(). Can be used as a default value in variables used to store group_id. - @@ -19128,13 +18163,11 @@ to create the ghost-pad and use gst_ghost_pad_set_target() to establish the association later on. Note that GhostPads add overhead to the data processing of a pipeline. - Create a new ghostpad with @target as the target. The direction will be taken from the target pad. @target must be unlinked. Will ref the target. - a new #GstPad, or %NULL in case of an error. @@ -19156,7 +18189,6 @@ case of an error. from the target pad. The template used on the ghostpad will be @template. Will ref the target. - a new #GstPad, or %NULL in case of an error. @@ -19183,7 +18215,6 @@ A target can be set on the ghostpad later with the gst_ghost_pad_set_target() function. The created ghostpad will not have a padtemplate. - a new #GstPad, or %NULL in case of an error. @@ -19203,7 +18234,6 @@ case of an error. Create a new ghostpad based on @templ, without setting a target. The direction will be taken from the @templ. - a new #GstPad, or %NULL in case of an error. @@ -19222,7 +18252,6 @@ case of an error. Invoke the default activate mode function of a ghost pad. - %TRUE if the operation was successful. @@ -19249,7 +18278,6 @@ case of an error. Invoke the default activate mode function of a proxy pad that is owned by a ghost pad. - %TRUE if the operation was successful. @@ -19282,7 +18310,6 @@ function. Call this function directly after a call to g_object_new (GST_TYPE_GHOST_PAD, "direction", @dir, ..., NULL). This function is deprecated since 1.18 and does nothing anymore. - %TRUE if the construction succeeds, %FALSE otherwise. @@ -19296,7 +18323,6 @@ anymore. Get the target pad of @gpad. Unref target pad after usage. - the target #GstPad, can be %NULL if the ghostpad has no target set. Unref target pad after @@ -19314,7 +18340,6 @@ usage. Set the new target of the ghostpad @gpad. Any existing target is unlinked and links to the new target are established. if @newtarget is %NULL the target will be cleared. - %TRUE if the new target could be set. This function can return %FALSE when the internal pads could not be linked. @@ -19339,7 +18364,6 @@ is unlinked and links to the new target are established. if @newtarget is - @@ -19349,277 +18373,236 @@ is unlinked and links to the new target are established. if @newtarget is - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -19628,315 +18611,270 @@ is unlinked and links to the new target are established. if @newtarget is - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -19944,7 +18882,6 @@ is unlinked and links to the new target are established. if @newtarget is Macro to cast to a #GstIterator - the #GstIterator value @@ -19958,7 +18895,6 @@ was created. Whenever the iterator is iterated, the value is compared to the value of the master cookie. If they are different, a concurrent modification happened to the iterator and a resync is needed. - the #GstIterator to get the cookie of @@ -19967,7 +18903,6 @@ modification happened to the iterator and a resync is needed. Macro to get the lock protecting the datastructure being iterated. - the #GstIterator to get the lock of @@ -19978,7 +18913,6 @@ modification happened to the iterator and a resync is needed. Macro to get a pointer to where the master cookie is stored. The master cookie protects the structure being iterated and gets updated whenever the datastructure changes. - the #GstIterator to get the master cookie of @@ -20030,7 +18964,6 @@ The basic use pattern of an iterator is as follows: g_value_unset (&amp;item); gst_iterator_free (it); ]| - The function to copy the iterator @@ -20087,7 +19020,6 @@ implementing the next/resync/free function to iterate a data structure. For each item retrieved, the @item function is called with the lock held. The @free function is called when the iterator is freed. - the new #GstIterator. @@ -20147,7 +19079,6 @@ When a concurrent update to the list is performed, usually by @owner while holding @lock, @master_cookie will be updated. The iterator implementation will notice the update of the cookie and will return %GST_ITERATOR_RESYNC to the user of the iterator in the next call to gst_iterator_next(). - the new #GstIterator for @list. @@ -20189,7 +19120,6 @@ MT safe. case where a #GstIterator needs to be returned but only a single object has to be considered. This happens often for the #GstPadIterIntLinkFunction. - the new #GstIterator for @object. @@ -20207,7 +19137,6 @@ for the #GstPadIterIntLinkFunction. Copy the iterator and its state. - a new copy of @it. @@ -20227,7 +19156,6 @@ iterator element and the second parameter is @user_data. @func should return 0 for elements that should be included in the filtered iterator. When this iterator is freed, @it will also be freed. - a new #GstIterator. @@ -20260,7 +19188,6 @@ The iterator will not be freed. This function will return %FALSE if an error happened to the iterator or if the element wasn't found. - Returns %TRUE if the element was found, else %FALSE. @@ -20302,7 +19229,6 @@ will cause fold to return %GST_ITERATOR_ERROR or %GST_ITERATOR_RESYNC as appropriate. The iterator will not be freed. - A #GstIteratorResult, as described above. @@ -20331,7 +19257,6 @@ MT safe. Iterate over all element of @it and call the given function @func for each element. - the result call to gst_iterator_fold(). The iterator will not be freed. @@ -20358,7 +19283,6 @@ MT safe. Free the iterator. MT safe. - @@ -20386,7 +19310,6 @@ concurrently updated. The user of @it should call gst_iterator_resync() to get the newly updated list. A return value of %GST_ITERATOR_ERROR indicates an unrecoverable fatal error. - The result of the iteration. Unset @elem after usage. @@ -20416,7 +19339,6 @@ When gst_iterator_resync() is called on @it, @other will automatically be popped. MT safe. - @@ -20439,7 +19361,6 @@ When an iterator was pushed on @it, it will automatically be popped again with this function. MT safe. - @@ -20455,7 +19376,6 @@ MT safe. This function will be called when creating a copy of @it and should create a copy of all custom iterator fields or increase their reference counts. - @@ -20472,7 +19392,6 @@ reference counts. A function to be passed to gst_iterator_fold(). - %TRUE if the fold should continue, %FALSE if it should stop. @@ -20494,7 +19413,6 @@ reference counts. A function that is called by gst_iterator_foreach() for every element. - @@ -20515,7 +19433,6 @@ reference counts. Implementors of a #GstIterator should implement this function and pass it to the constructor of the custom iterator. The function will be called with the iterator lock held. - @@ -20544,7 +19461,6 @@ has been retrieved. This function can be used to skip items or stop the iterator. The function will be called with the iterator lock held. - the result of the operation. @@ -20567,7 +19483,6 @@ should be retrieved. Implementors of a #GstIterator should implement this function and pass it to the constructor of the custom iterator. The function will be called with the iterator lock held. - the result of the operation. @@ -20607,7 +19522,6 @@ have. Implementors of a #GstIterator should implement this function and pass it to the constructor of the custom iterator. The function will be called with the iterator lock held. - @@ -20620,12 +19534,10 @@ The function will be called with the iterator lock held. To be used in GST_PLUGIN_DEFINE if unsure about the licence. - GstLockFlags value alias for GST_LOCK_FLAG_READ | GST_LOCK_FLAG_WRITE - @@ -20680,7 +19592,6 @@ deciding where to go while developing code. Function prototype for a logging function that can be registered with gst_debug_add_log_function(). Use G_GNUC_NO_INSTRUMENT on that function. - @@ -20726,7 +19637,6 @@ endianness. |[ guint32 fourcc = GST_MAKE_FOURCC ('M', 'J', 'P', 'G'); ]| - the first character @@ -20744,7 +19654,6 @@ guint32 fourcc = GST_MAKE_FOURCC ('M', 'J', 'P', 'G'); GstMapFlags value alias for GST_MAP_READ | GST_MAP_WRITE - @@ -20752,7 +19661,6 @@ guint32 fourcc = GST_MAKE_FOURCC ('M', 'J', 'P', 'G'); There is no need to finish the end of the message string with a newline character, a newline character will be added automatically. - message string to log with the data @@ -20770,7 +19678,6 @@ character, a newline character will be added automatically. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically. - the #GObject the message belongs to @@ -20787,7 +19694,6 @@ character, a newline character will be added automatically. - @@ -20795,7 +19701,6 @@ character, a newline character will be added automatically. A flags word containing #GstMemoryFlags flags set on @mem - a #GstMemory. @@ -20804,7 +19709,6 @@ character, a newline character will be added automatically. Gives the status of a specific flag on a @mem. - a #GstMemory. @@ -20816,7 +19720,6 @@ character, a newline character will be added automatically. Clear a specific flag on a @mem. - a #GstMemory. @@ -20828,7 +19731,6 @@ character, a newline character will be added automatically. Check if @mem can't be mapped via gst_memory_map() without any preconditions - a #GstMemory. @@ -20837,7 +19739,6 @@ character, a newline character will be added automatically. Check if @mem cannot be shared between buffers - a #GstMemory. @@ -20846,7 +19747,6 @@ character, a newline character will be added automatically. Check if @mem is physically contiguous. - a #GstMemory. @@ -20855,7 +19755,6 @@ character, a newline character will be added automatically. Check if @mem is readonly. - a #GstMemory. @@ -20864,7 +19763,6 @@ character, a newline character will be added automatically. Check if the padding in @mem is 0 filled. - a #GstMemory. @@ -20873,7 +19771,6 @@ character, a newline character will be added automatically. Check if the prefix in @mem is 0 filled. - a #GstMemory. @@ -20881,35 +19778,30 @@ character, a newline character will be added automatically. - - - - - @@ -20917,7 +19809,6 @@ character, a newline character will be added automatically. Get the sequence number of @message. - a #GstMessage @@ -20925,7 +19816,6 @@ character, a newline character will be added automatically. - @@ -20933,7 +19823,6 @@ character, a newline character will be added automatically. Get the object that posted @message. - a #GstMessage @@ -20943,7 +19832,6 @@ character, a newline character will be added automatically. Get the name of the object that posted @message. Returns "(NULL)" if the message has no source object set. - a #GstMessage @@ -20953,7 +19841,6 @@ the message has no source object set. Get the timestamp of @message. This is the timestamp when the message was created. - a #GstMessage @@ -20962,7 +19849,6 @@ was created. Get the #GstMessageType of @message. - a #GstMessage @@ -20971,7 +19857,6 @@ was created. Check if the message is in the extended message group - a #GstMessage @@ -20980,7 +19865,6 @@ was created. Get a constant string representation of the #GstMessageType of @message. - a #GstMessage @@ -20988,21 +19872,18 @@ was created. - - - @@ -21010,7 +19891,6 @@ was created. A flags word containing #GstMetaFlags flags set on @meta - a #GstMeta. @@ -21019,7 +19899,6 @@ was created. Gives the status of a specific flag on a metadata. - a #GstMeta. @@ -21031,7 +19910,6 @@ was created. Sets a metadata flag on a metadata. - a #GstMeta. @@ -21043,7 +19921,6 @@ was created. Clears a metadata flag. - a #GstMeta. @@ -21055,12 +19932,10 @@ was created. This metadata stays relevant as long as memory layout is unchanged. - Check if the transform type is a copy transform - a transform type @@ -21068,21 +19943,18 @@ was created. - - - @@ -21090,7 +19962,6 @@ was created. This macro returns the entire set of flags for the mini-object. - MiniObject to return flags for. @@ -21099,7 +19970,6 @@ was created. This macro checks to see if the given flag is set. - MiniObject to check for flags. @@ -21111,7 +19981,6 @@ was created. This macro sets the given bits. - MiniObject to set flag in. @@ -21123,7 +19992,6 @@ was created. This macro unsets the given bits. - MiniObject to unset flag in. @@ -21136,7 +20004,6 @@ was created. Check if @obj is lockable. A lockable object can be locked and unlocked with gst_mini_object_lock() and gst_mini_object_unlock(). - a #GstMiniObject @@ -21145,7 +20012,6 @@ gst_mini_object_lock() and gst_mini_object_unlock(). Get access to the reference count field of the mini-object. - a #GstMiniObject @@ -21154,7 +20020,6 @@ gst_mini_object_lock() and gst_mini_object_unlock(). Get the reference count value of the mini-object. - a #GstMiniObject @@ -21163,7 +20028,6 @@ gst_mini_object_lock() and gst_mini_object_unlock(). This macro returns the type of the mini-object. - MiniObject to return type for. @@ -21172,7 +20036,6 @@ gst_mini_object_lock() and gst_mini_object_unlock(). Constant that defines one GStreamer millisecond. - @@ -21190,7 +20053,6 @@ gst_mini_object_lock() and gst_mini_object_unlock(). A structure containing the result of a map operation such as gst_memory_map(). It contains the data and size. - a pointer to the mapped memory @@ -21263,7 +20125,6 @@ memory with an existing memory block at a custom offset and with a custom size. Memory can be efficiently merged when gst_memory_is_span() returns %TRUE. - parent structure @@ -21297,7 +20158,6 @@ Memory can be efficiently merged when gst_memory_is_span() returns %TRUE. The prefix/padding must be filled with 0 if @flags contains #GST_MEMORY_FLAG_ZERO_PREFIXED and #GST_MEMORY_FLAG_ZERO_PADDED respectively. - a new #GstMemory. @@ -21340,7 +20200,6 @@ The prefix/padding must be filled with 0 if @flags contains Return a copy of @size bytes from @mem starting from @offset. This copy is guaranteed to be writable. @size can be set to -1 to return a copy from @offset to the end of the memory region. - a new #GstMemory. @@ -21362,7 +20221,6 @@ from @offset to the end of the memory region. Get the current @size, @offset and @maxsize of @mem. - the current size of @mem @@ -21385,7 +20243,6 @@ from @offset to the end of the memory region. Initializes a newly allocated @mem with the given parameters. This function will call gst_mini_object_init() with the default memory parameters. - @@ -21431,7 +20288,6 @@ and that the memory is contiguous. If this is the case, the memory of @mem1 and @mem2 can be merged efficiently by performing gst_memory_share() on the parent object from the returned @offset. - %TRUE if the memory is contiguous and of a common parent. @@ -21453,7 +20309,6 @@ the returned @offset. Check if @mem if allocated with an allocator for @mem_type. - %TRUE if @mem was allocated from an allocator for @mem_type. @@ -21476,7 +20331,6 @@ mapped copy of @mem is returned. This function takes ownership of old @mem and returns a reference to a new #GstMemory. - a #GstMemory object mapped with @flags or %NULL when a mapping is not possible. @@ -21510,7 +20364,6 @@ until gst_memory_unmap() is called. For each gst_memory_map() call, a corresponding gst_memory_unmap() call should be done. - %TRUE if the map operation was successful. @@ -21532,7 +20385,6 @@ should be done. Increase the refcount of this memory. - @memory (for convenience when doing assignments) @@ -21550,7 +20402,6 @@ less than the maxsize of @mem. #GST_MEMORY_FLAG_ZERO_PREFIXED and #GST_MEMORY_FLAG_ZERO_PADDED will be cleared when offset or padding is increased respectively. - @@ -21574,7 +20425,6 @@ cleared when offset or padding is increased respectively. memory copy is performed and the memory region is simply shared. The result is guaranteed to be non-writable. @size can be set to -1 to return a shared copy from @offset to the end of the memory region. - a new #GstMemory. @@ -21596,7 +20446,6 @@ copy from @offset to the end of the memory region. Release the memory obtained with gst_memory_map() - @@ -21613,7 +20462,6 @@ copy from @offset to the end of the memory region. Decrease the refcount of a memory, freeing it if the refcount reaches 0. - @@ -21629,7 +20477,6 @@ copy from @offset to the end of the memory region. Copy @size bytes from @mem starting at @offset and return them wrapped in a new GstMemory object. If @size is set to -1, all bytes starting at @offset are copied. - a new #GstMemory object wrapping a copy of the requested region in @mem. @@ -21679,7 +20526,6 @@ made when this memory needs to be shared between buffers. Check if @mem1 and @mem2 occupy contiguous memory and return the offset of @mem1 in the parent buffer in @offset. - %TRUE if @mem1 and @mem2 are in contiguous memory. @@ -21703,7 +20549,6 @@ made when this memory needs to be shared between buffers. Get the memory of @mem that can be accessed according to the mode specified in @info's flags. The function should return a pointer that contains at least @maxsize bytes. - a pointer to memory of which at least @maxsize bytes can be accessed according to the access pattern in @info's flags. @@ -21728,7 +20573,6 @@ accessed according to the access pattern in @info's flags. Get the memory of @mem that can be accessed according to the mode specified in @flags. The function should return a pointer that contains at least @maxsize bytes. - a pointer to memory of which at least @maxsize bytes can be accessed according to the access pattern in @flags. @@ -21753,7 +20597,6 @@ accessed according to the access pattern in @flags. Share @size bytes from @mem starting at @offset and return them wrapped in a new GstMemory object. If @size is set to -1, all bytes starting at @offset are shared. This function does not make a copy of the bytes in @mem. - a new #GstMemory object sharing the requested region in @mem. @@ -21775,7 +20618,6 @@ shared. This function does not make a copy of the bytes in @mem. Release the pointer previously retrieved with gst_memory_map() with @info. - @@ -21792,7 +20634,6 @@ shared. This function does not make a copy of the bytes in @mem. Release the pointer previously retrieved with gst_memory_map(). - @@ -21819,7 +20660,6 @@ The basic use pattern of posting a message on a #GstBus is as follows: A #GstElement usually posts messages on the bus provided by the parent container using gst_element_post_message(). - the parent structure @@ -21849,7 +20689,6 @@ container using gst_element_post_message(). Create a new application-typed message. GStreamer will never create these messages; they are a gift from us to you. Enjoy. - The new application message. @@ -21874,7 +20713,6 @@ MT safe. elements goes to PLAYING. A value of #GST_CLOCK_TIME_NONE for @running_time means that the element has no clock interaction and thus doesn't care about the running_time of the pipeline. - The new async_done message. @@ -21894,7 +20732,6 @@ MT safe. This message is posted by elements when they start an ASYNC state change. - The new async_start message. @@ -21921,7 +20758,6 @@ message with @percent set to 100, which can happen after the pipeline completed prerolling. MT safe. - The new buffering message. @@ -21944,7 +20780,6 @@ clock is not valid anymore. If this message is posted by the pipeline, the pipeline will select a new clock again when it goes to PLAYING. It might therefore be needed to set the pipeline to PAUSED and PLAYING again. - The new clock lost message. @@ -21969,7 +20804,6 @@ a clock (maybe because it paused or became EOS). This message is mainly used internally to manage the clock selection. - the new provide clock message. @@ -21995,7 +20829,6 @@ MT safe. Create a new custom-typed message. This can be used for anything not handled by other message-specific functions to pass a message to the app. The structure field can be %NULL. - The new message. @@ -22022,7 +20855,6 @@ MT safe. Creates a new device-added message. The device-added message is produced by #GstDeviceProvider or a #GstDeviceMonitor. They announce the appearance of monitored devices. - a newly allocated #GstMessage @@ -22042,7 +20874,6 @@ of monitored devices. Creates a new device-changed message. The device-changed message is produced by #GstDeviceProvider or a #GstDeviceMonitor. They announce that a device properties has changed and @device represent the new modified version of @changed_device. - a newly allocated #GstMessage @@ -22066,7 +20897,6 @@ properties has changed and @device represent the new modified version of @change Creates a new device-removed message. The device-removed message is produced by #GstDeviceProvider or a #GstDeviceMonitor. They announce the disappearance of monitored devices. - a newly allocated #GstMessage @@ -22087,7 +20917,6 @@ disappearance of monitored devices. that know the duration of a stream when the duration changes. This message is received by bins and is used to calculate the total duration of a pipeline. - The new duration-changed message. @@ -22106,7 +20935,6 @@ MT safe. allowing one-way communication from an element to an application, for example "the firewire cable was unplugged". The format of the message should be documented in the element's documentation. The structure field can be %NULL. - The new element message. @@ -22129,7 +20957,6 @@ MT safe. Create a new eos message. This message is generated and posted in the sink elements of a GstBin. The bin will only forward the EOS message to the application if all sinks have posted an EOS message. - The new eos message. @@ -22148,7 +20975,6 @@ MT safe. @debug. This message is posted by element when a fatal event occurred. The pipeline will probably (partially) stop. The application receiving this message should stop the pipeline. - the new error message. @@ -22175,7 +21001,6 @@ MT safe. @debug. This message is posted by element when a fatal event occurred. The pipeline will probably (partially) stop. The application receiving this message should stop the pipeline. - the new error message. @@ -22201,7 +21026,6 @@ receiving this message should stop the pipeline. This message is posted when an element has a new local #GstContext. - The new have-context message. @@ -22222,7 +21046,6 @@ MT safe. Create a new info message. The message will make copies of @error and @debug. - the new info message. @@ -22247,7 +21070,6 @@ MT safe. Create a new info message. The message will make copies of @error and @debug. - the new warning message. @@ -22278,7 +21100,6 @@ handled at the pipeline, and allows the pipeline to select the running time when the rate change should happen and to send an @GST_EVENT_INSTANT_RATE_SYNC_TIME event to notify the elements in the pipeline. - a newly allocated #GstMessage @@ -22297,7 +21118,6 @@ in the pipeline. This message can be posted by elements when their latency requirements have changed. - The new latency message. @@ -22313,7 +21133,6 @@ MT safe. This message is posted when an element needs a specific #GstContext. - The new need-context message. @@ -22334,7 +21153,6 @@ MT safe. Create a new clock message. This message is posted whenever the pipeline selects a new clock for the pipeline. - The new new clock message. @@ -22358,7 +21176,6 @@ to perform actions triggered by a state change. @code contains a well defined string describing the action. @text should contain a user visible string detailing the current action. - The new qos message. @@ -22383,7 +21200,6 @@ to perform actions triggered by a state change. - a newly allocated #GstMessage @@ -22417,7 +21233,6 @@ events received from a downstream element (!live). respective running-time, stream-time, timestamp and duration of the (dropped) buffer that generated the QoS event. Values can be left to GST_CLOCK_TIME_NONE when unknown. - The new qos message. @@ -22477,7 +21292,6 @@ bitrate tag. The specified location string is copied. However, ownership over the tag list and structure are transferred to the message. - a newly allocated #GstMessage @@ -22505,7 +21319,6 @@ list and structure are transferred to the message. This message can be posted by elements when they want to have their state changed. A typical use case would be an audio server that wants to pause the pipeline because a higher priority stream is being played. - the new request state message. @@ -22526,7 +21339,6 @@ MT safe. This message is posted when the pipeline running-time should be reset to @running_time, like after a flushing seek. - The new reset_time message. @@ -22549,7 +21361,6 @@ MT safe. finish playback of a segment as a result of a segment seek. This message is received by the application after all elements that posted a segment_start have posted the segment_done. - the new segment done message. @@ -22576,7 +21387,6 @@ MT safe. start playback of a segment as a result of a segment seek. This message is not received by the application but is used for maintenance reasons in container elements. - the new segment start message. @@ -22601,7 +21411,6 @@ MT safe. Create a state change message. This message is posted whenever an element changed its state. - the new state change message. @@ -22631,7 +21440,6 @@ MT safe. Create a state dirty message. This message is posted whenever an element changed its state asynchronously and is used internally to update the states of container objects. - the new state dirty message. @@ -22651,7 +21459,6 @@ to %TRUE, or a complete step operation. @duration will contain the amount of time (in GST_FORMAT_TIME) of the stepped @amount of media in format @format. - the new step_done message. @@ -22704,7 +21511,6 @@ queued it for execution in the streaming threads. is now ready to start executing the step in the streaming thread. After this message is emitted, the application can queue a new step operation in the element. - The new step_start message. @@ -22745,7 +21551,6 @@ MT safe. Creates a new stream-collection message. The message is used to announce new #GstStreamCollection - a newly allocated #GstMessage @@ -22765,7 +21570,6 @@ MT safe. Create a new stream_start message. This message is generated and posted in the sink elements of a GstBin. The bin will only forward the STREAM_START message to the application if all sinks have posted an STREAM_START message. - The new stream_start message. @@ -22782,7 +21586,6 @@ MT safe. Create a new stream status message. This message is posted when a streaming thread is created/destroyed or when the state changed. - the new stream status message. @@ -22815,7 +21618,6 @@ belong to. Users of gst_message_new_streams_selected() can add the selected streams with gst_message_streams_selected_add(). - a newly allocated #GstMessage @@ -22837,7 +21639,6 @@ structure of a pipeline is in the process of being changed, for example when pads are linked or unlinked. @src should be the sinkpad that unlinked or linked. - the new structure change message. @@ -22866,7 +21667,6 @@ MT safe. Create a new tag message. The message will take ownership of the tag list. The message is posted by elements that discovered a new taglist. - the new tag message. @@ -22887,7 +21687,6 @@ MT safe. Create a new TOC message. The message is posted by elements that discovered or updated a TOC. - a new TOC message. @@ -22912,7 +21711,6 @@ MT safe. Create a new warning message. The message will make copies of @error and @debug. - the new warning message. @@ -22937,7 +21735,6 @@ MT safe. Create a new warning message. The message will make copies of @error and @debug. - the new warning message. @@ -22966,7 +21763,6 @@ MT safe. The specified location string is copied. However, ownership over the tag list and structure are transferred to the message. - @@ -22991,7 +21787,6 @@ list and structure are transferred to the message. Creates a copy of the message. Returns a copy of the message. - a new copy of @msg. @@ -23006,7 +21801,6 @@ MT safe - the number of entries stored in the message @@ -23031,7 +21825,6 @@ it is not required. Note that events and messages share the same sequence number incrementor; two events or messages will never have the same sequence number unless that correspondence was made explicitly. - The message's sequence number. @@ -23047,7 +21840,6 @@ MT safe. Extracts the object managing the streaming thread from @message. - a GValue containing the object that manages the streaming thread. This object is usually of type GstTask but other types can @@ -23064,7 +21856,6 @@ valid. Access the structure of the message. - The structure of the message. The structure is still owned by the message, which means that you should not @@ -23083,7 +21874,6 @@ MT safe. Checks if @message has the given @name. This function is usually used to check the name of a custom message. - %TRUE if @name matches the name of the message structure. @@ -23103,7 +21893,6 @@ check the name of a custom message. Extract the running_time from the async_done message. MT safe. - @@ -23123,7 +21912,6 @@ MT safe. gst_message_new_buffering(). MT safe. - @@ -23140,7 +21928,6 @@ MT safe. Extracts the buffering stats values from @message. - @@ -23173,7 +21960,6 @@ MT safe. The clock object returned remains valid until the message is freed. MT safe. - @@ -23193,7 +21979,6 @@ MT safe. The clock object returned remains valid until the message is freed. MT safe. - @@ -23215,7 +22000,6 @@ MT safe. Parse a context type from an existing GST_MESSAGE_NEED_CONTEXT message. - a #gboolean indicating if the parsing succeeded. @@ -23235,7 +22019,6 @@ MT safe. Parses a device-added message. The device-added message is produced by #GstDeviceProvider or a #GstDeviceMonitor. It announces the appearance of monitored devices. - @@ -23256,7 +22039,6 @@ of monitored devices. #GstDeviceProvider or a #GstDeviceMonitor. It announces the disappearance of monitored devices. * It announce that a device properties has changed and @device represents the new modified version of @changed_device. - @@ -23281,7 +22063,6 @@ changed and @device represents the new modified version of @changed_device.Parses a device-removed message. The device-removed message is produced by #GstDeviceProvider or a #GstDeviceMonitor. It announces the disappearance of monitored devices. - @@ -23323,7 +22104,6 @@ Typical usage of this function might be: ]| MT safe. - @@ -23346,7 +22126,6 @@ MT safe. Returns the optional details structure, may be NULL if none. The returned structure must not be freed. - @@ -23363,7 +22142,6 @@ The returned structure must not be freed. Extract the group from the STREAM_START message. - %TRUE if the message had a group id set, %FALSE otherwise @@ -23386,7 +22164,6 @@ MT safe. Extract the context from the HAVE_CONTEXT message. MT safe. - @@ -23407,7 +22184,6 @@ MT safe. in the output arguments are copies; the caller must free them when done. MT safe. - @@ -23430,7 +22206,6 @@ MT safe. Returns the optional details structure, may be NULL if none The returned structure must not be freed. - @@ -23447,7 +22222,6 @@ The returned structure must not be freed. Parses the rate_multiplier from the instant-rate-request message. - @@ -23467,7 +22241,6 @@ The returned structure must not be freed. The clock object returned remains valid until the message is freed. MT safe. - @@ -23485,7 +22258,6 @@ MT safe. Parses the progress @type, @code and @text. - @@ -23512,7 +22284,6 @@ MT safe. Parses a property-notify message. These will be posted on the bus only when set up with gst_element_add_property_notify_watch() or gst_element_add_property_deep_notify_watch(). - @@ -23548,7 +22319,6 @@ duration of the dropped buffer. Values of GST_CLOCK_TIME_NONE mean unknown values. MT safe. - @@ -23591,7 +22361,6 @@ When @format is @GST_FORMAT_UNDEFINED both @dropped and @processed are invalid. Values of -1 for either @processed or @dropped mean unknown values. MT safe. - @@ -23623,7 +22392,6 @@ MT safe. Extract the QoS values that have been calculated/analysed from the QoS data MT safe. - @@ -23654,7 +22422,6 @@ MT safe. Parses the location and/or structure from the entry with the given index. The index must be between 0 and gst_message_get_num_redirect_entries() - 1. Returned pointers are valid for as long as this message exists. - @@ -23688,7 +22455,6 @@ Returned pointers are valid for as long as this message exists. Extract the requested state from the request_state message. MT safe. - @@ -23707,7 +22473,6 @@ MT safe. Extract the running-time from the RESET_TIME message. MT safe. - @@ -23727,7 +22492,6 @@ MT safe. Extracts the position and format from the segment done message. MT safe. - @@ -23750,7 +22514,6 @@ MT safe. Extracts the position and format from the segment start message. MT safe. - @@ -23792,7 +22555,6 @@ Typical usage of this function might be: ]| MT safe. - @@ -23819,7 +22581,6 @@ MT safe. Extract the values the step_done message. MT safe. - @@ -23862,7 +22623,6 @@ MT safe. Extract the values from step_start message. MT safe. - @@ -23899,7 +22659,6 @@ MT safe. Parses a stream-collection message. - @@ -23921,7 +22680,6 @@ owner remains valid for as long as the reference to @message is valid and should thus not be unreffed. MT safe. - @@ -23942,7 +22700,6 @@ MT safe. Parses a streams-selected message. - @@ -23962,7 +22719,6 @@ MT safe. Extracts the change type and completion status from the GstMessage. MT safe. - @@ -24010,7 +22766,6 @@ Typical usage of this function might be: ]| MT safe. - @@ -24031,7 +22786,6 @@ output argument is a copy; the caller must free it with gst_toc_unref() when done. MT safe. - @@ -24055,7 +22809,6 @@ MT safe. in the output arguments are copies; the caller must free them when done. MT safe. - @@ -24078,7 +22831,6 @@ MT safe. Returns the optional details structure, may be NULL if none The returned structure must not be freed. - @@ -24095,7 +22847,6 @@ The returned structure must not be freed. Convenience macro to increase the reference count of the message. - @msg (for convenience when doing assignments) @@ -24109,7 +22860,6 @@ The returned structure must not be freed. Configures the buffering stats values in @message. - @@ -24146,7 +22896,6 @@ each time the stream is started, resulting in different group ids each time a file is played for example. MT safe. - @@ -24169,7 +22918,6 @@ When @format is @GST_FORMAT_UNDEFINED both @dropped and @processed are invalid. Values of -1 for either @processed or @dropped mean unknown values. MT safe. - @@ -24200,7 +22948,6 @@ or a flushing operation. Set the QoS values that have been calculated/analysed from the QoS data MT safe. - @@ -24233,7 +22980,6 @@ the message relates to other messages or events. See gst_message_get_seqnum() for more information. MT safe. - @@ -24251,7 +22997,6 @@ MT safe. Configures the object handling the streaming thread. This is usually a GstTask object but other objects might be added in the future. - @@ -24268,7 +23013,6 @@ GstTask object but other objects might be added in the future. Adds the @stream to the @message. - @@ -24285,7 +23029,6 @@ GstTask object but other objects might be added in the future. Returns the number of streams contained in the @message. - The number of streams contained within. @@ -24299,7 +23042,6 @@ GstTask object but other objects might be added in the future. Retrieves the #GstStream with index @index from the @message. - A #GstStream @@ -24318,7 +23060,6 @@ GstTask object but other objects might be added in the future. Convenience macro to decrease the reference count of the message, possibly freeing it. - @@ -24331,7 +23072,6 @@ freeing it. Get a writable version of the structure. - The structure of the message. The structure is still owned by the message, which means that you should not free @@ -24356,7 +23096,6 @@ in some cases), and the reference counts are updated appropriately (the old message is unreffed, the new one is reffed). Either @new_message or the #GstMessage pointed to by @old_message may be %NULL. - %TRUE if @new_message was different from @old_message @@ -24560,7 +23299,6 @@ was updated. Get a printable name for the given message type. Do not modify or free. - a reference to the static name of the message. @@ -24574,7 +23312,6 @@ was updated. Get the unique quark for the given message type. - the quark associated with the message type @@ -24607,7 +23344,6 @@ A specific implementation can be retrieved by name with gst_meta_get_info(). See #GstBuffer for how the metadata can be added, retrieved and removed from buffers. - extra flags for the metadata @@ -24619,7 +23355,6 @@ buffers. Meta sequence number compare function. Can be used as #GCompareFunc or a #GCompareDataFunc. - a negative number if @meta1 comes before @meta2, 0 if both metas have an equal sequence number, or a positive integer if @meta1 comes @@ -24639,7 +23374,6 @@ or a #GCompareDataFunc. Gets seqnum for this meta. - @@ -24651,7 +23385,6 @@ or a #GCompareDataFunc. - an array of tags as strings. @@ -24667,7 +23400,6 @@ or a #GCompareDataFunc. Check if @api was registered with @tag. - %TRUE if @api was registered with @tag. @@ -24686,7 +23418,6 @@ or a #GCompareDataFunc. Register and return a GType for the @api and associate it with @tags. - a unique GType for @api. @@ -24707,7 +23438,6 @@ or a #GCompareDataFunc. Lookup a previously registered meta info structure by its implementation name @impl. - a #GstMetaInfo with @impl, or %NULL when no such metainfo exists. @@ -24725,7 +23455,6 @@ or a #GCompareDataFunc. The same @info can be retrieved later with gst_meta_get_info() by using @impl as the key. - a #GstMetaInfo that can be used to access metadata. @@ -24779,7 +23508,6 @@ access metadata. Function called when @meta is freed in @buffer. - @@ -24797,7 +23525,6 @@ access metadata. The #GstMetaInfo provides information about a specific metadata structure. - tag identifying the metadata structure and api @@ -24825,7 +23552,6 @@ structure. Function called when @meta is initialized in @buffer. - @@ -24846,7 +23572,6 @@ structure. Extra data passed to a "gst-copy" transform #GstMetaTransformFunction. - %TRUE if only region is copied @@ -24868,7 +23593,6 @@ is passed to the function as @data. Implementations should check the @type of the transform and parse additional type specific fields in @data that should be used to update the metadata on @transbuf. - %TRUE if the transform could be performed @@ -24923,7 +23647,6 @@ with gst_mini_object_copy() or similar methods. A weak reference can be added and remove with gst_mini_object_weak_ref() and gst_mini_object_weak_unref() respectively. - the GType of the object @@ -24967,7 +23690,6 @@ the parents are writable and its own refcount is exactly 1. Note: This function does not take ownership of @parent and also does not take an additional reference. It is the responsibility of the caller to remove the parent again at a later time. - @@ -24986,7 +23708,6 @@ remove the parent again at a later time. Creates a copy of the mini-object. MT safe - the new mini-object if copying is possible, %NULL otherwise. @@ -25002,7 +23723,6 @@ possible, %NULL otherwise. This function gets back user data pointers stored via gst_mini_object_set_qdata(). - The user data pointer set, or %NULL @@ -25022,7 +23742,6 @@ gst_mini_object_set_qdata(). Initializes a mini-object with the desired type and copy/dispose/free functions. - @@ -25064,7 +23783,6 @@ object is therefore writable. Modification of a mini-object should only be done after verifying that it is writable. - %TRUE if the object is writable. @@ -25078,7 +23796,6 @@ is writable. Lock the mini-object with the specified access mode in @flags. - %TRUE if @object could be locked. @@ -25100,7 +23817,6 @@ returned. This gives away the reference to the original mini object, and returns a reference to the new object. MT safe - a mini-object (possibly the same pointer) that is writable. @@ -25122,7 +23838,6 @@ important to note that keeping additional references to GstMiniObject instances can potentially increase the number of memcpy operations in a pipeline, especially if the miniobject is a #GstBuffer. - the mini-object. @@ -25137,7 +23852,6 @@ is a #GstBuffer. This removes @parent as a parent for @object. See gst_mini_object_add_parent(). - @@ -25165,7 +23879,6 @@ removes the data stored. @destroy may be specified which is called with @data as argument when the @object is disposed, or the data is being overwritten by a call to gst_mini_object_set_qdata() with the same @quark. - @@ -25193,7 +23906,6 @@ a call to gst_mini_object_set_qdata() with the same @quark. This function gets back user data pointers stored via gst_mini_object_set_qdata() and removes the data from @object without invoking its `destroy()` function (if any was set). - The user data pointer set, or %NULL @@ -25212,7 +23924,6 @@ any was set). Unlock the mini-object with the specified access mode in @flags. - @@ -25230,7 +23941,6 @@ any was set). Decreases the reference count of the mini-object, possibly freeing the mini-object. - @@ -25248,7 +23958,6 @@ used for notification when a mini object is finalized. They are called to the mini object without calling gst_mini_object_ref() (gst_mini_object_ref() adds a strong reference, that is, forces the object to stay alive). - @@ -25269,7 +23978,6 @@ to stay alive). Removes a weak reference callback from a mini object. - @@ -25294,7 +24002,6 @@ The reference count of @olddata is decreased and the reference count of @newdata is increased. Either @newdata and the value pointed to by @olddata may be %NULL. - %TRUE if @newdata was different from @olddata @@ -25314,7 +24021,6 @@ Either @newdata and the value pointed to by @olddata may be %NULL. Replace the current #GstMiniObject pointer to by @olddata with %NULL and return the old value. - the #GstMiniObject at @oldata @@ -25334,7 +24040,6 @@ except that it does not increase the refcount of @newdata and thus takes ownership of @newdata. Either @newdata and the value pointed to by @olddata may be %NULL. - %TRUE if @newdata was different from @olddata @@ -25354,7 +24059,6 @@ Either @newdata and the value pointed to by @olddata may be %NULL. Function prototype for methods to create copies of instances. - reference to cloned instance. @@ -25372,7 +24076,6 @@ Implementation of the mini object are allowed to revive the passed object by doing a gst_mini_object_ref(). If the object is not revived after the dispose function, the function should return %TRUE and the memory associated with the object is freed. - %TRUE if the object should be cleaned up. @@ -25406,7 +24109,6 @@ detection tools. (Since: 1.10) Virtual function prototype for methods to free resources used by mini-objects. - @@ -25421,7 +24123,6 @@ mini-objects. A #GstMiniObjectNotify function can be added to a mini object as a callback that gets triggered when gst_mini_object_unref() drops the last ref and @obj is about to be freed. - @@ -25438,32 +24139,27 @@ last ref and @obj is about to be freed. Constant that defines one GStreamer nanosecond - - - - - @@ -25471,7 +24167,6 @@ last ref and @obj is about to be freed. This macro returns the entire set of flags for the object. - a #GstObject @@ -25480,7 +24175,6 @@ last ref and @obj is about to be freed. This macro checks to see if the given flag is set. - a #GstObject @@ -25492,7 +24186,6 @@ last ref and @obj is about to be freed. This macro sets the given bits. - a #GstObject @@ -25504,7 +24197,6 @@ last ref and @obj is about to be freed. This macro unsets the given bits. - a #GstObject @@ -25515,7 +24207,6 @@ last ref and @obj is about to be freed. - @@ -25523,7 +24214,6 @@ last ref and @obj is about to be freed. Acquire a reference to the mutex of this object. - a #GstObject @@ -25533,7 +24223,6 @@ last ref and @obj is about to be freed. This macro will obtain a lock on the object, making serialization possible. It blocks until the lock can be obtained. - a #GstObject to lock @@ -25544,7 +24233,6 @@ It blocks until the lock can be obtained. Get the name of this object. This is not thread-safe by default (i.e. you will have to make sure the object lock is taken yourself). If in doubt use gst_object_get_name() instead. - a #GstObject @@ -25555,7 +24243,6 @@ If in doubt use gst_object_get_name() instead. Get the parent of this object. This is not thread-safe by default (i.e. you will have to make sure the object lock is taken yourself). If in doubt use gst_object_get_parent() instead. - a #GstObject @@ -25564,7 +24251,6 @@ If in doubt use gst_object_get_parent() instead. Get access to the reference count field of the object. - a #GstObject @@ -25573,7 +24259,6 @@ If in doubt use gst_object_get_parent() instead. Get the reference count value of the object. - a #GstObject @@ -25583,7 +24268,6 @@ If in doubt use gst_object_get_parent() instead. This macro will try to obtain a lock on the object, but will return with %FALSE if it can't get it immediately. - a #GstObject. @@ -25592,7 +24276,6 @@ If in doubt use gst_object_get_parent() instead. This macro releases a lock on the object. - a #GstObject to unlock. @@ -25649,14 +24332,12 @@ What needs to be done in applications? Again it's not a lot to change. gst_timed_value_control_source_set ((GstTimedValueControlSource *)csource,1 * GST_SECOND, value2); * start your pipeline - Checks to see if there is any object named @name in @list. This function does not do any locking of any kind. You might want to protect the provided list with the lock of the owner of the list. This function will lock each #GstObject in the list to compare the name, so be careful when passing a list with a locked object. - %TRUE if a #GstObject named @name does not appear in @list, %FALSE if it does. @@ -25686,7 +24367,6 @@ using g_print. MT safe. This function grabs and releases @object's LOCK for getting its path string. - @@ -25725,7 +24405,6 @@ reference count by one. For more background on "floating references" please see the #GObject documentation. - @@ -25742,7 +24421,6 @@ The reference count of @oldobj is decreased and the reference count of @newobj is increased. Either @newobj and the value pointed to by @oldobj may be %NULL. - %TRUE if @newobj was different from @oldobj @@ -25760,7 +24438,6 @@ Either @newobj and the value pointed to by @oldobj may be %NULL. - @@ -25782,7 +24459,6 @@ Either @newobj and the value pointed to by @oldobj may be %NULL. The object's reference count will be incremented, and any floating reference will be removed (see gst_object_ref_sink()) - %FALSE if the given @binding has not been setup for this object or has been setup for a non suitable property, %TRUE otherwise. @@ -25804,7 +24480,6 @@ has been setup for a non suitable property, %TRUE otherwise. and the optional debug string.. The default handler will simply print the error string using g_print. - @@ -25826,7 +24501,6 @@ The default handler will simply print the error string using g_print. Gets the corresponding #GstControlBinding for the property. This should be unreferenced again after use. - the #GstControlBinding for @property_name or %NULL if the property is not controlled. @@ -25854,7 +24528,6 @@ If the @object is not under property control, this will return The control-rate is not expected to change if the element is in %GST_STATE_PAUSED or %GST_STATE_PLAYING. - the control rate in nanoseconds @@ -25873,7 +24546,6 @@ requested time. The array @values need to hold enough space for @n_values of This function is useful if one wants to e.g. draw a graph of the control curve or apply a control curve sample by sample. - %TRUE if the given array could be filled, %FALSE otherwise @@ -25914,7 +24586,6 @@ For a nameless object, this returns %NULL, which you can safely g_free() as well. Free-function: g_free - the name of @object. g_free() after usage. @@ -25932,7 +24603,6 @@ MT safe. This function grabs and releases @object's LOCK. Returns the parent of @object. This function increases the refcount of the parent object so you should gst_object_unref() it after usage. - parent of @object, this can be %NULL if @object has no parent. unref after usage. @@ -25952,7 +24622,6 @@ MT safe. Grabs and releases @object's LOCK. the object hierarchy. Only useful (or used) for debugging. Free-function: g_free - a string describing the path of @object. You must g_free() the string after usage. @@ -25970,7 +24639,6 @@ MT safe. Grabs and releases the #GstObject's LOCK for all objects Gets the value for the given controlled property at the requested time. - the GValue of the property at the given time, or %NULL if the property isn't controlled. @@ -26002,7 +24670,6 @@ curve or apply a control curve sample by sample. The values are unboxed and ready to be used. The similar function gst_object_get_g_value_array() returns the array as #GValues and is better suites for bindings. - %TRUE if the given array could be filled, %FALSE otherwise @@ -26036,7 +24703,6 @@ better suites for bindings. Check if the @object has active controlled properties. - %TRUE if the object has active controlled properties @@ -26054,7 +24720,6 @@ the hierarchy. One can e.g. check if a #GstElement is inside a #GstPipeline.Use gst_object_has_as_ancestor() instead. MT safe. Grabs and releases @object's locks. - %TRUE if @ancestor is an ancestor of @object. @@ -26073,7 +24738,6 @@ MT safe. Grabs and releases @object's locks. Check if @object has an ancestor @ancestor somewhere up in the hierarchy. One can e.g. check if a #GstElement is inside a #GstPipeline. - %TRUE if @ancestor is an ancestor of @object. @@ -26094,7 +24758,6 @@ MT safe. Grabs and releases @object's locks. Check if @parent is the parent of @object. E.g. a #GstElement can check if it owns a given #GstPad. - %FALSE if either @object or @parent is %NULL. %TRUE if @parent is the parent of @object. Otherwise %FALSE. @@ -26121,7 +24784,6 @@ atomic refcounting. This object returns the input parameter to ease writing constructs like : result = gst_object_ref (object->parent); - A pointer to @object @@ -26136,7 +24798,6 @@ constructs like : Removes the corresponding #GstControlBinding. If it was the last ref of the binding, it will be disposed. - %TRUE if the binding could be removed. @@ -26156,7 +24817,6 @@ last ref of the binding, it will be disposed. This function is used to disable the control bindings on a property for some time, i.e. gst_object_sync_values() will do nothing for the property. - @@ -26179,7 +24839,6 @@ or not. This function is used to disable all controlled properties of the @object for some time, i.e. gst_object_sync_values() will do nothing. - @@ -26203,7 +24862,6 @@ should be up to @control-rate nanoseconds. The control-rate should not change if the element is in %GST_STATE_PAUSED or %GST_STATE_PLAYING. - @@ -26223,7 +24881,6 @@ The control-rate should not change if the element is in %GST_STATE_PAUSED or name (if @name is %NULL). This function makes a copy of the provided name, so the caller retains ownership of the name it sent. - %TRUE if the name could be set. Since Objects that have a parent cannot be renamed, this function returns %FALSE in those @@ -26246,7 +24903,6 @@ MT safe. This function grabs and releases @object's LOCK. Sets the parent of @object to @parent. The object's reference count will be incremented, and any floating reference will be removed (see gst_object_ref_sink()). - %TRUE if @parent could be set or %FALSE when @object already had a parent or @object and @parent are the same. @@ -26268,7 +24924,6 @@ MT safe. Grabs and releases @object's LOCK. Returns a suggestion for timestamps where buffers should be split to get best controller results. - Returns the suggested timestamp or %GST_CLOCK_TIME_NONE if no control-rate was set. @@ -26287,7 +24942,6 @@ if no control-rate was set. If this function fails, it is most likely the application developers fault. Most probably the control sources are not setup correctly. - %TRUE if the controller values could be applied to the object properties, %FALSE otherwise @@ -26309,7 +24963,6 @@ properties, %FALSE otherwise This function decreases the refcount of @object. MT safe. Grabs and releases @object's lock. - @@ -26327,7 +24980,6 @@ on @object as it relies on atomic refcounting. The unref method should never be called with the LOCK held since this might deadlock the dispose function. - @@ -26403,7 +25055,6 @@ the elements contained in that bin. GStreamer base object class. - parent @@ -26414,7 +25065,6 @@ the elements contained in that bin. - @@ -26449,7 +25099,6 @@ detection tools. (Since: 1.10) - @@ -26457,7 +25106,6 @@ detection tools. (Since: 1.10) Get the #GstPadActivateFunction from @pad. - a #GstPad @@ -26466,7 +25114,6 @@ detection tools. (Since: 1.10) Get the #GstPadActivateModeFunction from the given @pad. - a #GstPad @@ -26474,35 +25121,30 @@ detection tools. (Since: 1.10) - - - - - @@ -26510,7 +25152,6 @@ detection tools. (Since: 1.10) Get the #GstPadChainFunction from the given @pad. - a #GstPad @@ -26519,7 +25160,6 @@ detection tools. (Since: 1.10) Get the #GstPadChainListFunction from the given @pad. - a #GstPad @@ -26527,7 +25167,6 @@ detection tools. (Since: 1.10) - @@ -26536,7 +25175,6 @@ detection tools. (Since: 1.10) Get the #GstPadDirection of the given @pad. Accessor macro, use gst_pad_get_direction() instead. - a #GstPad @@ -26547,7 +25185,6 @@ gst_pad_get_direction() instead. Get the private data of @pad, which is usually some pad- or stream-specific structure created by the element and set on the pad when creating it. No locking is performed in this function. - a #GstPad @@ -26560,7 +25197,6 @@ is the function that handles events on the pad. You can use this to set your own event handling function on a pad after you create it. If your element derives from a base class, use the base class's virtual functions instead. - a #GstPad @@ -26573,7 +25209,6 @@ is the function that handles events on the pad. You can use this to set your own event handling function on a pad after you create it. If your element derives from a base class, use the base class's virtual functions instead. - a #GstPad @@ -26582,7 +25217,6 @@ class, use the base class's virtual functions instead. Get the #GstPadGetRangeFunction from the given @pad. - a #GstPad @@ -26594,7 +25228,6 @@ class, use the base class's virtual functions instead. resources used in the data processing functions of @pad. Accessor macro, use GST_PAD_STREAM_LOCK() and GST_PAD_STREAM_UNLOCK() instead to take/release the pad's stream lock. - a #GstPad @@ -26604,7 +25237,6 @@ to take/release the pad's stream lock. Check if the given @pad has pending events. This is used internally by GStreamer. - a #GstPad @@ -26616,7 +25248,6 @@ GStreamer. handler will check if the caps intersect the query-caps result instead of checking for a subset. This is interesting for parser elements that can accept incompletely specified caps. - a #GstPad @@ -26629,7 +25260,6 @@ The default accept-caps will do a query caps to get the caps, which might be querying downstream causing unnecessary overhead. It is recommended to implement a proper accept-caps query handler or to use this flag to prevent recursive accept-caps handling. - a #GstPad @@ -26637,7 +25267,6 @@ recursive accept-caps handling. - a #GstPad @@ -26646,7 +25275,6 @@ recursive accept-caps handling. Check if the dataflow on a @pad is blocked. Use gst_pad_is_blocked() instead. - a #GstPad @@ -26656,7 +25284,6 @@ recursive accept-caps handling. Check if the @pad is currently blocking on a buffer or event. Use gst_pad_is_blocking() instead. - a #GstPad @@ -26665,7 +25292,6 @@ gst_pad_is_blocking() instead. Check if the @pad is in EOS state. - a #GstPad @@ -26676,7 +25302,6 @@ gst_pad_is_blocking() instead. Check if the given @pad is using fixed caps, which means that once the caps are set on the @pad, the caps query function will only return those caps. See gst_pad_use_fixed_caps(). - a #GstPad @@ -26685,7 +25310,6 @@ only return those caps. See gst_pad_use_fixed_caps(). Check if the given @pad is flushing. - a #GstPad @@ -26693,7 +25317,6 @@ only return those caps. See gst_pad_use_fixed_caps(). - a #GstPad @@ -26704,7 +25327,6 @@ only return those caps. See gst_pad_use_fixed_caps(). Check if the given @pad is set as proxy allocation which means that the default query handler will forward allocation queries to the internally linked @pads instead of discarding them. - a #GstPad @@ -26715,7 +25337,6 @@ internally linked @pads instead of discarding them. Check if the given @pad is set to proxy caps. This means that the default event and query handler will forward all events and queries to the internally linked @pads instead of discarding them. - a #GstPad @@ -26726,7 +25347,6 @@ internally linked @pads instead of discarding them. Check if the given @pad is set to proxy scheduling queries, which means that the default query handler will forward scheduling queries to the internally linked @pads instead of discarding them. - a #GstPad @@ -26734,7 +25354,6 @@ linked @pads instead of discarding them. - a #GstPad @@ -26742,7 +25361,6 @@ linked @pads instead of discarding them. - a #GstPad @@ -26751,7 +25369,6 @@ linked @pads instead of discarding them. Get the #GstPadIterIntLinkFunction from the given @pad. - a #GstPad @@ -26760,7 +25377,6 @@ linked @pads instead of discarding them. Gets the last flow return on this pad - a #GstPad @@ -26769,7 +25385,6 @@ linked @pads instead of discarding them. Get the #GstPadLinkFunction for the given @pad. - a #GstPad @@ -26779,7 +25394,6 @@ linked @pads instead of discarding them. Macro to test if the given #GstPadLinkReturn value indicates a failed link step. - the #GstPadLinkReturn value @@ -26789,7 +25403,6 @@ link step. Macro to test if the given #GstPadLinkReturn value indicates a successful link step. - the #GstPadLinkReturn value @@ -26800,7 +25413,6 @@ link step. Get the #GstPadMode of pad, which will be GST_PAD_MODE_NONE if the pad has not been activated yet, and otherwise either GST_PAD_MODE_PUSH or GST_PAD_MODE_PULL depending on which mode the pad was activated in. - a #GstPad @@ -26810,7 +25422,6 @@ GST_PAD_MODE_PULL depending on which mode the pad was activated in. Get name of the given pad. No locking is performed in this function, use gst_pad_get_name() instead. - a #GstPad @@ -26820,7 +25431,6 @@ No locking is performed in this function, use gst_pad_get_name() instead. Check if there is a parent object before calling into the @pad callbacks. This is used internally by GStreamer. - a #GstPad @@ -26831,7 +25441,6 @@ This is used internally by GStreamer. Check if the @pad should be reconfigured/renegotiated. The flag has to be unset manually after reconfiguration happened. Use gst_pad_needs_reconfigure() or gst_pad_check_reconfigure() instead. - a #GstPad @@ -26841,7 +25450,6 @@ Use gst_pad_needs_reconfigure() or gst_pad_check_reconfigure() instead. Get the @pad #GstPadTemplate. It describes the possible media types a @pad or an element factory can handle. - a #GstPad @@ -26851,7 +25459,6 @@ a @pad or an element factory can handle. Get the @pad parent. No locking is performed in this function, use gst_pad_get_parent() instead. - a #GstPad @@ -26861,7 +25468,6 @@ No locking is performed in this function, use gst_pad_get_parent() instead. Return the pad's peer member. This member is a pointer to the linked @pad. No locking is performed in this function, use gst_pad_get_peer() instead. - a #GstPad @@ -26869,70 +25475,60 @@ No locking is performed in this function, use gst_pad_get_peer() instead. - - - - - - - - - - @@ -26944,7 +25540,6 @@ that handles queries on the pad. You can use this to set your own query handling function on a pad after you create it. If your element derives from a base class, use the base class's virtual functions instead. - a #GstPad @@ -26955,7 +25550,6 @@ functions instead. Set @pad to by default accept caps by intersecting the result instead of checking for a subset. This is interesting for parser elements that can accept incompletely specified caps. - a #GstPad @@ -26965,7 +25559,6 @@ accept incompletely specified caps. Set @pad to by default use the pad template caps to compare with the accept caps instead of using a caps query result. - a #GstPad @@ -26979,7 +25572,6 @@ are pushed on it. This usually happens when the pad is shut down or when a flushing seek happens. This is used inside GStreamer when flush start/stop events pass through pads, or when an element state is changed and pads are activated or deactivated. - a #GstPad @@ -26993,7 +25585,6 @@ instead of discarding them. Set this if the element always outputs data in the exact same format as it receives as input. This is just for convenience to avoid implementing some standard query handling code in an element. - a #GstPad @@ -27006,7 +25597,6 @@ proxied down- or upstream to the other side of the element automatically. Set this if the element always outputs data in the exact same format as it receives as input. This is just for convenience to avoid implementing some standard event and query handling code in an element. - a #GstPad @@ -27018,7 +25608,6 @@ standard event and query handling code in an element. handler will forward scheduling queries to the internally linked @pads instead of discarding them. You will usually want to handle scheduling queries explicitly if your element supports multiple scheduling modes. - a #GstPad @@ -27028,7 +25617,6 @@ queries explicitly if your element supports multiple scheduling modes. Take the pad's stream lock. The stream lock is recursive and will be taken when buffers or serialized downstream events are pushed on a pad. - a #GstPad @@ -27038,7 +25626,6 @@ when buffers or serialized downstream events are pushed on a pad. Try to take the pad's stream lock, and return %TRUE if the lock could be taken, and otherwise %FALSE. - a #GstPad @@ -27047,7 +25634,6 @@ taken, and otherwise %FALSE. Release the pad's stream lock. - a #GstPad @@ -27058,7 +25644,6 @@ taken, and otherwise %FALSE. Get the #GstTask of @pad. Accessor macro used by GStreamer. Use the gst_pad_start_task(), gst_pad_stop_task() and gst_pad_pause_task() functions instead. - a #GstPad @@ -27066,7 +25651,6 @@ functions instead. - @@ -27074,7 +25658,6 @@ functions instead. Get a handle to the padtemplate #GstCaps - the template to query @@ -27082,7 +25665,6 @@ functions instead. - @@ -27090,7 +25672,6 @@ functions instead. Get the #GstPadDirection of the padtemplate. - the template to query @@ -27099,7 +25680,6 @@ functions instead. Get the #GType of the padtemplate - the template to query @@ -27108,7 +25688,6 @@ functions instead. Check if the properties of the padtemplate are fixed - the template to query @@ -27117,7 +25696,6 @@ functions instead. Get the nametemplate of the padtemplate. - the template to query @@ -27126,7 +25704,6 @@ functions instead. Get the #GstPadPresence of the padtemplate. - the template to query @@ -27135,7 +25712,6 @@ functions instead. Get the #GstPadUnlinkFunction from the given @pad. - a #GstPad @@ -27144,7 +25720,6 @@ functions instead. Unset accept intersect flag. - a #GstPad @@ -27153,7 +25728,6 @@ functions instead. Unset accept template flag. - a #GstPad @@ -27162,7 +25736,6 @@ functions instead. Unset the flushing flag. - a #GstPad @@ -27171,7 +25744,6 @@ functions instead. Unset proxy allocation flag. - a #GstPad @@ -27180,7 +25752,6 @@ functions instead. Unset proxy caps flag. - a #GstPad @@ -27189,7 +25760,6 @@ functions instead. Unset proxy scheduling flag. - a #GstPad @@ -27201,51 +25771,43 @@ functions instead. they might not be available depending on environment such as OS, device, etc, so such properties will be installed conditionally only if the GstObject is able to support it. - Use this flag on GObject properties to signal they can make sense to be. controlled over time. This hint is used by the GstController. - Use this flag on GObject properties of GstObject to indicate that during `gst-inspect` and friends, the default value should be used as default instead of the current value. - Use this flag on GObject properties of GstElements to indicate that they can be changed when the element is in the PAUSED or lower state. This flag implies GST_PARAM_MUTABLE_READY. - Use this flag on GObject properties of GstElements to indicate that they can be changed when the element is in the PLAYING or lower state. This flag implies GST_PARAM_MUTABLE_PAUSED. - Use this flag on GObject properties of GstElements to indicate that they can be changed when the element is in the READY or lower state. - - - @@ -27253,53 +25815,45 @@ they can be changed when the element is in the READY or lower state. Bits based on GST_PARAM_USER_SHIFT can be used by 3rd party applications. - - - - - - - - @@ -27318,7 +25872,6 @@ your application/package, e.g. 'someapp' or 'my-plugins-foo. If defined, the GST_PACKAGE_RELEASE_DATETIME will also be used for the #GstPluginDesc,release_datetime field. - major version number of the gstreamer-core that plugin was compiled for @@ -27350,28 +25903,24 @@ If defined, the GST_PACKAGE_RELEASE_DATETIME will also be used for the - - - - @@ -27379,7 +25928,6 @@ If defined, the GST_PACKAGE_RELEASE_DATETIME will also be used for the Debug the plugin feature names in @list. - a #GList of @@ -27388,7 +25936,6 @@ If defined, the GST_PACKAGE_RELEASE_DATETIME will also be used for the - @@ -27400,7 +25947,6 @@ necessary to call this macro before the plugin can be used. It has to be used in combination with GST_PLUGIN_STATIC_REGISTER and must be placed outside any block to declare the plugin initialization function. - short, but unique name of the plugin @@ -27412,7 +25958,6 @@ function. necessary to call this macro before the plugin can be used. It has to be used in combination with GST_PLUGIN_STATIC_DECLARE and calls the plugin initialization function. - short, but unique name of the plugin @@ -27420,21 +25965,18 @@ calls the plugin initialization function. - - - @@ -27443,7 +25985,6 @@ calls the plugin initialization function. The field name in a GstCaps that is used to signal the UUID of the protection system. - @@ -27457,18 +25998,15 @@ protection system to use. Example: The matroskademux uses this value in the case of encrypted WebM, the application will choose the appropriate protection system based on the information received through EME API. - - - @@ -27485,7 +26023,6 @@ to pretty-print the following types: #GstCaps, #GstStructure, else will simply be printed as pointer address. This can only be used on types whose size is >= sizeof(gpointer). - @@ -27548,13 +26085,11 @@ gst_pad_set_offset() can be used to change the offset. Convenience functions exist to start, pause and stop the task on a pad with gst_pad_start_task(), gst_pad_pause_task() and gst_pad_stop_task() respectively. - Creates a new pad with the given name in the given direction. If name is %NULL, a guaranteed unique name (across all pads) will be assigned. This function makes a copy of the name so you can safely free the name. - a new #GstPad. @@ -27577,7 +26112,6 @@ MT safe. If name is %NULL, a guaranteed unique name (across all pads) will be assigned. This function makes a copy of the name so you can safely free the name. - a new #GstPad. @@ -27598,7 +26132,6 @@ This function makes a copy of the name so you can safely free the name. If name is %NULL, a guaranteed unique name (across all pads) will be assigned. This function makes a copy of the name so you can safely free the name. - a new #GstPad. @@ -27616,7 +26149,6 @@ This function makes a copy of the name so you can safely free the name. Gets a string representing the given pad-link return. - a static string with the name of the pad-link return. @@ -27629,7 +26161,6 @@ This function makes a copy of the name so you can safely free the name. - @@ -27643,7 +26174,6 @@ This function makes a copy of the name so you can safely free the name. - @@ -27661,7 +26191,6 @@ This function makes a copy of the name so you can safely free the name. pad's activatemodefunc. For use from within pad activation functions only. If you don't know what this is, you probably don't want to call it. - %TRUE if the operation was successful. @@ -27693,7 +26222,6 @@ exception here are GST_PAD_PROBE_TYPE_IDLE probes that are called immediately if the pad is already idle while calling gst_pad_add_probe(). In each of the groups, probes are called in the order in which they were added. - an id or 0 if no probe is pending. The id can be used to remove the probe with gst_pad_remove_probe(). When using GST_PAD_PROBE_TYPE_IDLE it can @@ -27730,7 +26258,6 @@ MT safe. Checks if the source pad and the sink pad are compatible so they can be linked. - %TRUE if the pads can be linked. @@ -27762,7 +26289,6 @@ chain function. In all cases, success or failure, the caller loses its reference to @buffer after calling this function. - a #GstFlowReturn from the pad. @@ -27798,7 +26324,6 @@ In all cases, success or failure, the caller loses its reference to @list after calling this function. MT safe. - a #GstFlowReturn from the pad. @@ -27818,7 +26343,6 @@ MT safe. Check and clear the #GST_PAD_FLAG_NEED_RECONFIGURE flag on @pad and return %TRUE if the flag was set. - %TRUE is the GST_PAD_FLAG_NEED_RECONFIGURE flag was set on @pad. @@ -27848,7 +26372,6 @@ stream-id manually instead. Since stream IDs are sorted alphabetically, any numbers in the stream ID should be printed with a fixed number of characters, preceded by 0's, such as by using the format \%03u instead of \%u. - A stream-id for @pad. g_free() after usage. @@ -27882,7 +26405,6 @@ doing an URI query on the element and in the worst case just uses a random number. Source elements that don't implement the URI handler interface should ideally generate a unique, deterministic stream-id manually instead. - A stream-id for @pad. g_free() after usage. @@ -27920,7 +26442,6 @@ doing an URI query on the element and in the worst case just uses a random number. Source elements that don't implement the URI handler interface should ideally generate a unique, deterministic stream-id manually instead. - A stream-id for @pad. g_free() after usage. @@ -27952,7 +26473,6 @@ to all internally linked pads, The event is sent to all pads internally linked to @pad. This function takes ownership of @event. - %TRUE if the event was sent successfully. @@ -27978,7 +26498,6 @@ dynamically changing internal pads and will make sure that the @forward function is only called once for each pad. When @forward returns %TRUE, no further pads will be processed. - %TRUE if one of the dispatcher functions returned %TRUE. @@ -28005,7 +26524,6 @@ When @forward returns %TRUE, no further pads will be processed. The allowed capabilities is calculated as the intersection of the results of calling gst_pad_query_caps() on @pad and its peer. The caller owns a reference on the resulting caps. - the allowed #GstCaps of the pad link. Unref the caps when you no longer need it. This @@ -28024,7 +26542,6 @@ MT safe. Gets the capabilities currently configured on @pad with the last #GST_EVENT_CAPS event. - the current caps of the pad with incremented ref-count or %NULL when pad has no caps. Unref after usage. @@ -28041,7 +26558,6 @@ incremented ref-count or %NULL when pad has no caps. Unref after usage. Gets the direction of the pad. The direction of the pad is decided at construction time so this function does not take the LOCK. - the #GstPadDirection of the pad. @@ -28058,7 +26574,6 @@ MT safe. Gets the private data of a pad. No locking is performed in this function. - a #gpointer to the private data. @@ -28072,7 +26587,6 @@ No locking is performed in this function. Gets the #GstFlowReturn return from the last data passed by this pad. - @@ -28086,7 +26600,6 @@ No locking is performed in this function. Get the offset applied to the running time of @pad. @pad has to be a source pad. - the offset. @@ -28100,7 +26613,6 @@ pad. Gets the template for @pad. - the #GstPadTemplate from which this pad was instantiated, or %NULL if this pad has no @@ -28116,7 +26628,6 @@ pad. Gets the capabilities for @pad's template. - the #GstCaps of this pad template. Unref after usage. @@ -28132,7 +26643,6 @@ Unref after usage. Gets the parent of @pad, cast to a #GstElement. If a @pad has no parent or its parent is not an element, return %NULL. - the parent of the pad. The caller has a reference on the parent, so unref when you're finished @@ -28151,7 +26661,6 @@ MT safe. Gets the peer of @pad. This function refs the peer pad so you need to unref it after use. - the peer #GstPad. Unref after usage. @@ -28192,7 +26701,6 @@ When this function returns any other result value than #GST_FLOW_OK, @buffer will be unchanged. This is a lowlevel function. Usually gst_pad_pull_range() is used. - a #GstFlowReturn from the pad. @@ -28222,7 +26730,6 @@ MT safe. If there is a single internal link of the given pad, this function will return it. Otherwise, it will return NULL. - a #GstPad, or %NULL if @pad has none or more than one internal links. Unref returned pad with @@ -28239,7 +26746,6 @@ gst_object_unref(). Returns a new reference of the sticky event of type @event_type from the event. - a #GstEvent of type @event_type or %NULL when no event of @event_type was on @@ -28267,7 +26773,6 @@ set yet, i.e. the pad has not received a stream-start event yet. This is a convenience wrapper around gst_pad_get_sticky_event() and gst_event_parse_stream(). - the current #GstStream for @pad, or %NULL. unref the returned stream when no longer needed. @@ -28289,7 +26794,6 @@ gst_event_parse_stream_start(). The returned stream-id string should be treated as an opaque string, its contents should not be interpreted. - a newly-allocated copy of the stream-id for @pad, or %NULL. g_free() the returned string when no longer @@ -28306,7 +26810,6 @@ contents should not be interpreted. Get @pad task state. If no task is currently set, #GST_TASK_STOPPED is returned. - The current state of @pad's task. @@ -28320,7 +26823,6 @@ set, #GST_TASK_STOPPED is returned. Check if @pad has caps set on it with a #GST_EVENT_CAPS event. - %TRUE when @pad has caps associated with it. @@ -28334,7 +26836,6 @@ set, #GST_TASK_STOPPED is returned. Query if a pad is active - %TRUE if the pad is active. @@ -28352,7 +26853,6 @@ MT safe. Checks if the pad is blocked or not. This function returns the last requested state of the pad. It is not certain that the pad is actually blocking at this point (see gst_pad_is_blocking()). - %TRUE if the pad is blocked. @@ -28369,7 +26869,6 @@ MT safe. Checks if the pad is blocking or not. This is a guaranteed state of whether the pad is actually blocking on a #GstBuffer or a #GstEvent. - %TRUE if the pad is blocking. @@ -28385,7 +26884,6 @@ MT safe. Checks if a @pad is linked to another pad or not. - %TRUE if the pad is linked, %FALSE otherwise. @@ -28407,7 +26905,6 @@ Each #GstPad element yielded by the iterator will have its refcount increased, so unref after use. Free-function: gst_iterator_free - a new #GstIterator of #GstPad or %NULL when the pad does not have an iterator function @@ -28428,7 +26925,6 @@ This is the default handler, and thus returns an iterator of all of the pads inside the parent element with opposite direction. The caller must free this iterator after use with gst_iterator_free(). - a #GstIterator of #GstPad, or %NULL if @pad has no parent. Unref each returned pad with gst_object_unref(). @@ -28447,7 +26943,6 @@ has no parent. Unref each returned pad with gst_object_unref(). Links the source pad and the sink pad. - A result code indicating if the connection worked or what went wrong. @@ -28476,7 +26971,6 @@ can cause severe issues. Refer to the documentation of #GstPadLinkCheck for more information. MT Safe. - A result code indicating if the connection worked or what went wrong. @@ -28505,7 +26999,6 @@ This is a convenience function to save having to create and add intermediate If @src or @sink pads don't have parent elements or do not share a common ancestor, the link will fail. - whether the link succeeded. @@ -28533,7 +27026,6 @@ ancestor, the link will fail. Calling gst_pad_link_maybe_ghosting_full() with @flags == %GST_PAD_LINK_CHECK_DEFAULT is the recommended way of linking pads with safety checks applied. - whether the link succeeded. @@ -28556,7 +27048,6 @@ pads with safety checks applied. Mark a pad for needing reconfiguration. The next call to gst_pad_check_reconfigure() will return %TRUE after this call. - @@ -28570,7 +27061,6 @@ gst_pad_check_reconfigure() will return %TRUE after this call. Check the #GST_PAD_FLAG_NEED_RECONFIGURE flag on @pad and return %TRUE if the flag was set. - %TRUE is the GST_PAD_FLAG_NEED_RECONFIGURE flag is set on @pad. @@ -28586,7 +27076,6 @@ if the flag was set. Pause the task of @pad. This function will also wait until the function executed by the task is finished if this function is not called from the task function. - a %TRUE if the task could be paused or %FALSE when the pad has no task. @@ -28604,7 +27093,6 @@ has no task. The caller is responsible for both the allocation and deallocation of the query structure. - %TRUE if the query could be performed. This function returns %FALSE if @pad has no peer. @@ -28624,7 +27112,6 @@ if @pad has no peer. Check if the peer of @pad accepts @caps. If @pad has no peer, this function returns %TRUE. - %TRUE if the peer of @pad can accept the caps or @pad has no peer. @@ -28649,7 +27136,6 @@ upstream could produce in the order preferred by upstream. When called on sinkpads @filter contains the caps accepted by downstream in the preferred order. @filter might be %NULL but if it is not %NULL the returned caps will be a subset of @filter. - the caps of the peer pad with incremented ref-count. When there is no peer pad, this function returns @filter or, @@ -28670,7 +27156,6 @@ when @filter is %NULL, ANY caps. Queries the peer pad of a given sink pad to convert @src_val in @src_format to @dest_format. - %TRUE if the query could be performed. @@ -28701,7 +27186,6 @@ to @dest_format. Queries the peer pad of a given sink pad for the total stream duration. - %TRUE if the query could be performed. @@ -28725,7 +27209,6 @@ to @dest_format. Queries the peer of a given sink pad for the stream position. - %TRUE if the query could be performed. @@ -28754,7 +27237,6 @@ returns the intersection of the results. This function is useful as a default accept caps query function for an element that can handle any stream format, but requires caps that are acceptable for all opposite pads. - %TRUE if @query could be executed @@ -28777,7 +27259,6 @@ the intersection of the results. This function is useful as a default caps query function for an element that can handle any stream format, but requires all its pads to have the same caps. Two such elements are tee and adder. - %TRUE if @query could be executed @@ -28819,7 +27300,6 @@ accordingly. Note that less than @size bytes can be returned in @buffer when, for example, an EOS condition is near or when @buffer is not large enough to hold @size bytes. The caller should check the result buffer size to get the result size. - a #GstFlowReturn from the peer pad. @@ -28858,7 +27338,6 @@ be returned. In all cases, success or failure, the caller loses its reference to @buffer after calling this function. - a #GstFlowReturn from the peer pad. @@ -28884,7 +27363,6 @@ elements. This function takes ownership of the provided event so you should gst_event_ref() it if you want to reuse the event after this call. - %TRUE if the event was handled. @@ -28916,7 +27394,6 @@ chained via gst_pad_chain(). In all cases, success or failure, the caller loses its reference to @list after calling this function. - a #GstFlowReturn from the peer pad. @@ -28946,7 +27423,6 @@ Again, the caller is responsible for both the allocation and deallocation of the query structure. Please also note that some queries might need a running pipeline to work. - %TRUE if the query could be performed. @@ -28964,7 +27440,6 @@ Please also note that some queries might need a running pipeline to work. Check if the given pad accepts the caps. - %TRUE if the pad can accept the caps. @@ -28996,7 +27471,6 @@ if it is not %NULL the returned caps will be a subset of @filter. Note that this function does not return writable #GstCaps, use gst_caps_make_writable() before modifying the caps. - the caps of the pad with incremented ref-count. @@ -29014,7 +27488,6 @@ gst_caps_make_writable() before modifying the caps. Queries a pad to convert @src_val in @src_format to @dest_format. - %TRUE if the query could be performed. @@ -29048,7 +27521,6 @@ The query is sent to all pads internally linked to @pad. Note that if there are many possible sink pads that are internally linked to @pad, only one will be sent the query. Multi-sinkpad elements should implement custom query handlers. - %TRUE if the query was performed successfully. @@ -29070,7 +27542,6 @@ Multi-sinkpad elements should implement custom query handlers. Queries a pad for the total stream duration. - %TRUE if the query could be performed. @@ -29093,7 +27564,6 @@ Multi-sinkpad elements should implement custom query handlers. Queries a pad for the stream position. - %TRUE if the query could be performed. @@ -29117,7 +27587,6 @@ Multi-sinkpad elements should implement custom query handlers. Remove the probe with @id from @pad. MT safe. - @@ -29153,7 +27622,6 @@ all necessary locks and checks. This function takes ownership of the provided event so you should gst_event_ref() it if you want to reuse the event after this call. - %TRUE if the event was handled. @@ -29175,7 +27643,6 @@ dispatch to gst_pad_activate_mode() to perform the actual activation. Only makes sense to set on sink pads. Call this function if your sink pad can start a pull-based task. - @@ -29201,7 +27668,6 @@ Call this function if your sink pad can start a pull-based task. Sets the given activate_mode function for the pad. An activate_mode function prepares the element for data passing. - @@ -29234,7 +27700,6 @@ function to perform the actual activation. If not @active, calls gst_pad_activate_mode() with the pad's current mode and a %FALSE argument. - %TRUE if the operation was successful. @@ -29255,7 +27720,6 @@ MT safe. Sets the given chain function for the pad. The chain function is called to process a #GstBuffer input buffer. see #GstPadChainFunction for more details. - @@ -29282,7 +27746,6 @@ process a #GstBuffer input buffer. see #GstPadChainFunction for more details.Sets the given chain list function for the pad. The chainlist function is called to process a #GstBufferList input buffer list. See #GstPadChainListFunction for more details. - @@ -29309,7 +27772,6 @@ called to process a #GstBufferList input buffer list. See Set the given private data gpointer on the pad. This function can only be used by the element that owns the pad. No locking is performed in this function. - @@ -29326,7 +27788,6 @@ No locking is performed in this function. Sets the given event handler for the pad. - @@ -29351,7 +27812,6 @@ No locking is performed in this function. Sets the given event handler for the pad. - @@ -29378,7 +27838,6 @@ No locking is performed in this function. Sets the given getrange function for the pad. The getrange function is called to produce a new #GstBuffer to start the processing pipeline. see #GstPadGetRangeFunction for a description of the getrange function. - @@ -29403,7 +27862,6 @@ called to produce a new #GstBuffer to start the processing pipeline. see Sets the given internal link iterator function for the pad. - @@ -29438,7 +27896,6 @@ cannot be made for some reason. If @link is installed on a source pad, it should call the #GstPadLinkFunction of the peer sink pad, if present. - @@ -29463,7 +27920,6 @@ of the peer sink pad, if present. Set the offset that will be applied to the running time of @pad. - @@ -29480,7 +27936,6 @@ of the peer sink pad, if present. Set the given query function for the pad. - @@ -29510,7 +27965,6 @@ when the pad is unlinked. Note that the pad's lock is already held when the unlink function is called, so most pad functions cannot be called from within the callback. - @@ -29538,7 +27992,6 @@ from within the callback. is mostly used in pad activation functions to start the dataflow. The #GST_PAD_STREAM_LOCK of @pad will automatically be acquired before @func is called. - a %TRUE if the task could be started. @@ -29565,7 +28018,6 @@ before @func is called. Iterates all sticky events on @pad and calls @foreach_func for every event. If @foreach_func returns %FALSE the iteration is immediately stopped. - @@ -29595,7 +28047,6 @@ the task. Use gst_task_pause() instead. Regardless of whether the pad has a task, the stream lock is acquired and released so as to ensure that streaming through this pad has finished. - a %TRUE if the task could be stopped or %FALSE on error. @@ -29609,7 +28060,6 @@ released so as to ensure that streaming through this pad has finished. Store the sticky @event on @pad - #GST_FLOW_OK on success, #GST_FLOW_FLUSHING when the pad was flushing or #GST_FLOW_EOS when the pad was EOS. @@ -29629,7 +28079,6 @@ was flushing or #GST_FLOW_EOS when the pad was EOS. Unlinks the source pad from the sink pad. Will emit the #GstPad::unlinked signal on both pads. - %TRUE if the pads were unlinked. This function returns %FALSE if the pads were not linked together. @@ -29656,7 +28105,6 @@ or in case the pad is not negotiated, the padtemplate caps. The negotiated caps are the caps of the last CAPS event that passed on the pad. Use this function on a pad that, once it negotiated to a CAPS, cannot be renegotiated to something else. - @@ -29817,14 +28265,12 @@ be renegotiated to something else. - - @@ -29863,7 +28309,6 @@ be renegotiated to something else. READY to PAUSED state change. By default this function will call the activate function that puts the pad in push mode but elements can override this function to activate the pad in pull mode if they wish. - %TRUE if the pad could be activated. @@ -29881,7 +28326,6 @@ override this function to activate the pad in pull mode if they wish. The prototype of the push and pull activate functions. - %TRUE if the pad could be activated or deactivated. @@ -29915,7 +28359,6 @@ gst_buffer_unref() when the buffer is no longer needed. When a chain function detects an error in the data stream, it must post an error on the bus and return an appropriate #GstFlowReturn value. - #GST_FLOW_OK for success @@ -29947,7 +28390,6 @@ should gst_buffer_list_unref() when the list is no longer needed. When a chainlist function detects an error in the data stream, it must post an error on the bus and return an appropriate #GstFlowReturn value. - #GST_FLOW_OK for success @@ -29970,13 +28412,11 @@ post an error on the bus and return an appropriate #GstFlowReturn value. - - @@ -29992,7 +28432,6 @@ post an error on the bus and return an appropriate #GstFlowReturn value. - @@ -30030,7 +28469,6 @@ post an error on the bus and return an appropriate #GstFlowReturn value. This variant is for specific elements that will take into account the last downstream flow return (from a pad push), in which case they can return it. - %GST_FLOW_OK if the event was handled properly, or any other #GstFlowReturn dependent on downstream state. @@ -30055,7 +28493,6 @@ return it. Function signature to handle an event for the pad. - %TRUE if the pad could handle the event. @@ -30142,7 +28579,6 @@ return it. A forward function is called for all internally linked pads, see gst_pad_forward(). - %TRUE if the dispatching procedure has to be stopped. @@ -30192,7 +28628,6 @@ of length @length in the stream is returned. When this function is called with a -1 @length, a buffer with a default optimal length is returned in @buffer. The length might depend on the value of @offset. - #GST_FLOW_OK for success and a valid buffer in @buffer. Any other return value leaves @buffer undefined. @@ -30225,7 +28660,6 @@ return value leaves @buffer undefined. The signature of the internal pad link iterator function. - a new #GstIterator that will iterate over all pads that are linked to the given pad on the inside of the parent element. @@ -30283,7 +28717,6 @@ specified, expensive but safe @GST_PAD_LINK_CHECK_CAPS are performed. Function signature to handle a new link on the pad. - the result of the link with the specified peer. @@ -30344,7 +28777,6 @@ pad operates in push or pull mode. Return the name of a pad mode, for use in debug messages mostly. - short mnemonic for pad mode @mode @@ -30370,15 +28802,12 @@ pad operates in push or pull mode. gst_element_request_pad(). - - - + Callback used by gst_pad_add_probe(). Gets called to notify about the current blocking type. The callback is allowed to modify the data pointer in @info. - a #GstPadProbeReturn @@ -30400,7 +28829,6 @@ The callback is allowed to modify the data pointer in @info. Info passed in the #GstPadProbeCallback. - the current probe type @@ -30425,21 +28853,18 @@ The callback is allowed to modify the data pointer in @info. - - - The #GstBuffer from the probe @@ -30452,7 +28877,6 @@ The callback is allowed to modify the data pointer in @info. - The #GstBufferList from the probe @@ -30465,7 +28889,6 @@ The callback is allowed to modify the data pointer in @info. - The #GstEvent from the probe @@ -30478,7 +28901,6 @@ The callback is allowed to modify the data pointer in @info. - The #GstQuery from the probe @@ -30601,7 +29023,6 @@ blocking probe. The signature of the query function. - %TRUE if the query could be performed. @@ -30633,7 +29054,6 @@ When @event is set to %NULL, the item will be removed from the list of sticky ev @event can be replaced by assigning a new reference to it. This function is responsible for unreffing the old event when removing or modifying. - %TRUE if the iteration should continue @@ -30714,11 +29134,9 @@ element class, this is usually done in the class_init of the class: gst_element_class_add_static_pad_template (gstelement_class, &amp;my_template); } ]| - Creates a new pad template with a name according to the given template and with the given arguments. - a new #GstPadTemplate. @@ -30744,7 +29162,6 @@ and with the given arguments. Converts a #GstStaticPadTemplate into a #GstPadTemplate with a type. - a new #GstPadTemplate. @@ -30763,7 +29180,6 @@ and with the given arguments. Creates a new pad template with a name according to the given template and with the given arguments. - a new #GstPadTemplate. @@ -30793,7 +29209,6 @@ and with the given arguments. Emit the pad-created signal for this template when created by this pad. - @@ -30810,7 +29225,6 @@ and with the given arguments. Gets the capabilities of the pad template. - the #GstCaps of the pad template. Unref after usage. @@ -30825,7 +29239,6 @@ Unref after usage. See gst_pad_template_set_documentation_caps(). - The caps to document. For convenience, this will return gst_pad_template_get_caps() when no documentation caps were set. @@ -30840,7 +29253,6 @@ Unref after usage. Emit the pad-created signal for this template when created by this pad. - @@ -30860,7 +29272,6 @@ Unref after usage. pad templates. In order not to let environment-specific information into the documentation, element authors should use this method to expose "stable" caps to the reader. - @@ -30911,14 +29322,12 @@ expose "stable" caps to the reader. - - @@ -30941,13 +29350,11 @@ expose "stable" caps to the reader. - - @@ -30980,7 +29387,6 @@ expose "stable" caps to the reader. The pad's lock is already held when the unlink function is called, so most pad functions cannot be called from within the callback. - @@ -31007,7 +29413,6 @@ properties A GParamSpec derived structure for arrays of values. - super class @@ -31020,7 +29425,6 @@ properties A GParamSpec derived structure that contains the meta data for fractional properties. - super class @@ -31059,7 +29463,6 @@ Typically, #GstParentBufferMeta is used when the child buffer is directly using the #GstMemory of the parent buffer, and wants to prevent the parent buffer from being returned to a buffer pool until the #GstMemory is available for re-use. - the parent #GstMeta structure @@ -31070,7 +29473,6 @@ for re-use. Get the global #GstMetaInfo describing the #GstParentBufferMeta meta. - The #GstMetaInfo @@ -31079,13 +29481,11 @@ for re-use. Opaque structure. - Allocates a parse context for use with gst_parse_launch_full() or gst_parse_launchv_full(). Free-function: gst_parse_context_free - a newly-allocated parse context. Free with gst_parse_context_free() when no longer needed. @@ -31094,7 +29494,6 @@ Free-function: gst_parse_context_free Copies the @context. - A copied #GstParseContext @@ -31108,7 +29507,6 @@ Free-function: gst_parse_context_free Frees a parse context previously allocated with gst_parse_context_new(). - @@ -31123,7 +29521,6 @@ Free-function: gst_parse_context_free Retrieve missing elements from a previous run of gst_parse_launch_full() or gst_parse_launchv_full(). Will only return results if an error code of %GST_PARSE_ERROR_NO_SUCH_ELEMENT was returned. - a %NULL-terminated array of element factory name strings of missing @@ -31240,11 +29637,9 @@ to PLAYING again. The effect is that the running time (as the difference between the clock time and the base time) will count how much time was spent in the PLAYING state. This default behaviour can be changed with the gst_element_set_start_time() method. - Create a new pipeline with the given name. - newly created GstPipeline @@ -31267,7 +29662,6 @@ gst_pipeline_use_clock() and want to restore the default pipeline clock selection algorithm. MT safe. - @@ -31281,7 +29675,6 @@ MT safe. Check if @pipeline will automatically flush messages when going to the NULL state. - whether the pipeline will automatically flush its bus when going from READY to NULL state or not. @@ -31299,7 +29692,6 @@ MT safe. Gets the #GstBus of @pipeline. The bus allows applications to receive #GstMessage packets. - a #GstBus, unref after usage. @@ -31320,7 +29712,6 @@ to avoid confusion with gst_element_get_clock() which has a different behavior. Unlike gst_element_get_clock(), this function will always return a clock, even if the pipeline is not in the PLAYING state. - a #GstClock, unref after usage. @@ -31334,7 +29725,6 @@ clock, even if the pipeline is not in the PLAYING state. Get the configured delay (see gst_pipeline_set_delay()). - The configured delay. @@ -31351,7 +29741,6 @@ MT safe. Gets the latency that should be configured on the pipeline. See gst_pipeline_set_latency(). - Latency to configure on the pipeline or GST_CLOCK_TIME_NONE @@ -31368,7 +29757,6 @@ gst_pipeline_set_latency(). Unlike gst_element_get_clock(), this function will always return a clock, even if the pipeline is not in the PLAYING state. - a #GstClock, unref after usage. @@ -31395,7 +29783,6 @@ It is important that all messages on the bus are handled when the automatic flushing is disabled else memory leaks will be introduced. MT safe. - @@ -31414,7 +29801,6 @@ the pipeline goes from READY to NULL state Set the clock for @pipeline. The clock will be distributed to all the elements managed by the pipeline. - %TRUE if the clock could be set on the pipeline. %FALSE if some element did not accept the clock. @@ -31444,7 +29830,6 @@ This option is used for tuning purposes and should normally not be used. MT safe. - @@ -31467,7 +29852,6 @@ the pipeline will figure out an appropriate latency automatically. Setting a too low latency, especially lower than the minimum latency from the LATENCY query, will most likely cause the pipeline to fail. - @@ -31491,7 +29875,6 @@ If @clock is %NULL all clocking will be disabled which will make the pipeline run as fast as possible. MT safe. - @@ -31552,7 +29935,6 @@ see gst_pipeline_set_delay() for more information on this option. - @@ -31571,9 +29953,7 @@ see gst_pipeline_set_delay() for more information on this option. offset to define more flags - - - + GStreamer is extensible, so #GstElement instances can be loaded at runtime. A plugin system can provide one or more of the basic GStreamer @@ -31594,10 +29974,8 @@ gst_plugin_load() explicitly to bring it into memory. There are options to statically link plugins to an app or even use GStreamer without a plugin repository in which case gst_plugin_load() can be needed to bring the plugin into memory. - Unrefs each member of @list, then frees the list. - @@ -31612,7 +29990,6 @@ into memory. Load the named plugin. Refs the plugin. - a reference to a loaded plugin, or %NULL on error. @@ -31627,7 +30004,6 @@ into memory. Loads the given plugin and refs it. Caller needs to unref after use. - a reference to the existing loaded GstPlugin, a reference to the newly-loaded GstPlugin, or %NULL if an error occurred. @@ -31647,7 +30023,6 @@ being shipped as a separate module file). You must make sure that GStreamer has been initialised (with gst_init() or via gst_init_get_option_group()) before calling this function. - %TRUE if the plugin was registered correctly, otherwise %FALSE. @@ -31709,7 +30084,6 @@ for bindings). You must make sure that GStreamer has been initialised (with gst_init() or via gst_init_get_option_group()) before calling this function. - %TRUE if the plugin was registered correctly, otherwise %FALSE. @@ -31777,7 +30151,6 @@ other plugin systems, e.g. a plugin which wraps a plugin-based visualisation library and makes visualisations available as GStreamer elements, or a codec loader which exposes elements and/or caps dependent on what external codec libraries are currently installed. - @@ -31833,7 +30206,6 @@ codec libraries are currently installed. Convenience wrapper function for gst_plugin_add_dependency() which takes simple strings as arguments instead of string arrays, with multiple arguments separated by predefined delimiters (see above). - @@ -31868,7 +30240,6 @@ arguments separated by predefined delimiters (see above). Gets the plugin specific data cache. If it is %NULL there is no cached data stored. This is the case when the registry is getting rebuilt. - The cached data as a #GstStructure or %NULL. @@ -31883,7 +30254,6 @@ stored. This is the case when the registry is getting rebuilt. Get the long descriptive name of the plugin - the long name of the plugin @@ -31897,7 +30267,6 @@ stored. This is the case when the registry is getting rebuilt. get the filename of the plugin - the filename of the plugin @@ -31911,7 +30280,6 @@ stored. This is the case when the registry is getting rebuilt. get the license of the plugin - the license of the plugin @@ -31925,7 +30293,6 @@ stored. This is the case when the registry is getting rebuilt. Get the short name of the plugin - the name of the plugin @@ -31939,7 +30306,6 @@ stored. This is the case when the registry is getting rebuilt. get the URL where the plugin comes from - the origin of the plugin @@ -31953,7 +30319,6 @@ stored. This is the case when the registry is getting rebuilt. get the package the plugin belongs to. - the package of the plugin @@ -31974,7 +30339,6 @@ a time component after the date as well, in which case the string will be formatted like "YYYY-MM-DDTHH:MMZ" (e.g. "2012-04-30T09:30Z"). There may be plugins that do not have a valid release date set on them. - the date string of the plugin, or %NULL if not available. @@ -31989,7 +30353,6 @@ available. get the source module the plugin belongs to. - the source of the plugin @@ -32003,7 +30366,6 @@ available. get the version of the plugin - the version of the plugin @@ -32017,7 +30379,6 @@ available. queries if the plugin is loaded into memory - %TRUE is loaded, %FALSE otherwise @@ -32040,7 +30401,6 @@ loaded_plugin = gst_plugin_load (plugin); gst_object_unref (plugin); plugin = loaded_plugin; ]| - a reference to a loaded plugin, or %NULL on error. @@ -32058,7 +30418,6 @@ plugin = loaded_plugin; the @plugin. The cache is flushed every time the registry is rebuilt. - @@ -32081,9 +30440,7 @@ The cache is flushed every time the registry is rebuilt. dynamically, in order not to expose incorrect documentation to the end user. - - - + Flags used in connection with gst_plugin_add_dependency(). @@ -32118,7 +30475,6 @@ loader will use the data provided there to initialize the plugin. The @licence parameter must be one of: LGPL, GPL, QPL, GPL/QPL, MPL, BSD, MIT/X11, Proprietary, unknown. - the major version number of core that plugin was compiled for @@ -32195,11 +30551,9 @@ BSD, MIT/X11, Proprietary, unknown. This is a base class for anything that can be added to a #GstPlugin. - Copies the list of features. Caller should call @gst_plugin_feature_list_free when done with the list. - a copy of @list, with each feature's reference count incremented. @@ -32219,7 +30573,6 @@ when done with the list. Debug the plugin feature names in @list. - @@ -32235,7 +30588,6 @@ when done with the list. Unrefs each member of @list, then frees the list. - @@ -32252,7 +30604,6 @@ when done with the list. Compares the two given #GstPluginFeature instances. This function can be used as a #GCompareFunc when sorting by rank and then by name. - negative value if the rank of p1 > the rank of p2 or the ranks are equal but the name of p1 comes before the name of p2; zero if the rank @@ -32274,7 +30625,6 @@ ranks are equal but the name of p2 comes before the name of p1 Checks whether the given plugin feature is at least the required version - %TRUE if the plugin feature has at least the required version, otherwise %FALSE. @@ -32301,7 +30651,6 @@ ranks are equal but the name of p2 comes before the name of p1 Get the plugin that provides this feature. - the plugin that provides this feature, or %NULL. Unref with gst_object_unref() when no @@ -32317,7 +30666,6 @@ ranks are equal but the name of p2 comes before the name of p1 Get the name of the plugin that provides this feature. - the name of the plugin that provides this feature, or %NULL if the feature is not associated with a @@ -32333,7 +30681,6 @@ ranks are equal but the name of p2 comes before the name of p1 Gets the rank of a plugin feature. - The rank of the feature @@ -32358,7 +30705,6 @@ loaded_feature = gst_plugin_feature_load (feature); gst_object_unref (feature); feature = loaded_feature; ]| - a reference to the loaded feature, or %NULL on error @@ -32374,7 +30720,6 @@ feature, or %NULL on error Specifies a rank for a plugin feature, so that autoplugging uses the most appropriate feature. - @@ -32390,13 +30735,10 @@ the most appropriate feature. - - - + A function that can be used with e.g. gst_registry_feature_filter() to get a list of pluginfeature that match certain criteria. - %TRUE for a positive match, %FALSE otherwise @@ -32416,7 +30758,6 @@ to get a list of pluginfeature that match certain criteria. A function that can be used with e.g. gst_registry_plugin_filter() to get a list of plugins that match certain criteria. - %TRUE for a positive match, %FALSE otherwise @@ -32447,7 +30788,6 @@ or this type in the plugin_desc struct. The function will be called by the loader at startup. One would then register each #GstPluginFeature. This version allows user data to be passed to init function (useful for bindings). - %TRUE if plugin initialised successfully @@ -32468,7 +30808,6 @@ user data to be passed to init function (useful for bindings). plugin_desc struct. This function will be called by the loader at startup. One would then register each #GstPluginFeature. - %TRUE if plugin initialised successfully @@ -32504,10 +30843,8 @@ gst_poll_fd_has_error() to see if it has generated an error, gst_poll_fd_can_read() to see if it is possible to read from the file descriptor, and gst_poll_fd_can_write() to see if it is possible to write to it. - Add a file descriptor to the file descriptor set. - %TRUE if the file descriptor was successfully added to the set. @@ -32525,7 +30862,6 @@ write to it. Check if @fd in @set has data to be read. - %TRUE if the descriptor has data to be read. @@ -32543,7 +30879,6 @@ write to it. Check if @fd in @set can be used for writing. - %TRUE if the descriptor can be used for writing. @@ -32564,7 +30899,6 @@ write to it. exceptional conditions (POLLPRI). Not implemented on Windows (will just return %FALSE there). - %TRUE if the descriptor was successfully updated. @@ -32587,7 +30921,6 @@ Not implemented on Windows (will just return %FALSE there). Control whether the descriptor @fd in @set will be monitored for readability. - %TRUE if the descriptor was successfully updated. @@ -32610,7 +30943,6 @@ readability. Control whether the descriptor @fd in @set will be monitored for writability. - %TRUE if the descriptor was successfully updated. @@ -32632,7 +30964,6 @@ writability. Check if @fd in @set has closed the connection. - %TRUE if the connection was closed. @@ -32650,7 +30981,6 @@ writability. Check if @fd in @set has an error. - %TRUE if the descriptor has an error. @@ -32670,7 +31000,6 @@ writability. Check if @fd in @set has an exceptional condition (POLLPRI). Not implemented on Windows (will just return %FALSE there). - %TRUE if the descriptor has an exceptional condition. @@ -32695,7 +31024,6 @@ the next call to gst_poll_wait(). The reason why this is needed is because the underlying implementation might not allow querying the fd more than once between calls to one of the re-enabling operations. - @@ -32712,7 +31040,6 @@ the re-enabling operations. Free a file descriptor set. - @@ -32726,7 +31053,6 @@ the re-enabling operations. Get a GPollFD for the reading part of the control socket. This is useful when integrating with a GSource and GMainLoop. - @@ -32746,7 +31072,6 @@ integrating with a GSource and GMainLoop. This function only works for timer #GstPoll objects created with gst_poll_new_timer(). - %TRUE on success. %FALSE when when there was no byte to read or reading the byte failed. If there was no byte to read, and only then, errno @@ -32763,7 +31088,6 @@ critical error. Remove a file descriptor from the file descriptor set. - %TRUE if the file descriptor was successfully removed from the set. @@ -32787,7 +31111,6 @@ If @set is not controllable, then this call will have no effect. This function only works for non-timer #GstPoll objects created with gst_poll_new(). - @@ -32805,7 +31128,6 @@ gst_poll_set_flushing(). This function only works for non-timer #GstPoll objects created with gst_poll_new(). - %TRUE if the controllability of @set could be updated. @@ -32829,7 +31151,6 @@ Unsetting the flushing state will restore normal operation of @set. This function only works for non-timer #GstPoll objects created with gst_poll_new(). - @@ -32855,7 +31176,6 @@ called from a single thread at a time. If called from multiple threads, This is not true for timer #GstPoll objects created with gst_poll_new_timer(), where it is allowed to have multiple threads waiting simultaneously. - The number of #GstPollFD in @set that have activity or 0 when no activity was detected after @timeout. If an error occurs, -1 is returned @@ -32885,7 +31205,6 @@ block again until their timeout expired. This function only works for timer #GstPoll objects created with gst_poll_new_timer(). - %TRUE on success. %FALSE when when the byte could not be written. errno contains the detailed error code but will never be EAGAIN, EINTR or @@ -32905,7 +31224,6 @@ is possible to restart or flush a call to gst_poll_wait() with gst_poll_restart() and gst_poll_set_flushing() respectively. Free-function: gst_poll_free - a new #GstPoll, or %NULL in case of an error. Free with gst_poll_free(). @@ -32926,7 +31244,6 @@ A timeout is performed with gst_poll_wait(). Multiple timeouts can be performed from different threads. Free-function: gst_poll_free - a new #GstPoll, or %NULL in case of an error. Free with gst_poll_free(). @@ -32936,7 +31253,6 @@ Free-function: gst_poll_free A file descriptor object. - a file descriptor @@ -32947,7 +31263,6 @@ Free-function: gst_poll_free Initializes @fd. Alternatively you can initialize it with #GST_POLL_FD_INIT. - @@ -32983,11 +31298,9 @@ a list of presets individual presets are read and overlaid in 1) system, later entries will be updated. Since 1.8 you can also provide extra paths where to find presets through the GST_PRESET_PATH environment variable. Presets found in those paths will be considered as "app presets". - Gets the directory for application specific presets if set by the application. - the directory or %NULL, don't free or modify the string @@ -32998,7 +31311,6 @@ the string Sets an extra directory as an absolute path that should be considered when looking for presets. Any presets in the application dir will shadow the system presets. - %TRUE for success, %FALSE if the dir already has been set @@ -33012,7 +31324,6 @@ system presets. Delete the given preset. - %TRUE for success, %FALSE if e.g. there is no preset with that @name @@ -33031,7 +31342,6 @@ system presets. Gets the @value for an existing meta data @tag. Meta data @tag names can be something like e.g. "comment". Returned values need to be released when done. - %TRUE for success, %FALSE if e.g. there is no preset with that @name or no value for the given @tag @@ -33058,7 +31368,6 @@ or no value for the given @tag Get a copy of preset names as a %NULL terminated string array. - list with names, use g_strfreev() after usage. @@ -33075,7 +31384,6 @@ or no value for the given @tag Get a the names of the GObject properties that can be used for presets. - an array of property names which should be freed with g_strfreev() after use. @@ -33092,7 +31400,6 @@ or no value for the given @tag Load the given preset. - %TRUE for success, %FALSE if e.g. there is no preset with that @name @@ -33111,7 +31418,6 @@ or no value for the given @tag Renames a preset. If there is already a preset by the @new_name it will be overwritten. - %TRUE for success, %FALSE if e.g. there is no preset with @old_name @@ -33134,7 +31440,6 @@ overwritten. Save the current object settings as a preset under the given name. If there is already a preset by this @name it will be overwritten. - %TRUE for success, %FALSE @@ -33154,7 +31459,6 @@ is already a preset by this @name it will be overwritten. Sets a new @value for an existing meta data item or adds a new item. Meta data @tag names can be something like e.g. "comment". Supplying %NULL for the @value will unset an existing value. - %TRUE for success, %FALSE if e.g. there is no preset with that @name @@ -33180,7 +31484,6 @@ data @tag names can be something like e.g. "comment". Supplying %NULL for the Delete the given preset. - %TRUE for success, %FALSE if e.g. there is no preset with that @name @@ -33199,7 +31502,6 @@ data @tag names can be something like e.g. "comment". Supplying %NULL for the Gets the @value for an existing meta data @tag. Meta data @tag names can be something like e.g. "comment". Returned values need to be released when done. - %TRUE for success, %FALSE if e.g. there is no preset with that @name or no value for the given @tag @@ -33226,7 +31528,6 @@ or no value for the given @tag Get a copy of preset names as a %NULL terminated string array. - list with names, use g_strfreev() after usage. @@ -33243,7 +31544,6 @@ or no value for the given @tag Get a the names of the GObject properties that can be used for presets. - an array of property names which should be freed with g_strfreev() after use. @@ -33260,7 +31560,6 @@ or no value for the given @tag Check if one can add new presets, change existing ones and remove presets. - %TRUE if presets are editable or %FALSE if they are static @@ -33274,7 +31573,6 @@ or no value for the given @tag Load the given preset. - %TRUE for success, %FALSE if e.g. there is no preset with that @name @@ -33293,7 +31591,6 @@ or no value for the given @tag Renames a preset. If there is already a preset by the @new_name it will be overwritten. - %TRUE for success, %FALSE if e.g. there is no preset with @old_name @@ -33316,7 +31613,6 @@ overwritten. Save the current object settings as a preset under the given name. If there is already a preset by this @name it will be overwritten. - %TRUE for success, %FALSE @@ -33336,7 +31632,6 @@ is already a preset by this @name it will be overwritten. Sets a new @value for an existing meta data item or adds a new item. Meta data @tag names can be something like e.g. "comment". Supplying %NULL for the @value will unset an existing value. - %TRUE for success, %FALSE if e.g. there is no preset with that @name @@ -33363,14 +31658,12 @@ data @tag names can be something like e.g. "comment". Supplying %NULL for the #GstPreset interface. - parent interface type. - list with names, use g_strfreev() after usage. @@ -33388,7 +31681,6 @@ data @tag names can be something like e.g. "comment". Supplying %NULL for the - an array of property names which should be freed with g_strfreev() after use. @@ -33406,7 +31698,6 @@ data @tag names can be something like e.g. "comment". Supplying %NULL for the - %TRUE for success, %FALSE if e.g. there is no preset with that @name @@ -33425,7 +31716,6 @@ data @tag names can be something like e.g. "comment". Supplying %NULL for the - %TRUE for success, %FALSE @@ -33444,7 +31734,6 @@ data @tag names can be something like e.g. "comment". Supplying %NULL for the - %TRUE for success, %FALSE if e.g. there is no preset with @old_name @@ -33467,7 +31756,6 @@ data @tag names can be something like e.g. "comment". Supplying %NULL for the - %TRUE for success, %FALSE if e.g. there is no preset with that @name @@ -33486,7 +31774,6 @@ data @tag names can be something like e.g. "comment". Supplying %NULL for the - %TRUE for success, %FALSE if e.g. there is no preset with that @name @@ -33513,7 +31800,6 @@ data @tag names can be something like e.g. "comment". Supplying %NULL for the - %TRUE for success, %FALSE if e.g. there is no preset with that @name or no value for the given @tag @@ -33619,13 +31905,11 @@ gst_promise_interrupt() or gst_promise_expire() and can be called from an arbitrary thread. #GstPromise using APIs can restrict this to a single thread or a subset of threads but that is entirely up to the API that uses #GstPromise. - parent #GstMiniObject - a new #GstPromise @@ -33635,7 +31919,6 @@ that uses #GstPromise. @func will be called exactly once when transitioning out of %GST_PROMISE_RESULT_PENDING into any of the other #GstPromiseResult states. - a new #GstPromise @@ -33659,7 +31942,6 @@ states. Expire a @promise. This will wake up any waiters with %GST_PROMISE_RESULT_EXPIRED. Called by a message loop when the parent message is handled and/or destroyed (possibly unanswered). - @@ -33673,7 +31955,6 @@ message is handled and/or destroyed (possibly unanswered). Retrieve the reply set on @promise. @promise must be in %GST_PROMISE_RESULT_REPLIED and the returned structure is owned by @promise - The reply set on @promise @@ -33689,7 +31970,6 @@ message is handled and/or destroyed (possibly unanswered). Interrupt waiting for a @promise. This will wake up any waiters with %GST_PROMISE_RESULT_INTERRUPTED. Called when the consumer does not want the value produced anymore. - @@ -33707,7 +31987,6 @@ indicate success (or failure). If @promise has already been interrupted by the consumer, then this reply is not visible to the consumer. - @@ -33726,7 +32005,6 @@ is not visible to the consumer. Wait for @promise to move out of the %GST_PROMISE_RESULT_PENDING state. If @promise is not in %GST_PROMISE_RESULT_PENDING then it will return immediately with the current result. - the result of the promise @@ -33740,7 +32018,6 @@ immediately with the current result. - @@ -33776,7 +32053,6 @@ immediately with the current result. Metadata type that holds information about a sample from a protection-protected track, including the information needed to decrypt it (if it is encrypted). - the parent #GstMeta. @@ -33786,17 +32062,14 @@ track, including the information needed to decrypt it (if it is encrypted). - - Invoke the default chain function of the proxy pad. - a #GstFlowReturn from the pad. @@ -33819,7 +32092,6 @@ track, including the information needed to decrypt it (if it is encrypted). Invoke the default chain list function of the proxy pad. - a #GstFlowReturn from the pad. @@ -33842,7 +32114,6 @@ track, including the information needed to decrypt it (if it is encrypted). Invoke the default getrange function of the proxy pad. - a #GstFlowReturn from the pad. @@ -33873,7 +32144,6 @@ track, including the information needed to decrypt it (if it is encrypted). Invoke the default iterate internal links function of the proxy pad. - a #GstIterator of #GstPad, or %NULL if @pad has no parent. Unref each returned pad with gst_object_unref(). @@ -33895,7 +32165,6 @@ has no parent. Unref each returned pad with gst_object_unref(). The internal pad of a #GstGhostPad is the internally used pad of opposite direction, which is used to link to the target. - the target #GstProxyPad, can be %NULL. Unref target pad after usage. @@ -33916,7 +32185,6 @@ be %NULL. Unref target pad after usage. - @@ -33926,9 +32194,7 @@ be %NULL. Unref target pad after usage. - - - + The different types of QoS events that can be given to the gst_event_new_qos() method. @@ -33949,14 +32215,12 @@ gst_event_new_qos() method. - - @@ -33964,7 +32228,6 @@ gst_event_new_qos() method. Check if an query can travel downstream. - the query to query @@ -33973,7 +32236,6 @@ gst_event_new_qos() method. Check if an query is serialized with the data stream. - the query to query @@ -33982,7 +32244,6 @@ gst_event_new_qos() method. Check if an query can travel upstream. - the query to query @@ -33992,7 +32253,6 @@ gst_event_new_qos() method. when making custom query types, use this macro with the num and the given flags - the query number to create @@ -34003,12 +32263,10 @@ the given flags - Get the #GstQueryType of the query. - the query to query @@ -34017,12 +32275,10 @@ the given flags The same thing as #GST_QUERY_TYPE_UPSTREAM | #GST_QUERY_TYPE_DOWNSTREAM. - Get a constant string representation of the #GstQueryType of the query. - the query to query @@ -34053,7 +32309,6 @@ The following example shows how to query the duration of a pipeline: } gst_query_unref (query); ]| - The parent #GstMiniObject type @@ -34066,7 +32321,6 @@ The following example shows how to query the duration of a pipeline: Constructs a new query object for querying if @caps are accepted. Free-function: gst_query_unref() - a new #GstQuery @@ -34082,7 +32336,6 @@ Free-function: gst_query_unref() Constructs a new query object for querying the allocation properties. Free-function: gst_query_unref() - a new #GstQuery @@ -34102,7 +32355,6 @@ Free-function: gst_query_unref() Constructs a new query object for querying the bitrate. Free-function: gst_query_unref() - a new #GstQuery @@ -34113,7 +32365,6 @@ Free-function: gst_query_unref() a stream. Free-function: gst_query_unref() - a new #GstQuery @@ -34146,7 +32397,6 @@ The @filter is used to restrict the result caps, only the caps matching greatly reduce the amount of processing an element needs to do. Free-function: gst_query_unref() - a new #GstQuery @@ -34162,7 +32412,6 @@ Free-function: gst_query_unref() Constructs a new query object for querying the pipeline-local context. Free-function: gst_query_unref() - a new #GstQuery @@ -34180,7 +32429,6 @@ when done with it. A convert query is used to ask for a conversion between one format and another. Free-function: gst_query_unref() - a #GstQuery @@ -34205,7 +32453,6 @@ Free-function: gst_query_unref() when done with it. Free-function: gst_query_unref() - a new #GstQuery @@ -34225,7 +32472,6 @@ Free-function: gst_query_unref() Constructs a new query object for querying the drain state. Free-function: gst_query_unref() - a new #GstQuery @@ -34237,7 +32483,6 @@ Use gst_query_unref() when done with it. A duration query will give the total length of the stream. Free-function: gst_query_unref() - a new #GstQuery @@ -34254,7 +32499,6 @@ Free-function: gst_query_unref() the stream. Free-function: gst_query_unref() - a new #GstQuery @@ -34267,7 +32511,6 @@ by sinks to compensate for additional latency introduced by elements in the pipeline. Free-function: gst_query_unref() - a #GstQuery @@ -34279,7 +32522,6 @@ when done with it. A position query is used to query the current position of playback in the streams, in some format. Free-function: gst_query_unref() - a new #GstQuery @@ -34295,7 +32537,6 @@ Free-function: gst_query_unref() Constructs a new query object for querying the scheduling properties. Free-function: gst_query_unref() - a new #GstQuery @@ -34306,7 +32547,6 @@ Free-function: gst_query_unref() the stream. Free-function: gst_query_unref() - a new #GstQuery @@ -34324,7 +32564,6 @@ when done with it. A segment query is used to discover information about the currently configured segment for playback. Free-function: gst_query_unref() - a new #GstQuery @@ -34342,7 +32581,6 @@ when done with it. An URI query is used to query the current URI that is used by the source or sink. Free-function: gst_query_unref() - a new #GstQuery @@ -34350,7 +32588,6 @@ Free-function: gst_query_unref() Add @api with @params as one of the supported metadata API to @query. - @@ -34371,7 +32608,6 @@ Free-function: gst_query_unref() Add @allocator and its @params as a supported memory allocator. - @@ -34392,7 +32628,6 @@ Free-function: gst_query_unref() Set the pool parameters in @query. - @@ -34422,7 +32657,6 @@ Free-function: gst_query_unref() Set the buffering-ranges array field in @query. The current last start position of the array should be inferior to @start. - a #gboolean indicating if the range was added or not. @@ -34444,7 +32678,6 @@ start position of the array should be inferior to @start. Add @mode as one of the supported scheduling modes to @query. - @@ -34463,7 +32696,6 @@ start position of the array should be inferior to @start. Copies the given query using the copy function of the parent #GstStructure. Free-function: gst_query_unref - a new copy of @q. @@ -34479,7 +32711,6 @@ Free-function: gst_query_unref Check if @query has metadata @api set. When this function returns %TRUE, @index will contain the index where the requested API and the parameters can be found. - %TRUE when @api is in the list of metadata. @@ -34502,7 +32733,6 @@ can be found. Retrieve the number of values currently stored in the meta API array of the query's structure. - the metadata API array size as a #guint. @@ -34522,7 +32752,6 @@ If no memory allocator is specified, the downstream element can handle the default memory allocator. The first memory allocator in the query should be generic and allow mapping to system memory, all following allocators should be ordered by preference with the preferred one first. - the allocator array size as a #guint. @@ -34537,7 +32766,6 @@ allocators should be ordered by preference with the preferred one first. Retrieve the number of values currently stored in the pool array of the query's structure. - the pool array size as a #guint. @@ -34552,7 +32780,6 @@ pool array of the query's structure. Retrieve the number of values currently stored in the buffered-ranges array of the query's structure. - the range array size as a #guint. @@ -34567,7 +32794,6 @@ buffered-ranges array of the query's structure. Retrieve the number of values currently stored in the scheduling mode array of the query's structure. - the scheduling mode array size as a #guint. @@ -34581,7 +32807,6 @@ scheduling mode array of the query's structure. Get the structure of a query. - the #GstStructure of the query. The structure is still owned by the query and will therefore be freed when the @@ -34603,7 +32828,6 @@ scheduling mode array of the query's structure. > also want to check whether the scheduling flags returned by > gst_query_parse_scheduling() have the seeking flag set (meaning > random access is supported, not only sequential pulls). - %TRUE when @mode is in the list of scheduling modes. @@ -34622,7 +32846,6 @@ scheduling mode array of the query's structure. Check if @query has scheduling mode set and @flags is set in query scheduling flags. - %TRUE when @mode is in the list of scheduling modes and @flags are compatible with query flags. @@ -34646,7 +32869,6 @@ query scheduling flags. Get the caps from @query. The caps remains valid as long as @query remains valid. - @@ -34663,7 +32885,6 @@ valid. Parse the result from @query and store in @result. - @@ -34685,7 +32906,6 @@ are non-%NULL. Pool details can be retrieved using gst_query_get_n_allocation_pools() and gst_query_parse_nth_allocation_pool(). - @@ -34706,7 +32926,6 @@ gst_query_parse_nth_allocation_pool(). Get the results of a bitrate query. See also gst_query_set_bitrate(). - @@ -34724,7 +32943,6 @@ gst_query_parse_nth_allocation_pool(). Get the percentage of buffered data. This is a value between 0 and 100. The @busy indicator is %TRUE when the buffering is in progress. - @@ -34747,7 +32965,6 @@ The @busy indicator is %TRUE when the buffering is in progress. Parse an available query, writing the format into @format, and other results into the passed parameters, if the respective parameters are non-%NULL - @@ -34778,7 +32995,6 @@ are non-%NULL Extracts the buffering stats values from @query. - @@ -34809,7 +33025,6 @@ are non-%NULL Get the filter from the caps @query. The caps remains valid as long as @query remains valid. - @@ -34827,7 +33042,6 @@ are non-%NULL Get the caps result from @query. The caps remains valid as long as @query remains valid. - @@ -34845,7 +33059,6 @@ are non-%NULL Get the context from the context @query. The context remains valid as long as @query remains valid. - @@ -34862,7 +33075,6 @@ are non-%NULL Parse a context type from an existing GST_QUERY_CONTEXT query. - a #gboolean indicating if the parsing succeeded. @@ -34881,7 +33093,6 @@ are non-%NULL Parse a convert query answer. Any of @src_format, @src_value, @dest_format, and @dest_value may be %NULL, in which case that value is omitted. - @@ -34914,7 +33125,6 @@ and @dest_value may be %NULL, in which case that value is omitted. Parse a duration query answer. Write the format of the duration into @format, and the value into @duration, if the respective variables are non-%NULL. - @@ -34936,7 +33146,6 @@ and the value into @duration, if the respective variables are non-%NULL. Parse a latency query answer. - @@ -34961,7 +33170,6 @@ and the value into @duration, if the respective variables are non-%NULL. Parse the number of formats in the formats @query. - @@ -34979,7 +33187,6 @@ and the value into @duration, if the respective variables are non-%NULL. Parse an available query and get the metadata API at @index of the metadata API array. - a #GType of the metadata API at @index. @@ -35002,7 +33209,6 @@ at @index of the metadata API array. Parse an available query and get the allocator and its params at @index of the allocator array. - @@ -35029,7 +33235,6 @@ at @index of the allocator array. Get the pool parameters in @query. Unref @pool with gst_object_unref() when it's not needed any more. - @@ -35063,7 +33268,6 @@ Unref @pool with gst_object_unref() when it's not needed any more. Parse an available query and get the start and stop values stored at the @index of the buffered ranges array. - a #gboolean indicating if the parsing succeeded. @@ -35091,7 +33295,6 @@ at the @index of the buffered ranges array. Parse the format query and retrieve the @nth format from it into @format. If the list contains less elements than @nth, @format will be set to GST_FORMAT_UNDEFINED. - @@ -35113,7 +33316,6 @@ set to GST_FORMAT_UNDEFINED. Parse an available query and get the scheduling mode at @index of the scheduling modes array. - a #GstPadMode of the scheduling mode at @index. @@ -35132,7 +33334,6 @@ at @index of the scheduling modes array. Parse a position query, writing the format into @format, and the position into @cur, if the respective parameters are non-%NULL. - @@ -35154,7 +33355,6 @@ into @cur, if the respective parameters are non-%NULL. Set the scheduling properties. - @@ -35185,7 +33385,6 @@ into @cur, if the respective parameters are non-%NULL. Parse a seeking query, writing the format into @format, and other results into the passed parameters, if the respective parameters are non-%NULL - @@ -35218,7 +33417,6 @@ are non-%NULL @stop_value may be %NULL, which will cause this value to be omitted. See gst_query_set_segment() for an explanation of the function arguments. - @@ -35250,7 +33448,6 @@ See gst_query_set_segment() for an explanation of the function arguments. Parse an URI query, writing the URI into @uri as a newly allocated string, if the respective parameters are non-%NULL. Free the string with g_free() after usage. - @@ -35270,7 +33467,6 @@ Free the string with g_free() after usage. Parse an URI query, writing the URI into @uri as a newly allocated string, if the respective parameters are non-%NULL. Free the string with g_free() after usage. - @@ -35291,7 +33487,6 @@ Free the string with g_free() after usage. and it should be considered permanent. If a redirection is permanent, applications should update their internal storage of the URI, otherwise they should make all future requests to the original URI. - @@ -35309,7 +33504,6 @@ they should make all future requests to the original URI. Remove the metadata API at @index of the metadata API array. - @@ -35326,7 +33520,6 @@ they should make all future requests to the original URI. Remove the allocation param at @index of the allocation param array. - @@ -35343,7 +33536,6 @@ they should make all future requests to the original URI. Remove the allocation pool at @index of the allocation pool array. - @@ -35360,7 +33552,6 @@ they should make all future requests to the original URI. Set @result as the result for the @query. - @@ -35379,7 +33570,6 @@ they should make all future requests to the original URI. Set the results of a bitrate query. The nominal bitrate is the average bitrate expected over the length of the stream as advertised in file headers (or similar). - @@ -35397,7 +33587,6 @@ headers (or similar). Set the percentage of buffered data. This is a value between 0 and 100. The @busy indicator is %TRUE when the buffering is in progress. - @@ -35418,7 +33607,6 @@ The @busy indicator is %TRUE when the buffering is in progress. Set the available query result fields in @query. - @@ -35448,7 +33636,6 @@ The @busy indicator is %TRUE when the buffering is in progress. Configures the buffering stats values in @query. - @@ -35477,7 +33664,6 @@ The @busy indicator is %TRUE when the buffering is in progress. Set the @caps result in @query. - @@ -35494,7 +33680,6 @@ The @busy indicator is %TRUE when the buffering is in progress. Answer a context query by setting the requested context. - @@ -35511,7 +33696,6 @@ The @busy indicator is %TRUE when the buffering is in progress. Answer a convert query by setting the requested values. - @@ -35540,7 +33724,6 @@ The @busy indicator is %TRUE when the buffering is in progress. Answer a duration query by setting the requested value in the given format. - @@ -35562,7 +33745,6 @@ The @busy indicator is %TRUE when the buffering is in progress. Set the formats query result fields in @query. The number of formats passed must be equal to @n_formats. - @@ -35584,7 +33766,6 @@ must be equal to @n_formats. Set the formats query result fields in @query. The number of formats passed in the @formats array must be equal to @n_formats. - @@ -35608,7 +33789,6 @@ in the @formats array must be equal to @n_formats. Answer a latency query by setting the requested values in the given format. - @@ -35634,7 +33814,6 @@ in the @formats array must be equal to @n_formats. Parse an available query and get the allocator and its params at @index of the allocator array. - @@ -35659,7 +33838,6 @@ at @index of the allocator array. Set the pool parameters in @query. - @@ -35692,7 +33870,6 @@ at @index of the allocator array. Answer a position query by setting the requested value in the given format. - @@ -35713,7 +33890,6 @@ at @index of the allocator array. Set the scheduling properties. - @@ -35742,7 +33918,6 @@ at @index of the allocator array. Set the seeking query result fields in @query. - @@ -35781,7 +33956,6 @@ The values are always between 0 and the duration of the media and @start_value <= @stop_value. @rate will contain the playback rate. For negative rates, playback will actually happen from @stop_value to @start_value. - @@ -35810,7 +33984,6 @@ negative rates, playback will actually happen from @stop_value to Answer a URI query by setting the requested URI. - @@ -35827,7 +34000,6 @@ negative rates, playback will actually happen from @stop_value to Answer a URI query by setting the requested URI redirection. - @@ -35845,7 +34017,6 @@ negative rates, playback will actually happen from @stop_value to Answer a URI query by setting the requested URI redirection to permanent or not. - @@ -35863,7 +34034,6 @@ to permanent or not. Decreases the refcount of the query. If the refcount reaches 0, the query will be freed. - @@ -35877,7 +34047,6 @@ will be freed. Get the structure of a query. This method should be called with a writable @query so that the returned structure is guaranteed to be writable. - the #GstStructure of the query. The structure is still owned by the query and will therefore be freed when the query @@ -35898,7 +34067,6 @@ in some cases), and the reference counts are updated appropriately (the old query is unreffed, the new one is reffed). Either @new_query or the #GstQuery pointed to by @old_query may be %NULL. - %TRUE if @new_query was different from @old_query @@ -35982,7 +34150,6 @@ Either @new_query or the #GstQuery pointed to by @old_query may be %NULL. Gets the #GstQueryTypeFlags associated with @type. - a #GstQueryTypeFlags. @@ -35996,7 +34163,6 @@ Either @new_query or the #GstQuery pointed to by @old_query may be %NULL. Get a printable name for the given query type. Do not modify or free. - a reference to the static name of the query. @@ -36010,7 +34176,6 @@ Either @new_query or the #GstQuery pointed to by @old_query may be %NULL. Get the unique quark for the given query type. - the quark associated with the query type @@ -36040,7 +34205,6 @@ gst_query_type_get_flags() function. Read a 16 bit unsigned integer value in big endian format from the memory buffer. - memory location @@ -36049,7 +34213,6 @@ gst_query_type_get_flags() function. Read a 16 bit unsigned integer value in little endian format from the memory buffer. - memory location @@ -36058,7 +34221,6 @@ gst_query_type_get_flags() function. Read a 24 bit unsigned integer value in big endian format from the memory buffer. - memory location @@ -36067,7 +34229,6 @@ gst_query_type_get_flags() function. Read a 24 bit unsigned integer value in little endian format from the memory buffer. - memory location @@ -36076,7 +34237,6 @@ gst_query_type_get_flags() function. Read a 32 bit unsigned integer value in big endian format from the memory buffer. - memory location @@ -36085,7 +34245,6 @@ gst_query_type_get_flags() function. Read a 32 bit unsigned integer value in little endian format from the memory buffer. - memory location @@ -36094,7 +34253,6 @@ gst_query_type_get_flags() function. Read a 64 bit unsigned integer value in big endian format from the memory buffer. - memory location @@ -36103,7 +34261,6 @@ gst_query_type_get_flags() function. Read a 64 bit unsigned integer value in little endian format from the memory buffer. - memory location @@ -36112,7 +34269,6 @@ gst_query_type_get_flags() function. Read an 8 bit unsigned integer value from the memory buffer. - memory location @@ -36120,21 +34276,18 @@ gst_query_type_get_flags() function. - - - @@ -36142,7 +34295,6 @@ gst_query_type_get_flags() function. Rounds an integer value down to the next multiple of 128. - integer value to round down @@ -36151,7 +34303,6 @@ gst_query_type_get_flags() function. Rounds an integer value down to the next multiple of 16. - integer value to round down @@ -36160,7 +34311,6 @@ gst_query_type_get_flags() function. Rounds an integer value down to the next multiple of 2. - integer value to round down @@ -36169,7 +34319,6 @@ gst_query_type_get_flags() function. Rounds an integer value down to the next multiple of 32. - integer value to round down @@ -36178,7 +34327,6 @@ gst_query_type_get_flags() function. Rounds an integer value down to the next multiple of 4. - integer value to round down @@ -36187,7 +34335,6 @@ gst_query_type_get_flags() function. Rounds an integer value down to the next multiple of 64. - integer value to round down @@ -36196,7 +34343,6 @@ gst_query_type_get_flags() function. Rounds an integer value down to the next multiple of 8. - integer value to round down @@ -36206,7 +34352,6 @@ gst_query_type_get_flags() function. Rounds an integer value down to the next multiple of @align. @align MUST be a power of two. - integrer value to round down @@ -36218,7 +34363,6 @@ power of two. Rounds an integer value up to the next multiple of 128. - integer value to round up @@ -36227,7 +34371,6 @@ power of two. Rounds an integer value up to the next multiple of 16. - integer value to round up @@ -36236,7 +34379,6 @@ power of two. Rounds an integer value up to the next multiple of 2. - integer value to round up @@ -36245,7 +34387,6 @@ power of two. Rounds an integer value up to the next multiple of 32. - integer value to round up @@ -36254,7 +34395,6 @@ power of two. Rounds an integer value up to the next multiple of 4. - integer value to round up @@ -36263,7 +34403,6 @@ power of two. Rounds an integer value up to the next multiple of 64. - integer value to round up @@ -36272,7 +34411,6 @@ power of two. Rounds an integer value up to the next multiple of 8. - integer value to round up @@ -36282,7 +34420,6 @@ power of two. Rounds an integer value up to the next multiple of @align. @align MUST be a power of two. - integrer value to round up @@ -36324,7 +34461,6 @@ references would be "timestamp/x-drivername-stream" for timestamps that are loca generated by some driver named "drivername" when generating the stream, e.g. based on a frame counter, or "timestamp/x-ntp, host=pool.ntp.org, port=123" for timestamps based on a specific NTP server. - the parent #GstMeta structure @@ -36343,7 +34479,6 @@ port=123" for timestamps based on a specific NTP server. Get the global #GstMetaInfo describing the #GstReferenceTimestampMeta meta. - The #GstMetaInfo @@ -36409,7 +34544,6 @@ different sets of plugins. For various reasons, at init time, the cache is stored in the default registry, and plugins not relevant to the current process are marked with the %GST_PLUGIN_FLAG_CACHED bit. These plugins are removed at the end of initialization. - By default GStreamer will perform scanning and rebuilding of the registry file using a helper child process. @@ -36417,7 +34551,6 @@ registry file using a helper child process. Applications might want to disable this behaviour with the gst_registry_fork_set_enabled() function, in which case new plugins are scanned (and loaded) into the application process. - %TRUE if GStreamer will use the child helper process when rebuilding the registry. @@ -36428,7 +34561,6 @@ rebuilding the registry. Applications might want to disable/enable spawning of a child helper process when rebuilding the registry. See gst_registry_fork_is_enabled() for more information. - @@ -36443,7 +34575,6 @@ information. Retrieves the singleton plugin registry. The caller does not own a reference on the registry, as it is alive as long as GStreamer is initialized. - the #GstRegistry. @@ -36454,7 +34585,6 @@ initialized. @feature's reference count will be incremented, and any floating reference will be removed (see gst_object_ref_sink()) - %TRUE on success. @@ -36477,7 +34607,6 @@ MT safe. @plugin's reference count will be incremented, and any floating reference will be removed (see gst_object_ref_sink()) - %TRUE on success. @@ -36499,7 +34628,6 @@ MT safe. Checks whether a plugin feature by the given name exists in @registry and whether its version is at least the version required. - %TRUE if the feature could be found and the version is the same as the required version or newer, and %FALSE otherwise. @@ -36533,7 +34661,6 @@ the same as the required version or newer, and %FALSE otherwise. and returns a GList with the results. If the first flag is set, only the first match is returned (as a list with a single object). - a #GList of #GstPluginFeature. Use gst_plugin_feature_list_free() after usage. @@ -36564,7 +34691,6 @@ MT safe. Find the pluginfeature with the given name and type in the registry. - the pluginfeature with the given name and type or %NULL if the plugin was not @@ -36591,7 +34717,6 @@ MT safe. Find the plugin with the given name in the registry. The plugin will be reffed; caller is responsible for unreffing. - the plugin with the given name or %NULL if the plugin was not found. gst_object_unref() after @@ -36613,7 +34738,6 @@ MT safe. Retrieves a #GList of #GstPluginFeature of @type. - a #GList of #GstPluginFeature of @type. Use gst_plugin_feature_list_free() after use @@ -36636,7 +34760,6 @@ MT safe. Retrieves a #GList of features of the plugin with name @name. - a #GList of #GstPluginFeature. Use gst_plugin_feature_list_free() after usage. @@ -36658,7 +34781,6 @@ MT safe. Returns the registry's feature list cookie. This changes every time a feature is added or removed from the registry. - the feature list cookie. @@ -36673,7 +34795,6 @@ every time a feature is added or removed from the registry. Get a copy of all plugins registered in the given registry. The refcount of each element in the list in incremented. - a #GList of #GstPlugin. Use gst_plugin_list_free() after usage. @@ -36693,7 +34814,6 @@ MT safe. Look up a plugin in the given registry with the given filename. If found, plugin is reffed. - the #GstPlugin if found, or %NULL if not. gst_object_unref() after usage. @@ -36712,7 +34832,6 @@ If found, plugin is reffed. Find a #GstPluginFeature with @name in @registry. - a #GstPluginFeature with its refcount incremented, use gst_object_unref() after usage. @@ -36737,7 +34856,6 @@ the results. If the first flag is set, only the first match is returned (as a list with a single object). Every plugin is reffed; use gst_plugin_list_free() after use, which will unref again. - a #GList of #GstPlugin. Use gst_plugin_list_free() after usage. @@ -36770,7 +34888,6 @@ MT safe. Remove the feature from the registry. MT safe. - @@ -36789,7 +34906,6 @@ MT safe. Remove the plugin from the registry. MT safe. - @@ -36807,7 +34923,6 @@ MT safe. Scan the given path for plugins to add to the registry. The syntax of the path is specific to the registry. - %TRUE if registry changed @@ -36857,14 +34972,11 @@ replacing a previously-added one by the same name) - - - - + Resource errors are for any resource used by an element: memory, files, network connections, process space, ... @@ -36930,14 +35042,12 @@ both reading and writing, or either (but unspecified which). - - @@ -36945,7 +35055,6 @@ both reading and writing, or either (but unspecified which). Constant that defines one GStreamer second. - @@ -36954,11 +35063,9 @@ combination with GStreamer's debug logging system as well as the functions gst_info_vasprintf(), gst_info_strdup_vprintf() and gst_info_strdup_printf() to pretty-print #GstSegment structures. This can only be used on pointers to GstSegment structures. - - @@ -36966,12 +35073,10 @@ This can only be used on pointers to GstSegment structures. gst_util_seqnum_next(). Can be used as a default value in variables used to store seqnum. - This macro returns the current #GstState of the element. - a #GstElement to return state for. @@ -36979,7 +35084,6 @@ Can be used as a default value in variables used to store seqnum. - @@ -36987,7 +35091,6 @@ Can be used as a default value in variables used to store seqnum. Get the conditional used to signal the completion of a state change. - a #GstElement @@ -36998,7 +35101,6 @@ Can be used as a default value in variables used to store seqnum. Get a reference to the state lock of @elem. This lock is used by the core. It is taken while getting or setting the state, during state changes, and while finalizing. - a #GstElement @@ -37008,7 +35110,6 @@ the state, during state changes, and while finalizing. Given a current state @cur and a target state @pending, calculate the next (intermediate) #GstState. - A starting #GstState @@ -37019,7 +35120,6 @@ the state, during state changes, and while finalizing. - @@ -37027,7 +35127,6 @@ the state, during state changes, and while finalizing. This macro returns the next #GstState of the element. - a #GstElement to return the next state for. @@ -37036,7 +35135,6 @@ the state, during state changes, and while finalizing. This macro returns the currently pending #GstState of the element. - a #GstElement to return the pending state for. @@ -37045,7 +35143,6 @@ the state, during state changes, and while finalizing. This macro returns the last #GstStateChangeReturn value. - a #GstElement to return the last state result for. @@ -37053,7 +35150,6 @@ the state, during state changes, and while finalizing. - @@ -37061,7 +35157,6 @@ the state, during state changes, and while finalizing. This macro returns the target #GstState of the element. - a #GstElement to return the target state for. @@ -37071,7 +35166,6 @@ the state, during state changes, and while finalizing. Given a current state @cur and a next state @next, calculate the associated #GstStateChange transition. - A current state @@ -37083,7 +35177,6 @@ the state, during state changes, and while finalizing. Given a state transition @trans, extract the current #GstState. - A #GstStateChange @@ -37092,7 +35185,6 @@ the state, during state changes, and while finalizing. Given a state transition @trans, extract the next #GstState. - A #GstStateChange @@ -37100,28 +35192,24 @@ the state, during state changes, and while finalizing. - - - - @@ -37132,7 +35220,6 @@ the state, during state changes, and while finalizing. Creates a new #GstCaps static caps from an input string. This can be used in pad templates. - the string describing the caps @@ -37148,7 +35235,6 @@ static GstStaticPadTemplate my_src_template = * GST_STATIC_PAD_TEMPLATE("src" , GST_STATIC_CAPS_ANY); ]| - the name template of the pad @@ -37170,13 +35256,11 @@ can use this in combination with GStreamer's debug logging system as well as the functions gst_info_vasprintf(), gst_info_strdup_vprintf() and gst_info_strdup_printf() to pretty-print signed time (pointers to #GstClockTimeDiff or #gint64). - Format @t for the #GST_STIME_FORMAT format string. Note: @t will be evaluated more than once. - a #GstClockTimeDiff or #gint64 @@ -37192,74 +35276,63 @@ Example: |[ printf("%" GST_STIME_FORMAT "\n", GST_STIME_ARGS(ts)); ]| - - - - - - - - - - - @@ -37274,7 +35347,6 @@ four characters. |[ guint32 fourcc = GST_STR_FOURCC ("MJPG"); ]| - a string with at least four characters @@ -37287,7 +35359,6 @@ is %NULL, "(NULL)" is printed instead. In GStreamer printf string arguments may not be %NULL, because on some platforms (ie Solaris) the libc crashes in that case. This includes debugging strings. - The string to check. @@ -37295,28 +35366,24 @@ strings. - - - - @@ -37325,12 +35392,10 @@ strings. A #GstSample is a small object containing data, a type, timing and extra arbitrary information. - Create a new #GstSample with the provided details. Free-function: gst_sample_unref - the new #GstSample. gst_sample_unref() after usage. @@ -37358,7 +35423,6 @@ Free-function: gst_sample_unref Create a copy of the given sample. This will also make a newly allocated copy of the data the source sample contains. - a new copy of @buf. @@ -37372,7 +35436,6 @@ copy of the data the source sample contains. Get the buffer associated with @sample - the buffer of @sample or %NULL when there is no buffer. The buffer remains valid as long as @@ -37389,7 +35452,6 @@ copy of the data the source sample contains. Get the buffer list associated with @sample - the buffer list of @sample or %NULL when there is no buffer list. The buffer list remains valid as long as @@ -37406,7 +35468,6 @@ copy of the data the source sample contains. Get the caps associated with @sample - the caps of @sample or %NULL when there is no caps. The caps remain valid as long as @sample is @@ -37423,7 +35484,6 @@ copy of the data the source sample contains. Get extra information associated with @sample. - the extra info of @sample. The info remains valid as long as @sample is valid. @@ -37438,7 +35498,6 @@ copy of the data the source sample contains. Get the segment associated with @sample - the segment of @sample. The segment remains valid as long as @sample is valid. @@ -37453,7 +35512,6 @@ copy of the data the source sample contains. Increases the refcount of the given sample by one. - @sample @@ -37467,7 +35525,6 @@ copy of the data the source sample contains. Set the buffer associated with @sample. @sample must be writable. - @@ -37484,7 +35541,6 @@ copy of the data the source sample contains. Set the buffer list associated with @sample. @sample must be writable. - @@ -37501,7 +35557,6 @@ copy of the data the source sample contains. Set the caps associated with @sample. @sample must be writable. - @@ -37519,7 +35574,6 @@ copy of the data the source sample contains. Set the info structure associated with @sample. @sample must be writable, and @info must not have a parent set already. - @@ -37536,7 +35590,6 @@ and @info must not have a parent set already. Set the segment associated with @sample. @sample must be writable. - @@ -37554,7 +35607,6 @@ and @info must not have a parent set already. Decreases the refcount of the sample. If the refcount reaches 0, the sample will be freed. - @@ -37769,7 +35821,6 @@ any rate or applied_rate conversions. For elements that need to perform operations on media data in stream_time, gst_segment_to_stream_time() can be used to convert a timestamp and the segment info to stream time (which is always between 0 and the duration of the stream). - flags for this segment @@ -37871,7 +35922,6 @@ info to stream time (which is always between 0 and the duration of the stream).< gst_segment_init(). Free-function: gst_segment_free - a new #GstSegment, free with gst_segment_free(). @@ -37891,7 +35941,6 @@ respectively, the region fell partially in the segment. Note that when @stop is -1, @clip_stop will be set to the end of the segment. Depending on the use case, this may or may not be what you want. - %TRUE if the given @start and @stop times fall partially or completely in @segment, %FALSE if the values are completely outside @@ -37929,7 +35978,6 @@ segment. Depending on the use case, this may or may not be what you want. Create a copy of given @segment. Free-function: gst_segment_free - a new #GstSegment, free with gst_segment_free(). @@ -37943,7 +35991,6 @@ Free-function: gst_segment_free Copy the contents of @src into @dest. - @@ -37986,7 +36033,6 @@ rate and applied_rate after calling this function. @update will be set to %TRUE if a seek should be performed to the segment position field. This field can be %FALSE if, for example, only the @rate has been changed but not the playback position. - %TRUE if the seek could be performed. @@ -38032,7 +36078,6 @@ has been changed but not the playback position. Free the allocated segment @segment. - @@ -38049,7 +36094,6 @@ fields are set to -1 (unknown). The default rate of 1.0 and no flags are set. Initialize @segment to its default values. - @@ -38067,7 +36111,6 @@ Initialize @segment to its default values. Checks for two segments being equal. Equality here is defined as perfect equality, including floating point values. - %TRUE if the segments are equal, %FALSE otherwise. @@ -38086,7 +36129,6 @@ as perfect equality, including floating point values. Adjust the values in @segment so that @offset is applied to all future running-time calculations. - %TRUE if the segment could be updated successfully. If %FALSE is returned, @offset is not in @segment. @@ -38110,7 +36152,6 @@ returned, @offset is not in @segment. Convert @running_time into a position in the segment so that gst_segment_to_running_time() with that position returns @running_time. - the position in the segment for @running_time. This function returns -1 when @running_time is -1 or when it is not inside @segment. @@ -38148,7 +36189,6 @@ in @position. When this function returns -1, the returned @position was < 0, and the value in the position variable should be negated to get the real negative segment position. - a 1 or -1 on success, 0 on failure. @@ -38175,7 +36215,6 @@ position. Convert @stream_time into a position in the segment so that gst_segment_to_stream_time() with that position returns @stream_time. - the position in the segment for @stream_time. This function returns -1 when @stream_time is -1 or when it is not inside @segment. @@ -38212,7 +36251,6 @@ in @position. When this function returns -1, the returned @position should be negated to get the real negative segment position. - a 1 or -1 on success, 0 on failure. @@ -38239,7 +36277,6 @@ to get the real negative segment position. Adjust the start/stop and base values of @segment such that the next valid buffer will be one with @running_time. - %TRUE if the segment could be updated successfully. If %FALSE is returned, @running_time is -1 or not in @segment. @@ -38264,7 +36301,6 @@ returned, @running_time is -1 or not in @segment. Convert @running_time into a position in the segment so that gst_segment_to_running_time() with that position returns @running_time. Use gst_segment_position_from_running_time() instead. - the position in the segment for @running_time. This function returns -1 when @running_time is -1 or when it is not inside @segment. @@ -38295,7 +36331,6 @@ starting from 0. When gst_segment_init() is called, this value will reset to 0. This function returns -1 if the position is outside of @segment start and stop. - the position as the total running time or -1 when an invalid position was given. @@ -38332,7 +36367,6 @@ in @running_time. When this function returns -1, the returned @running_time should be negated to get the real negative running time. - a 1 or -1 on success, 0 on failure. @@ -38367,7 +36401,6 @@ In those use cases, @position is typically the buffer timestamp or clock time that one wants to convert to the stream time. The stream time is always between 0 and the total duration of the media stream. - the position in stream_time or -1 when an invalid position was given. @@ -38404,7 +36437,6 @@ in @stream_time. When this function returns -1, the returned @stream_time should be negated to get the real negative stream time. - a 1 or -1 on success, 0 on failure. @@ -38584,7 +36616,6 @@ they should make sure to go back to real 'PAUSED' state (prerolling for example) Gets a string representing the given state transition. - a string with the name of the state result. @@ -38620,7 +36651,6 @@ gst_element_set_state(). Only @GST_STATE_CHANGE_FAILURE is a real failure. Datastructure to initialize #GstCaps from a string description usually used in conjunction with GST_STATIC_CAPS() and gst_static_caps_get() to instantiate a #GstCaps. - the cached #GstCaps @@ -38636,7 +36666,6 @@ instantiate a #GstCaps. Clean up the cached caps contained in @static_caps. - @@ -38649,7 +36678,6 @@ instantiate a #GstCaps. Converts a #GstStaticCaps to a #GstCaps. - a pointer to the #GstCaps. Unref after usage. Since the core holds an additional ref to the @@ -38667,7 +36695,6 @@ instantiate a #GstCaps. Structure describing the #GstStaticPadTemplate. - the name of the template @@ -38686,7 +36713,6 @@ instantiate a #GstCaps. Converts a #GstStaticPadTemplate into a #GstPadTemplate. - a new #GstPadTemplate. @@ -38700,7 +36726,6 @@ instantiate a #GstCaps. Gets the capabilities of the static pad template. - the #GstCaps of the static pad template. Unref after usage. Since the core holds an additional @@ -38729,11 +36754,9 @@ stream-id, tags, caps, type, ... Elements can subclass a #GstStream for internal usage (to contain information pertinent to streams of data). - Create a new #GstStream for the given @stream_id, @caps, @type and @flags - The new #GstStream @@ -38760,7 +36783,6 @@ a new one will be automatically generated Retrieve the caps for @stream, if any - The #GstCaps for @stream @@ -38774,7 +36796,6 @@ a new one will be automatically generated Retrieve the current stream flags for @stream - The #GstStreamFlags for @stream @@ -38788,7 +36809,6 @@ a new one will be automatically generated Returns the stream ID of @stream. - the stream ID of @stream. Only valid during the lifetime of @stream. @@ -38803,7 +36823,6 @@ during the lifetime of @stream. Retrieve the stream type for @stream - The #GstStreamType for @stream @@ -38817,7 +36836,6 @@ during the lifetime of @stream. Retrieve the tags for @stream, if any - The #GstTagList for @stream @@ -38831,7 +36849,6 @@ during the lifetime of @stream. Set the caps for the #GstStream - @@ -38848,7 +36865,6 @@ during the lifetime of @stream. Set the @flags for the @stream. - @@ -38865,7 +36881,6 @@ during the lifetime of @stream. Set the stream type of @stream - @@ -38882,7 +36897,6 @@ during the lifetime of @stream. Set the tags for the #GstStream - @@ -38935,7 +36949,6 @@ time. GstStream class structure - the parent class structure @@ -38963,10 +36976,8 @@ Several elements in a pipeline can provide #GstStreamCollection. Applications can activate streams from a collection by using the #GST_EVENT_SELECT_STREAMS event on a pipeline, bin or element. - Create a new #GstStreamCollection. - The new #GstStreamCollection. @@ -38979,7 +36990,6 @@ Applications can activate streams from a collection by using the - @@ -38997,7 +37007,6 @@ Applications can activate streams from a collection by using the Add the given @stream to the @collection. - %TRUE if the @stream was properly added, else %FALSE @@ -39015,7 +37024,6 @@ Applications can activate streams from a collection by using the Get the number of streams this collection contains - The number of streams that @collection contains @@ -39031,7 +37039,6 @@ Applications can activate streams from a collection by using the Retrieve the #GstStream with index @index from the collection. The caller should not modify the returned #GstStream - A #GstStream @@ -39049,7 +37056,6 @@ The caller should not modify the returned #GstStream Returns the upstream id of the @collection. - The upstream id @@ -39094,14 +37100,12 @@ The caller should not modify the returned #GstStream GstStreamCollection class structure - the parent class structure - @@ -39124,9 +37128,7 @@ The caller should not modify the returned #GstStream - - - + Stream errors are for anything related to the stream being processed: format errors, media type errors, ... @@ -39211,9 +37213,7 @@ can't be decrypted because no suitable key is available. a director's commentary track). - - - + The type of a %GST_MESSAGE_STREAM_STATUS. The stream status messages inform the application of new streaming threads and their status. @@ -39263,7 +37263,6 @@ whether a stream is of a certain type. Get a descriptive string for a given #GstStreamType - A string describing the stream type @@ -39376,7 +37375,6 @@ a-struct, nested=(GstStructure)"nested-struct, nested=true" > It can only support one level of nesting. Using more levels will lead to > unexpected behavior when using serialization features, such as > gst_caps_to_string() or gst_value_serialize() and their counterparts. - the GType of a structure @@ -39390,7 +37388,6 @@ If end is not %NULL, a pointer to the place inside the given string where parsing ended will be returned. Free-function: gst_structure_free - a new #GstStructure or %NULL when the string could not be parsed. Free with @@ -39415,7 +37412,6 @@ Variable arguments should be passed as field name, field type, and value. Last variable argument should be %NULL. Free-function: gst_structure_free - a new #GstStructure @@ -39441,7 +37437,6 @@ Free-function: gst_structure_free See gst_structure_set_name() for constraints on the @name parameter. Free-function: gst_structure_free - a new, empty #GstStructure @@ -39462,7 +37457,6 @@ The current implementation of serialization will lead to unexpected results when there are nested #GstCaps / #GstStructure deeper than one level. Free-function: gst_structure_free - a new #GstStructure or %NULL when the string could not be parsed. Free with @@ -39485,7 +37479,6 @@ gst_structure_new_id_empty() and gst_structure_id_set(). The last variable argument must be %NULL (or 0). Free-function: gst_structure_free - a new #GstStructure @@ -39509,7 +37502,6 @@ Free-function: gst_structure_free Creates a new, empty #GstStructure with the given name as a GQuark. Free-function: gst_structure_free - a new, empty #GstStructure @@ -39529,7 +37521,6 @@ gst_structure_new(). See gst_structure_set_name() for constraints on the @name parameter. Free-function: gst_structure_free - a new #GstStructure @@ -39552,7 +37543,6 @@ Free-function: gst_structure_free Tries intersecting @struct1 and @struct2 and reports whether the result would not be empty. - %TRUE if intersection would not be empty @@ -39572,7 +37562,6 @@ would not be empty. Duplicates a #GstStructure and all its fields and values. Free-function: gst_structure_free - a new #GstStructure. @@ -39590,7 +37579,6 @@ contrast to gst_structure_foreach(), the function may modify the fields. In contrast to gst_structure_map_in_place(), the field is removed from the structure if %FALSE is returned from the function. The structure must be mutable. - @@ -39612,7 +37600,6 @@ The structure must be mutable. Fixate all values in @structure using gst_value_fixate(). @structure will be modified in-place and should be writable. - @@ -39625,7 +37612,6 @@ The structure must be mutable. Fixates a #GstStructure by changing the given field with its fixated value. - %TRUE if the structure field could be fixated @@ -39644,7 +37630,6 @@ The structure must be mutable. Fixates a #GstStructure by changing the given @field_name field to the given @target boolean if that field is not fixed yet. - %TRUE if the structure could be fixated @@ -39667,7 +37652,6 @@ The structure must be mutable. Fixates a #GstStructure by changing the given field to the nearest double to @target that is a subset of the existing field. - %TRUE if the structure could be fixated @@ -39691,7 +37675,6 @@ double to @target that is a subset of the existing field. Fixates a #GstStructure by changing the given field to the nearest fraction to @target_numerator/@target_denominator that is a subset of the existing field. - %TRUE if the structure could be fixated @@ -39718,7 +37701,6 @@ of the existing field. Fixates a #GstStructure by changing the given field to the nearest integer to @target that is a subset of the existing field. - %TRUE if the structure could be fixated @@ -39741,7 +37723,6 @@ integer to @target that is a subset of the existing field. Fixates a #GstStructure by changing the given @field_name field to the given @target string if that field is not fixed yet. - %TRUE if the structure could be fixated @@ -39765,7 +37746,6 @@ integer to @target that is a subset of the existing field. Calls the provided function once for each field in the #GstStructure. The function must not modify the fields. Also see gst_structure_map_in_place() and gst_structure_filter_and_map_in_place(). - %TRUE if the supplied function returns %TRUE For each of the fields, %FALSE otherwise. @@ -39789,7 +37769,6 @@ and gst_structure_filter_and_map_in_place(). Frees a #GstStructure and all its fields and values. The structure must not have a parent when this function is called. - @@ -39810,7 +37789,6 @@ For refcounted (mini)objects you will receive a new reference which you must release with a suitable _unref\() when no longer needed. For strings and boxed types you will receive a copy which you will need to release with either g_free() or the suitable function for the boxed type. - %FALSE if there was a problem reading any of the fields (e.g. because the field requested did not exist, or was of a type other @@ -39837,7 +37815,6 @@ release with either g_free() or the suitable function for the boxed type. supported. This function will convert the %GST_TYPE_ARRAY into a newly allocated #GValueArray and return it through @array. Be aware that this is slower then getting the #GValue directly. - %TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a %GST_TYPE_ARRAY, @@ -39863,7 +37840,6 @@ this function returns %FALSE. Sets the boolean pointed to by @value corresponding to the value of the given field. Caller is responsible for making sure the field exists and has the correct type. - %TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a boolean, this @@ -39889,7 +37865,6 @@ function returns %FALSE. Sets the clock time pointed to by @value corresponding to the clock time of the given field. Caller is responsible for making sure the field exists and has the correct type. - %TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a #GstClockTime, this @@ -39920,7 +37895,6 @@ On success @value will point to a newly-allocated copy of the date which should be freed with g_date_free() when no longer needed (note: this is inconsistent with e.g. gst_structure_get_string() which doesn't return a copy of the string). - %TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a data, this function @@ -39951,7 +37925,6 @@ On success @value will point to a reference of the datetime which should be unreffed with gst_date_time_unref() when no longer needed (note: this is inconsistent with e.g. gst_structure_get_string() which doesn't return a copy of the string). - %TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a data, this function @@ -39977,7 +37950,6 @@ returns %FALSE. Sets the double pointed to by @value corresponding to the value of the given field. Caller is responsible for making sure the field exists and has the correct type. - %TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a double, this @@ -40003,7 +37975,6 @@ function returns %FALSE. Sets the int pointed to by @value corresponding to the value of the given field. Caller is responsible for making sure the field exists, has the correct type and that the enumtype is correct. - %TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain an enum of the given @@ -40033,7 +38004,6 @@ type, this function returns %FALSE. Finds the field with the given name, and returns the type of the value it contains. If the field is not found, G_TYPE_INVALID is returned. - the #GValue of the field @@ -40052,7 +38022,6 @@ returned. Read the GstFlagSet flags and mask out of the structure into the provided pointers. - %TRUE if the values could be set correctly. If there was no field with @fieldname or the existing field did not contain a GstFlagSet, this @@ -40082,7 +38051,6 @@ function returns %FALSE. Sets the integers pointed to by @value_numerator and @value_denominator corresponding to the value of the given field. Caller is responsible for making sure the field exists and has the correct type. - %TRUE if the values could be set correctly. If there was no field with @fieldname or the existing field did not contain a GstFraction, this @@ -40112,7 +38080,6 @@ function returns %FALSE. Sets the int pointed to by @value corresponding to the value of the given field. Caller is responsible for making sure the field exists and has the correct type. - %TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain an int, this function @@ -40138,7 +38105,6 @@ returns %FALSE. Sets the #gint64 pointed to by @value corresponding to the value of the given field. Caller is responsible for making sure the field exists and has the correct type. - %TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a #gint64, this function @@ -40165,7 +38131,6 @@ returns %FALSE. supported. This function will convert the %GST_TYPE_LIST into a newly allocated GValueArray and return it through @array. Be aware that this is slower then getting the #GValue directly. - %TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a %GST_TYPE_LIST, this @@ -40189,7 +38154,6 @@ function returns %FALSE. Get the name of @structure as a string. - the name of the structure. @@ -40203,7 +38167,6 @@ function returns %FALSE. Get the name of @structure as a GQuark. - the quark representing the name of the structure. @@ -40222,7 +38185,6 @@ sure the field exists and has the correct type. The string should not be modified, and remains valid until the next call to a gst_structure_*() function with the given structure. - a pointer to the string or %NULL when the field did not exist or did not contain a string. @@ -40243,7 +38205,6 @@ field did not exist or did not contain a string. Sets the uint pointed to by @value corresponding to the value of the given field. Caller is responsible for making sure the field exists and has the correct type. - %TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a uint, this function @@ -40269,7 +38230,6 @@ returns %FALSE. Sets the #guint64 pointed to by @value corresponding to the value of the given field. Caller is responsible for making sure the field exists and has the correct type. - %TRUE if the value could be set correctly. If there was no field with @fieldname or the existing field did not contain a #guint64, this function @@ -40295,7 +38255,6 @@ returns %FALSE. Parses the variable arguments and reads fields from @structure accordingly. valist-variant of gst_structure_get(). Look at the documentation of gst_structure_get() for more details. - %TRUE, or %FALSE if there was a problem reading any of the fields @@ -40317,7 +38276,6 @@ gst_structure_get() for more details. Get the value of the field with name @fieldname. - the #GValue corresponding to the field with the given name. @@ -40336,7 +38294,6 @@ name. Check if @structure contains a field named @fieldname. - %TRUE if the structure contains a field with the given name @@ -40354,7 +38311,6 @@ name. Check if @structure contains a field named @fieldname and with GType @type. - %TRUE if the structure contains a field with the given name and type @@ -40376,7 +38332,6 @@ name. Checks if the structure has the given name - %TRUE if @name matches the name of the structure. @@ -40408,7 +38363,6 @@ For refcounted (mini)objects you will receive a new reference which you must release with a suitable _unref\() when no longer needed. For strings and boxed types you will receive a copy which you will need to release with either g_free() or the suitable function for the boxed type. - %FALSE if there was a problem reading any of the fields (e.g. because the field requested did not exist, or was of a type other @@ -40434,7 +38388,6 @@ release with either g_free() or the suitable function for the boxed type. Parses the variable arguments and reads fields from @structure accordingly. valist-variant of gst_structure_id_get(). Look at the documentation of gst_structure_id_get() for more details. - %TRUE, or %FALSE if there was a problem reading any of the fields @@ -40456,7 +38409,6 @@ gst_structure_id_get() for more details. Get the value of the field with GQuark @field. - the #GValue corresponding to the field with the given name identifier. @@ -40475,7 +38427,6 @@ name identifier. Check if @structure contains a field named @field. - %TRUE if the structure contains a field with the given name @@ -40493,7 +38444,6 @@ name identifier. Check if @structure contains a field named @field and with GType @type. - %TRUE if the structure contains a field with the given name and type @@ -40519,7 +38469,6 @@ passed using the GQuark for the field name. This allows more efficient setting of the structure if the caller already knows the associated quark values. The last variable argument must be %NULL. - @@ -40540,7 +38489,6 @@ The last variable argument must be %NULL. va_list form of gst_structure_id_set(). - @@ -40563,7 +38511,6 @@ The last variable argument must be %NULL. Sets the field with the given GQuark @field to @value. If the field does not exist, it is created. If the field exists, the previous value is replaced and freed. - @@ -40586,7 +38533,6 @@ value is replaced and freed. Sets the field with the given GQuark @field to @value. If the field does not exist, it is created. If the field exists, the previous value is replaced and freed. - @@ -40607,7 +38553,6 @@ value is replaced and freed. Intersects @struct1 and @struct2 and returns the intersection. - Intersection of @struct1 and @struct2 @@ -40625,7 +38570,6 @@ value is replaced and freed. Tests if the two #GstStructure are equal. - %TRUE if the two structures have the same name and field. @@ -40645,7 +38589,6 @@ value is replaced and freed. Checks if @subset is a subset of @superset, i.e. has the same structure name and for all fields that are existing in @superset, @subset has a value that is a subset of the value in @superset. - %TRUE if @subset is a subset of @superset @@ -40665,7 +38608,6 @@ structure name and for all fields that are existing in @superset, Calls the provided function once for each field in the #GstStructure. In contrast to gst_structure_foreach(), the function may modify but not delete the fields. The structure must be mutable. - %TRUE if the supplied function returns %TRUE For each of the fields, %FALSE otherwise. @@ -40688,7 +38630,6 @@ fields. The structure must be mutable. Get the number of fields in the structure. - the number of fields in the structure @@ -40702,7 +38643,6 @@ fields. The structure must be mutable. Get the name of the given field number, counting from 0 onwards. - the name of the given field number @@ -40720,7 +38660,6 @@ fields. The structure must be mutable. Removes all fields in a GstStructure. - @@ -40734,7 +38673,6 @@ fields. The structure must be mutable. Removes the field with the given name. If the field with the given name does not exist, the structure is unchanged. - @@ -40752,7 +38690,6 @@ name does not exist, the structure is unchanged. Removes the fields with the given names. If a field does not exist, the argument is ignored. - @@ -40773,7 +38710,6 @@ argument is ignored. va_list form of gst_structure_remove_fields(). - @@ -40797,7 +38733,6 @@ argument is ignored. weren't already part of the structure are added as needed. Variable arguments should be in the form field name, field type (as a GType), value(s). The last variable argument should be %NULL. - @@ -40821,7 +38756,6 @@ Variable arguments should be in the form field name, field type supported. This function will convert a @array to %GST_TYPE_ARRAY and set the field specified by @fieldname. Be aware that this is slower then using %GST_TYPE_ARRAY in a #GValue directly. - @@ -40845,7 +38779,6 @@ the field specified by @fieldname. Be aware that this is slower then using supported. This function will convert a @array to %GST_TYPE_LIST and set the field specified by @fieldname. Be aware that this is slower then using %GST_TYPE_LIST in a #GValue directly. - @@ -40868,7 +38801,6 @@ the field specified by @fieldname. Be aware that this is slower then using Sets the name of the structure to the given @name. The string provided is copied before being used. It must not be empty, start with a letter and can be followed by letters, numbers and any of "/-_.:". - @@ -40888,7 +38820,6 @@ letter and can be followed by letters, numbers and any of "/-_.:". determine whether a structure is mutable or not. This function should only be called by code implementing parent objects of #GstStructure, as described in the MT Refcounting section of the design documents. - %TRUE if the parent refcount could be set. @@ -40906,7 +38837,6 @@ the MT Refcounting section of the design documents. va_list form of gst_structure_set(). - @@ -40929,7 +38859,6 @@ the MT Refcounting section of the design documents. Sets the field with the given name @field to @value. If the field does not exist, it is created. If the field exists, the previous value is replaced and freed. - @@ -40952,7 +38881,6 @@ value is replaced and freed. Sets the field with the given name @field to @value. If the field does not exist, it is created. If the field exists, the previous value is replaced and freed. The function will take ownership of @value. - @@ -40984,7 +38912,6 @@ The current implementation of serialization will lead to unexpected results when there are nested #GstCaps / #GstStructure deeper than one level. Free-function: g_free - a pointer to string allocated by g_malloc(). g_free() after usage. @@ -41006,7 +38933,6 @@ Either @newstr and the value pointed to by @oldstr_ptr may be %NULL. It is a programming error if both @newstr and the value pointed to by @oldstr_ptr refer to the same, non-%NULL structure. - %TRUE if @newstr was different from @oldstr_ptr @@ -41037,7 +38963,6 @@ It is a programming error if both @newstr and the value pointed to by A function that will be called in gst_structure_filter_and_map_in_place(). The function may modify @value, and the value will be removed from the structure if %FALSE is returned. - %TRUE if the field should be preserved, %FALSE if it should be removed. @@ -41061,7 +38986,6 @@ should be removed. A function that will be called in gst_structure_foreach(). The function may not modify @value. - %TRUE if the foreach operation should continue, %FALSE if the foreach operation should stop with %FALSE. @@ -41085,7 +39009,6 @@ the foreach operation should stop with %FALSE. A function that will be called in gst_structure_map_in_place(). The function may modify @value. - %TRUE if the map operation should continue, %FALSE if the map operation should stop with %FALSE. @@ -41116,12 +39039,10 @@ implements the async notification. Subclasses can however override all of the important methods for sync and async notifications to implement their own callback methods or blocking wait operations. - Get a handle to the default system clock. The refcount of the clock will be increased so you need to unref the clock after usage. - the default clock. @@ -41138,7 +39059,6 @@ want to have control over the time reported by the default system clock. MT safe. - @@ -41165,7 +39085,6 @@ MT safe. - @@ -41175,51 +39094,41 @@ MT safe. - - - + album containing this data (string) The album name as it should be displayed, e.g. 'The Jazz Guitar' - The artist of the entire album, as it should be displayed. - The artist of the entire album, as it should be sorted. - album gain in db (double) - peak of the album (double) - album containing this data, as used for sorting (string) The album name as it should be sorted, e.g. 'Jazz Guitar, The' - count of discs inside collection this disc belongs to (unsigned integer) - disc number inside a collection (unsigned integer) - @@ -41227,12 +39136,10 @@ The album name as it should be sorted, e.g. 'Jazz Guitar, The' Some formats allow applications to add their own arbitrary data into files. This data is application dependent. - Name of the application used to create the media (string) - @@ -41240,7 +39147,6 @@ into files. This data is application dependent. The artist name as it should be displayed, e.g. 'Jimi Hendrix' or 'The Guitar Heroes' - @@ -41248,104 +39154,84 @@ The artist name as it should be displayed, e.g. 'Jimi Hendrix' or The artist name as it should be sorted, e.g. 'Hendrix, Jimi' or 'Guitar Heroes, The' - generic file attachment (sample) (sample taglist should specify the content type and if possible set "filename" to the file name of the attachment) - codec the audio data is stored in (string) - number of beats per minute in audio (double) - exact or average bitrate in bits/s (unsigned integer) - codec the data is stored in (string) - free text commenting the data (string) - person(s) who composed the recording (string) - The composer's name, used for sorting (string) - conductor/performer refinement (string) - contact information (string) - container format the data is stored in (string) - copyright notice of the data (string) - URI to location where copyright details can be found (string) - date the data was created (#GDate structure) - date and time the data was created (#GstDateTime structure) - short text describing the content of the data (string) - Manufacturer of the device used to create the media (string) - Model of the device used to create the media (string) - length in GStreamer time units (nanoseconds) (unsigned 64-bit integer) - @@ -41355,17 +39241,14 @@ copyright message if the person or organisation also holds the copyright Note: do not use this field to describe the encoding application. Use #GST_TAG_APPLICATION_NAME or #GST_TAG_COMMENT for that. - encoder used to encode this stream (string) - version of the encoder used to encode this stream (unsigned integer) - @@ -41377,11 +39260,9 @@ language code. This tag is used for unknown Vorbis comment tags, unknown APE tags and certain ID3v2 comment fields. - - @@ -41389,7 +39270,6 @@ unknown APE tags and certain ID3v2 comment fields. genre this data belongs to (string) - @@ -41398,43 +39278,36 @@ a media. It is represented as degrees in floating point representation, 0 means the geographic north, and increases clockwise (double from 0 to 360) See also #GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION - The city (english name) where the media has been produced (string). - The country (english name) where the media has been produced (string). - geo elevation of where the media has been recorded or produced in meters according to WGS84 (zero is average sea level) (double). - Represents the expected error on the horizontal positioning in meters (double). - geo latitude location of where the media has been recorded or produced in degrees according to WGS84 (zero at the equator, negative values for southern latitudes) (double). - geo longitude location of where the media has been recorded or produced in degrees according to WGS84 (zero at the prime meridian in Greenwich/UK, negative values for western longitudes). (double). - @@ -41443,7 +39316,6 @@ of a media. It is represented as degrees in floating point representation, 0 means the geographic north, and increases clockwise (double from 0 to 360) See also #GST_TAG_GEO_LOCATION_CAPTURE_DIRECTION - @@ -41451,13 +39323,11 @@ See also #GST_TAG_GEO_LOCATION_CAPTURE_DIRECTION Represented in m/s. (double) See also #GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION - human readable descriptive location of where the media has been recorded or produced. (string). - @@ -41466,24 +39336,20 @@ where the media has been produced. (e.g. the neighborhood) (string). This tag has been added as this is how it is handled/named in XMP's Iptc4xmpcore schema. - Groups together media that are related and spans multiple tracks. An example are multiple pieces of a concerto. (string) - Homepage for this media (i.e. artist or movie homepage) (string) - image (sample) (sample taglist should specify the content type and preferably also set "image-type" field as `GstTagImageType`) - @@ -41506,23 +39372,19 @@ yield the same result. Rotations indicated by the values are in clockwise direction and 'flip' means an horizontal mirroring. - Information about the people behind a remix and similar interpretations of another existing piece (string) - International Standard Recording Code - see http://www.ifpi.org/isrc/ (string) - comma separated keywords describing the content (string). - @@ -41530,7 +39392,6 @@ interpretations of another existing piece (string) There is utility API in libgsttag in gst-plugins-base to obtain a translated language name from the language code: `gst_tag_get_language_name()` - @@ -41539,21 +39400,17 @@ language name from the language code: `gst_tag_get_language_name()` Free-form name of the language the content is in, if a language code is not available. This tag should not be set in addition to a language code. It is undefined what language or locale the language name is in. - license of data (string) - URI to location where license details can be found (string) - - @@ -41562,33 +39419,27 @@ code. It is undefined what language or locale the language name is in. Origin of media as a URI (location, where the original of the file or stream is hosted) (string) - The lyrics of the media (string) - maximum bitrate in bits/s (unsigned integer) - [Midi note number](http://en.wikipedia.org/wiki/Note#Note_designation_in_accordance_with_octave_name) of the audio track. This is useful for sample instruments and in particular for multi-samples. - minimum bitrate in bits/s (unsigned integer) - - @@ -41597,23 +39448,19 @@ for multi-samples. nominal bitrate in bits/s (unsigned integer). The actual bitrate might be different from this target bitrate. - organization (string) - person(s) performing (string) - image that is meant for preview purposes, e.g. small icon-sized version (sample) (sample taglist should specify the content type) - @@ -41627,33 +39474,27 @@ Private frames in ID3v2 tags ('PRIV' frames) will be represented using this tag, in which case the GstStructure will be named "ID3PrivateFrame" and contain a field named "owner" of type string which contains the owner-identification string from the tag. - Name of the label or publisher (string) - reference level of track and album gain values (double) - serial number of track (unsigned integer) - - - @@ -41661,82 +39502,67 @@ which contains the owner-identification string from the tag. Number of the episode within a season/show (unsigned integer) - Name of the show, used for displaying (string) - Number of the season of a show/series (unsigned integer) - Name of the show, used for sorting (string) - codec/format the subtitle data is stored in (string) - commonly used title (string) The title as it should be displayed, e.g. 'The Doll House' - commonly used title, as used for sorting (string) The title as it should be sorted, e.g. 'Doll House, The' - count of tracks inside collection this track belongs to (unsigned integer) - track gain in db (double) - track number inside a collection (unsigned integer) - peak of the track (double) - Rating attributed by a person (likely the application user). The higher the value, the more the user likes this media (unsigned int from 0 to 100) - version of this data (string) - codec the video data is stored in (string) - - @@ -41744,7 +39570,6 @@ The higher the value, the more the user likes this media Send a broadcast signal to all waiting task conds - Task to broadcast @@ -41752,21 +39577,18 @@ The higher the value, the more the user likes this media - - - @@ -41774,7 +39596,6 @@ The higher the value, the more the user likes this media Get access to the cond of the task. - Task to get the cond of @@ -41783,7 +39604,6 @@ The higher the value, the more the user likes this media Get access to the task lock. - Task to get the lock of @@ -41791,28 +39611,24 @@ The higher the value, the more the user likes this media - - - - @@ -41820,7 +39636,6 @@ The higher the value, the more the user likes this media Signal the task cond - Task to signal @@ -41829,7 +39644,6 @@ The higher the value, the more the user likes this media Get access to the state of the task. - Task to get the state of @@ -41838,7 +39652,6 @@ The higher the value, the more the user likes this media Wait for the task cond to be signalled - Task to wait for @@ -41851,12 +39664,10 @@ this in combination with GStreamer's debug logging system as well as the functions gst_info_vasprintf(), gst_info_strdup_vprintf() and gst_info_strdup_printf() to pretty-print #GstClockTime pointers. This can only be used on pointers to GstClockTime values. - Convert a struct timespec (see man pselect) to a #GstClockTime. - the timespec to convert @@ -41865,7 +39676,6 @@ only be used on pointers to GstClockTime values. Convert a GTimeVal to a #GstClockTime. - the timeval to convert @@ -41875,7 +39685,6 @@ only be used on pointers to GstClockTime values. Format @t for the #GST_TIME_FORMAT format string. Note: @t will be evaluated more than once. - a #GstClockTime @@ -41884,7 +39693,6 @@ evaluated more than once. Convert a #GstClockTime to milliseconds (1/1000 of a second). - the time @@ -41893,7 +39701,6 @@ evaluated more than once. Convert a #GstClockTime to nanoseconds (1/1000000000 of a second). - the time @@ -41902,7 +39709,6 @@ evaluated more than once. Convert a #GstClockTime to seconds. - the time @@ -41911,7 +39717,6 @@ evaluated more than once. Convert a #GstClockTime to microseconds (1/1000000 of a second). - the time @@ -41927,12 +39732,10 @@ Example: |[<!-- language="C" --> printf("%" GST_TIME_FORMAT "\n", GST_TIME_ARGS(ts)); ]| - Convert a #GstClockTime to a struct timespec (see man pselect) - The #GstClockTime to convert @@ -41948,7 +39751,6 @@ printf("%" GST_TIME_FORMAT "\n", GST_TIME_ARGS(ts)); > on 32-bit systems, a timeval has a range of only 2^32 - 1 seconds, > which is about 68 years. Expect trouble if you want to schedule stuff > in your pipeline for 2038. - The #GstClockTime to convert @@ -41960,7 +39762,6 @@ printf("%" GST_TIME_FORMAT "\n", GST_TIME_ARGS(ts)); Checks if @entry_type indicates that its #GstTocEntry is an alternative. - The #GstTocEntryType from a #GstTocEntry @@ -41969,7 +39770,6 @@ printf("%" GST_TIME_FORMAT "\n", GST_TIME_ARGS(ts)); Checks if @entry_type indicates that its #GstTocEntry is a sequence. - The #GstTocEntryType from a #GstTocEntry @@ -41979,123 +39779,105 @@ printf("%" GST_TIME_FORMAT "\n", GST_TIME_ARGS(ts)); Special value for the repeat_count set in gst_toc_entry_set_loop() or returned by gst_toc_entry_set_loop() to indicate infinite looping. - - - - - - - - - - - - - - - - - - @@ -42122,7 +39904,6 @@ returned by gst_toc_entry_set_loop() to indicate infinite looping. A function that will be called in gst_tag_list_foreach(). The function may not modify the tag list. - @@ -42146,7 +39927,6 @@ not modify the tag list. Strings in structures must be ASCII or UTF-8 encoded. Other encodings are not allowed. Strings must not be empty or %NULL. - the parent type @@ -42165,7 +39945,6 @@ taglist to signal if the contained tags are global or stream tags. By default stream scope is assumes. See gst_tag_list_set_scope(). Free-function: gst_tag_list_unref - a new #GstTagList. Free with gst_tag_list_unref() when no longer needed. @@ -42186,7 +39965,6 @@ Free-function: gst_tag_list_unref Creates a new empty GstTagList. Free-function: gst_tag_list_unref - An empty tag list @@ -42194,7 +39972,6 @@ Free-function: gst_tag_list_unref Deserializes a tag list. - a new #GstTagList, or %NULL in case of an error. @@ -42212,7 +39989,6 @@ error. Useful mostly for language bindings. Free-function: gst_tag_list_unref - a new #GstTagList. Free with gst_tag_list_unref() when no longer needed. @@ -42227,7 +40003,6 @@ Free-function: gst_tag_list_unref Sets the values for the given tags using the specified mode. - @@ -42252,7 +40027,6 @@ Free-function: gst_tag_list_unref Sets the values for the given tags using the specified mode. - @@ -42277,7 +40051,6 @@ Free-function: gst_tag_list_unref Sets the GValues for the given tags using the specified mode. - @@ -42302,7 +40075,6 @@ Free-function: gst_tag_list_unref Sets the GValue for a given tag using the specified mode. - @@ -42327,7 +40099,6 @@ Free-function: gst_tag_list_unref Sets the GValues for the given tags using the specified mode. - @@ -42360,7 +40131,6 @@ followed by a gst_tag_list_make_writable(). If you only want to hold on to a reference to the data, you should use gst_tag_list_ref(). When you are finished with the taglist, call gst_tag_list_unref() on it. - the new #GstTagList @@ -42375,7 +40145,6 @@ When you are finished with the taglist, call gst_tag_list_unref() on it. Calls the given function for each tag inside the tag list. Note that if there is no tag, the function won't be called at all. - @@ -42397,7 +40166,6 @@ is no tag, the function won't be called at all. Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -42421,7 +40189,6 @@ into one if multiple values are associated with the tag. Gets the value that is at the given index for the given tag in the given list. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -42452,7 +40219,6 @@ pointed to by @value. Free the date with g_date_free() when it is no longer needed. Free-function: g_date_free - %TRUE, if a date was copied, %FALSE if the tag didn't exist in the given list or if it was %NULL. @@ -42480,7 +40246,6 @@ list and copies it into the variable pointed to by @value. Free the date with g_date_free() when it is no longer needed. Free-function: g_date_free - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list or if it was %NULL. @@ -42511,7 +40276,6 @@ pointed to by @value. Unref the date with gst_date_time_unref() when it is no longer needed. Free-function: gst_date_time_unref - %TRUE, if a datetime was copied, %FALSE if the tag didn't exist in the given list or if it was %NULL. @@ -42539,7 +40303,6 @@ list and copies it into the variable pointed to by @value. Unref the datetime with gst_date_time_unref() when it is no longer needed. Free-function: gst_date_time_unref - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list or if it was %NULL. @@ -42567,7 +40330,6 @@ Free-function: gst_date_time_unref Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -42591,7 +40353,6 @@ into one if multiple values are associated with the tag. Gets the value that is at the given index for the given tag in the given list. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -42619,7 +40380,6 @@ list. Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -42643,7 +40403,6 @@ into one if multiple values are associated with the tag. Gets the value that is at the given index for the given tag in the given list. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -42671,7 +40430,6 @@ list. Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -42695,7 +40453,6 @@ into one if multiple values are associated with the tag. Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -42719,7 +40476,6 @@ into one if multiple values are associated with the tag. Gets the value that is at the given index for the given tag in the given list. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -42747,7 +40503,6 @@ list. Gets the value that is at the given index for the given tag in the given list. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -42775,7 +40530,6 @@ list. Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -42799,7 +40553,6 @@ into one if multiple values are associated with the tag. Gets the value that is at the given index for the given tag in the given list. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -42832,7 +40585,6 @@ gst_sample_get_buffer() and the associated caps (if any) with gst_sample_get_caps(). Free-function: gst_sample_unref - %TRUE, if a sample was returned, %FALSE if the tag didn't exist in the given list or if it was %NULL. @@ -42862,7 +40614,6 @@ buffer from the sample using gst_sample_get_buffer() and the associated caps (if any) with gst_sample_get_caps(). Free-function: gst_sample_unref - %TRUE, if a sample was copied, %FALSE if the tag didn't exist in the given list or if it was %NULL. @@ -42890,7 +40641,6 @@ Free-function: gst_sample_unref Gets the scope of @list. - The scope of @list @@ -42914,7 +40664,6 @@ freed by the caller using g_free when no longer needed. The returned string is also guaranteed to be non-%NULL and non-empty. Free-function: g_free - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -42944,7 +40693,6 @@ freed by the caller using g_free when no longer needed. The returned string is also guaranteed to be non-%NULL and non-empty. Free-function: g_free - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -42971,7 +40719,6 @@ Free-function: g_free Checks how many value are stored in this tag list for the given tag. - The number of tags stored @@ -42990,7 +40737,6 @@ Free-function: g_free Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -43014,7 +40760,6 @@ into one if multiple values are associated with the tag. Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -43038,7 +40783,6 @@ into one if multiple values are associated with the tag. Gets the value that is at the given index for the given tag in the given list. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -43066,7 +40810,6 @@ list. Gets the value that is at the given index for the given tag in the given list. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -43094,7 +40837,6 @@ list. Gets the value that is at the given index for the given tag in the given list. - The GValue for the specified entry or %NULL if the tag wasn't available or the tag @@ -43118,7 +40860,6 @@ list. Inserts the tags of the @from list into the first list using the given mode. - @@ -43139,7 +40880,6 @@ list. Checks if the given taglist is empty. - %TRUE if the taglist is empty, otherwise %FALSE. @@ -43153,7 +40893,6 @@ list. Checks if the two given taglists are equal. - %TRUE if the taglists are equal, otherwise %FALSE @@ -43174,7 +40913,6 @@ list. copy of the other is returned. If both lists are %NULL, %NULL is returned. Free-function: gst_tag_list_unref - the new list @@ -43196,7 +40934,6 @@ Free-function: gst_tag_list_unref Get the number of tags in @list. - The number of tags in @list. @@ -43210,7 +40947,6 @@ Free-function: gst_tag_list_unref Get the name of the tag in @list at @index. - The name of the tag at @index. @@ -43233,7 +40969,6 @@ list. The resulting string in @value will be in UTF-8 encoding and doesn't need to be freed by the caller. The returned string is also guaranteed to be non-%NULL and non-empty. - %TRUE, if a value was set, %FALSE if the tag didn't exist in the given list. @@ -43266,7 +41001,6 @@ gst_tag_list_make_writable(), it is guaranteed that the taglist object will not change. To use a #GstTagList object, you must always have a refcount on it -- either the one made implicitly by e.g. gst_tag_list_new(), or via taking one explicitly with this function. - the same #GstTagList mini object. @@ -43280,7 +41014,6 @@ taking one explicitly with this function. Removes the given tag from the taglist. - @@ -43298,7 +41031,6 @@ taking one explicitly with this function. Sets the scope of @list to @scope. By default the scope of a taglist is stream scope. - @@ -43315,7 +41047,6 @@ of a taglist is stream scope. Serializes a tag list to a string. - a newly-allocated string, or %NULL in case of an error. The string must be freed with g_free() when no longer @@ -43331,7 +41062,6 @@ of a taglist is stream scope. Unref a #GstTagList, and and free all its memory when the refcount reaches 0. - @@ -43347,7 +41077,6 @@ of a taglist is stream scope. merging multiple values into one if multiple values are associated with the tag. You must g_value_unset() the value after use. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -43372,7 +41101,6 @@ You must g_value_unset() the value after use. A function for merging multiple values of a tag used when registering tags. - @@ -43480,12 +41208,10 @@ result = gst_tag_list_merge (application_tags, event_tags, merge_mode); GST_LOG_OBJECT (tagsetter, "final tags: %" GST_PTR_FORMAT, result); ]| - Adds the given tag / value pairs on the setter using the given merge mode. The list must be terminated with %NULL. - @@ -43511,7 +41237,6 @@ The list must be terminated with %NULL. Adds the given tag / GValue pairs on the setter using the given merge mode. The list must be terminated with %NULL. - @@ -43536,7 +41261,6 @@ The list must be terminated with %NULL. Adds the given tag / GValue pair on the setter using the given merge mode. - @@ -43562,7 +41286,6 @@ The list must be terminated with %NULL. Adds the given tag / GValue pairs on the setter using the given merge mode. The list must be terminated with %NULL. - @@ -43588,7 +41311,6 @@ The list must be terminated with %NULL. Adds the given tag / value pairs on the setter using the given merge mode. The list must be terminated with %NULL. - @@ -43616,7 +41338,6 @@ The list must be terminated with %NULL. modified or freed. This function is not thread-safe. - a current snapshot of the taglist used in the setter or %NULL if none is used. @@ -43632,7 +41353,6 @@ This function is not thread-safe. Queries the mode by which tags inside the setter are overwritten by tags from events - the merge mode used inside the element. @@ -43646,7 +41366,6 @@ from events Merges the given list into the setter's list using the given mode. - @@ -43668,7 +41387,6 @@ from events Reset the internal taglist. Elements should call this from within the state-change handler. - @@ -43683,7 +41401,6 @@ state-change handler. Sets the given merge mode that is used for adding tags from events to tags specified by this interface. The default is #GST_TAG_MERGE_KEEP, which keeps the tags set with this interface and discards tags from events. - @@ -43701,7 +41418,6 @@ the tags set with this interface and discards tags from events. #GstTagSetterInterface interface. - parent interface type. @@ -43747,7 +41463,6 @@ For debugging purposes, the task will configure its object name as the thread name on Linux. Please note that the object name should be configured before the task is started; changing the object name after the task has been started, has no effect on the thread name. - Create a new Task that will repeatedly call the provided @func with @user_data as a parameter. Typically the task will run in @@ -43762,7 +41477,6 @@ gst_task_pause() to create and start the GThread. Before the task can be used, a #GRecMutex must be configured using the gst_task_set_lock() function. This lock will always be acquired while @func is called. - A new #GstTask. @@ -43789,7 +41503,6 @@ MT safe. to ensure proper cleanup of internal data structures in test suites. MT safe. - @@ -43799,7 +41512,6 @@ MT safe. threads. MT safe. - the #GstTaskPool used by @task. gst_object_unref() after usage. @@ -43814,7 +41526,6 @@ after usage. Get the current state of the task. - The #GstTaskState of the task @@ -43837,7 +41548,6 @@ The task will automatically be stopped with this call. This function cannot be called from within a task function as this would cause a deadlock. The function will detect this and print a g_warning. - %TRUE if the task could be joined. @@ -43856,7 +41566,6 @@ MT safe. stopped state, in which case a thread will be started and will remain in the paused state. This function does not wait for the task to complete the paused state. - %TRUE if the task could be paused. @@ -43873,7 +41582,6 @@ MT safe. Resume @task in case it was paused. If the task was stopped, it will remain in that state and this function will return %FALSE. - %TRUE if the task could be resumed. @@ -43891,7 +41599,6 @@ MT safe. Call @enter_func when the task function of @task is entered. @user_data will be passed to @enter_func and @notify will be called when @user_data is no longer referenced. - @@ -43918,7 +41625,6 @@ longer referenced. Call @leave_func when the task function of @task is left. @user_data will be passed to @leave_func and @notify will be called when @user_data is no longer referenced. - @@ -43949,7 +41655,6 @@ This function has to be called before calling gst_task_pause() or gst_task_start(). MT safe. - @@ -43969,7 +41674,6 @@ MT safe. will be created by @task will now use @pool. MT safe. - @@ -43992,7 +41696,6 @@ gst_task_set_lock() when going to GST_TASK_STARTED or GST_TASK_PAUSED or this function will return %FALSE. MT safe. - %TRUE if the state could be changed. @@ -44011,7 +41714,6 @@ MT safe. Starts @task. The @task must have a lock associated with it using gst_task_set_lock() or this function will return %FALSE. - %TRUE if the task could be started. @@ -44029,7 +41731,6 @@ MT safe. Stops @task. This method merely schedules the task to stop and will not wait for the task to have completely stopped. Use gst_task_join() to stop and wait for completion. - %TRUE if the task could be stopped. @@ -44087,7 +41788,6 @@ MT safe. - @@ -44103,7 +41803,6 @@ MT safe. A function that will repeatedly be called in the thread created by a #GstTask. - @@ -44119,11 +41818,9 @@ a #GstTask. implementation uses a regular GThreadPool to start tasks. Subclasses can be made to create custom threads. - Create a new default task pool. The default task pool will use a regular GThreadPool for threads. - a new #GstTaskPool. gst_object_unref() after usage. @@ -44134,7 +41831,6 @@ GThreadPool for threads. to ensure proper cleanup of internal data structures in test suites. MT safe. - @@ -44148,7 +41844,6 @@ MT safe. Join a task and/or return it to the pool. @id is the id obtained from gst_task_pool_push(). - @@ -44167,7 +41862,6 @@ gst_task_pool_push(). Prepare the taskpool for accepting gst_task_pool_push() operations. MT safe. - @@ -44180,7 +41874,6 @@ MT safe. Start the execution of a new thread from @pool. - a pointer that should be used for the gst_task_pool_join function. This pointer can be %NULL, you @@ -44207,7 +41900,6 @@ must check @error to detect errors. to ensure proper cleanup of internal data structures in test suites. MT safe. - @@ -44221,7 +41913,6 @@ MT safe. Join a task and/or return it to the pool. @id is the id obtained from gst_task_pool_push(). - @@ -44240,7 +41931,6 @@ gst_task_pool_push(). Prepare the taskpool for accepting gst_task_pool_push() operations. MT safe. - @@ -44253,7 +41943,6 @@ MT safe. Start the execution of a new thread from @pool. - a pointer that should be used for the gst_task_pool_join function. This pointer can be %NULL, you @@ -44289,14 +41978,12 @@ must check @error to detect errors. The #GstTaskPoolClass object. - the parent class structure - @@ -44310,7 +41997,6 @@ must check @error to detect errors. - @@ -44324,7 +42010,6 @@ must check @error to detect errors. - a pointer that should be used for the gst_task_pool_join function. This pointer can be %NULL, you @@ -44349,7 +42034,6 @@ must check @error to detect errors. - @@ -44373,7 +42057,6 @@ must check @error to detect errors. Task function, see gst_task_pool_push(). - @@ -44384,9 +42067,7 @@ must check @error to detect errors. - - - + The different states a task can be in @@ -44401,7 +42082,6 @@ must check @error to detect errors. Custom GstTask thread callback functions that can be installed. - @@ -44422,7 +42102,6 @@ must check @error to detect errors. Structure for saving a timestamp and a value. - timestamp of the value change @@ -44478,10 +42157,8 @@ alternative type entry) with track entries underneath that node; or even multiple top-level edition nodes (or some other alternative type entries) each with track entries underneath, in case the source file has extracted a track listing from different sources). - Create a new #GstToc structure. - newly allocated #GstToc structure, free it with gst_toc_unref(). @@ -44496,7 +42173,6 @@ a track listing from different sources). Appends the #GstTocEntry @entry to @toc. - @@ -44512,7 +42188,6 @@ a track listing from different sources). - @@ -44524,7 +42199,6 @@ a track listing from different sources). Find #GstTocEntry with given @uid in the @toc. - #GstTocEntry with specified @uid from the @toc, or %NULL if not found. @@ -44543,7 +42217,6 @@ a track listing from different sources). Gets the list of #GstTocEntry of @toc. - A #GList of #GstTocEntry for @entry @@ -44558,7 +42231,6 @@ a track listing from different sources). - scope of @toc @@ -44572,7 +42244,6 @@ a track listing from different sources). Gets the tags for @toc. - A #GstTagList for @entry @@ -44586,7 +42257,6 @@ a track listing from different sources). Merge @tags into the existing tags of @toc using @mode. - @@ -44607,7 +42277,6 @@ a track listing from different sources). Set a #GstTagList with tags for the complete @toc. - @@ -44624,10 +42293,8 @@ a track listing from different sources). - Create new #GstTocEntry structure. - newly allocated #GstTocEntry structure, free it with gst_toc_entry_unref(). @@ -44645,7 +42312,6 @@ a track listing from different sources). Appends the #GstTocEntry @subentry to @entry. - @@ -44661,7 +42327,6 @@ a track listing from different sources). - @entry's entry type @@ -44678,7 +42343,6 @@ a track listing from different sources). appropriate storages. Loops are e.g. used by sampled instruments. GStreamer is not automatically applying the loop. The application can process this meta data and use it e.g. to send a seek-event to loop a section. - %TRUE if all non-%NULL storage pointers were filled with appropriate values, %FALSE otherwise. @@ -44703,7 +42367,6 @@ values, %FALSE otherwise. Gets the parent #GstTocEntry of @entry. - The parent #GstTocEntry of @entry @@ -44718,7 +42381,6 @@ values, %FALSE otherwise. Get @start and @stop values from the @entry and write them into appropriate storages. - %TRUE if all non-%NULL storage pointers were filled with appropriate values, %FALSE otherwise. @@ -44743,7 +42405,6 @@ values, %FALSE otherwise. Gets the sub-entries of @entry. - A #GList of #GstTocEntry of @entry @@ -44759,7 +42420,6 @@ values, %FALSE otherwise. Gets the tags for @entry. - A #GstTagList for @entry @@ -44773,7 +42433,6 @@ values, %FALSE otherwise. Gets the parent #GstToc of @entry. - The parent #GstToc of @entry @@ -44787,7 +42446,6 @@ values, %FALSE otherwise. Gets the UID of @entry. - The UID of @entry @@ -44800,7 +42458,6 @@ values, %FALSE otherwise. - %TRUE if @entry's type is an alternative type, otherwise %FALSE @@ -44813,7 +42470,6 @@ values, %FALSE otherwise. - %TRUE if @entry's type is a sequence type, otherwise %FALSE @@ -44827,7 +42483,6 @@ values, %FALSE otherwise. Merge @tags into the existing tags of @entry using @mode. - @@ -44848,7 +42503,6 @@ values, %FALSE otherwise. Set @loop_type and @repeat_count values for the @entry. - @@ -44869,7 +42523,6 @@ values, %FALSE otherwise. Set @start and @stop values for the @entry. - @@ -44890,7 +42543,6 @@ values, %FALSE otherwise. Set a #GstTagList with tags for the complete @entry. - @@ -44933,7 +42585,6 @@ There are two types of TOC entries: alternatives or parts in a sequence. Converts @type to a string representation. - Returns a human-readable string for @type. This string is only for debugging purpose and should not be displayed in a user @@ -44994,12 +42645,10 @@ and set TOC using gst_toc_setter_set_toc(). Elements implementing the #GstTocSetter interface can extend existing TOC by getting extend UID for that (you can use gst_toc_find_entry() to retrieve it) with any TOC entries received from downstream. - Return current TOC the setter uses. The TOC should not be modified without making it writable first. - TOC set, or %NULL. Unref with gst_toc_unref() when no longer needed @@ -45015,7 +42664,6 @@ modified without making it writable first. Reset the internal TOC. Elements should call this from within the state-change handler. - @@ -45029,7 +42677,6 @@ state-change handler. Set the given TOC on the setter. Previously set TOC will be unreffed before setting a new one. - @@ -45047,7 +42694,6 @@ unreffed before setting a new one. #GstTocSetterInterface interface. - parent interface type. @@ -45058,11 +42704,9 @@ unreffed before setting a new one. gst_tracer_register(). Modules can attach to various hook-types - see gst_tracing_register_hook(). When invoked they receive hook specific contextual data, which they must not modify. - Create a new tracer-factory capable of instantiating objects of the @type and add the factory to @plugin. - %TRUE, if the registering succeeded, %FALSE on error @@ -45098,7 +42742,6 @@ contextual data, which they must not modify. - @@ -45111,7 +42754,6 @@ contextual data, which they must not modify. Use gst_tracer_factory_get_list() to get a list of tracer factories known to GStreamer. - Gets the list of all registered tracer factories. You must free the list using gst_plugin_feature_list_free(). @@ -45119,7 +42761,6 @@ list using gst_plugin_feature_list_free(). The returned factories are sorted by factory name. Free-function: gst_plugin_feature_list_free - the list of all registered #GstTracerFactory. @@ -45132,7 +42773,6 @@ Free-function: gst_plugin_feature_list_free Get the #GType for elements managed by this factory. The type can only be retrieved if the element factory is loaded, which can be assured with gst_plugin_feature_load(). - the #GType for tracers managed by this factory or 0 if the factory is not loaded. @@ -45146,16 +42786,11 @@ the factory is not loaded. - - - - - - + + Tracing modules will create instances of this class to announce the data they will log and create a log formatter. - Create a new tracer record. The record instance can be used to efficiently log entries using gst_tracer_record_log(). @@ -45175,7 +42810,6 @@ pointer type values must not be NULL - the underlying serialisation can not handle that right now. > Please note that this is still under discussion and subject to change. - a new #GstTracerRecord @@ -45202,7 +42836,6 @@ Right now this is using the gstreamer debug log with the level TRACE (7) and the category "GST_TRACER". > Please note that this is still under discussion and subject to change. - @@ -45218,9 +42851,7 @@ the category "GST_TRACER". - - - + Flag that describe the value. These flags help applications processing the logs to understand the values. @@ -45259,10 +42890,8 @@ events may contain values for different #GstPads. The following functions allow you to detect the media type of an unknown stream. - - @@ -45281,7 +42910,6 @@ stream. - @@ -45304,7 +42932,6 @@ stream. - @@ -45322,7 +42949,6 @@ stream. Get the length of the data stream. - The length of the data stream, or 0 if it is not available. @@ -45340,7 +42966,6 @@ offset is a positive number, the offset is relative to the beginning of the stream, if offset is a negative number the offset is relative to the end of the stream. The returned memory is valid until the typefinding function returns and must not be freed. - the requested data, or %NULL if that data is not available. @@ -45368,7 +42993,6 @@ returns and must not be freed. given probability. A #GstTypeFindFunction may supply different suggestions in one call. It is up to the caller of the #GstTypeFindFunction to interpret these values. - @@ -45401,7 +43025,6 @@ Make sure you terminate the list of arguments with a %NULL argument and that the values passed have the correct type (in terms of width in bytes when passed to the vararg function - this applies particularly to gdouble and guint64 arguments). - @@ -45434,7 +43057,6 @@ guint64 arguments). Registers a new typefind function to be used for typefinding. After registering this function will be available for typefinding. This function is typically called during an element's plugin initialization. - %TRUE on success, %FALSE otherwise @@ -45529,7 +43151,6 @@ that though. return find.caps; }; ]| - Gets the list of all registered typefind factories. You must free the list using gst_plugin_feature_list_free(). @@ -45538,7 +43159,6 @@ The returned factories are sorted by highest rank first, and then by factory name. Free-function: gst_plugin_feature_list_free - the list of all registered #GstTypeFindFactory. @@ -45549,7 +43169,6 @@ Free-function: gst_plugin_feature_list_free Calls the #GstTypeFindFunction associated with this factory. - @@ -45567,7 +43186,6 @@ Free-function: gst_plugin_feature_list_free Gets the #GstCaps associated with a typefind factory. - the #GstCaps associated with this factory @@ -45584,7 +43202,6 @@ Free-function: gst_plugin_feature_list_free array should not be changed. If you need to change stuff in it, you should copy it using g_strdupv(). This function may return %NULL to indicate a 0-length list. - a %NULL-terminated array of extensions associated with this factory @@ -45603,7 +43220,6 @@ a 0-length list. Check whether the factory has a typefind function. Typefind factories without typefind functions are a last-effort fallback mechanism to e.g. assume a certain media type based on the file extension. - %TRUE if the factory has a typefind functions set, otherwise %FALSE @@ -45616,12 +43232,9 @@ e.g. assume a certain media type based on the file extension. - - - + A function that will be called by typefinding. - @@ -45659,7 +43272,6 @@ in doing a reliable typefind. - @@ -45697,10 +43309,8 @@ that handles the given URI for reading or writing (gst_element_make_from_uri()). Source and Sink plugins should implement this interface when possible. - Gets the currently handled URI. - the URI currently handled by the @handler. Returns %NULL if there are no URI currently @@ -45717,7 +43327,6 @@ Source and Sink plugins should implement this interface when possible. Tries to set the URI of the given handler. - %TRUE if the URI was set successfully, else %FALSE. @@ -45736,7 +43345,6 @@ Source and Sink plugins should implement this interface when possible. Gets the list of protocols supported by @handler. This list may not be modified. - the supported protocols. Returns %NULL if the @handler isn't @@ -45755,7 +43363,6 @@ modified. Gets the currently handled URI. - the URI currently handled by the @handler. Returns %NULL if there are no URI currently @@ -45772,7 +43379,6 @@ modified. Gets the type of the given URI handler - the #GstURIType of the URI handler. Returns #GST_URI_UNKNOWN if the @handler isn't implemented correctly. @@ -45787,7 +43393,6 @@ Returns #GST_URI_UNKNOWN if the @handler isn't implemented correctly. Tries to set the URI of the given handler. - %TRUE if the URI was set successfully, else %FALSE. @@ -45806,14 +43411,12 @@ Returns #GST_URI_UNKNOWN if the @handler isn't implemented correctly. Any #GstElement using this interface should implement these methods. - The parent interface type - @@ -45826,7 +43429,6 @@ Returns #GST_URI_UNKNOWN if the @handler isn't implemented correctly. - @@ -45841,7 +43443,6 @@ Returns #GST_URI_UNKNOWN if the @handler isn't implemented correctly. - the URI currently handled by the @handler. Returns %NULL if there are no URI currently @@ -45859,7 +43460,6 @@ Returns #GST_URI_UNKNOWN if the @handler isn't implemented correctly. - %TRUE if the URI was set successfully, else %FALSE. @@ -45890,28 +43490,24 @@ Returns #GST_URI_UNKNOWN if the @handler isn't implemented correctly. - - - - @@ -45919,12 +43515,10 @@ Returns #GST_URI_UNKNOWN if the @handler isn't implemented correctly. Value for #GstUri<!-- -->.port to indicate no port number. - Tests if the type direction is valid. - A #GstURIType @@ -45933,19 +43527,16 @@ Returns #GST_URI_UNKNOWN if the @handler isn't implemented correctly. Constant that defines one GStreamer microsecond. - A #GstUri object can be used to parse and split a URI string into its constituent parts. Two #GstUri objects can be joined to make a new #GstUri using the algorithm described in RFC3986. - Creates a new #GstUri object with the given URI parts. The path and query strings will be broken down into their elements. All strings should not be escaped except where indicated. - A new #GstUri object. @@ -45987,7 +43578,6 @@ escaped except where indicated. Append a path onto the end of the path in the URI. The path is not normalized, call #gst_uri_normalize() to normalize the path. - %TRUE if the path was appended successfully. @@ -46005,7 +43595,6 @@ normalized, call #gst_uri_normalize() to normalize the path. Append a single path segment onto the end of the URI path. - %TRUE if the path was appended successfully. @@ -46024,7 +43613,6 @@ normalized, call #gst_uri_normalize() to normalize the path. Compares two #GstUri objects to see if they represent the same normalized URI. - %TRUE if the normalized versions of the two URI's would be equal. @@ -46042,7 +43630,6 @@ URI. Like gst_uri_from_string() but also joins with a base URI. - A new #GstUri object. @@ -46061,7 +43648,6 @@ URI. Get the fragment name from the URI or %NULL if it doesn't exist. If @uri is %NULL then returns %NULL. - The host name from the #GstUri object or %NULL. @@ -46076,7 +43662,6 @@ If @uri is %NULL then returns %NULL. Get the host name from the URI or %NULL if it doesn't exist. If @uri is %NULL then returns %NULL. - The host name from the #GstUri object or %NULL. @@ -46100,7 +43685,6 @@ with #g_hash_table_unref() when it is no longer required. Modifying this hash table does not affect the fragment in the URI. See more about Media Fragments URI 1.0 (W3C) at https://www.w3.org/TR/media-frags/ - The fragment hash table from the URI. @@ -46118,7 +43702,6 @@ See more about Media Fragments URI 1.0 (W3C) at https://www.w3.org/TR/media-frag Extract the path string from the URI object. - The path from the URI. Once finished with the string should be g_free()'d. @@ -46133,7 +43716,6 @@ See more about Media Fragments URI 1.0 (W3C) at https://www.w3.org/TR/media-frag Get a list of path segments from the URI. - A #GList of path segment strings or %NULL if no path segments are available. Free the list @@ -46151,7 +43733,6 @@ See more about Media Fragments URI 1.0 (W3C) at https://www.w3.org/TR/media-frag Extract the path string from the URI object as a percent encoded URI path. - The path from the URI. Once finished with the string should be g_free()'d. @@ -46167,7 +43748,6 @@ See more about Media Fragments URI 1.0 (W3C) at https://www.w3.org/TR/media-frag Get the port number from the URI or %GST_URI_NO_PORT if it doesn't exist. If @uri is %NULL then returns %GST_URI_NO_PORT. - The port number from the #GstUri object or %GST_URI_NO_PORT. @@ -46181,7 +43761,6 @@ If @uri is %NULL then returns %GST_URI_NO_PORT. Get a list of the query keys from the URI. - A list of keys from the URI query. Free the list with g_list_free(). @@ -46198,7 +43777,6 @@ If @uri is %NULL then returns %GST_URI_NO_PORT. Get a percent encoded URI query string from the @uri. - A percent encoded query string. Use g_free() when no longer needed. @@ -46218,7 +43796,6 @@ the key should appear in the query string in the URI, but does not have a value. Free the returned #GHashTable with #g_hash_table_unref() when it is no longer required. Modifying this hash table will modify the query in the URI. - The query hash table from the URI. @@ -46240,7 +43817,6 @@ key has no value or if the key does not exist in the URI query table. Because %NULL is returned for both missing keys and keys with no value, you should use gst_uri_query_has_key() to determine if a key is present in the URI query. - The value for the given key, or %NULL if not found. @@ -46259,7 +43835,6 @@ query. Get the scheme name from the URI or %NULL if it doesn't exist. If @uri is %NULL then returns %NULL. - The scheme from the #GstUri object or %NULL. @@ -46274,7 +43849,6 @@ If @uri is %NULL then returns %NULL. Get the userinfo (usually in the form "username:password") from the URI or %NULL if it doesn't exist. If @uri is %NULL then returns %NULL. - The userinfo from the #GstUri object or %NULL. @@ -46289,7 +43863,6 @@ or %NULL if it doesn't exist. If @uri is %NULL then returns %NULL. Tests the @uri to see if it is normalized. A %NULL @uri is considered to be normalized. - TRUE if the URI is normalized or is %NULL. @@ -46309,7 +43882,6 @@ reference exists to the #GstUri and that the #GstUri is therefore writable. Modification of a #GstUri should only be done after verifying that it is writable. - %TRUE if it is safe to write to the object. @@ -46325,7 +43897,6 @@ writable. Join a reference URI onto a base URI using the method from RFC 3986. If either URI is %NULL then the other URI will be returned with the ref count increased. - A #GstUri which represents the base with the reference URI joined on. @@ -46350,7 +43921,6 @@ Checks if @uri is writable, and if so the original object is returned. If not, then a writable copy is made and returned. This gives away the reference to @uri and returns a reference to the new #GstUri. If @uri is %NULL then %NULL is returned. - A writable version of @uri. @@ -46364,7 +43934,6 @@ If @uri is %NULL then %NULL is returned. Like gst_uri_new(), but joins the new URI onto a base URI. - The new URI joined onto @base. @@ -46414,7 +43983,6 @@ percent-encoded values to uppercase. The #GstUri object must be writable. Check with gst_uri_is_writable() or use gst_uri_make_writable() first. - TRUE if the URI was modified. @@ -46428,7 +43996,6 @@ gst_uri_make_writable() first. Check if there is a query table entry for the @query_key key. - %TRUE if @query_key exists in the URI query table. @@ -46446,7 +44013,6 @@ gst_uri_make_writable() first. Remove an entry from the query table by key. - %TRUE if the key existed in the table and was removed. @@ -46465,7 +44031,6 @@ gst_uri_make_writable() first. Sets the fragment string in the URI. Use a value of %NULL in @fragment to unset the fragment string. - %TRUE if the fragment was set/unset successfully. @@ -46483,7 +44048,6 @@ unset the fragment string. Set or unset the host for the URI. - %TRUE if the host was set/unset successfully. @@ -46501,7 +44065,6 @@ unset the fragment string. Sets or unsets the path in the URI. - %TRUE if the path was set successfully. @@ -46520,7 +44083,6 @@ unset the fragment string. Replace the path segments list in the URI. - %TRUE if the path segments were set successfully. @@ -46541,7 +44103,6 @@ unset the fragment string. Sets or unsets the path in the URI. - %TRUE if the path was set successfully. @@ -46560,7 +44121,6 @@ unset the fragment string. Set or unset the port number for the URI. - %TRUE if the port number was set/unset successfully. @@ -46578,7 +44138,6 @@ unset the fragment string. Sets or unsets the query table in the URI. - %TRUE if the query table was set successfully. @@ -46599,7 +44158,6 @@ unset the fragment string. Set the query table to use in the URI. The old table is unreferenced and a reference to the new one is used instead. A value if %NULL for @query_table will remove the query string from the URI. - %TRUE if the new table was successfully used for the query table. @@ -46623,7 +44181,6 @@ will remove the query string from the URI. This inserts or replaces a key in the query table. A @query_value of %NULL indicates that the key has no associated value, but will still be present in the query string. - %TRUE if the query table was successfully updated. @@ -46645,7 +44202,6 @@ the query string. Set or unset the scheme for the URI. - %TRUE if the scheme was set/unset successfully. @@ -46663,7 +44219,6 @@ the query string. Set or unset the user information for the URI. - %TRUE if the user information was set/unset successfully. @@ -46685,7 +44240,6 @@ the query string. Returns the URI as held in this object as a #gchar* nul-terminated string. The caller should g_free() the string once they are finished with it. The string is put together as described in RFC 3986. - The string version of the URI. @@ -46702,7 +44256,6 @@ The string is put together as described in RFC 3986. Free-function: g_free Use GstURI instead. - a new string for this URI. Returns %NULL if the given URI protocol is not valid, or the given location is %NULL. @@ -46722,7 +44275,6 @@ Free-function: g_free Parses a URI string into a new #GstUri object. Will return NULL if the URI cannot be parsed. - A new #GstUri object, or NULL. @@ -46748,7 +44300,6 @@ delineates the username and password. The same applies to the fragment component of the URI, such as https://example.com/path#fragment which may contain a URI-escaped '#'. - A new #GstUri object, or NULL. @@ -46767,7 +44318,6 @@ the hostname if one is specified. The returned string must be freed using g_free(). Free-function: g_free - the location for this URI. Returns %NULL if the URI isn't valid. If the URI does not contain a location, an @@ -46784,7 +44334,6 @@ Free-function: g_free Extracts the protocol out of a given valid URI. The returned string must be freed using g_free(). - The protocol for this URI. @@ -46798,7 +44347,6 @@ freed using g_free(). Checks if the protocol of a given valid URI matches @protocol. - %TRUE if the protocol matches. @@ -46817,7 +44365,6 @@ freed using g_free(). Tests if the given string is a valid URI identifier. URIs start with a valid scheme followed by ":" and maybe a string identifying the location. - %TRUE if the string is a valid URI @@ -46832,7 +44379,6 @@ scheme followed by ":" and maybe a string identifying the location. This is a convenience function to join two URI strings and return the result. The returned string should be g_free()'d after use. - A string representing the percent-encoded join of the two URIs. @@ -46853,7 +44399,6 @@ The returned string should be g_free()'d after use. Checks if an element exists that supports the given URI protocol. Note that a positive return value does not imply that a subsequent call to gst_element_make_from_uri() is guaranteed to work. - %TRUE @@ -46873,7 +44418,6 @@ gst_element_make_from_uri() is guaranteed to work. Tests if the given string is a valid protocol identifier. Protocols must consist of alphanumeric characters, '+', '-' and '.' and must start with a alphabetic character. See RFC 3986 Section 3.1. - %TRUE if the string is a valid protocol identifier, %FALSE otherwise. @@ -46889,18 +44433,15 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Indicates that the first value provided to a comparison function (gst_value_compare()) is equal to the second one. - Indicates that the first value provided to a comparison function (gst_value_compare()) is greater than the second one. - Checks if the given #GValue contains a #GST_TYPE_ARRAY value. - the #GValue to check @@ -46909,7 +44450,6 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Checks if the given #GValue contains a #GST_TYPE_BITMASK value. - the #GValue to check @@ -46918,7 +44458,6 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Checks if the given #GValue contains a #GST_TYPE_BUFFER value. - the #GValue to check @@ -46927,7 +44466,6 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Checks if the given #GValue contains a #GST_TYPE_CAPS value. - the #GValue to check @@ -46936,7 +44474,6 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Checks if the given #GValue contains a #GST_TYPE_CAPS_FEATURES value. - the #GValue to check @@ -46945,7 +44482,6 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Checks if the given #GValue contains a #GST_TYPE_DATE_TIME value. - the #GValue to check @@ -46954,7 +44490,6 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Checks if the given #GValue contains a #GST_TYPE_DOUBLE_RANGE value. - the #GValue to check @@ -46963,7 +44498,6 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Checks if the given #GValue contains a #GST_TYPE_FLAG_SET value. - the #GValue to check @@ -46972,7 +44506,6 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Checks if the given #GValue contains a #GST_TYPE_FRACTION value. - the #GValue to check @@ -46981,7 +44514,6 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Checks if the given #GValue contains a #GST_TYPE_FRACTION_RANGE value. - the #GValue to check @@ -46990,7 +44522,6 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Checks if the given #GValue contains a #GST_TYPE_INT64_RANGE value. - the #GValue to check @@ -46999,7 +44530,6 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Checks if the given #GValue contains a #GST_TYPE_INT_RANGE value. - the #GValue to check @@ -47008,7 +44538,6 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Checks if the given #GValue contains a #GST_TYPE_LIST value. - the #GValue to check @@ -47017,7 +44546,6 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Checks if the given #GValue contains a #GST_TYPE_SAMPLE value. - the #GValue to check @@ -47026,7 +44554,6 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Checks if the given #GValue contains a #GST_TYPE_STRUCTURE value. - the #GValue to check @@ -47036,41 +44563,34 @@ start with a alphabetic character. See RFC 3986 Section 3.1. Indicates that the first value provided to a comparison function (gst_value_compare()) is lesser than the second one. - Indicates that the comparison function (gst_value_compare()) can not determine a order for the two provided values. - The major version of GStreamer at compile time: - The micro version of GStreamer at compile time: - The minor version of GStreamer at compile time: - The nano version of GStreamer at compile time: Actual releases have 0, GIT versions have 1, prerelease versions have 2-... - A fundamental type that describes an ordered list of #GValue Appends @append_value to the GstValueArray in @value. - @@ -47087,7 +44607,6 @@ Actual releases have 0, GIT versions have 1, prerelease versions have 2-... Appends @append_value to the GstValueArray in @value. - @@ -47104,7 +44623,6 @@ Actual releases have 0, GIT versions have 1, prerelease versions have 2-... Gets the number of values contained in @value. - the number of values @@ -47119,7 +44637,6 @@ Actual releases have 0, GIT versions have 1, prerelease versions have 2-... Gets the value that is a member of the array contained in @value and has the index @index. - the value at the given index @@ -47137,7 +44654,6 @@ has the index @index. Initializes and pre-allocates a #GValue of type #GST_VALUE_ARRAY. - The #GValue structure that has been passed in @@ -47155,7 +44671,6 @@ has the index @index. Prepends @prepend_value to the GstValueArray in @value. - @@ -47173,7 +44688,6 @@ has the index @index. Used together with gst_value_compare() to compare #GValue items. - one of GST_VALUE_LESS_THAN, GST_VALUE_EQUAL, GST_VALUE_GREATER_THAN or GST_VALUE_UNORDERED @@ -47192,7 +44706,6 @@ or GST_VALUE_UNORDERED Used by gst_value_deserialize() to parse a non-binary form into the #GValue. - %TRUE for success @@ -47212,7 +44725,6 @@ or GST_VALUE_UNORDERED A fundamental type that describes an unordered list of #GValue Appends @append_value to the GstValueList in @value. - @@ -47229,7 +44741,6 @@ or GST_VALUE_UNORDERED Appends @append_value to the GstValueList in @value. - @@ -47248,7 +44759,6 @@ or GST_VALUE_UNORDERED Concatenates copies of @value1 and @value2 into a list. Values that are not of type #GST_TYPE_LIST are treated as if they were lists of length 1. @dest will be initialized to the type #GST_TYPE_LIST. - @@ -47269,7 +44779,6 @@ of type #GST_TYPE_LIST are treated as if they were lists of length 1. Gets the number of values contained in @value. - the number of values @@ -47284,7 +44793,6 @@ of type #GST_TYPE_LIST are treated as if they were lists of length 1. Gets the value that is a member of the list contained in @value and has the index @index. - the value at the given index @@ -47302,7 +44810,6 @@ has the index @index. Initializes and pre-allocates a #GValue of type #GST_VALUE_LIST. - The #GValue structure that has been passed in @@ -47325,7 +44832,6 @@ of type #GST_TYPE_LIST are treated as if they were lists of length 1. The result will be put into @dest and will either be a list that will not contain any duplicates, or a non-list type (if @value1 and @value2 were equal). - @@ -47346,7 +44852,6 @@ were equal). Prepends @prepend_value to the GstValueList in @value. - @@ -47366,7 +44871,6 @@ were equal). Used by gst_value_serialize() to obtain a non-binary form of the #GValue. Free-function: g_free - the string representation of the value @@ -47380,7 +44884,6 @@ Free-function: g_free VTable for the #GValue @type. - a #GType @@ -47405,7 +44908,6 @@ Free-function: g_free Store a 16 bit unsigned integer value in big endian format into the memory buffer. - memory location @@ -47417,7 +44919,6 @@ Free-function: g_free Store a 16 bit unsigned integer value in little endian format into the memory buffer. - memory location @@ -47429,7 +44930,6 @@ Free-function: g_free Store a 24 bit unsigned integer value in big endian format into the memory buffer. - memory location @@ -47441,7 +44941,6 @@ Free-function: g_free Store a 24 bit unsigned integer value in little endian format into the memory buffer. - memory location @@ -47453,7 +44952,6 @@ Free-function: g_free Store a 32 bit unsigned integer value in big endian format into the memory buffer. - memory location @@ -47465,7 +44963,6 @@ Free-function: g_free Store a 32 bit unsigned integer value in little endian format into the memory buffer. - memory location @@ -47477,7 +44974,6 @@ Free-function: g_free Store a 64 bit unsigned integer value in big endian format into the memory buffer. - memory location @@ -47489,7 +44985,6 @@ Free-function: g_free Store a 64 bit unsigned integer value in little endian format into the memory buffer. - memory location @@ -47501,7 +44996,6 @@ Free-function: g_free Store an 8 bit unsigned integer value into the memory buffer. - memory location @@ -47517,7 +45011,6 @@ compile time constant that can be queried with the function. When more memory blocks are added, existing memory blocks will be merged together to make room for the new block. - the maximum amount of memory blocks that a buffer can hold. @@ -47526,7 +45019,6 @@ together to make room for the new block. Find and return a #GstParentBufferMeta if one exists on the buffer - a #GstBuffer @@ -47534,7 +45026,6 @@ buffer - @@ -47544,7 +45035,6 @@ buffer Tests if you can safely write to a buffer's metadata or its memory array. It is only safe to change buffer metadata when the current reference is writable, i.e. nobody can see the modifications you will make. - a #GstBuffer @@ -47553,7 +45043,6 @@ writable, i.e. nobody can see the modifications you will make. Append @b at the end of @l. - a #GstBufferList @@ -47565,7 +45054,6 @@ writable, i.e. nobody can see the modifications you will make. Tests if you can safely add buffers and groups into a buffer list. - a #GstBufferList @@ -47576,7 +45064,6 @@ writable, i.e. nobody can see the modifications you will make. Makes a writable buffer list from the given buffer list. If the source buffer list is already writable, this will simply return the same buffer list. A copy will otherwise be made using gst_buffer_list_copy(). - a #GstBufferList @@ -47602,7 +45089,6 @@ not copied if it can be shared amongst multiple buffers. In short, this function unrefs the buf in the argument and refs the buffer that it returns. Don't access the argument after calling this function unless you have an additional reference to it. - a #GstBuffer @@ -47610,7 +45096,6 @@ you have an additional reference to it. - @@ -47623,7 +45108,6 @@ in some cases), and the reference counts are updated appropriately (the old buffer is unreffed, the new is reffed). Either @nbuf or the #GstBuffer pointed to by @obuf may be %NULL. - %TRUE when @obuf was different from @nbuf. @@ -47658,7 +45142,6 @@ amount of memory allocated as @xy, i.e. 2*n*sizeof(GstClockTime). > between them. It will not calculate the exact results if the differences > between neighbouring values are too small due to not being able to > represent sub-integer values during the calculations. - %TRUE if the linear regression was successfully calculated @@ -47702,7 +45185,6 @@ amount of memory allocated as @xy, i.e. 2*n*sizeof(GstClockTime). Creates a #GstCapsFeatures from a string representation. Free-function: gst_caps_features_free - a new #GstCapsFeatures or %NULL when the string could not be parsed. Free with @@ -47721,7 +45203,6 @@ Free-function: gst_caps_features_free The current implementation of serialization will lead to unexpected results when there are nested #GstCaps / #GstStructure deeper than one level. - a newly allocated #GstCaps @@ -47736,7 +45217,6 @@ when there are nested #GstCaps / #GstStructure deeper than one level. Tests if you can safely modify @caps. It is only safe to modify caps when there is only one owner of the caps - ie, the object is writable. - a #GstCaps @@ -47755,7 +45235,6 @@ caller will own a reference to the returned object. In short, this function unrefs the caps in the argument and refs the caps that it returns. Don't access the argument after calling this function. See also: gst_caps_ref(). - a #GstCaps @@ -47769,7 +45248,6 @@ in some cases), and the reference counts are updated appropriately (the old caps is unreffed, the new is reffed). Either @new_caps or the #GstCaps pointed to by @old_caps may be %NULL. - %TRUE if @new_caps was different from @old_caps @@ -47791,7 +45269,6 @@ Either @new_caps or the #GstCaps pointed to by @old_caps may be %NULL. Modifies a pointer to a #GstCaps to point to a different #GstCaps. This function is similar to gst_caps_replace() except that it takes ownership of @new_caps. - %TRUE if @new_caps was different from @old_caps @@ -47820,7 +45297,6 @@ gst_mini_object_unref() and the pointer is set to %NULL. A macro is also included that allows this function to be used without pointer casts. - @@ -47842,7 +45318,6 @@ gst_object_unref() and the pointer is set to %NULL. A macro is also included that allows this function to be used without pointer casts. - @@ -47864,7 +45339,6 @@ pointer is set to %NULL. A macro is also included that allows this function to be used without pointer casts. - @@ -47878,7 +45352,6 @@ pointer casts. Tests if you can safely write into a context's structure or validly modify the seqnum and timestamp fields. - a #GstContext @@ -47888,7 +45361,6 @@ modify the seqnum and timestamp fields. Checks if a context is writable. If not, a writable copy is made and returned. - the context to make writable @@ -47904,7 +45376,6 @@ returned. Adds the logging function to the list of logging functions. Be sure to use #G_GNUC_NO_INSTRUMENT on that function, it is needed. - @@ -47931,7 +45402,6 @@ Be sure to use #G_GNUC_NO_INSTRUMENT on that function, it is needed. Logs can be fetched with gst_debug_ring_buffer_logger_get_logs() and the logger can be removed again with gst_debug_remove_ring_buffer_logger(). Only one logger at a time is possible. - @@ -47950,7 +45420,6 @@ Only one logger at a time is possible. To aid debugging applications one can use this method to obtain the whole network of gstreamer elements that form the pipeline into an dot file. This data can be processed with graphviz to get an image. - a string containing the pipeline in graphviz dot format. @@ -47975,7 +45444,6 @@ This file can be processed with graphviz to get an image. ``` shell dot -Tpng -oimage.png graph_lowlevel.dot ``` - @@ -47997,7 +45465,6 @@ This file can be processed with graphviz to get an image. This works like gst_debug_bin_to_dot_file(), but adds the current timestamp to the filename, so that it can be used to take multiple snapshots. - @@ -48020,7 +45487,6 @@ to the filename, so that it can be used to take multiple snapshots. Constructs a string that can be used for getting the desired color in color terminals. You need to free the string after use. - a string containing the color definition @@ -48039,7 +45505,6 @@ windows' terminals (cmd.exe). As there is no mean to underline, we simply ignore this attribute. This function returns 0 on non-windows machines. - an integer containing the color definition @@ -48055,7 +45520,6 @@ This function returns 0 on non-windows machines. Returns a snapshot of a all categories that are currently in use . This list may change anytime. The caller has to free the list after use. - the list of debug categories @@ -48066,7 +45530,6 @@ The caller has to free the list after use. Changes the coloring mode for debug output. - see @GstDebugColorMode for possible values. @@ -48074,14 +45537,12 @@ The caller has to free the list after use. Returns the default threshold that is used for new categories. - the default threshold level - a stack trace, if libunwind or glibc backtrace are present, else %NULL. @@ -48097,7 +45558,6 @@ look like. Pass #GST_STACK_TRACE_SHOW_NONE to retrieve a minimal backtrace. Checks if debugging output is activated. - %TRUE, if debugging is activated @@ -48105,7 +45565,6 @@ look like. Pass #GST_STACK_TRACE_SHOW_NONE to retrieve a minimal backtrace. Checks if the debugging output should be colored. - %TRUE, if the debug output should be colored. @@ -48113,7 +45572,6 @@ look like. Pass #GST_STACK_TRACE_SHOW_NONE to retrieve a minimal backtrace. Get the string representation of a debugging level - the name @@ -48127,7 +45585,6 @@ look like. Pass #GST_STACK_TRACE_SHOW_NONE to retrieve a minimal backtrace. Logs the given message using the currently registered debugging handlers. - @@ -48177,7 +45634,6 @@ specified via the GST_DEBUG_FILE environment variable) as received via You can add other handlers by using gst_debug_add_log_function(). And you can remove this handler by calling gst_debug_remove_log_function(gst_debug_log_default); - @@ -48223,7 +45679,6 @@ formatted in the same way as gst_debug_log_default() (the default handler), without color. The purpose is to make it easy for custom log output handlers to get a log output that is identical to what the default handler would write out. - @@ -48261,7 +45716,6 @@ would write out. Logs the given message using the currently registered debugging handlers. - @@ -48304,14 +45758,12 @@ would write out. If libunwind, glibc backtrace or DbgHelp are present a stack trace is printed. - Removes all registered instances of the given logging functions. - How many instances of the function were removed @@ -48326,7 +45778,6 @@ a stack trace is printed. Removes all registered instances of log functions with the given user data. - How many instances of the function were removed @@ -48341,7 +45792,6 @@ a stack trace is printed. Removes any previously added ring buffer logger with gst_debug_add_ring_buffer_logger(). - @@ -48349,7 +45799,6 @@ gst_debug_add_ring_buffer_logger(). Fetches the current logs per thread from the ring buffer logger. See gst_debug_add_ring_buffer_logger() for details. - NULL-terminated array of strings with the debug output per thread @@ -48364,7 +45813,6 @@ handlers. It makes sense to deactivate it for speed issues. > This function is not threadsafe. It makes sense to only call it during initialization. - @@ -48379,7 +45827,6 @@ during initialization. Changes the coloring mode for debug output. This function may be called before gst_init(). - @@ -48394,7 +45841,6 @@ This function may be called before gst_init(). Changes the coloring mode for debug output. This function may be called before gst_init(). - @@ -48412,7 +45858,6 @@ Same as gst_debug_set_color_mode () with the argument being being GST_DEBUG_COLOR_MODE_ON or GST_DEBUG_COLOR_MODE_OFF. This function may be called before gst_init(). - @@ -48428,7 +45873,6 @@ This function may be called before gst_init(). use this threshold. This function may be called before gst_init(). - @@ -48442,7 +45886,6 @@ This function may be called before gst_init(). Sets all categories which match the given glob style pattern to the given level. - @@ -48462,7 +45905,6 @@ level. environment variable. You can use wildcards such as '*', but note that the order matters when you use wild cards, e.g. "foosrc:6,*src:3,*:2" sets everything to log level 2. - @@ -48482,7 +45924,6 @@ everything to log level 2. Resets all categories with the given name back to the default level. - @@ -48502,14 +45943,12 @@ This function is therefore mostly used by testsuites and other memory profiling tools. After this call GStreamer (including this method) should not be used anymore. - Registers a new #GstDynamicTypeFactory in the registry - @@ -48525,42 +45964,36 @@ After this call GStreamer (including this method) should not be used anymore. - - - - - - @@ -48571,7 +46004,6 @@ After this call GStreamer (including this method) should not be used anymore. - a #GstElement to get the name of @elem. @@ -48580,7 +46012,6 @@ as well. Get the parent of an element. - a #GstElement to get the parent of. @@ -48589,7 +46020,6 @@ as well. Sets the name of the element, getting rid of the old name if there was one. - a #GstElement to set the name of. @@ -48601,7 +46031,6 @@ as well. Sets the parent of an element. - a #GstElement to set the parent of. @@ -48613,7 +46042,6 @@ as well. Get a string describing the error message in the current locale. - a newly allocated string describing the error message (in UTF-8 encoding) @@ -48633,7 +46061,6 @@ as well. Tests if you can safely write data into a event's structure or validly modify the seqnum and timestamp field. - a #GstEvent @@ -48644,7 +46071,6 @@ modify the seqnum and timestamp field. Makes a writable event from the given event. If the source event is already writable, this will simply return the same event. A copy will otherwise be made using gst_event_copy(). - a #GstEvent @@ -48658,7 +46084,6 @@ in some cases), and the reference counts are updated appropriately (the old event is unreffed, the new one is reffed). Either @new_event or the #GstEvent pointed to by @old_event may be %NULL. - %TRUE if @new_event was different from @old_event @@ -48679,7 +46104,6 @@ Either @new_event or the #GstEvent pointed to by @old_event may be %NULL. Atomically replace the #GstEvent pointed to by @old_event with %NULL and return the original event. - the #GstEvent that was in @old_event @@ -48698,7 +46122,6 @@ function is similar to gst_event_replace() except that it takes ownership of @new_event. Either @new_event or the #GstEvent pointed to by @old_event may be %NULL. - %TRUE if @new_event was different from @old_event @@ -48718,7 +46141,6 @@ Either @new_event or the #GstEvent pointed to by @old_event may be %NULL. Gets the #GstEventTypeFlags associated with @type. - a #GstEventTypeFlags. @@ -48732,7 +46154,6 @@ Either @new_event or the #GstEvent pointed to by @old_event may be %NULL. Get a printable name for the given event type. Do not modify or free. - a reference to the static name of the event. @@ -48746,7 +46167,6 @@ Either @new_event or the #GstEvent pointed to by @old_event may be %NULL. Get the unique quark for the given event type. - the quark associated with the event type @@ -48765,7 +46185,6 @@ the current working directory if it is a relative path, and then the path will be canonicalised so that it doesn't contain any './' or '../' segments. On Windows @filename should be in UTF-8 encoding. - newly-allocated URI string, or NULL on error. The caller must free the URI string with g_free() when no longer needed. @@ -48780,7 +46199,6 @@ On Windows @filename should be in UTF-8 encoding. Gets a string representing the given flow return. - a static string with the name of the flow return. @@ -48794,7 +46212,6 @@ On Windows @filename should be in UTF-8 encoding. Get the unique quark for the given GstFlowReturn. - the quark associated with the flow return or 0 if an invalid return was specified. @@ -48809,7 +46226,6 @@ invalid return was specified. Return the format registered with the given nick. - The format with @nick or GST_FORMAT_UNDEFINED if the format was not registered. @@ -48824,7 +46240,6 @@ if the format was not registered. Get details about the given format. - The #GstFormatDefinition for @format or %NULL on failure. @@ -48841,7 +46256,6 @@ MT safe. Get a printable name for the given format. Do not modify or free. - a reference to the static name of the format or %NULL if the format is unknown. @@ -48857,7 +46271,6 @@ or %NULL if the format is unknown. Iterate all the registered formats. The format definition is read only. - a GstIterator of #GstFormatDefinition. @@ -48866,7 +46279,6 @@ only. Create a new GstFormat based on the nick or return an already registered format with that nick. - A new GstFormat or an already registered format with the same nick. @@ -48887,7 +46299,6 @@ MT safe. Get the unique quark for the given format. - the quark associated with the format or 0 if the format is unknown. @@ -48902,7 +46313,6 @@ is unknown. See if the given format is inside the format array. - %TRUE if the format is found inside the array @@ -48922,7 +46332,6 @@ is unknown. Convert @value to a guint64. - the #gdouble value to convert @@ -48937,7 +46346,6 @@ their set of features. When a plugin is initialized from the gst-plugin-scanner external process, the returned path will be the same as from the parent process. - The path of the executable that initialized GStreamer, or %NULL if it could not be determined. @@ -49205,7 +46613,6 @@ The version macros get defined by including "gst/gst.h". Convert @value to a gdouble. - the #guint64 value to convert @@ -49219,7 +46626,6 @@ The version macros get defined by including "gst/gst.h". See gst_info_vasprintf() for when this function is required. Free with g_free(). - a newly allocated null terminated string or %NULL on any error @@ -49242,7 +46648,6 @@ Free with g_free(). See gst_info_vasprintf() for when this function is required. Free with g_free(). - a newly allocated null terminated string or %NULL on any error @@ -49268,7 +46673,6 @@ in your @format string, you do not need to use this function and can use alternatives such as g_vasprintf(). Free @result with g_free(). - the length of the string allocated into @result or -1 on any error @@ -49307,7 +46711,6 @@ WARNING: This function does not work in the same way as corresponding functions in other glib-style libraries, such as gtk_init\(\). In particular, unknown command line options cause this function to abort program execution. - @@ -49331,7 +46734,6 @@ registering built-in elements, and loading standard plugins. This function will return %FALSE if GStreamer could not be initialized for some reason. If you want your program to fail fatally, use gst_init() instead. - %TRUE if GStreamer could be initialized. @@ -49361,7 +46763,6 @@ libraries that use GOption (see g_option_context_add_group() ). If you use this function, you should make sure you initialise the GLib threading system as one of the very first things in your program (see the example at the beginning of this section). - a pointer to GStreamer's option group. @@ -49369,7 +46770,6 @@ threading system as one of the very first things in your program Checks if @obj is a #GstCapsFeatures - %TRUE if @obj is a #GstCapsFeatures %FALSE otherwise @@ -49383,7 +46783,6 @@ threading system as one of the very first things in your program Use this function to check if GStreamer has been initialized with gst_init() or gst_init_check(). - %TRUE if initialization has been done, %FALSE otherwise. @@ -49397,7 +46796,6 @@ or gst_init_check(). Create a #GstStructure to be used with #gst_element_message_full_with_details - @@ -49413,14 +46811,12 @@ or gst_init_check(). - - @@ -49429,14 +46825,12 @@ or gst_init_check(). - - @@ -49447,7 +46841,6 @@ or gst_init_check(). Tests if you can safely write into a message's structure or validly modify the seqnum and timestamp fields. - a #GstMessage @@ -49457,7 +46850,6 @@ modify the seqnum and timestamp fields. Checks if a message is writable. If not, a writable copy is made and returned. - the message to make writable @@ -49465,7 +46857,6 @@ returned. - @@ -49476,7 +46867,6 @@ returned. - @@ -49493,7 +46883,6 @@ in some cases), and the reference counts are updated appropriately (the old message is unreffed, the new one is reffed). Either @new_message or the #GstMessage pointed to by @old_message may be %NULL. - %TRUE if @new_message was different from @old_message @@ -49513,7 +46902,6 @@ Either @new_message or the #GstMessage pointed to by @old_message may be %NULL.< Get a printable name for the given message type. Do not modify or free. - a reference to the static name of the message. @@ -49527,7 +46915,6 @@ Either @new_message or the #GstMessage pointed to by @old_message may be %NULL.< Get the unique quark for the given message type. - the quark associated with the message type @@ -49540,7 +46927,6 @@ Either @new_message or the #GstMessage pointed to by @old_message may be %NULL.< - an array of tags as strings. @@ -49556,7 +46942,6 @@ Either @new_message or the #GstMessage pointed to by @old_message may be %NULL.< Check if @api was registered with @tag. - %TRUE if @api was registered with @tag. @@ -49575,7 +46960,6 @@ Either @new_message or the #GstMessage pointed to by @old_message may be %NULL.< Register and return a GType for the @api and associate it with @tags. - a unique GType for @api. @@ -49596,7 +46980,6 @@ Either @new_message or the #GstMessage pointed to by @old_message may be %NULL.< Lookup a previously registered meta info structure by its implementation name @impl. - a #GstMetaInfo with @impl, or %NULL when no such metainfo exists. @@ -49614,7 +46997,6 @@ Either @new_message or the #GstMessage pointed to by @old_message may be %NULL.< The same @info can be retrieved later with gst_meta_get_info() by using @impl as the key. - a #GstMetaInfo that can be used to access metadata. @@ -49653,7 +47035,6 @@ The reference count of @olddata is decreased and the reference count of @newdata is increased. Either @newdata and the value pointed to by @olddata may be %NULL. - %TRUE if @newdata was different from @olddata @@ -49673,7 +47054,6 @@ Either @newdata and the value pointed to by @olddata may be %NULL. Replace the current #GstMiniObject pointer to by @olddata with %NULL and return the old value. - the #GstMiniObject at @oldata @@ -49693,7 +47073,6 @@ except that it does not increase the refcount of @newdata and thus takes ownership of @newdata. Either @newdata and the value pointed to by @olddata may be %NULL. - %TRUE if @newdata was different from @olddata @@ -49711,7 +47090,6 @@ Either @newdata and the value pointed to by @olddata may be %NULL. - @@ -49721,7 +47099,6 @@ Either @newdata and the value pointed to by @olddata may be %NULL. Get a copy of the name of the pad. g_free() after usage. MT safe. - the pad to get the name from @@ -49734,7 +47111,6 @@ of the parent object so you should gst_object_unref() it after usage. Can return %NULL if the pad did not have a parent. MT safe. - the pad to get the parent of @@ -49743,7 +47119,6 @@ MT safe. Return the name of a pad mode, for use in debug messages mostly. - short mnemonic for pad mode @mode @@ -49756,7 +47131,6 @@ MT safe. - @@ -49765,7 +47139,6 @@ MT safe. Calls gst_pad_set_activate_function_full() with %NULL for the user_data and notify. - a #GstPad. @@ -49778,7 +47151,6 @@ notify. Calls gst_pad_set_activatemode_function_full() with %NULL for the user_data and notify. - a #GstPad. @@ -49791,7 +47163,6 @@ notify. Calls gst_pad_set_chain_function_full() with %NULL for the user_data and notify. - a sink #GstPad. @@ -49804,7 +47175,6 @@ notify. Calls gst_pad_set_chain_list_function_full() with %NULL for the user_data and notify. - a sink #GstPad. @@ -49817,7 +47187,6 @@ notify. Calls gst_pad_set_event_full_function_full() with %NULL for the user_data and notify. - a #GstPad of either direction. @@ -49830,7 +47199,6 @@ notify. Calls gst_pad_set_event_function_full() with %NULL for the user_data and notify. - a #GstPad of either direction. @@ -49843,7 +47211,6 @@ notify. Calls gst_pad_set_getrange_function_full() with %NULL for the user_data and notify. - a source #GstPad. @@ -49856,7 +47223,6 @@ notify. Calls gst_pad_set_iterate_internal_links_function_full() with %NULL for the user_data and notify. - a #GstPad of either direction. @@ -49869,7 +47235,6 @@ for the user_data and notify. Calls gst_pad_set_link_function_full() with %NULL for the user_data and notify. - a #GstPad. @@ -49882,7 +47247,6 @@ for the user_data and notify. Calls gst_pad_set_query_function_full() with %NULL for the user_data and notify. - a #GstPad of either direction. @@ -49895,7 +47259,6 @@ notify. Calls gst_pad_set_unlink_function_full() with %NULL for the user_data and notify. - a #GstPad. @@ -49910,7 +47273,6 @@ for the user_data and notify. that want to expose properties of GstArray type. This function is typically * used in connection with g_object_class_install_property() in a GObjects's instance_init function. - a newly created parameter specification @@ -49943,7 +47305,6 @@ GObjects's instance_init function. that want to expose properties of fraction type. This function is typically used in connection with g_object_class_install_property() in a GObjects's instance_init function. - a newly created parameter specification @@ -49993,14 +47354,12 @@ instance_init function. - Get the global #GstMetaInfo describing the #GstParentBufferMeta meta. - The #GstMetaInfo @@ -50016,7 +47375,6 @@ one ghost pad for each direction will be created; if you expect multiple unlinked source pads or multiple unlinked sink pads and want them all ghosted, you will have to create the ghost pads yourself). - a newly-created bin, or %NULL if an error occurred. @@ -50044,7 +47402,6 @@ one ghost pad for each direction will be created; if you expect multiple unlinked source pads or multiple unlinked sink pads and want them all ghosted, you will have to create the ghost pads yourself). - a newly-created element, which is guaranteed to be a bin unless @@ -50088,7 +47445,6 @@ can try to play the pipeline. To create a sub-pipeline (bin) for embedding into an existing pipeline use gst_parse_bin_from_description(). - a new element on success, %NULL on failure. If more than one toplevel element is specified by the @@ -50111,7 +47467,6 @@ can try to play the pipeline. To create a sub-pipeline (bin) for embedding into an existing pipeline use gst_parse_bin_from_description_full(). - a new element on success, %NULL on failure. If more than one toplevel element is specified by the @@ -50140,7 +47495,6 @@ use gst_parse_bin_from_description_full(). Create a new element based on command line syntax. @error will contain an error message if an erroneous pipeline is specified. An error does not mean that the pipeline could not be constructed. - a new element on success and %NULL on failure. @@ -50159,7 +47513,6 @@ on failure. Create a new element based on command line syntax. @error will contain an error message if an erroneous pipeline is specified. An error does not mean that the pipeline could not be constructed. - a new element on success; on failure, either %NULL or a partially-constructed bin or element will be @@ -50196,7 +47549,6 @@ An error does not mean that the pipeline could not be constructed. Returns the name of @feature. For a nameless plugin feature, this returns %NULL. - a #GstPluginFeature to get the name of @feature. @@ -50205,7 +47557,6 @@ For a nameless plugin feature, this returns %NULL. Sets the name of the plugin feature, getting rid of the old name if there was one. - a #GstPluginFeature to set the name of. @@ -50221,7 +47572,6 @@ is possible to restart or flush a call to gst_poll_wait() with gst_poll_restart() and gst_poll_set_flushing() respectively. Free-function: gst_poll_free - a new #GstPoll, or %NULL in case of an error. Free with gst_poll_free(). @@ -50242,7 +47592,6 @@ A timeout is performed with gst_poll_wait(). Multiple timeouts can be performed from different threads. Free-function: gst_poll_free - a new #GstPoll, or %NULL in case of an error. Free with gst_poll_free(). @@ -50252,7 +47601,6 @@ Free-function: gst_poll_free Gets the directory for application specific presets if set by the application. - the directory or %NULL, don't free or modify the string @@ -50263,7 +47611,6 @@ the string Sets an extra directory as an absolute path that should be considered when looking for presets. Any presets in the application dir will shadow the system presets. - %TRUE for success, %FALSE if the dir already has been set @@ -50289,7 +47636,6 @@ printf specifiers that are supported by GStreamer's debug logging system, such as #GST_PTR_FORMAT and #GST_SEGMENT_FORMAT. This function is primarily for printing debug output. - @@ -50318,7 +47664,6 @@ printf specifiers that are supported by GStreamer's debug logging system, such as #GST_PTR_FORMAT and #GST_SEGMENT_FORMAT. This function is primarily for printing debug output. - @@ -50347,7 +47692,6 @@ printf specifiers that are supported by GStreamer's debug logging system, such as #GST_PTR_FORMAT and #GST_SEGMENT_FORMAT. This function is primarily for printing debug output. - @@ -50376,7 +47720,6 @@ printf specifiers that are supported by GStreamer's debug logging system, such as #GST_PTR_FORMAT and #GST_SEGMENT_FORMAT. This function is primarily for printing debug output. - @@ -50394,7 +47737,6 @@ This function is primarily for printing debug output. Iterates the supplied list of UUIDs and checks the GstRegistry for all the decryptors supporting one of the supplied UUIDs. - A null terminated array containing all @@ -50417,13 +47759,11 @@ protection system that is to be checked. - - @@ -50432,7 +47772,6 @@ protection system that is to be checked. Iterates the supplied list of UUIDs and checks the GstRegistry for an element that supports one of the supplied UUIDs. If more than one element matches, the system ID of the highest ranked element is selected. - One of the strings from @system_identifiers that indicates the highest ranked element that @@ -50453,7 +47792,6 @@ checked. Tests if you can safely write data into a query's structure. - a #GstQuery @@ -50462,7 +47800,6 @@ checked. Makes a writable query from the given query. - a #GstQuery to make writable @@ -50476,7 +47813,6 @@ in some cases), and the reference counts are updated appropriately (the old query is unreffed, the new one is reffed). Either @new_query or the #GstQuery pointed to by @old_query may be %NULL. - %TRUE if @new_query was different from @old_query @@ -50496,7 +47832,6 @@ Either @new_query or the #GstQuery pointed to by @old_query may be %NULL. Gets the #GstQueryTypeFlags associated with @type. - a #GstQueryTypeFlags. @@ -50510,7 +47845,6 @@ Either @new_query or the #GstQuery pointed to by @old_query may be %NULL. Get a printable name for the given query type. Do not modify or free. - a reference to the static name of the query. @@ -50524,7 +47858,6 @@ Either @new_query or the #GstQuery pointed to by @old_query may be %NULL. Get the unique quark for the given query type. - the quark associated with the query type @@ -50538,14 +47871,12 @@ Either @new_query or the #GstQuery pointed to by @old_query may be %NULL. - Get the global #GstMetaInfo describing the #GstReferenceTimestampMeta meta. - The #GstMetaInfo @@ -50559,7 +47890,6 @@ Either @new_query or the #GstQuery pointed to by @old_query may be %NULL. Tests if you can safely set the buffer and / or buffer list of @sample. - A #GstSample @@ -50583,7 +47913,6 @@ caller will now own a reference to the new returned sample object. In short, this function unrefs the sample in the argument and refs the sample that it returns. Don't access the argument after calling this function unless you have an additional reference to it. - A #GstSample @@ -50598,7 +47927,6 @@ is enabled by default when loading plugins. Applications might want to disable this behaviour with the gst_segtrap_set_enabled() function. This is typically done if the application wants to install its own handler without GStreamer interfering. - %TRUE if GStreamer is allowed to install a custom SIGSEGV handler. @@ -50607,7 +47935,6 @@ wants to install its own handler without GStreamer interfering. Applications might want to disable/enable the SIGSEGV handling of the GStreamer core. See gst_segtrap_is_enabled() for more information. - @@ -50620,7 +47947,6 @@ the GStreamer core. See gst_segtrap_is_enabled() for more information. Gets a string representing the given state transition. - a string with the name of the state result. @@ -50635,14 +47961,12 @@ the GStreamer core. See gst_segtrap_is_enabled() for more information. - - @@ -50655,7 +47979,6 @@ the GStreamer core. See gst_segtrap_is_enabled() for more information. Get a descriptive string for a given #GstStreamType - A string describing the stream type @@ -50676,7 +47999,6 @@ Either @newstr and the value pointed to by @oldstr_ptr may be %NULL. It is a programming error if both @newstr and the value pointed to by @oldstr_ptr refer to the same, non-%NULL structure. - %TRUE if @newstr was different from @oldstr_ptr @@ -50695,7 +48017,6 @@ It is a programming error if both @newstr and the value pointed to by Checks if the given type is already registered. - %TRUE if the type is already registered @@ -50710,7 +48031,6 @@ It is a programming error if both @newstr and the value pointed to by Returns the human-readable description of this tag, You must not change or free this string. - the human-readable description of this tag @@ -50724,7 +48044,6 @@ free this string. Gets the flag of @tag. - the flag of this tag. @@ -50739,7 +48058,6 @@ free this string. Returns the human-readable name of this tag, You must not change or free this string. - the human-readable name of this tag @@ -50753,7 +48071,6 @@ this string. Gets the #GType used for this tag. - the #GType of this tag @@ -50768,7 +48085,6 @@ this string. Checks if the given tag is fixed. A fixed tag can only contain one value. Unfixed tags can contain lists of values. - %TRUE, if the given tag is fixed. @@ -50785,7 +48101,6 @@ Unfixed tags can contain lists of values. merging multiple values into one if multiple values are associated with the tag. You must g_value_unset() the value after use. - %TRUE, if a value was copied, %FALSE if the tag didn't exist in the given list. @@ -50807,7 +48122,6 @@ You must g_value_unset() the value after use. - @@ -50816,7 +48130,6 @@ You must g_value_unset() the value after use. Tests if you can safely modify @taglist. It is only safe to modify taglist when there is only one owner of the taglist - ie, the refcount is 1. - a #GstTagList @@ -50836,7 +48149,6 @@ reference to the returned object. In short, this function unrefs the taglist in the argument and refs the taglist that it returns. Don't access the argument after calling this function. See also: gst_tag_list_ref(). - a #GstTagList @@ -50847,7 +48159,6 @@ function. See also: gst_tag_list_ref(). This is a convenience function for the func argument of gst_tag_register(). It concatenates all given strings using a comma. The tag must be registered as a G_TYPE_STRING or this function will fail. - @@ -50865,7 +48176,6 @@ as a G_TYPE_STRING or this function will fail. This is a convenience function for the func argument of gst_tag_register(). It creates a copy of the first value from the list. - @@ -50902,7 +48212,6 @@ merge function was supplied and if so which one. Two default merge functions are provided: gst_tag_merge_use_first() and gst_tag_merge_strings_with_comma(). - @@ -50940,7 +48249,6 @@ Same as gst_tag_register(), but @name, @nick, and @blurb must be static strings or inlined strings, as they will not be copied. (GStreamer plugins will be made resident once loaded, so this function can be used even from dynamically loaded plugins.) - @@ -50973,7 +48281,6 @@ even from dynamically loaded plugins.) Copy #GstToc with all subentries (deep copy). - #GstToc to copy. @@ -50982,7 +48289,6 @@ even from dynamically loaded plugins.) Copy #GstTocEntry with all subentries (deep copy). - #GstTocEntry to copy. @@ -50990,14 +48296,12 @@ even from dynamically loaded plugins.) - - @@ -51005,7 +48309,6 @@ even from dynamically loaded plugins.) Converts @type to a string representation. - Returns a human-readable string for @type. This string is only for debugging purpose and should not be displayed in a user @@ -51020,28 +48323,24 @@ even from dynamically loaded plugins.) - - - - @@ -51050,7 +48349,6 @@ even from dynamically loaded plugins.) Get a list of all active tracer objects owned by the tracing framework for the entirety of the run-time of the process or till gst_deinit() is called. - A #GList of #GstTracer objects @@ -51062,7 +48360,6 @@ the entirety of the run-time of the process or till gst_deinit() is called. Register @func to be called when the trace hook @detail is getting invoked. Use %NULL for @detail to register to all hooks. - @@ -51083,7 +48380,6 @@ Use %NULL for @detail to register to all hooks. - @@ -51092,7 +48388,6 @@ Use %NULL for @detail to register to all hooks. Registers a new typefind function to be used for typefinding. After registering this function will be available for typefinding. This function is typically called during an element's plugin initialization. - %TRUE on success, %FALSE otherwise @@ -51139,7 +48434,6 @@ This function is typically called during an element's plugin initialization. Checks if @type is plugin API. See gst_type_mark_as_plugin_api() for details. - %TRUE if @type is plugin API or %FALSE otherwise. @@ -51166,7 +48460,6 @@ documented via that library instead. By marking a type as plugin API it will be included in the documentation of the plugin that defines it. - @@ -51198,7 +48491,6 @@ any elements or access the GStreamer registry while the update is in progress. Note that this function may block for a significant amount of time. - %TRUE if the registry has been updated successfully (does not imply that there were changes), otherwise %FALSE. @@ -51210,7 +48502,6 @@ Note that this function may block for a significant amount of time. Free-function: g_free Use GstURI instead. - a new string for this URI. Returns %NULL if the given URI protocol is not valid, or the given location is %NULL. @@ -51236,7 +48527,6 @@ Free-function: g_free Parses a URI string into a new #GstUri object. Will return NULL if the URI cannot be parsed. - A new #GstUri object, or NULL. @@ -51262,7 +48552,6 @@ delineates the username and password. The same applies to the fragment component of the URI, such as https://example.com/path#fragment which may contain a URI-escaped '#'. - A new #GstUri object, or NULL. @@ -51281,7 +48570,6 @@ the hostname if one is specified. The returned string must be freed using g_free(). Free-function: g_free - the location for this URI. Returns %NULL if the URI isn't valid. If the URI does not contain a location, an @@ -51298,7 +48586,6 @@ Free-function: g_free Extracts the protocol out of a given valid URI. The returned string must be freed using g_free(). - The protocol for this URI. @@ -51312,7 +48599,6 @@ freed using g_free(). Checks if the protocol of a given valid URI matches @protocol. - %TRUE if the protocol matches. @@ -51331,7 +48617,6 @@ freed using g_free(). Tests if the given string is a valid URI identifier. URIs start with a valid scheme followed by ":" and maybe a string identifying the location. - %TRUE if the string is a valid URI @@ -51346,7 +48631,6 @@ scheme followed by ":" and maybe a string identifying the location. This is a convenience function to join two URI strings and return the result. The returned string should be g_free()'d after use. - A string representing the percent-encoded join of the two URIs. @@ -51367,7 +48651,6 @@ The returned string should be g_free()'d after use. Checks if an element exists that supports the given URI protocol. Note that a positive return value does not imply that a subsequent call to gst_element_make_from_uri() is guaranteed to work. - %TRUE @@ -51387,7 +48670,6 @@ gst_element_make_from_uri() is guaranteed to work. Tests if the given string is a valid protocol identifier. Protocols must consist of alphanumeric characters, '+', '-' and '.' and must start with a alphabetic character. See RFC 3986 Section 3.1. - %TRUE if the string is a valid protocol identifier, %FALSE otherwise. @@ -51407,7 +48689,6 @@ As @search_data is always passed as second argument to @search_func it's not required that @search_data has the same type as the array elements. The complexity of this search function is O(log (num_elements)). - The address of the found element or %NULL if nothing was found @@ -51447,7 +48728,6 @@ element or %NULL if nothing was found Transforms a #gdouble to a fraction and simplifies the result. - @@ -51468,7 +48748,6 @@ the result. Dumps the buffer memory into a hex representation. Useful for debugging. - @@ -51481,7 +48760,6 @@ the result. Dumps the memory block into a hex representation. Useful for debugging. - @@ -51501,7 +48779,6 @@ the result. Adds the fractions @a_n/@a_d and @b_n/@b_d and stores the result in @res_n and @res_d. - %FALSE on overflow, %TRUE otherwise. @@ -51536,7 +48813,6 @@ the result in @res_n and @res_d. Compares the fractions @a_n/@a_d and @b_n/@b_d and returns -1 if a < b, 0 if a = b and 1 if a > b. - -1 if a < b; 0 if a = b; 1 if a > b. @@ -51563,7 +48839,6 @@ the result in @res_n and @res_d. Multiplies the fractions @a_n/@a_d and @b_n/@b_d and stores the result in @res_n and @res_d. - %FALSE on overflow, %TRUE otherwise. @@ -51597,7 +48872,6 @@ the result in @res_n and @res_d. Transforms a fraction to a #gdouble. - @@ -51617,7 +48891,6 @@ the result in @res_n and @res_d. - @value casted to #guint64 @@ -51633,7 +48906,6 @@ the result in @res_n and @res_d. Get a property of type %GST_TYPE_ARRAY and transform it into a #GValueArray. This allow language bindings to get GST_TYPE_ARRAY properties which are otherwise not an accessible type. - @@ -51655,7 +48927,6 @@ properties which are otherwise not an accessible type. Get a timestamp as GstClockTime to be used for interval measurements. The timestamp should not be interpreted in any other way. - the timestamp @@ -51664,7 +48935,6 @@ The timestamp should not be interpreted in any other way. Calculates the greatest common divisor of @a and @b. - Greatest common divisor of @a and @b @@ -51683,7 +48953,6 @@ and @b. Calculates the greatest common divisor of @a and @b. - Greatest common divisor of @a and @b @@ -51706,7 +48975,6 @@ This function is used to generate a new group-id for the stream-start event. This function never returns %GST_GROUP_ID_INVALID (which is 0) - A constantly incrementing unsigned integer, which might overflow back to 0 at some point. @@ -51714,7 +48982,6 @@ overflow back to 0 at some point. - @value casted to #gdouble @@ -51730,7 +48997,6 @@ overflow back to 0 at some point. Compare two sequence numbers, handling wraparound. The current implementation just returns (gint32)(@s1 - @s2). - A negative number if @s1 is before @s2, 0 if they are equal, or a positive number if @s1 is after @s2. @@ -51756,7 +49022,6 @@ on a segment-done message to be the same as that of the last seek event, to indicate that event and the message correspond to the same segment. This function never returns %GST_SEQNUM_INVALID (which is 0). - A constantly incrementing 32-bit unsigned integer, which might overflow at some point. Use gst_util_seqnum_compare() to make sure @@ -51770,7 +49035,6 @@ sets the argument with it. Note that this function silently returns if @object has no property named @name or when @value cannot be converted to the type of the property. - @@ -51793,7 +49057,6 @@ Note that this function silently returns if @object has no property named Transfer a #GValueArray to %GST_TYPE_ARRAY and set this value on the specified property name. This allow language bindings to set GST_TYPE_ARRAY properties which are otherwise not an accessible type. - @@ -51818,7 +49081,6 @@ sets the value with it. Note that this function is dangerous as it does not return any indication if the conversion worked or not. - @@ -51839,7 +49101,6 @@ underflows and without loss of precision. This function can potentially be very slow if val and num are both greater than G_MAXUINT32. - @val * @num / @denom. In the case of an overflow, this function returns G_MAXUINT64. If the result is not exactly @@ -51870,7 +49131,6 @@ underflows and without loss of precision. This function can potentially be very slow if val and num are both greater than G_MAXUINT32. - @val * @num / @denom. In the case of an overflow, this function returns G_MAXUINT64. If the result is not exactly @@ -51899,7 +49159,6 @@ gst_util_uint64_scale_int_ceil(). Scale @val by the rational number @num / @denom, avoiding overflows and underflows and without loss of precision. @num must be non-negative and @denom must be positive. - @val * @num / @denom. In the case of an overflow, this function returns G_MAXUINT64. If the result is not exactly @@ -51928,7 +49187,6 @@ gst_util_uint64_scale_ceil(). Scale @val by the rational number @num / @denom, avoiding overflows and underflows and without loss of precision. @num must be non-negative and @denom must be positive. - @val * @num / @denom. In the case of an overflow, this function returns G_MAXUINT64. If the result is not exactly @@ -51957,7 +49215,6 @@ gst_util_uint64_scale_ceil(). Scale @val by the rational number @num / @denom, avoiding overflows and underflows and without loss of precision. @num must be non-negative and @denom must be positive. - @val * @num / @denom. In the case of an overflow, this function returns G_MAXUINT64. If the result is not exactly @@ -51988,7 +49245,6 @@ underflows and without loss of precision. This function can potentially be very slow if val and num are both greater than G_MAXUINT32. - @val * @num / @denom. In the case of an overflow, this function returns G_MAXUINT64. If the result is not exactly @@ -52015,7 +49271,6 @@ gst_util_uint64_scale_int_round(), gst_util_uint64_scale_int_ceil(). Determines if @value1 and @value2 can be compared. - %TRUE if the values can be compared @@ -52035,7 +49290,6 @@ gst_util_uint64_scale_int_round(), gst_util_uint64_scale_int_ceil(). Determines if intersecting two values will produce a valid result. Two values will produce a valid intersection if they have the same type. - %TRUE if the values can intersect @@ -52053,7 +49307,6 @@ type. Checks if it's possible to subtract @subtrahend from @minuend. - %TRUE if a subtraction is possible @@ -52077,7 +49330,6 @@ to be unioned in a simpler way. For example, an integer range and an integer can be unioned if the integer is a subset of the integer range. If there is the possibility that two values can be unioned, this function returns %TRUE. - %TRUE if there is a function allowing the two values to be unioned. @@ -52100,7 +49352,6 @@ compared, the function returns GST_VALUE_UNORDERED. Otherwise, if @value1 is greater than @value2, GST_VALUE_GREATER_THAN is returned. If @value1 is less than @value2, GST_VALUE_LESS_THAN is returned. If the values are equal, GST_VALUE_EQUAL is returned. - comparison result @@ -52119,7 +49370,6 @@ If the values are equal, GST_VALUE_EQUAL is returned. Tries to deserialize a string into the type specified by the given GValue. If the operation succeeds, %TRUE is returned, %FALSE otherwise. - %TRUE on success @@ -52141,7 +49391,6 @@ If the operation succeeds, %TRUE is returned, %FALSE otherwise. For ranges, the first element is taken. For lists and arrays, the first item is fixated and returned. If @src is already fixed, this function returns %FALSE. - %TRUE if @dest contains a fixated version of @src. @@ -52160,7 +49409,6 @@ If @src is already fixed, this function returns %FALSE. Multiplies the two #GValue items containing a #GST_TYPE_FRACTION and sets @product to the product of the two fractions. - %FALSE in case of an error (like integer overflow), %TRUE otherwise. @@ -52182,7 +49430,6 @@ If @src is already fixed, this function returns %FALSE. Subtracts the @subtrahend from the @minuend and sets @dest to the result. - %FALSE in case of an error (like integer overflow), %TRUE otherwise. @@ -52204,7 +49451,6 @@ If @src is already fixed, this function returns %FALSE. Gets the bitmask specified by @value. - the bitmask. @@ -52220,7 +49466,6 @@ If @src is already fixed, this function returns %FALSE. Receives a #GstBuffer as the value of @v. Does not return a reference to the buffer, so the pointer is only valid for as long as the caller owns a reference to @v. - a #GValue to query @@ -52231,7 +49476,6 @@ a reference to @v. Gets the contents of @value. The reference count of the returned #GstCaps will not be modified, therefore the caller must take one before getting rid of the @value. - the contents of @value @@ -52245,7 +49489,6 @@ before getting rid of the @value. Gets the contents of @value. - the contents of @value @@ -52259,7 +49502,6 @@ before getting rid of the @value. Gets the maximum of the range specified by @value. - the maximum of the range @@ -52273,7 +49515,6 @@ before getting rid of the @value. Gets the minimum of the range specified by @value. - the minimum of the range @@ -52287,7 +49528,6 @@ before getting rid of the @value. Retrieve the flags field of a GstFlagSet @value. - the flags field of the flagset instance. @@ -52301,7 +49541,6 @@ before getting rid of the @value. Retrieve the mask field of a GstFlagSet @value. - the mask field of the flagset instance. @@ -52315,7 +49554,6 @@ before getting rid of the @value. Gets the denominator of the fraction specified by @value. - the denominator of the fraction. @@ -52329,7 +49567,6 @@ before getting rid of the @value. Gets the numerator of the fraction specified by @value. - the numerator of the fraction. @@ -52343,7 +49580,6 @@ before getting rid of the @value. Gets the maximum of the range specified by @value. - the maximum of the range @@ -52357,7 +49593,6 @@ before getting rid of the @value. Gets the minimum of the range specified by @value. - the minimum of the range @@ -52371,7 +49606,6 @@ before getting rid of the @value. Gets the maximum of the range specified by @value. - the maximum of the range @@ -52385,7 +49619,6 @@ before getting rid of the @value. Gets the minimum of the range specified by @value. - the minimum of the range @@ -52399,7 +49632,6 @@ before getting rid of the @value. Gets the step of the range specified by @value. - the step of the range @@ -52413,7 +49645,6 @@ before getting rid of the @value. Gets the maximum of the range specified by @value. - the maximum of the range @@ -52427,7 +49658,6 @@ before getting rid of the @value. Gets the minimum of the range specified by @value. - the minimum of the range @@ -52441,7 +49671,6 @@ before getting rid of the @value. Gets the step of the range specified by @value. - the step of the range @@ -52457,7 +49686,6 @@ before getting rid of the @value. Receives a #GstSample as the value of @v. Does not return a reference to the sample, so the pointer is only valid for as long as the caller owns a reference to @v. - a #GValue to query @@ -52466,7 +49694,6 @@ a reference to @v. Gets the contents of @value. - the contents of @value @@ -52481,7 +49708,6 @@ a reference to @v. Initialises the target value to be of the same type as source and then copies the contents from source to target. - @@ -52501,7 +49727,6 @@ the contents from source to target. a non-empty intersection, the value representing the intersection is placed in @dest, unless %NULL. If the intersection is non-empty, @dest is not modified. - %TRUE if the intersection is non-empty @@ -52529,7 +49754,6 @@ is placed in @dest, unless %NULL. If the intersection is non-empty, container) contains a "fixed" (which means: one value) or an "unfixed" (which means: multiple possible values, such as data lists or data ranges) value. - true if the value is "fixed". @@ -52543,7 +49767,6 @@ ranges) value. Check that @value1 is a subset of @value2. - %TRUE is @value1 is a subset of @value2 @@ -52562,7 +49785,6 @@ ranges) value. Registers functions to perform calculations on #GValue items of a given type. Each type can only be added once. - @@ -52578,7 +49800,6 @@ type. Each type can only be added once. getting back this string later on using gst_value_deserialize(). Free-function: g_free - the serialization for @value or %NULL if none exists @@ -52593,7 +49814,6 @@ or %NULL if none exists Sets @value to the bitmask specified by @bitmask. - @@ -52610,7 +49830,6 @@ or %NULL if none exists Sets @b as the value of @v. Caller retains reference to buffer. - a #GValue to receive the data @@ -52623,7 +49842,6 @@ or %NULL if none exists Sets the contents of @value to @caps. A reference to the provided @caps will be taken by the @value. - @@ -52640,7 +49858,6 @@ provided @caps will be taken by the @value. Sets the contents of @value to @features. - @@ -52657,7 +49874,6 @@ provided @caps will be taken by the @value. Sets @value to the range specified by @start and @end. - @@ -52680,7 +49896,6 @@ provided @caps will be taken by the @value. Sets @value to the flags and mask values provided in @flags and @mask. The @flags value indicates the values of flags, the @mask represents which bits in the flag value have been set, and which are "don't care" - @@ -52703,7 +49918,6 @@ which bits in the flag value have been set, and which are "don't care" Sets @value to the fraction specified by @numerator over @denominator. The fraction gets reduced to the smallest numerator and denominator, and if necessary the sign is moved to the numerator. - @@ -52724,7 +49938,6 @@ and if necessary the sign is moved to the numerator. Sets @value to the range specified by @start and @end. - @@ -52746,7 +49959,6 @@ and if necessary the sign is moved to the numerator. Sets @value to the range specified by @numerator_start/@denominator_start and @numerator_end/@denominator_end. - @@ -52775,7 +49987,6 @@ and @numerator_end/@denominator_end. Sets @value to the range specified by @start and @end. - @@ -52796,7 +50007,6 @@ and @numerator_end/@denominator_end. Sets @value to the range specified by @start, @end and @step. - @@ -52821,7 +50031,6 @@ and @numerator_end/@denominator_end. Sets @value to the range specified by @start and @end. - @@ -52842,7 +50051,6 @@ and @numerator_end/@denominator_end. Sets @value to the range specified by @start, @end and @step. - @@ -52867,7 +50075,6 @@ and @numerator_end/@denominator_end. Sets @b as the value of @v. Caller retains reference to sample. - a #GValue to receive the data @@ -52879,7 +50086,6 @@ and @numerator_end/@denominator_end. Sets the contents of @value to @structure. - @@ -52897,7 +50103,6 @@ and @numerator_end/@denominator_end. Subtracts @subtrahend from @minuend and stores the result in @dest. Note that this means subtraction as in sets, not as in mathematics. - %TRUE if the subtraction is not empty @@ -52922,7 +50127,6 @@ Note that this means subtraction as in sets, not as in mathematics. Sets @b as the value of @v. Caller gives away reference to buffer. - a #GValue to receive the data @@ -52934,7 +50138,6 @@ Note that this means subtraction as in sets, not as in mathematics. Sets @b as the value of @v. Caller gives away reference to sample. - a #GValue to receive the data @@ -52946,7 +50149,6 @@ Note that this means subtraction as in sets, not as in mathematics. Creates a GValue corresponding to the union of @value1 and @value2. - %TRUE if the union succeeded. @@ -52968,7 +50170,6 @@ Note that this means subtraction as in sets, not as in mathematics. Gets the version number of the GStreamer library. - @@ -52994,7 +50195,6 @@ Note that this means subtraction as in sets, not as in mathematics. This function returns a string that is useful for describing this version of GStreamer to the outside world: user agent strings, logging, ... - a newly allocated string describing this version of GStreamer. diff --git a/gir-files/GstAllocators-1.0.gir b/gir-files/GstAllocators-1.0.gir index 5e5596847..2e1a8417b 100644 --- a/gir-files/GstAllocators-1.0.gir +++ b/gir-files/GstAllocators-1.0.gir @@ -8,11 +8,9 @@ and/or use gtk-doc annotations. --> - - @@ -40,32 +38,27 @@ feature should not be used. This allows scalers, color converts and any image processing filters to work directly on the dma buffer. In this case the importer element should check all incoming memory using gst_is_dmabuf_memory(). - - - - - @@ -73,10 +66,8 @@ gst_is_dmabuf_memory(). Base class for allocators with dmabuf-backed memory - Return a new dmabuf allocator. - a new dmabuf allocator, or NULL if the allocator isn't available. Use gst_object_unref() to release the allocator after @@ -86,7 +77,6 @@ gst_is_dmabuf_memory(). Return a %GstMemory that wraps a dmabuf file descriptor. - a GstMemory based on @allocator. When the buffer will be released dmabuf allocator will close the @fd. @@ -110,7 +100,6 @@ The memory is only mmapped on gst_buffer_map() request. Return a %GstMemory that wraps a dmabuf file descriptor. - a GstMemory based on @allocator. @@ -148,7 +137,6 @@ The memory is only mmapped on gst_buffer_mmap() request. - @@ -159,28 +147,24 @@ The memory is only mmapped on gst_buffer_mmap() request. - - - - @@ -188,10 +172,8 @@ The memory is only mmapped on gst_buffer_mmap() request. Base class for allocators with fd-backed memory - Return a new fd allocator. - a new fd allocator, or NULL if the allocator isn't available. Use gst_object_unref() to release the allocator after @@ -201,7 +183,6 @@ The memory is only mmapped on gst_buffer_mmap() request. Return a %GstMemory that wraps a generic file descriptor. - a GstMemory based on @allocator. When the buffer will be released the allocator will close the @fd unless @@ -233,14 +214,12 @@ The memory is only mmapped on gst_buffer_map() request. - Various flags to control the operation of the fd backed memory. - no flag @@ -258,52 +237,44 @@ The memory is only mmapped on gst_buffer_map() request. - - - - - - - - @@ -319,13 +290,11 @@ The memory is only mmapped on gst_buffer_map() request. Marker interface for allocators with physical address backed memory - - @@ -342,7 +311,6 @@ The memory is only mmapped on gst_buffer_map() request. Return the file descriptor associated with @mem. - the file descriptor associated with the memory, or -1. The file descriptor is still owned by the GstMemory. Use dup to take a copy @@ -359,7 +327,6 @@ The memory is only mmapped on gst_buffer_map() request. Get the fd from @mem. Call gst_is_fd_memory() to check if @mem has an fd. - the fd of @mem or -1 when there is no fd on @mem @@ -373,7 +340,6 @@ an fd. Check if @mem is dmabuf memory. - %TRUE if @mem is dmabuf memory, otherwise %FALSE @@ -387,7 +353,6 @@ an fd. Check if @mem is memory backed by an fd - %TRUE when @mem has an fd that can be retrieved with gst_fd_memory_get_fd(). @@ -401,7 +366,6 @@ gst_fd_memory_get_fd(). - whether the memory at @mem is backed by physical memory @@ -414,7 +378,6 @@ gst_fd_memory_get_fd(). - Physical memory address that is backing @mem, or 0 if none diff --git a/gir-files/GstApp-1.0.gir b/gir-files/GstApp-1.0.gir index 15003924a..643a9de73 100644 --- a/gir-files/GstApp-1.0.gir +++ b/gir-files/GstApp-1.0.gir @@ -9,42 +9,36 @@ and/or use gtk-doc annotations. --> - - - - - - @@ -87,10 +81,8 @@ is stopped or in the EOS state. You can check for the EOS state with the The eos signal can also be used to be informed when the EOS state is reached to avoid polling. - - @@ -101,7 +93,6 @@ to avoid polling. - @@ -112,7 +103,6 @@ to avoid polling. - @@ -141,7 +131,6 @@ If an EOS event was received before any buffers, this function returns This function blocks until a preroll sample or EOS is received or the appsink element is set to the READY/NULL state. - a #GstSample or NULL when the appsink is stopped or EOS. Call gst_sample_unref() after usage. @@ -166,7 +155,6 @@ especially when dealing with raw video frames. If an EOS event was received before any buffers, this function returns %NULL. Use gst_app_sink_is_eos () to check for the EOS condition. - a #GstSample or NULL when the appsink is stopped or EOS. Call gst_sample_unref() after usage. @@ -199,7 +187,6 @@ condition. This function blocks until a preroll sample or EOS is received, the appsink element is set to the READY/NULL state, or the timeout expires. - a #GstSample or NULL when the appsink is stopped or EOS or the timeout expires. Call gst_sample_unref() after usage. @@ -229,7 +216,6 @@ especially when dealing with raw video frames. If an EOS event was received before any buffers or the timeout expires, this function returns %NULL. Use gst_app_sink_is_eos () to check for the EOS condition. - a #GstSample or NULL when the appsink is stopped or EOS or the timeout expires. Call gst_sample_unref() after usage. @@ -248,7 +234,6 @@ Call gst_sample_unref() after usage. Check if @appsink supports buffer lists. - %TRUE if @appsink supports buffer lists. @@ -262,7 +247,6 @@ Call gst_sample_unref() after usage. Get the configured caps on @appsink. - the #GstCaps accepted by the sink. gst_caps_unref() after usage. @@ -277,7 +261,6 @@ Call gst_sample_unref() after usage. Check if @appsink will drop old buffers when the maximum amount of queued buffers is reached. - %TRUE if @appsink is dropping old buffers when the queue is filled. @@ -292,7 +275,6 @@ filled. Check if appsink will emit the "new-preroll" and "new-sample" signals. - %TRUE if @appsink is emitting the "new-preroll" and "new-sample" signals. @@ -307,7 +289,6 @@ signals. Get the maximum amount of buffers that can be queued in @appsink. - The maximum amount of buffers that can be queued. @@ -322,7 +303,6 @@ signals. Check if @appsink will wait for all buffers to be consumed when an EOS is received. - %TRUE if @appsink will wait for all buffers to be consumed when an EOS is received. @@ -341,7 +321,6 @@ an EOS event was received. This function also returns %TRUE when the appsink is not in the PAUSED or PLAYING state. - %TRUE if no more samples can be pulled and the appsink is EOS. @@ -372,7 +351,6 @@ If an EOS event was received before any buffers, this function returns This function blocks until a preroll sample or EOS is received or the appsink element is set to the READY/NULL state. - a #GstSample or NULL when the appsink is stopped or EOS. Call gst_sample_unref() after usage. @@ -397,7 +375,6 @@ especially when dealing with raw video frames. If an EOS event was received before any buffers, this function returns %NULL. Use gst_app_sink_is_eos () to check for the EOS condition. - a #GstSample or NULL when the appsink is stopped or EOS. Call gst_sample_unref() after usage. @@ -415,7 +392,6 @@ If an EOS event was received before any buffers, this function returns For backwards-compatibility reasons applications need to opt in to indicate that they will be able to handle buffer lists. - @@ -440,7 +416,6 @@ reasons. Before 1.16.3 it was not possible to change the callbacks in a thread-safe way. - @@ -468,7 +443,6 @@ way. a copy of the caps structure. After calling this method, the sink will only accept caps that match @caps. If @caps is non-fixed, or incomplete, you must check the caps on the samples to get the actual used caps. - @@ -486,7 +460,6 @@ you must check the caps on the samples to get the actual used caps. Instruct @appsink to drop old buffers when the maximum amount of queued buffers is reached. - @@ -505,7 +478,6 @@ buffers is reached. Make appsink emit the "new-preroll" and "new-sample" signals. This option is by default disabled because signal emission is expensive and unneeded when the application prefers to operate in pull mode. - @@ -524,7 +496,6 @@ the application prefers to operate in pull mode. Set the maximum amount of buffers that can be queued in @appsink. After this amount of buffers are queued in appsink, any more buffers will block upstream elements until a sample is pulled from @appsink. - @@ -541,7 +512,6 @@ elements until a sample is pulled from @appsink. Instruct @appsink to wait for all buffers to be consumed when an EOS is received. - @@ -576,7 +546,6 @@ condition. This function blocks until a preroll sample or EOS is received, the appsink element is set to the READY/NULL state, or the timeout expires. - a #GstSample or NULL when the appsink is stopped or EOS or the timeout expires. Call gst_sample_unref() after usage. @@ -606,7 +575,6 @@ especially when dealing with raw video frames. If an EOS event was received before any buffers or the timeout expires, this function returns %NULL. Use gst_app_sink_is_eos () to check for the EOS condition. - a #GstSample or NULL when the appsink is stopped or EOS or the timeout expires. Call gst_sample_unref() after usage. @@ -800,10 +768,8 @@ for the EOS condition. A set of callbacks that can be installed on the appsink with gst_app_sink_set_callbacks(). - - @@ -819,7 +785,6 @@ gst_app_sink_set_callbacks(). - @@ -835,7 +800,6 @@ gst_app_sink_set_callbacks(). - @@ -856,13 +820,11 @@ gst_app_sink_set_callbacks(). - - @@ -875,7 +837,6 @@ gst_app_sink_set_callbacks(). - @@ -888,7 +849,6 @@ gst_app_sink_set_callbacks(). - @@ -901,7 +861,6 @@ gst_app_sink_set_callbacks(). - a #GstSample or NULL when the appsink is stopped or EOS. Call gst_sample_unref() after usage. @@ -917,7 +876,6 @@ gst_app_sink_set_callbacks(). - a #GstSample or NULL when the appsink is stopped or EOS. Call gst_sample_unref() after usage. @@ -933,7 +891,6 @@ gst_app_sink_set_callbacks(). - a #GstSample or NULL when the appsink is stopped or EOS or the timeout expires. Call gst_sample_unref() after usage. @@ -953,7 +910,6 @@ gst_app_sink_set_callbacks(). - a #GstSample or NULL when the appsink is stopped or EOS or the timeout expires. Call gst_sample_unref() after usage. @@ -977,9 +933,7 @@ Call gst_sample_unref() after usage. - - - + The appsrc element can be used by applications to insert data into a GStreamer pipeline. Unlike most GStreamer elements, appsrc provides @@ -1045,12 +999,10 @@ When the application has finished pushing data into appsrc, it should call gst_app_src_end_of_stream() or emit the end-of-stream action signal. After this call, no more buffers can be pushed into appsrc until a flushing seek occurs or the state of the appsrc has gone through READY. - Indicates to the appsrc element that the last buffer queued in the element is the last buffer of the stream. - #GST_FLOW_OK when the EOS was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. @@ -1064,7 +1016,6 @@ element is the last buffer of the stream. - @@ -1075,7 +1026,6 @@ element is the last buffer of the stream. - @@ -1094,7 +1044,6 @@ push to its source pad. This function takes ownership of the buffer. When the block property is TRUE, this function can block until free space becomes available in the queue. - #GST_FLOW_OK when the buffer was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. @@ -1119,7 +1068,6 @@ of @buffer_list. When the block property is TRUE, this function can block until free space becomes available in the queue. - #GST_FLOW_OK when the buffer list was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. @@ -1148,7 +1096,6 @@ sample so the sample needs to be unreffed after calling this function. When the block property is TRUE, this function can block until free space becomes available in the queue. - #GST_FLOW_OK when the buffer was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. @@ -1168,7 +1115,6 @@ extracted - @@ -1184,7 +1130,6 @@ extracted Indicates to the appsrc element that the last buffer queued in the element is the last buffer of the stream. - #GST_FLOW_OK when the EOS was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. @@ -1199,7 +1144,6 @@ element is the last buffer of the stream. Get the configured caps on @appsrc. - the #GstCaps produced by the source. gst_caps_unref() after usage. @@ -1213,7 +1157,6 @@ element is the last buffer of the stream. Get the number of currently queued bytes inside @appsrc. - The number of currently queued bytes. @@ -1228,7 +1171,6 @@ element is the last buffer of the stream. Get the duration of the stream in nanoseconds. A value of GST_CLOCK_TIME_NONE means that the duration is not known. - the duration of the stream previously set with gst_app_src_set_duration(); @@ -1242,7 +1184,6 @@ not known. Check if appsrc will emit the "new-preroll" and "new-buffer" signals. - %TRUE if @appsrc is emitting the "new-preroll" and "new-buffer" signals. @@ -1257,7 +1198,6 @@ signals. Retrieve the min and max latencies in @min and @max respectively. - @@ -1278,7 +1218,6 @@ signals. Get the maximum amount of bytes that can be queued in @appsrc. - The maximum amount of bytes that can be queued. @@ -1293,7 +1232,6 @@ signals. Get the size of the stream in bytes. A value of -1 means that the size is not known. - the size of the stream previously set with gst_app_src_set_size(); @@ -1308,7 +1246,6 @@ not known. Get the stream type. Control the stream type of @appsrc with gst_app_src_set_stream_type(). - the stream type. @@ -1326,7 +1263,6 @@ push to its source pad. This function takes ownership of the buffer. When the block property is TRUE, this function can block until free space becomes available in the queue. - #GST_FLOW_OK when the buffer was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. @@ -1351,7 +1287,6 @@ of @buffer_list. When the block property is TRUE, this function can block until free space becomes available in the queue. - #GST_FLOW_OK when the buffer list was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. @@ -1380,7 +1315,6 @@ sample so the sample needs to be unreffed after calling this function. When the block property is TRUE, this function can block until free space becomes available in the queue. - #GST_FLOW_OK when the buffer was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. @@ -1410,7 +1344,6 @@ reasons. Before 1.16.3 it was not possible to change the callbacks in a thread-safe way. - @@ -1438,7 +1371,6 @@ way. a copy of the caps structure. After calling this method, the source will only produce caps that match @caps. @caps must be fixed and the caps on the buffers must match the caps or left NULL. - @@ -1456,7 +1388,6 @@ buffers must match the caps or left NULL. Set the duration of the stream in nanoseconds. A value of GST_CLOCK_TIME_NONE means that the duration is not known. - @@ -1475,7 +1406,6 @@ not known. Make appsrc emit the "new-preroll" and "new-buffer" signals. This option is by default disabled because signal emission is expensive and unneeded when the application prefers to operate in pull mode. - @@ -1493,7 +1423,6 @@ the application prefers to operate in pull mode. Configure the @min and @max latency in @src. If @min is set to -1, the default latency calculations for pseudo-live sources will be used. - @@ -1516,7 +1445,6 @@ default latency calculations for pseudo-live sources will be used. Set the maximum amount of bytes that can be queued in @appsrc. After the maximum amount of bytes are queued, @appsrc will emit the "enough-data" signal. - @@ -1534,7 +1462,6 @@ After the maximum amount of bytes are queued, @appsrc will emit the Set the size of the stream in bytes. A value of -1 means that the size is not known. - @@ -1554,7 +1481,6 @@ not known. be connected to. A stream_type stream - @@ -1720,10 +1646,8 @@ application should connect to the seek-data signal. A set of callbacks that can be installed on the appsrc with gst_app_src_set_callbacks(). - - @@ -1742,7 +1666,6 @@ gst_app_src_set_callbacks(). - @@ -1758,7 +1681,6 @@ gst_app_src_set_callbacks(). - @@ -1782,13 +1704,11 @@ gst_app_src_set_callbacks(). - - @@ -1804,7 +1724,6 @@ gst_app_src_set_callbacks(). - @@ -1817,7 +1736,6 @@ gst_app_src_set_callbacks(). - @@ -1833,7 +1751,6 @@ gst_app_src_set_callbacks(). - #GST_FLOW_OK when the buffer was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. @@ -1854,7 +1771,6 @@ gst_app_src_set_callbacks(). - #GST_FLOW_OK when the EOS was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. @@ -1870,7 +1786,6 @@ gst_app_src_set_callbacks(). - #GST_FLOW_OK when the buffer was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. @@ -1892,7 +1807,6 @@ extracted - #GST_FLOW_OK when the buffer list was successfully queued. #GST_FLOW_FLUSHING when @appsrc is not PAUSED or PLAYING. @@ -1917,9 +1831,7 @@ extracted - - - + The stream type. @@ -1936,28 +1848,24 @@ such as in a local file. - - - - diff --git a/gir-files/GstAudio-1.0.gir b/gir-files/GstAudio-1.0.gir index 4e561bf6d..4fd936d2c 100644 --- a/gir-files/GstAudio-1.0.gir +++ b/gir-files/GstAudio-1.0.gir @@ -12,84 +12,72 @@ and/or use gtk-doc annotations. --> - - - - - - - - - - - - @@ -97,7 +85,6 @@ and/or use gtk-doc annotations. --> Get the #GstClock of @obj. - a #GstAudioBaseSink @@ -105,7 +92,6 @@ and/or use gtk-doc annotations. --> - @@ -113,7 +99,6 @@ and/or use gtk-doc annotations. --> Get the sink #GstPad of @obj. - a #GstAudioBaseSink @@ -121,21 +106,18 @@ and/or use gtk-doc annotations. --> - - - @@ -143,7 +125,6 @@ and/or use gtk-doc annotations. --> Get the #GstClock of @obj. - a #GstAudioBaseSrc @@ -151,7 +132,6 @@ and/or use gtk-doc annotations. --> - @@ -159,7 +139,6 @@ and/or use gtk-doc annotations. --> Get the source #GstPad of @obj. - a #GstAudioBaseSrc @@ -167,63 +146,54 @@ and/or use gtk-doc annotations. --> - - - - - - - - - @@ -232,28 +202,24 @@ and/or use gtk-doc annotations. --> - - - - @@ -261,7 +227,6 @@ and/or use gtk-doc annotations. --> Generic caps string for audio, for use in pad templates. - string format that describes the sample layout, as string @@ -270,21 +235,18 @@ and/or use gtk-doc annotations. --> - - - @@ -292,32 +254,27 @@ and/or use gtk-doc annotations. --> Maximum range of allowed channels, for use in template caps strings. - - - - - @@ -327,7 +284,6 @@ and/or use gtk-doc annotations. --> #GstAudioDitherMethod, The dither method to use when changing bit depth. Default is #GST_AUDIO_DITHER_NONE. - @@ -358,46 +314,39 @@ g_value_unset (&v2); g_object_set_property (G_OBJECT (audiomixmatrix), "matrix", &v); g_value_unset (&v); ]| - #GstAudioNoiseShapingMethod, The noise shaping method to use to mask noise from quantization errors. Default is #GST_AUDIO_NOISE_SHAPING_NONE. - #G_TYPE_UINT, The quantization amount. Components will be quantized to multiples of this value. Default is 1 - #GstAudioResamplerMethod, The resampler method to use when changing sample rates. Default is #GST_AUDIO_RESAMPLER_METHOD_BLACKMAN_NUTTALL. - - - - @@ -412,7 +361,6 @@ post an error message and the application will be requested to stop further media processing. Otherwise, it is considered a "glitch" and only a warning is logged. In either case, @ret is set to the proper value to return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). - the base audio decoder element that generates the error @@ -440,7 +388,6 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). - @@ -448,7 +395,6 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). Gives the input segment of the element. - audio decoder instance @@ -457,12 +403,10 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). Default maximum number of errors tolerated before signaling error. - Gives the output segment of the element. - audio decoder instance @@ -471,12 +415,10 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). The name of the templates for the sink pad. - Gives the pointer to the sink #GstPad object of the element. - base audio codec instance @@ -485,12 +427,10 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). The name of the templates for the source pad. - Gives the pointer to the source #GstPad object of the element. - base audio codec instance @@ -498,14 +438,12 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). - - @@ -513,42 +451,35 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). Standard number of channels used in consumer audio. - Standard format used in consumer audio. - Standard sampling rate used in consumer audio. - - - - - @@ -556,7 +487,6 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). Gives the input segment of the element. - base parse instance @@ -565,7 +495,6 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). Gives the output segment of the element. - base parse instance @@ -574,12 +503,10 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). the name of the templates for the sink pad - Gives the pointer to the sink #GstPad object of the element. - audio encoder instance @@ -588,12 +515,10 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). the name of the templates for the source pad - Gives the pointer to the source #GstPad object of the element. - audio encoder instance @@ -601,91 +526,78 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). - - - - - - - - - - - - - @@ -699,200 +611,171 @@ Formats are sorted by decreasing "quality", using these criteria by priority: - width - Float > Signed > Unsigned - native endianness preferred - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -901,14 +784,12 @@ Formats are sorted by decreasing "quality", using these criteria by priority: - - @@ -916,7 +797,6 @@ Formats are sorted by decreasing "quality", using these criteria by priority: Turns audio format string @s into the format string for native endianness. - format string without endianness marker @@ -925,7 +805,6 @@ Formats are sorted by decreasing "quality", using these criteria by priority: Turns audio format string @s into the format string for other endianness. - format string without endianness marker @@ -934,7 +813,6 @@ Formats are sorted by decreasing "quality", using these criteria by priority: Maximum range of allowed sample rates, for use in template caps strings. - @@ -946,7 +824,6 @@ Below are some values of popular filters: Hermite 0.0 0.0 Spline 1.0 0.0 Catmull-Rom 0.0 1/2 - @@ -954,171 +831,144 @@ Catmull-Rom 0.0 1/2 Values between 0.0 and 2.0 are accepted. 0.0 is the default. See #GST_AUDIO_RESAMPLER_OPT_CUBIC_B for some more common values - G_TYPE_DOUBLE, Cutoff parameter for the filter. 0.940 is the default. - GST_TYPE_AUDIO_RESAMPLER_INTERPOLATION: how the filter coefficients should be interpolated. GST_AUDIO_RESAMPLER_FILTER_INTERPOLATION_CUBIC is default. - GST_TYPE_AUDIO_RESAMPLER_FILTER_MODE: how the filter tables should be constructed. GST_AUDIO_RESAMPLER_FILTER_MODE_AUTO is the default. - G_TYPE_UINT: the amount of memory to use for full filter tables before switching to interpolated filter tables. 1048576 is the default. - G_TYPE_UINT, oversampling to use when interpolating filters 8 is the default. - G_TYPE_DOUBLE: The maximum allowed phase error when switching sample rates. 0.1 is the default. - G_TYPE_INT: the number of taps to use for the filter. 0 is the default and selects the taps automatically. - G_TYPE_DOUBLE, stopband attenuation in decibels. The attenuation after the stopband for the kaiser window. 85 dB is the default. - G_TYPE_DOUBLE, transition bandwidth. The width of the transition band for the kaiser window. 0.087 is the default. - - - - - - - - - - - - - - - - - - @@ -1169,9 +1019,7 @@ additional information in the info #GstStructure of the returned sample: buffer would be placed - "position" G_TYPE_UINT current position in the input buffer in samples - "size" G_TYPE_UINT size of the input buffer in samples - - @@ -1200,7 +1048,6 @@ additional information in the info #GstStructure of the returned sample: - @@ -1214,7 +1061,6 @@ additional information in the info #GstStructure of the returned sample: - @@ -1260,13 +1106,11 @@ additional information in the info #GstStructure of the returned sample: - - @@ -1282,7 +1126,6 @@ additional information in the info #GstStructure of the returned sample: - @@ -1321,7 +1164,6 @@ additional information in the info #GstStructure of the returned sample: An implementation of GstPad that can be used with #GstAudioAggregator. See #GstAudioAggregator for more details. - @@ -1338,7 +1180,6 @@ See #GstAudioAggregator for more details. - @@ -1348,14 +1189,10 @@ See #GstAudioAggregator for more details. - - - + The default implementation of GstPad used with #GstAudioAggregator - - @@ -1375,7 +1212,6 @@ See #GstAudioAggregator for more details. - @@ -1402,13 +1238,11 @@ See #GstAudioAggregator for more details. - - @@ -1430,7 +1264,6 @@ See #GstAudioAggregator for more details. - @@ -1447,22 +1280,16 @@ See #GstAudioAggregator for more details. - - - - - - + + This is the base class for audio sinks. Subclasses need to implement the ::create_ringbuffer vmethod. This base class will then take care of writing samples to the ringbuffer, synchronisation, clipping and flushing. - Create and return the #GstAudioRingBuffer for @sink. This function will call the ::create_ringbuffer vmethod and will set @sink as the parent of the returned buffer (see gst_object_set_parent()). - The new ringbuffer of @sink. @@ -1475,7 +1302,6 @@ the returned buffer (see gst_object_set_parent()). - @@ -1492,7 +1318,6 @@ the returned buffer (see gst_object_set_parent()). Create and return the #GstAudioRingBuffer for @sink. This function will call the ::create_ringbuffer vmethod and will set @sink as the parent of the returned buffer (see gst_object_set_parent()). - The new ringbuffer of @sink. @@ -1506,7 +1331,6 @@ the returned buffer (see gst_object_set_parent()). Get the current alignment threshold, in nanoseconds, used by @sink. - The current alignment threshold used by @sink. @@ -1520,7 +1344,6 @@ the returned buffer (see gst_object_set_parent()). Get the current discont wait, in nanoseconds, used by @sink. - The current discont wait used by @sink. @@ -1534,7 +1357,6 @@ the returned buffer (see gst_object_set_parent()). Get the current drift tolerance, in microseconds, used by @sink. - The current drift tolerance used by @sink. @@ -1549,7 +1371,6 @@ the returned buffer (see gst_object_set_parent()). Queries whether @sink will provide a clock or not. See also gst_audio_base_sink_set_provide_clock. - %TRUE if @sink will provide a clock. @@ -1563,7 +1384,6 @@ gst_audio_base_sink_set_provide_clock. Get the current slave method used by @sink. - The current slave method used by @sink. @@ -1581,7 +1401,6 @@ some reason, causing a discontinuity (for example, because the device recovered from the error, but lost all contents of its ring buffer). This function is typically called by derived classes, and is useful for the custom slave method. - @@ -1594,7 +1413,6 @@ for the custom slave method. Controls the sink's alignment threshold. - @@ -1618,7 +1436,6 @@ receives and plays samples. Setting the callback to NULL causes the sink to behave as if the GST_AUDIO_BASE_SINK_SLAVE_NONE method were used. - @@ -1643,7 +1460,6 @@ method were used. Controls how long the sink will wait before creating a discontinuity. - @@ -1660,7 +1476,6 @@ method were used. Controls the sink's drift tolerance. - @@ -1680,7 +1495,6 @@ method were used. gst_element_provide_clock() will return a clock that reflects the datarate of @sink. If @provide is %FALSE, gst_element_provide_clock() will return NULL. - @@ -1697,7 +1511,6 @@ NULL. Controls how clock slaving will be performed in @sink. - @@ -1773,14 +1586,12 @@ to drift before resynchronisation happens. #GstAudioBaseSink class. Override the vmethod to implement functionality. - the parent class. - The new ringbuffer of @sink. @@ -1795,7 +1606,6 @@ functionality. - @@ -1839,7 +1649,6 @@ The sink may experience discontinuities. If one happens, discont is TRUE, itime, etime are set to GST_CLOCK_TIME_NONE, and requested_skew is NULL. This makes it possible to reset custom clock slaving algorithms when a discontinuity happens. - @@ -1892,9 +1701,7 @@ slave method. Audio output device experienced and recovered from an error but introduced latency in the process (see also @gst_audio_base_sink_report_device_failure()) - - - + Different possible clock slaving algorithms used when the internal audio clock is not selected as the pipeline master clock. @@ -1916,12 +1723,10 @@ drifts too much. This is the base class for audio sources. Subclasses need to implement the ::create_ringbuffer vmethod. This base class will then take care of reading samples from the ringbuffer, synchronisation and flushing. - Create and return the #GstAudioRingBuffer for @src. This function will call the ::create_ringbuffer vmethod and will set @src as the parent of the returned buffer (see gst_object_set_parent()). - The new ringbuffer of @src. @@ -1937,7 +1742,6 @@ returned buffer (see gst_object_set_parent()). Create and return the #GstAudioRingBuffer for @src. This function will call the ::create_ringbuffer vmethod and will set @src as the parent of the returned buffer (see gst_object_set_parent()). - The new ringbuffer of @src. @@ -1952,7 +1756,6 @@ returned buffer (see gst_object_set_parent()). Queries whether @src will provide a clock or not. See also gst_audio_base_src_set_provide_clock. - %TRUE if @src will provide a clock. @@ -1966,7 +1769,6 @@ gst_audio_base_src_set_provide_clock. Get the current slave method used by @src. - The current slave method used by @src. @@ -1982,7 +1784,6 @@ gst_audio_base_src_set_provide_clock. Controls whether @src will provide a clock or not. If @provide is %TRUE, gst_element_provide_clock() will return a clock that reflects the datarate of @src. If @provide is %FALSE, gst_element_provide_clock() will return NULL. - @@ -1999,7 +1800,6 @@ of @src. If @provide is %FALSE, gst_element_provide_clock() will return NULL. Controls how clock slaving will be performed in @src. - @@ -2064,14 +1864,12 @@ of @src. If @provide is %FALSE, gst_element_provide_clock() will return NULL. #GstAudioBaseSrc class. Override the vmethod to implement functionality. - the parent class. - The new ringbuffer of @src. @@ -2090,9 +1888,7 @@ functionality. - - - + Different possible clock slaving algorithms when the internal audio clock was not selected as the pipeline clock. @@ -2120,7 +1916,6 @@ one item, which is the pointer to the beginning of the buffer, and @n_planes equals 1. The different channels in @planes are always in the GStreamer channel order. - a #GstAudioInfo describing the audio properties of this buffer @@ -2185,7 +1980,6 @@ memories in the buffer before calling this function. Note: The actual #GstBuffer is not ref'ed, but it is required to stay valid as long as it's mapped. - %TRUE if the map operation succeeded or %FALSE on failure @@ -2212,7 +2006,6 @@ as long as it's mapped. Unmaps an audio buffer that was previously mapped with gst_audio_buffer_map(). - @@ -2228,7 +2021,6 @@ gst_audio_buffer_map(). After calling this function the caller does not own a reference to @buffer anymore. - %NULL if the buffer is completely outside the configured segment, otherwise the clipped buffer is returned. @@ -2263,7 +2055,6 @@ number of channels. positions @to. @from and @to must contain the same number of positions and the same positions, only in a different order. @buffer must be writable. - %TRUE if the reordering was possible. @@ -2302,7 +2093,6 @@ from the beginning. After calling this function the caller does not own a reference to @buffer anymore. - the truncated buffer or %NULL if the arguments were invalid @@ -2375,10 +2165,8 @@ each track, with information about each track. The duration for each track can be retrieved via the #GST_TAG_DURATION tag from each entry's tag list, or calculated via gst_toc_entry_get_start_stop_times(). The track entries in the TOC will be sorted by track number. - - @@ -2389,7 +2177,6 @@ The track entries in the TOC will be sorted by track number. - @@ -2403,7 +2190,6 @@ The track entries in the TOC will be sorted by track number. - @@ -2421,7 +2207,6 @@ The track entries in the TOC will be sorted by track number. available data and audio tracks to the base source class. The caller should allocate @track on the stack, the base source will do a shallow copy of the structure (and take ownership of the taglist if there is one). - FALSE on error, otherwise TRUE. @@ -2468,14 +2253,12 @@ copy of the structure (and take ownership of the taglist if there is one). Audio CD source base class. - the parent class - @@ -2491,7 +2274,6 @@ copy of the structure (and take ownership of the taglist if there is one). - @@ -2504,7 +2286,6 @@ copy of the structure (and take ownership of the taglist if there is one). - @@ -2534,9 +2315,7 @@ EOS handling and seeking. the entire disc is a single stream - - - + CD track abstraction to communicate TOC entries to the base class. @@ -2545,7 +2324,6 @@ gst_audio_cd_src_add_track(). Applications will be informed of the available tracks via a TOC message on the pipeline's #GstBus instead. - Whether this is an audio track @@ -2578,10 +2356,8 @@ on the pipeline's #GstBus instead. - Free memory allocated by @mix. - @@ -2604,7 +2380,6 @@ generated, they should be rounded up or down by explicit assignment of 0.0 or 1.0 to values within a user-defined epsilon, this code doesn't make assumptions as to what may constitute an appropriate epsilon. - %TRUE is @mix is passthrough. @@ -2625,7 +2400,6 @@ array with pointers to memory blocks, one for each channel. Perform channel mixing on @in_data and write the result to @out_data. @in_data and @out_data need to be in @format and @layout. - @@ -2650,7 +2424,6 @@ Perform channel mixing on @in_data and write the result to @out_data. Create a new channel mixer object for the given parameters. - a new #GstAudioChannelMixer object, or %NULL if @format isn't supported. Free with gst_audio_channel_mixer_free() after usage. @@ -2684,7 +2457,6 @@ Perform channel mixing on @in_data and write the result to @out_data. Create a new channel mixer object for the given parameters. - a new #GstAudioChannelMixer object, or %NULL if @format isn't supported, @matrix is invalid, or @matrix is %NULL and @in_channels != @out_channels. @@ -2868,7 +2640,6 @@ samples, and multiply decoded streams can be gaplessly concatenated. Note: If clipping of the start is done by adjusting the segment, this meta has to be dropped from buffers as otherwise clipping could happen twice. - parent #GstMeta @@ -2886,7 +2657,6 @@ has to be dropped from buffers as otherwise clipping could happen twice. - @@ -2897,12 +2667,10 @@ has to be dropped from buffers as otherwise clipping could happen twice. simply need to provide a function that returns the current clock time. This object is internally used to implement the clock in #GstAudioBaseSink. - Create a new #GstAudioClock instance. Whenever the clock time should be calculated it will call @func with @user_data. When @func returns #GST_CLOCK_TIME_NONE, the clock will return the last reported time. - a new #GstAudioClock casted to a #GstClock. @@ -2928,7 +2696,6 @@ calculated it will call @func with @user_data. When @func returns Adjust @time with the internal offset of the audio clock. - @time adjusted with the internal offset. @@ -2947,7 +2714,6 @@ calculated it will call @func with @user_data. When @func returns Report the time as returned by the #GstAudioClockGetTimeFunc without applying any offsets. - the time as reported by the time function of the audio clock @@ -2966,7 +2732,6 @@ user_data becomes invalid. After calling this function, @clock will return the last returned time for the rest of its lifetime. - @@ -2982,7 +2747,6 @@ the rest of its lifetime. starting from @time. The clock will update an internal offset to make sure that future calls to internal_time will return an increasing result as required by the #GstClock object. - @@ -3022,7 +2786,6 @@ the #GstClock object. - @@ -3036,7 +2799,6 @@ the #GstClock object. This function will be called whenever the current clock time needs to be calculated. If this function returns #GST_CLOCK_TIME_NONE, the last reported time will be returned by the clock. - the current time or #GST_CLOCK_TIME_NONE if the previous time should be used. @@ -3062,14 +2824,12 @@ The object can perform conversion of: * audio samplerate * audio channels and channel layout - Create a new #GstAudioConverter that is able to convert between @in and @out audio formats. @config contains extra configuration options, see `GST_AUDIO_CONVERTER_OPT_*` parameters for details about the options and values. - a #GstAudioConverter or %NULL if conversion is not possible. @@ -3097,7 +2857,6 @@ parameters for details about the options and values. Convenience wrapper around gst_audio_converter_samples(), which will perform allocation of the output buffer based on the result from gst_audio_converter_get_out_frames(). - %TRUE is the conversion could be performed. @@ -3136,7 +2895,6 @@ gst_audio_converter_get_out_frames(). Free a previously allocated @convert instance. - @@ -3149,7 +2907,6 @@ gst_audio_converter_get_out_frames(). Get the current configuration of @convert. - a #GstStructure that remains valid for as long as @convert is valid @@ -3174,7 +2931,6 @@ gst_audio_converter_get_out_frames(). Calculate how many input frames are currently needed by @convert to produce @out_frames of output frames. - the number of input frames @@ -3193,7 +2949,6 @@ gst_audio_converter_get_out_frames(). Get the maximum number of input frames that the converter would need before producing output. - the latency of @convert as expressed in the number of frames. @@ -3209,7 +2964,6 @@ frames. Calculate how many output frames can be produced when @in_frames input frames are given to @convert. - the number of output frames @@ -3228,7 +2982,6 @@ frames are given to @convert. Returns whether the audio converter will operate in passthrough mode. The return value would be typically input to gst_base_transform_set_passthrough() - %TRUE when no conversion will actually occur. @@ -3242,7 +2995,6 @@ The return value would be typically input to gst_base_transform_set_passthrough( Reset @convert to the state it was when it was first created, clearing any history it might currently have. - @@ -3270,7 +3022,6 @@ This function always produces @out_frames of output and consumes @in_frames of input. Use gst_audio_converter_get_out_frames() and gst_audio_converter_get_in_frames() to make sure @in_frames and @out_frames are matching and @in and @out point to enough memory. - %TRUE is the conversion could be performed. @@ -3305,7 +3056,6 @@ are matching and @in and @out point to enough memory. Returns whether the audio converter can perform the conversion in-place. The return value would be typically input to gst_base_transform_set_in_place() - %TRUE when the conversion can be done in place. @@ -3332,7 +3082,6 @@ then be retrieved and refined with gst_audio_converter_get_config(). Look at the `GST_AUDIO_CONVERTER_OPT_*` fields to check valid configuration option and values. - %TRUE when the new parameters could be set @@ -3461,9 +3210,7 @@ Things that subclass need to take care of: @gst_audio_decoder_finish_frame. If it is prepared to perform PLC, it should also accept NULL data in @handle_frame and provide for data for indicated duration. - - @@ -3474,7 +3221,6 @@ Things that subclass need to take care of: - @@ -3488,7 +3234,6 @@ Things that subclass need to take care of: - @@ -3502,7 +3247,6 @@ Things that subclass need to take care of: - @@ -3516,7 +3260,6 @@ Things that subclass need to take care of: - @@ -3533,7 +3276,6 @@ Things that subclass need to take care of: Negotiate with downstream elements to currently configured #GstAudioInfo. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails. - %TRUE if the negotiation succeeded, else %FALSE. @@ -3546,7 +3288,6 @@ negotiate fails. - @@ -3557,7 +3298,6 @@ negotiate fails. - @@ -3577,7 +3317,6 @@ negotiate fails. - @@ -3591,7 +3330,6 @@ negotiate fails. - @@ -3605,7 +3343,6 @@ negotiate fails. - @@ -3619,7 +3356,6 @@ negotiate fails. - @@ -3633,7 +3369,6 @@ negotiate fails. - @@ -3647,7 +3382,6 @@ negotiate fails. - @@ -3661,7 +3395,6 @@ negotiate fails. - @@ -3675,7 +3408,6 @@ negotiate fails. - @@ -3686,7 +3418,6 @@ negotiate fails. - @@ -3697,7 +3428,6 @@ negotiate fails. - @@ -3719,7 +3449,6 @@ negotiate fails. Helper function that allocates a buffer to hold an audio frame for @dec's current output format. - allocated buffer @@ -3746,7 +3475,6 @@ data in @buf. Note that a frame received in #GstAudioDecoderClass.handle_frame() may be invalidated by a call to this function. - a #GstFlowReturn that should be escalated to caller (of caller) @@ -3780,7 +3508,6 @@ already. Note that a frame received in #GstAudioDecoderClass.handle_frame() may be invalidated by a call to this function. - a #GstFlowReturn that should be escalated to caller (of caller) @@ -3801,7 +3528,6 @@ invalidated by a call to this function. used by the base class and its @params. Unref the @allocator after use it. - @@ -3823,7 +3549,6 @@ used - a #GstAudioInfo describing the input audio format @@ -3836,7 +3561,6 @@ used - currently configured decoder delay @@ -3850,7 +3574,6 @@ used Queries decoder drain handling. - TRUE if drainable handling is enabled. @@ -3865,7 +3588,6 @@ MT safe. - currently configured byte to time conversion setting @@ -3880,7 +3602,6 @@ MT safe. Sets the variables pointed to by @min and @max to the currently configured latency. - @@ -3900,7 +3621,6 @@ latency. - currently configured decoder tolerated error count. @@ -3914,7 +3634,6 @@ latency. Queries decoder's latency aggregation. - aggregation latency. @@ -3930,7 +3649,6 @@ MT safe. Queries decoder required format handling. - TRUE if required format handling is enabled. @@ -3946,7 +3664,6 @@ MT safe. Return current parsing (sync and eos) state. - @@ -3967,7 +3684,6 @@ MT safe. Queries decoder packet loss concealment handling. - TRUE if packet loss concealment is enabled. @@ -3982,7 +3698,6 @@ MT safe. - currently configured plc handling @@ -3996,7 +3711,6 @@ MT safe. Queries current audio jitter tolerance threshold. - decoder audio jitter tolerance threshold. @@ -4017,7 +3731,6 @@ with gst_audio_decoder_merge_tags(). Note that this is provided for convenience, and the subclass is not required to use this and can still do tag handling on its own. - @@ -4040,7 +3753,6 @@ not required to use this and can still do tag handling on its own. Negotiate with downstream elements to currently configured #GstAudioInfo. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails. - %TRUE if the negotiation succeeded, else %FALSE. @@ -4056,7 +3768,6 @@ negotiate fails. Returns caps that express @caps (or sink template caps if @caps == NULL) restricted to rate/channels/... combinations supported by downstream elements. - a #GstCaps owned by caller @@ -4081,7 +3792,6 @@ elements. pad's caps. Use this function before calling gst_audio_decoder_negotiate(). Setting to %NULL the allocation query will use the caps from the pad. - @@ -4103,7 +3813,6 @@ Otherwise, it is not considered so capable and will only ever be passed real data. MT safe. - @@ -4120,7 +3829,6 @@ MT safe. Allows baseclass to perform byte to time estimated conversion. - @@ -4137,7 +3845,6 @@ MT safe. Sets decoder latency. - @@ -4161,7 +3868,6 @@ MT safe. warned about, but more than tolerated will lead to fatal error. You can set -1 for never returning fatal errors. Default is set to GST_AUDIO_DECODER_MAX_ERRORS. - @@ -4180,7 +3886,6 @@ GST_AUDIO_DECODER_MAX_ERRORS. Sets decoder minimum aggregation latency. MT safe. - @@ -4204,7 +3909,6 @@ is then expected being able to do so either by default or based on the input data. MT safe. - @@ -4224,7 +3928,6 @@ MT safe. gst_audio_decoder_set_output_format(), but allows subclasses to specify output caps that can't be expressed via #GstAudioInfo e.g. caps that have caps features. - %TRUE on success. @@ -4242,7 +3945,6 @@ caps features. Configure output info on the srcpad of @dec. - %TRUE on success. @@ -4263,7 +3965,6 @@ caps features. and codec are capable and allow handling plc. MT safe. - @@ -4280,7 +3981,6 @@ MT safe. Indicates whether or not subclass handles packet loss concealment (plc). - @@ -4299,7 +3999,6 @@ MT safe. Configures decoder audio jitter tolerance threshold. MT safe. - @@ -4321,7 +4020,6 @@ to use the default pad query handler to reply to accept-caps queries. By setting this to true it is possible to further customize the default handler with %GST_PAD_SET_ACCEPT_INTERSECT and %GST_PAD_SET_ACCEPT_TEMPLATE - @@ -4381,14 +4079,12 @@ gst_audio_decoder_set_max_errors() for more details. Subclasses can override any of the available virtual methods or not, as needed. At minimum @handle_frame (and likely @set_format) needs to be overridden. - The parent class structure - @@ -4401,7 +4097,6 @@ overridden. - @@ -4414,7 +4109,6 @@ overridden. - @@ -4430,7 +4124,6 @@ overridden. - @@ -4452,7 +4145,6 @@ overridden. - @@ -4468,7 +4160,6 @@ overridden. - @@ -4484,7 +4175,6 @@ overridden. - @@ -4500,7 +4190,6 @@ overridden. - @@ -4516,7 +4205,6 @@ overridden. - @@ -4532,7 +4220,6 @@ overridden. - @@ -4545,7 +4232,6 @@ overridden. - @@ -4558,7 +4244,6 @@ overridden. - %TRUE if the negotiation succeeded, else %FALSE. @@ -4573,7 +4258,6 @@ overridden. - @@ -4589,7 +4273,6 @@ overridden. - @@ -4605,7 +4288,6 @@ overridden. - @@ -4621,7 +4303,6 @@ overridden. - @@ -4637,7 +4318,6 @@ overridden. - @@ -4653,7 +4333,6 @@ overridden. - @@ -4679,9 +4358,7 @@ overridden. - - - + Set of available dithering methods. @@ -4706,7 +4383,6 @@ of channels to @channels. coefficients, i.e. the i-th output channels is constructed by multiplicating the input channels with the coefficients in @matrix[i] and taking the sum of the results. - parent #GstMeta @@ -4732,7 +4408,6 @@ of the results. - @@ -4831,10 +4506,8 @@ Things that subclass need to take care of: and discontinuity processing. * Accept data in @handle_frame and provide encoded results to gst_audio_encoder_finish_frame(). - - @@ -4845,7 +4518,6 @@ Things that subclass need to take care of: - @@ -4859,7 +4531,6 @@ Things that subclass need to take care of: - @@ -4870,7 +4541,6 @@ Things that subclass need to take care of: - @@ -4884,7 +4554,6 @@ Things that subclass need to take care of: - @@ -4901,7 +4570,6 @@ Things that subclass need to take care of: Negotiate with downstream elements to currently configured #GstCaps. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails. - %TRUE if the negotiation succeeded, else %FALSE. @@ -4914,7 +4582,6 @@ negotiate fails. - @@ -4925,7 +4592,6 @@ negotiate fails. - @@ -4939,7 +4605,6 @@ negotiate fails. - @@ -4953,7 +4618,6 @@ negotiate fails. - @@ -4967,7 +4631,6 @@ negotiate fails. - @@ -4981,7 +4644,6 @@ negotiate fails. - @@ -4995,7 +4657,6 @@ negotiate fails. - @@ -5009,7 +4670,6 @@ negotiate fails. - @@ -5023,7 +4683,6 @@ negotiate fails. - @@ -5034,7 +4693,6 @@ negotiate fails. - @@ -5045,7 +4703,6 @@ negotiate fails. - @@ -5067,7 +4724,6 @@ negotiate fails. Helper function that allocates a buffer to hold an encoded audio frame for @enc's current output format. - allocated buffer @@ -5094,7 +4750,6 @@ and a discontinuity is marked. Note that samples received in #GstAudioEncoderClass.handle_frame() may be invalidated by a call to this function. - a #GstFlowReturn that should be escalated to caller (of caller) @@ -5119,7 +4774,6 @@ may be invalidated by a call to this function. used by the base class and its @params. Unref the @allocator after use it. - @@ -5141,7 +4795,6 @@ used - a #GstAudioInfo describing the input audio format @@ -5155,7 +4808,6 @@ used Queries encoder drain handling. - TRUE if drainable handling is enabled. @@ -5170,7 +4822,6 @@ MT safe. - currently configured maximum handled frames @@ -5183,7 +4834,6 @@ MT safe. - currently maximum requested samples per frame @@ -5196,7 +4846,6 @@ MT safe. - currently minimum requested samples per frame @@ -5210,7 +4859,6 @@ MT safe. Queries encoder hard minimum handling. - TRUE if hard minimum handling is enabled. @@ -5225,7 +4873,6 @@ MT safe. - @@ -5238,7 +4885,6 @@ MT safe. Sets the variables pointed to by @min and @max to the currently configured latency. - @@ -5258,7 +4904,6 @@ latency. - currently configured encoder lookahead @@ -5272,7 +4917,6 @@ latency. Queries if the encoder will handle granule marking. - TRUE if granule marking is enabled. @@ -5288,7 +4932,6 @@ MT safe. Queries encoder perfect timestamp behaviour. - TRUE if perfect timestamp setting enabled. @@ -5304,7 +4947,6 @@ MT safe. Queries current audio jitter tolerance threshold. - encoder audio jitter tolerance threshold. @@ -5327,7 +4969,6 @@ Note that this is provided for convenience, and the subclass is not required to use this and can still do tag handling on its own. MT safe. - @@ -5351,7 +4992,6 @@ MT safe. Negotiate with downstream elements to currently configured #GstCaps. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails. - %TRUE if the negotiation succeeded, else %FALSE. @@ -5367,7 +5007,6 @@ negotiate fails. Returns caps that express @caps (or sink template caps if @caps == NULL) restricted to channel/rate combinations supported by downstream elements (e.g. muxers). - a #GstCaps owned by caller @@ -5392,7 +5031,6 @@ restricted to channel/rate combinations supported by downstream elements pad's caps. Use this function before calling gst_audio_encoder_negotiate(). Setting to %NULL the allocation query will use the caps from the pad. - @@ -5414,7 +5052,6 @@ Otherwise, it is not considered so capable and will only ever be passed real data. MT safe. - @@ -5435,7 +5072,6 @@ Requires @frame_samples_min and @frame_samples_max to be the equal. Note: This value will be reset to 0 every time before #GstAudioEncoderClass.set_format() is called. - @@ -5459,7 +5095,6 @@ must be called with the same number. Note: This value will be reset to 0 every time before #GstAudioEncoderClass.set_format() is called. - @@ -5483,7 +5118,6 @@ must be called with the same number. Note: This value will be reset to 0 every time before #GstAudioEncoderClass.set_format() is called. - @@ -5505,7 +5139,6 @@ might occur near end-of-data handling. Instead, the leftover samples will simply be discarded. MT safe. - @@ -5521,7 +5154,6 @@ MT safe. - @@ -5536,7 +5168,6 @@ MT safe. Set the codec headers to be sent downstream whenever requested. - @@ -5556,7 +5187,6 @@ MT safe. Sets encoder latency. - @@ -5580,7 +5210,6 @@ MT safe. Note: This value will be reset to 0 every time before #GstAudioEncoderClass.set_format() is called. - @@ -5599,7 +5228,6 @@ Note: This value will be reset to 0 every time before Enable or disable encoder granule handling. MT safe. - @@ -5616,7 +5244,6 @@ MT safe. Configure output caps on the srcpad of @enc. - %TRUE on success. @@ -5636,7 +5263,6 @@ MT safe. Enable or disable encoder perfect output timestamp preference. MT safe. - @@ -5655,7 +5281,6 @@ MT safe. Configures encoder audio jitter tolerance threshold. MT safe. - @@ -5712,14 +5337,12 @@ MT safe. Subclasses can override any of the available virtual methods or not, as needed. At minimum @set_format and @handle_frame needs to be overridden. - The parent class structure - @@ -5732,7 +5355,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5745,7 +5367,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5761,7 +5382,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5777,7 +5397,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5790,7 +5409,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5806,7 +5424,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5822,7 +5439,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5838,7 +5454,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5854,7 +5469,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5867,7 +5481,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5880,7 +5493,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - %TRUE if the negotiation succeeded, else %FALSE. @@ -5895,7 +5507,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5911,7 +5522,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5927,7 +5537,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5949,7 +5558,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5965,7 +5573,6 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - @@ -5985,9 +5592,7 @@ needed. At minimum @set_format and @handle_frame needs to be overridden. - - - + #GstAudioFilter is a #GstBaseTransform<!-- -->-derived base class for simple audio filters, ie. those that output the same format that they get as input. @@ -6002,9 +5607,7 @@ Derived classes should override the #GstAudioFilterClass.setup() and #GstBaseTransformClass.transform_ip() and/or #GstBaseTransformClass.transform() virtual functions in their class_init function. - - @@ -6033,14 +5636,12 @@ virtual functions in their class_init function. In addition to the @setup virtual function, you should also override the GstBaseTransform::transform and/or GstBaseTransform::transform_ip virtual function. - parent class - @@ -6064,7 +5665,6 @@ function. @allowed_caps as the caps that can be handled. This function is usually used from within a GObject class_init function. - @@ -6232,7 +5832,6 @@ This function is usually used from within a GObject class_init function. Construct a #GstAudioFormat with given parameters. - a #GstAudioFormat or GST_AUDIO_FORMAT_UNKNOWN when no audio format exists with the given parameters. @@ -6259,7 +5858,6 @@ exists with the given parameters. Fill @length bytes in @dest with silence samples for @info. - @@ -6283,7 +5881,6 @@ exists with the given parameters. Convert the @format string to its #GstAudioFormat. - the #GstAudioFormat for @format or GST_AUDIO_FORMAT_UNKNOWN when the string is not a known format. @@ -6298,7 +5895,6 @@ string is not a known format. Get the #GstAudioFormatInfo for @format - The #GstAudioFormatInfo for @format. @@ -6311,7 +5907,6 @@ string is not a known format. - @@ -6343,7 +5938,6 @@ string is not a known format. Information for an audio format. - #GstAudioFormat @@ -6400,7 +5994,6 @@ string is not a known format. Packs @length samples from @src to the data array in format @info. The samples from source have each channel interleaved and will be packed into @data. - @@ -6437,7 +6030,6 @@ and will be packed into @data. The samples will be unpacked into @dest which each channel interleaved. @dest should at least be big enough to hold @length * channels * size(unpack_format) bytes. - @@ -6473,7 +6065,6 @@ channels * size(unpack_format) bytes. in from GstCaps with gst_audio_info_from_caps(). Use the provided macros to access the info in this structure. - the format info of the audio @@ -6513,7 +6104,6 @@ Use the provided macros to access the info in this structure. Allocate a new #GstAudioInfo that is also initialized with gst_audio_info_init(). - a new #GstAudioInfo. free with gst_audio_info_free(). @@ -6524,7 +6114,6 @@ gst_audio_info_init(). GST_FORMAT_BYTES, GST_FORMAT_TIME, and GST_FORMAT_DEFAULT. For raw audio, GST_FORMAT_DEFAULT corresponds to audio frames. This function can be used to handle pad queries of the type GST_QUERY_CONVERT. - TRUE if the conversion was successful. @@ -6554,7 +6143,6 @@ function can be used to handle pad queries of the type GST_QUERY_CONVERT. Copy a GstAudioInfo structure. - a new #GstAudioInfo. free with gst_audio_info_free. @@ -6569,7 +6157,6 @@ function can be used to handle pad queries of the type GST_QUERY_CONVERT. Free a GstAudioInfo structure previously allocated with gst_audio_info_new() or gst_audio_info_copy(). - @@ -6582,7 +6169,6 @@ or gst_audio_info_copy(). Parse @caps and update @info. - TRUE if @caps could be parsed @@ -6600,7 +6186,6 @@ or gst_audio_info_copy(). Initialize @info with default values. - @@ -6613,7 +6198,6 @@ or gst_audio_info_copy(). Compares two #GstAudioInfo and returns whether they are equal or not - %TRUE if @info and @other are equal, else %FALSE. @@ -6633,7 +6217,6 @@ or gst_audio_info_copy(). Set the default info for the audio info of @format and @rate and @channels. Note: This initializes @info first, no values are preserved. - @@ -6664,7 +6247,6 @@ Note: This initializes @info first, no values are preserved. Convert the values of @info into a #GstCaps. - the new #GstCaps containing the info of @info. @@ -6691,7 +6273,6 @@ Note: This initializes @info first, no values are preserved. #GstAudioDownmixMeta defines an audio downmix matrix to be send along with audio buffers. These functions in this module help to create and attach the meta as well as extracting it. - parent #GstMeta @@ -6721,7 +6302,6 @@ meta as well as extracting it. - @@ -6759,10 +6339,8 @@ meta as well as extracting it. - Free a #GstAudioQuantize. - @@ -6776,7 +6354,6 @@ meta as well as extracting it. Reset @quant to the state is was when created, clearing any history it might have. - @@ -6798,7 +6375,6 @@ array with pointers to memory blocks, one for each channel. @in and @out may point to the same memory location, in which case samples will be modified in-place. - @@ -6829,7 +6405,6 @@ performance is achieved when @quantizer is a power of 2. Dithering and noise-shaping can be performed during quantization with the @dither and @ns parameters. - a new #GstAudioQuantize. Free with gst_audio_quantize_free(). @@ -6874,10 +6449,8 @@ the @dither and @ns parameters. #GstAudioResampler is a structure which holds the information required to perform various kinds of resampling filtering. - Free a previously allocated #GstAudioResampler @resampler. - @@ -6891,7 +6464,6 @@ required to perform various kinds of resampling filtering. Get the number of input frames that would currently be needed to produce @out_frames from @resampler. - The number of input frames needed for producing @out_frames of data from @resampler. @@ -6911,7 +6483,6 @@ to produce @out_frames from @resampler. Get the maximum number of input samples that the resampler would need before producing output. - the latency of @resampler as expressed in the number of frames. @@ -6927,7 +6498,6 @@ frames. Get the number of output frames that would be currently available when @in_frames are given to @resampler. - The number of frames that would be available after giving @in_frames as input to @resampler. @@ -6960,7 +6530,6 @@ This function always produces @out_frames of output and consumes @in_frames of input. Use gst_audio_resampler_get_out_frames() and gst_audio_resampler_get_in_frames() to make sure @in_frames and @out_frames are matching and @in and @out point to enough memory. - @@ -6990,7 +6559,6 @@ are matching and @in and @out point to enough memory. Reset @resampler to the state it was when it was first created, discarding all sample history. - @@ -7008,7 +6576,6 @@ not be called concurrently with any other function on @resampler. When @in_rate or @out_rate is 0, its value is unchanged. When @options is %NULL, the previously configured options are reused. - %TRUE if the new parameters could be set @@ -7034,7 +6601,6 @@ When @options is %NULL, the previously configured options are reused. Make a new resampler. - The new #GstAudioResampler, or %NULL on failure. @@ -7074,7 +6640,6 @@ When @options is %NULL, the previously configured options are reused. Set the parameters for resampling from @in_rate to @out_rate using @method for @quality in @options. - @@ -7182,10 +6747,8 @@ one writer can operate on the data from different threads in a lockfree manner. The base class is sufficiently flexible to be used as an abstraction for DMA based ringbuffers as well as a pure software implementations. - Print debug info about the buffer sized in @spec to the debug log. - @@ -7198,7 +6761,6 @@ implementations. Print debug info about the parsed caps in @spec to the debug log. - @@ -7211,7 +6773,6 @@ implementations. Parse @caps into @spec. - TRUE if the caps could be parsed. @@ -7231,7 +6792,6 @@ implementations. Allocate the resources for the ringbuffer. This function fills in the data pointer of the ring buffer with a valid #GstBuffer to which samples can be written. - TRUE if the device could be acquired, FALSE on error. @@ -7253,7 +6813,6 @@ MT safe. Activate @buf to start or stop pulling data. MT safe. - TRUE if the device could be activated in the requested mode, FALSE on error. @@ -7274,7 +6833,6 @@ FALSE on error. Clear all samples from the ringbuffer. MT safe. - @@ -7288,7 +6846,6 @@ MT safe. Close the audio device associated with the ring buffer. The ring buffer should already have been released via gst_audio_ring_buffer_release(). - TRUE if the device could be closed, FALSE on error. @@ -7322,7 +6879,6 @@ interrupted, one can resume the processing by passing the previously returned @accum value back to this function. MT safe. - The number of samples written to the ringbuffer or -1 on error. The number of samples written can be less than @out_samples when @buf was interrupted @@ -7369,7 +6925,6 @@ ringbuffer to the device but still not played. For capture ringbuffers this is the amount of samples in the device that are not yet transferred to the ringbuffer. - The number of samples queued in the audio device. @@ -7387,7 +6942,6 @@ MT safe. Open the audio device associated with the ring buffer. Does not perform any setup on the device. You must open the device before acquiring the ring buffer. - TRUE if the device could be opened, FALSE on error. @@ -7403,7 +6957,6 @@ MT safe. Pause processing samples from the ringbuffer. - TRUE if the device could be paused, FALSE on error. @@ -7419,7 +6972,6 @@ MT safe. Free the resources of the ringbuffer. - TRUE if the device could be released, FALSE on error. @@ -7434,7 +6986,6 @@ MT safe. - @@ -7446,7 +6997,6 @@ MT safe. Start processing samples from the ringbuffer. - TRUE if the device could be started, FALSE on error. @@ -7462,7 +7012,6 @@ MT safe. Stop processing samples from the ringbuffer. - TRUE if the device could be stopped, FALSE on error. @@ -7480,7 +7029,6 @@ MT safe. Allocate the resources for the ringbuffer. This function fills in the data pointer of the ring buffer with a valid #GstBuffer to which samples can be written. - TRUE if the device could be acquired, FALSE on error. @@ -7502,7 +7050,6 @@ MT safe. Activate @buf to start or stop pulling data. MT safe. - TRUE if the device could be activated in the requested mode, FALSE on error. @@ -7524,7 +7071,6 @@ FALSE on error. @advance segments are now processed by the device. MT safe. - @@ -7544,7 +7090,6 @@ MT safe. This function is used by subclasses. MT safe. - @@ -7563,7 +7108,6 @@ MT safe. Clear all samples from the ringbuffer. MT safe. - @@ -7577,7 +7121,6 @@ MT safe. Close the audio device associated with the ring buffer. The ring buffer should already have been released via gst_audio_ring_buffer_release(). - TRUE if the device could be closed, FALSE on error. @@ -7611,7 +7154,6 @@ interrupted, one can resume the processing by passing the previously returned @accum value back to this function. MT safe. - The number of samples written to the ringbuffer or -1 on error. The number of samples written can be less than @out_samples when @buf was interrupted @@ -7650,7 +7192,6 @@ with a flush or stop. Convert @src_val in @src_fmt to the equivalent value in @dest_fmt. The result will be put in @dest_val. - TRUE if the conversion succeeded. @@ -7689,7 +7230,6 @@ ringbuffer to the device but still not played. For capture ringbuffers this is the amount of samples in the device that are not yet transferred to the ringbuffer. - The number of samples queued in the audio device. @@ -7705,7 +7245,6 @@ MT safe. Checks the status of the device associated with the ring buffer. - TRUE if the device was open, FALSE if it was closed. @@ -7721,7 +7260,6 @@ MT safe. Check if the ringbuffer is acquired and ready to use. - TRUE if the ringbuffer is acquired, FALSE on error. @@ -7739,7 +7277,6 @@ MT safe. Check if @buf is activated. MT safe. - TRUE if the device is active. @@ -7755,7 +7292,6 @@ MT safe. Check if @buf is flushing. MT safe. - TRUE if the device is flushing. @@ -7772,7 +7308,6 @@ MT safe. the ringbuffer is filled with samples. MT safe. - @@ -7791,7 +7326,6 @@ MT safe. Open the audio device associated with the ring buffer. Does not perform any setup on the device. You must open the device before acquiring the ring buffer. - TRUE if the device could be opened, FALSE on error. @@ -7807,7 +7341,6 @@ MT safe. Pause processing samples from the ringbuffer. - TRUE if the device could be paused, FALSE on error. @@ -7824,7 +7357,6 @@ MT safe. Returns a pointer to memory where the data from segment @segment can be found. This function is mostly used by subclasses. - FALSE if the buffer is not started. @@ -7863,7 +7395,6 @@ the ringbuffer. although it is recommended. @timestamp will return the timestamp associated with the data returned. - The number of samples read from the ringbuffer or -1 on error. @@ -7898,7 +7429,6 @@ MT safe. Free the resources of the ringbuffer. - TRUE if the device could be released, FALSE on error. @@ -7916,7 +7446,6 @@ MT safe. Get the number of samples that were processed by the ringbuffer since it was last started. This does not include the number of samples not yet processed (see gst_audio_ring_buffer_delay()). - The number of samples processed by the ringbuffer. @@ -7935,7 +7464,6 @@ MT safe. will be called every time a segment has been written to a device. MT safe. - @@ -7959,7 +7487,6 @@ MT safe. will be called every time a segment has been written to a device. MT safe. - @@ -7985,7 +7512,6 @@ MT safe. Tell the ringbuffer about the device's channel positions. This must be called in when the ringbuffer is acquired. - @@ -8006,7 +7532,6 @@ be called in when the ringbuffer is acquired. Set the ringbuffer to flushing mode or normal mode. MT safe. - @@ -8030,7 +7555,6 @@ sample position of the ringbuffer. This function will also clear the buffer with silence. MT safe. - @@ -8046,7 +7570,6 @@ MT safe. - @@ -8064,7 +7587,6 @@ MT safe. Start processing samples from the ringbuffer. - TRUE if the device could be started, FALSE on error. @@ -8080,7 +7602,6 @@ MT safe. Stop processing samples from the ringbuffer. - TRUE if the device could be stopped, FALSE on error. @@ -8183,7 +7704,6 @@ MT safe. This function is set with gst_audio_ring_buffer_set_callback() and is called to fill the memory at @data with @len bytes of samples. - @@ -8210,14 +7730,12 @@ called to fill the memory at @data with @len bytes of samples. The vmethods that subclasses can override to implement the ringbuffer. - parent class - TRUE if the device could be opened, FALSE on error. @@ -8234,7 +7752,6 @@ MT safe. - TRUE if the device could be acquired, FALSE on error. @@ -8255,7 +7772,6 @@ MT safe. - TRUE if the device could be released, FALSE on error. @@ -8272,7 +7788,6 @@ MT safe. - TRUE if the device could be closed, FALSE on error. @@ -8289,7 +7804,6 @@ MT safe. - TRUE if the device could be started, FALSE on error. @@ -8306,7 +7820,6 @@ MT safe. - TRUE if the device could be paused, FALSE on error. @@ -8323,7 +7836,6 @@ MT safe. - @@ -8336,7 +7848,6 @@ MT safe. - TRUE if the device could be stopped, FALSE on error. @@ -8353,7 +7864,6 @@ MT safe. - The number of samples queued in the audio device. @@ -8370,7 +7880,6 @@ MT safe. - TRUE if the device could be activated in the requested mode, FALSE on error. @@ -8390,7 +7899,6 @@ FALSE on error. - The number of samples written to the ringbuffer or -1 on error. The number of samples written can be less than @out_samples when @buf was interrupted @@ -8429,7 +7937,6 @@ with a flush or stop. - @@ -8497,7 +8004,6 @@ with a flush or stop. The structure containing the format specification of the ringbuffer. - The caps that generated the Spec. @@ -8576,9 +8082,7 @@ by the device. All scheduling of samples and timestamps is done in this base class together with #GstAudioBaseSink using a default implementation of a #GstAudioRingBuffer that uses threads. - - @@ -8589,7 +8093,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8600,7 +8103,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8611,7 +8113,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8622,7 +8123,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8636,7 +8136,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8647,7 +8146,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8658,7 +8156,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8669,7 +8166,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8680,7 +8176,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8709,14 +8204,12 @@ together with #GstAudioBaseSink using a default implementation of a - the parent class structure. - @@ -8729,7 +8222,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8745,7 +8237,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8758,7 +8249,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8771,7 +8261,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8790,7 +8279,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8803,7 +8291,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8816,7 +8303,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8829,7 +8315,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8842,7 +8327,6 @@ together with #GstAudioBaseSink using a default implementation of a - @@ -8859,10 +8343,8 @@ together with #GstAudioBaseSink using a default implementation of a - - @@ -8889,9 +8371,7 @@ subclasses to implement a set of simple functions: All scheduling of samples and timestamps is done in this base class together with #GstAudioBaseSrc using a default implementation of a #GstAudioRingBuffer that uses threads. - - @@ -8902,7 +8382,6 @@ together with #GstAudioBaseSrc using a default implementation of a - @@ -8913,7 +8392,6 @@ together with #GstAudioBaseSrc using a default implementation of a - @@ -8924,7 +8402,6 @@ together with #GstAudioBaseSrc using a default implementation of a - @@ -8938,7 +8415,6 @@ together with #GstAudioBaseSrc using a default implementation of a - @@ -8958,7 +8434,6 @@ together with #GstAudioBaseSrc using a default implementation of a - @@ -8969,7 +8444,6 @@ together with #GstAudioBaseSrc using a default implementation of a - @@ -8994,14 +8468,12 @@ together with #GstAudioBaseSrc using a default implementation of a #GstAudioSrc class. Override the vmethod to implement functionality. - the parent class. - @@ -9014,7 +8486,6 @@ functionality. - @@ -9030,7 +8501,6 @@ functionality. - @@ -9043,7 +8513,6 @@ functionality. - @@ -9056,7 +8525,6 @@ functionality. - @@ -9078,7 +8546,6 @@ functionality. - @@ -9091,7 +8558,6 @@ functionality. - @@ -9115,7 +8581,6 @@ possible. See gst_audio_stream_align_new() for a description of its parameters and gst_audio_stream_align_process() for the details of the processing. - Allocate a new #GstAudioStreamAlign with the given configuration. All processing happens according to sample rate @rate, until @@ -9128,7 +8593,6 @@ timestamp difference is considered a discontinuity. Once detected, again until the output buffer is marked as a discontinuity. These can later be re-configured with gst_audio_stream_align_set_alignment_threshold() and gst_audio_stream_align_set_discont_wait(). - a new #GstAudioStreamAlign. free with gst_audio_stream_align_free(). @@ -9150,7 +8614,6 @@ gst_audio_stream_align_set_discont_wait(). Copy a GstAudioStreamAlign structure. - a new #GstAudioStreamAlign. free with gst_audio_stream_align_free. @@ -9165,7 +8628,6 @@ gst_audio_stream_align_set_discont_wait(). Free a GstAudioStreamAlign structure previously allocated with gst_audio_stream_align_new() or gst_audio_stream_align_copy(). - @@ -9178,7 +8640,6 @@ or gst_audio_stream_align_copy(). Gets the currently configured alignment threshold. - The currently configured alignment threshold @@ -9192,7 +8653,6 @@ or gst_audio_stream_align_copy(). Gets the currently configured discont wait. - The currently configured discont wait @@ -9206,7 +8666,6 @@ or gst_audio_stream_align_copy(). Gets the currently configured sample rate. - The currently configured sample rate @@ -9221,7 +8680,6 @@ or gst_audio_stream_align_copy(). Returns the number of samples that were processed since the last discontinuity was detected. - The number of samples processed since the last discontinuity. @@ -9236,7 +8694,6 @@ discontinuity was detected. Timestamp that was passed when a discontinuity was detected, i.e. the first timestamp after the discontinuity. - The last timestamp at when a discontinuity was detected @@ -9250,7 +8707,6 @@ timestamp after the discontinuity. Marks the next buffer as discontinuous and resets timestamp tracking. - @@ -9278,7 +8734,6 @@ discontinuous with the first sample of the current one. However for this function they are only considered discontinuous in reverse playback if the first sample of the previous buffer is discontinuous with the last sample of the current one. - %TRUE if a discontinuity was detected, %FALSE otherwise. @@ -9316,7 +8771,6 @@ of the current one. Sets @alignment_treshold as new alignment threshold for the following processing. - @@ -9333,7 +8787,6 @@ of the current one. Sets @alignment_treshold as new discont wait for the following processing. - @@ -9351,7 +8804,6 @@ of the current one. Sets @rate as new sample rate for the following processing. If the sample rate differs this implicitly marks the next data as discontinuous. - @@ -9369,7 +8821,6 @@ rate differs this implicitly marks the next data as discontinuous. Calculate frames from @clocktime and sample @rate. - clock time @@ -9381,7 +8832,6 @@ rate differs this implicitly marks the next data as discontinuous. Calculate clocktime from sample @frames and @rate. - sample frames @@ -9392,182 +8842,156 @@ rate differs this implicitly marks the next data as discontinuous. - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -9575,21 +8999,17 @@ rate differs this implicitly marks the next data as discontinuous. This metadata stays relevant as long as channels are unchanged. - This metadata stays relevant as long as sample rate is unchanged. - This metadata is relevant for audio streams. - - @@ -9612,9 +9032,7 @@ gst_stream_volume_set_mute() and gst_stream_volume_get_mute(). Elements that provide some kind of stream volume should implement the "volume" and "mute" #GObject properties and handle setting and getting of them properly. The volume property is defined to be a linear volume factor. - - the converted volume @@ -9635,7 +9053,6 @@ The volume property is defined to be a linear volume factor. - Returns %TRUE if the stream is muted @@ -9648,7 +9065,6 @@ The volume property is defined to be a linear volume factor. - The current stream volume as linear factor @@ -9665,7 +9081,6 @@ The volume property is defined to be a linear volume factor. - @@ -9681,7 +9096,6 @@ The volume property is defined to be a linear volume factor. - @@ -9713,7 +9127,6 @@ 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). - Linear scale factor, 1.0 = 100% @@ -9725,7 +9138,6 @@ cbrt(val) and 20 * log10 (val). - @@ -9735,7 +9147,6 @@ cbrt(val) and 20 * log10 (val). After calling this function the caller does not own a reference to @buffer anymore. - %NULL if the buffer is completely outside the configured segment, otherwise the clipped buffer is returned. @@ -9770,7 +9181,6 @@ number of channels. positions @to. @from and @to must contain the same number of positions and the same positions, only in a different order. @buffer must be writable. - %TRUE if the reordering was possible. @@ -9809,7 +9219,6 @@ from the beginning. After calling this function the caller does not own a reference to @buffer anymore. - the truncated buffer or %NULL if the arguments were invalid @@ -9842,7 +9251,6 @@ beginning. This function returns a reasonable fallback channel-mask and should be called as a last resort when the specific channel map is unknown. - a fallback channel-mask for @channels or 0 when there is no mask and mono. @@ -9857,7 +9265,6 @@ mask and mono. Create a new channel mixer object for the given parameters. - a new #GstAudioChannelMixer object, or %NULL if @format isn't supported. Free with gst_audio_channel_mixer_free() after usage. @@ -9891,7 +9298,6 @@ mask and mono. Create a new channel mixer object for the given parameters. - a new #GstAudioChannelMixer object, or %NULL if @format isn't supported, @matrix is invalid, or @matrix is %NULL and @in_channels != @out_channels. @@ -9929,7 +9335,6 @@ If @channel_mask is set to 0, it is considered as 'not present' for purpose of conversion. A partially valid @channel_mask with less bits set than the number of channels is considered valid. - %TRUE if channel and channel mask are valid and could be converted @@ -9957,7 +9362,6 @@ of channels is considered valid. If @force_order is %TRUE it additionally checks if the channels are in the order required by GStreamer. - %TRUE if the channel positions are valid and could be converted. @@ -9986,7 +9390,6 @@ in the order required by GStreamer. Converts @position to a human-readable string representation for debugging purposes. - a newly allocated string representing @position @@ -10009,7 +9412,6 @@ debugging purposes. Reorders the channel positions in @position from any order to the GStreamer channel order. - %TRUE if the channel positions are valid and reordering was successful. @@ -10033,7 +9435,6 @@ was successful. Checks if @position contains valid channel positions for @channels channels. If @force_order is %TRUE it additionally checks if the channels are in the order required by GStreamer. - %TRUE if the channel positions are valid. @@ -10057,32 +9458,27 @@ checks if the channels are in the order required by GStreamer. - - - - Construct a #GstAudioFormat with given parameters. - a #GstAudioFormat or GST_AUDIO_FORMAT_UNKNOWN when no audio format exists with the given parameters. @@ -10109,7 +9505,6 @@ exists with the given parameters. Fill @length bytes in @dest with silence samples for @info. - @@ -10133,7 +9528,6 @@ exists with the given parameters. Convert the @format string to its #GstAudioFormat. - the #GstAudioFormat for @format or GST_AUDIO_FORMAT_UNKNOWN when the string is not a known format. @@ -10148,7 +9542,6 @@ string is not a known format. Get the #GstAudioFormatInfo for @format - The #GstAudioFormatInfo for @format. @@ -10161,13 +9554,11 @@ string is not a known format. - - @@ -10179,7 +9570,6 @@ string is not a known format. Return all the raw audio formats supported by GStreamer. - an array of #GstAudioFormat @@ -10202,7 +9592,6 @@ different order. The resulting @reorder_map can be used for reordering by assigning channel i of the input to channel reorder_map[i] of the output. - %TRUE if the channel positions are valid and reordering is possible. @@ -10236,7 +9625,6 @@ is possible. Calculated the size of the buffer expected by gst_audio_iec61937_payload() for payloading type from @spec. - the size or 0 if the given @type is not supported or cannot be payloaded. @@ -10253,7 +9641,6 @@ payloaded. Payloads @src in the form specified by IEC 61937 for the type from @spec and stores the result in @dst. @src must contain exactly one frame of data and the frame is not checked for errors. - transfer-full: %TRUE if the payloading was successful, %FALSE otherwise. @@ -10295,7 +9682,6 @@ otherwise. Return a generic raw audio caps for formats defined in @formats. If @formats is %NULL returns a caps for all the supported raw audio formats, see gst_audio_formats_raw(). - an audio @GstCaps @@ -10318,13 +9704,11 @@ see gst_audio_formats_raw(). - - @@ -10337,7 +9721,6 @@ performance is achieved when @quantizer is a power of 2. Dithering and noise-shaping can be performed during quantization with the @dither and @ns parameters. - a new #GstAudioQuantize. Free with gst_audio_quantize_free(). @@ -10375,7 +9758,6 @@ positions @to. @from and @to must contain the same number of positions and the same positions, only in a different order. Note: this function assumes the audio data is in interleaved layout - %TRUE if the reordering was possible. @@ -10416,7 +9798,6 @@ Note: this function assumes the audio data is in interleaved layout Make a new resampler. - The new #GstAudioResampler, or %NULL on failure. @@ -10456,7 +9837,6 @@ Note: this function assumes the audio data is in interleaved layout Set the parameters for resampling from @in_rate to @out_rate using @method for @quality in @options. - @@ -10485,7 +9865,6 @@ for @quality in @options. Attaches #GstAudioClippingMeta metadata to @buffer with the given parameters. - the #GstAudioClippingMeta on @buffer. @@ -10516,7 +9895,6 @@ for @quality in @options. coefficients, i.e. the i-th output channels is constructed by multiplicating the input channels with the coefficients in @matrix[i] and taking the sum of the results. - the #GstAudioDownmixMeta on @buffer. @@ -10573,7 +9951,6 @@ specified cause this restriction to be violated. It is, obviously, also not allowed to specify parameters that would cause out-of-bounds memory access on @buffer. This is also checked, which means that you must add enough memory on the @buffer before adding this meta. - the #GstAudioMeta that was attached on the @buffer @@ -10600,14 +9977,12 @@ that you must add enough memory on the @buffer before adding this meta. - - @@ -10616,7 +9991,6 @@ that you must add enough memory on the @buffer before adding this meta. Find the #GstAudioDownmixMeta on @buffer for the given destination channel positions. - the #GstAudioDownmixMeta on @buffer. @@ -10640,7 +10014,6 @@ channel positions. - @@ -10657,7 +10030,6 @@ channel positions. audio formats in IEC 61937 headers and padding. - the converted volume diff --git a/gir-files/GstBase-1.0.gir b/gir-files/GstBase-1.0.gir index 053ca36a8..d0e5d2b97 100644 --- a/gir-files/GstBase-1.0.gir +++ b/gir-files/GstBase-1.0.gir @@ -11,77 +11,66 @@ and/or use gtk-doc annotations. --> - - - - - - - - - - - @@ -89,7 +78,6 @@ and/or use gtk-doc annotations. --> Convenience macro to access the source pad of #GstAggregator - a #GstAggregator @@ -196,10 +184,8 @@ Note that gst_adapter_push() takes ownership of the buffer passed. Use gst_buffer_ref() before pushing it into the adapter if you still want to access the buffer later. The adapter will never modify the data in the buffer pushed in it. - Creates a new #GstAdapter. Free with g_object_unref(). - a new #GstAdapter @@ -209,7 +195,6 @@ buffer pushed in it. Gets the maximum amount of bytes available, that is it returns the maximum value that can be supplied to gst_adapter_map() without that function returning %NULL. - number of bytes available in @adapter @@ -225,7 +210,6 @@ returning %NULL. Gets the maximum number of bytes that are immediately available without requiring any expensive operations (like copying the data into a temporary buffer). - number of bytes that are available in @adapter without expensive operations @@ -240,7 +224,6 @@ operations Removes all buffers from @adapter. - @@ -258,7 +241,6 @@ contained in #GstAdapter into an array @dest provided by the caller. The array @dest should be large enough to contain @size bytes. The user should check that the adapter has (@offset + @size) bytes available before calling this function. - @@ -289,7 +271,6 @@ available before calling this function. bytes of data starting at @offset will be copied out of the buffers contained in @adapter and into a new #GBytes structure which is returned. Depending on the value of the @size argument an empty #GBytes structure may be returned. - A new #GBytes structure containing the copied data. @@ -316,7 +297,6 @@ the value of the @size argument an empty #GBytes structure may be returned. - The offset. Can be %GST_BUFFER_OFFSET_NONE. @@ -331,7 +311,6 @@ following buffers based on their size. Get the DTS that was on the last buffer with the GST_BUFFER_FLAG_DISCONT flag, or GST_CLOCK_TIME_NONE. - The DTS at the last discont or GST_CLOCK_TIME_NONE. @@ -348,7 +327,6 @@ flag, or GST_CLOCK_TIME_NONE. at least this many bytes are available. See also: gst_adapter_map(), gst_adapter_unmap() - @@ -372,7 +350,6 @@ Caller owns a reference to the returned buffer. gst_buffer_unref() after usage. Free-function: gst_buffer_unref - a #GstBuffer containing the first @nbytes of the adapter, or %NULL if @nbytes bytes are not available. @@ -399,7 +376,6 @@ Caller owns a reference to the returned buffer. gst_buffer_unref() after usage. Free-function: gst_buffer_unref - a #GstBuffer containing the first @nbytes of the adapter, or %NULL if @nbytes bytes are not available. @@ -424,7 +400,6 @@ gst_adapter_take_buffer_list() for details. Caller owns the returned list. Call gst_buffer_list_unref() to free the list after usage. - a #GstBufferList of buffers containing the first @nbytes of the adapter, or %NULL if @nbytes bytes are not @@ -449,7 +424,6 @@ gst_adapter_take_list() for details. Caller owns returned list and contained buffers. gst_buffer_unref() each buffer in the list before freeing the list after usage. - a #GList of buffers containing the first @nbytes of the adapter, or %NULL if @nbytes @@ -483,7 +457,6 @@ as #GstBuffer memory or the potentially more performant gst_adapter_take_buffer(). Returns %NULL if @size bytes are not available. - a pointer to the first @size bytes of data, or %NULL @@ -515,7 +488,6 @@ enough data (offset+size bytes) in the adapter. This function calls gst_adapter_masked_scan_uint32_peek() passing %NULL for value. - offset of the first match, or -1 if no match was found. @@ -575,7 +547,6 @@ adapter for it to match, even if the first or last bytes are masked out. It is an error to call this function without making sure that there is enough data (offset+size bytes) in the adapter. - offset of the first match, or -1 if no match was found. @@ -611,7 +582,6 @@ enough data (offset+size bytes) in the adapter. Get the offset that was on the last buffer with the GST_BUFFER_FLAG_DISCONT flag, or GST_BUFFER_OFFSET_NONE. - The offset at the last discont or GST_BUFFER_OFFSET_NONE. @@ -632,7 +602,6 @@ The dts is reset to GST_CLOCK_TIME_NONE and the distance is set to 0 when the adapter is first created or when it is cleared. This also means that before the first byte with a dts is removed from the adapter, the dts and distance returned are GST_CLOCK_TIME_NONE and 0 respectively. - The previously seen dts. @@ -657,7 +626,6 @@ The dts is reset to GST_CLOCK_TIME_NONE and the distance is set to 0 when the adapter is first created or when it is cleared. This also means that before the first byte with a dts is removed from the adapter, the dts and distance returned are GST_CLOCK_TIME_NONE and 0 respectively. - The previously seen dts at given offset. @@ -686,7 +654,6 @@ The offset is reset to GST_BUFFER_OFFSET_NONE and the distance is set to 0 when the adapter is first created or when it is cleared. This also means that before the first byte with an offset is removed from the adapter, the offset and distance returned are GST_BUFFER_OFFSET_NONE and 0 respectively. - The previous seen offset. @@ -711,7 +678,6 @@ The pts is reset to GST_CLOCK_TIME_NONE and the distance is set to 0 when the adapter is first created or when it is cleared. This also means that before the first byte with a pts is removed from the adapter, the pts and distance returned are GST_CLOCK_TIME_NONE and 0 respectively. - The previously seen pts. @@ -736,7 +702,6 @@ The pts is reset to GST_CLOCK_TIME_NONE and the distance is set to 0 when the adapter is first created or when it is cleared. This also means that before the first byte with a pts is removed from the adapter, the pts and distance returned are GST_CLOCK_TIME_NONE and 0 respectively. - The previously seen pts at given offset. @@ -759,7 +724,6 @@ and distance returned are GST_CLOCK_TIME_NONE and 0 respectively. Get the PTS that was on the last buffer with the GST_BUFFER_FLAG_DISCONT flag, or GST_CLOCK_TIME_NONE. - The PTS at the last discont or GST_CLOCK_TIME_NONE. @@ -774,7 +738,6 @@ flag, or GST_CLOCK_TIME_NONE. Adds the data from @buf to the data stored inside @adapter and takes ownership of the buffer. - @@ -796,7 +759,6 @@ ownership of the buffer. Caller owns returned value. g_free after usage. Free-function: g_free - oven-fresh hot data, or %NULL if @nbytes bytes are not available @@ -835,7 +797,6 @@ Caller owns a reference to the returned buffer. gst_buffer_unref() after usage. Free-function: gst_buffer_unref - a #GstBuffer containing the first @nbytes of the adapter, or %NULL if @nbytes bytes are not available. @@ -877,7 +838,6 @@ Caller owns a reference to the returned buffer. gst_buffer_unref() after usage. Free-function: gst_buffer_unref - a #GstBuffer containing the first @nbytes of the adapter, or %NULL if @nbytes bytes are not available. @@ -903,7 +863,6 @@ performant because no memory should be copied. Caller owns the returned list. Call gst_buffer_list_unref() to free the list after usage. - a #GstBufferList of buffers containing the first @nbytes of the adapter, or %NULL if @nbytes bytes are not @@ -929,7 +888,6 @@ performant because no memory should be copied. Caller owns returned list and contained buffers. gst_buffer_unref() each buffer in the list before freeing the list after usage. - a #GList of buffers containing the first @nbytes of the adapter, or %NULL if @nbytes @@ -951,7 +909,6 @@ buffer in the list before freeing the list after usage. Releases the memory obtained with the last gst_adapter_map(). - @@ -963,9 +920,7 @@ buffer in the list before freeing the list after usage. - - - + Manages a set of pads with the purpose of aggregating their buffers. Control is given to the subclass when all pads have data. @@ -1026,9 +981,7 @@ Control is given to the subclass when all pads have data. See gst_element_class_add_static_pad_template_with_gtype(). This class used to live in gst-plugins-bad and was moved to core. - - @@ -1042,7 +995,6 @@ This class used to live in gst-plugins-bad and was moved to core. - @@ -1059,7 +1011,6 @@ This class used to live in gst-plugins-bad and was moved to core. - @@ -1079,7 +1030,6 @@ This class used to live in gst-plugins-bad and was moved to core. - @@ -1096,7 +1046,6 @@ This class used to live in gst-plugins-bad and was moved to core. This method will push the provided output buffer downstream. If needed, mandatory events such as stream-start, caps, and segment events will be sent before pushing the buffer. - @@ -1115,7 +1064,6 @@ sent before pushing the buffer. This method will push the provided output buffer list downstream. If needed, mandatory events such as stream-start, caps, and segment events will be sent before pushing the buffer. - @@ -1131,7 +1079,6 @@ sent before pushing the buffer. - @@ -1145,7 +1092,6 @@ sent before pushing the buffer. - @@ -1156,7 +1102,6 @@ sent before pushing the buffer. - @@ -1170,7 +1115,6 @@ sent before pushing the buffer. Negotiates src pad caps with downstream elements. Unmarks GST_PAD_FLAG_NEED_RECONFIGURE in any case. But marks it again if #GstAggregatorClass.negotiate() fails. - %TRUE if the negotiation succeeded, else %FALSE. @@ -1183,7 +1127,6 @@ if #GstAggregatorClass.negotiate() fails. - @@ -1201,7 +1144,6 @@ if #GstAggregatorClass.negotiate() fails. to produce the next output buffer. This should only be called from a #GstAggregator::samples-selected handler, and can be used to precisely control aggregating parameters for a given set of input samples. - The sample that is about to be aggregated. It may hold a #GstBuffer or a #GstBufferList. The contents of its info structure is subclass-dependent, @@ -1219,7 +1161,6 @@ control aggregating parameters for a given set of input samples. - @@ -1239,7 +1180,6 @@ control aggregating parameters for a given set of input samples. - @@ -1256,7 +1196,6 @@ control aggregating parameters for a given set of input samples. - @@ -1273,7 +1212,6 @@ control aggregating parameters for a given set of input samples. - @@ -1290,7 +1228,6 @@ control aggregating parameters for a given set of input samples. - @@ -1307,7 +1244,6 @@ control aggregating parameters for a given set of input samples. - @@ -1324,7 +1260,6 @@ control aggregating parameters for a given set of input samples. - @@ -1338,7 +1273,6 @@ control aggregating parameters for a given set of input samples. - @@ -1352,7 +1286,6 @@ control aggregating parameters for a given set of input samples. - @@ -1363,7 +1296,6 @@ control aggregating parameters for a given set of input samples. - @@ -1374,7 +1306,6 @@ control aggregating parameters for a given set of input samples. - @@ -1394,7 +1325,6 @@ control aggregating parameters for a given set of input samples. This method will push the provided output buffer downstream. If needed, mandatory events such as stream-start, caps, and segment events will be sent before pushing the buffer. - @@ -1413,7 +1343,6 @@ sent before pushing the buffer. This method will push the provided output buffer list downstream. If needed, mandatory events such as stream-start, caps, and segment events will be sent before pushing the buffer. - @@ -1433,7 +1362,6 @@ sent before pushing the buffer. acquired by the base class and its @params. Unref the @allocator after use it. - @@ -1455,7 +1383,6 @@ used - the instance of the #GstBufferPool used by @trans; free it after use it @@ -1474,7 +1401,6 @@ query, or %GST_CLOCK_TIME_NONE if there is not live source connected and the ele will not wait for the clock. Typically only called by subclasses. - The latency or %GST_CLOCK_TIME_NONE if the element does not sync @@ -1490,7 +1416,6 @@ Typically only called by subclasses. Negotiates src pad caps with downstream elements. Unmarks GST_PAD_FLAG_NEED_RECONFIGURE in any case. But marks it again if #GstAggregatorClass.negotiate() fails. - %TRUE if the negotiation succeeded, else %FALSE. @@ -1507,7 +1432,6 @@ if #GstAggregatorClass.negotiate() fails. to produce the next output buffer. This should only be called from a #GstAggregator::samples-selected handler, and can be used to precisely control aggregating parameters for a given set of input samples. - The sample that is about to be aggregated. It may hold a #GstBuffer or a #GstBufferList. The contents of its info structure is subclass-dependent, @@ -1536,7 +1460,6 @@ it MUST be called before gst_aggregator_selected_samples(). This function MUST only be called from the #GstAggregatorClass::aggregate() function. - @@ -1566,7 +1489,6 @@ function. Lets #GstAggregator sub-classes tell the baseclass what their internal latency is. Will also post a LATENCY message on the bus so the pipeline can reconfigure its global latency. - @@ -1587,7 +1509,6 @@ can reconfigure its global latency. Sets the caps to be used on the src pad. - @@ -1609,7 +1530,6 @@ the next time on the running time there. This is the desired behaviour in most cases where you have a live source and you have a dead line based aggregator subclass. - The running time based on the position @@ -1628,7 +1548,6 @@ downstream. Subclasses MUST call this before gst_aggregator_selected_samples(), if it is used at all. - @@ -1718,13 +1637,11 @@ It will also take care of event ordering (stream-start, segment, eos). Basically, a simple implementation will override @aggregate, and call _finish_buffer from inside that function. - - @@ -1737,7 +1654,6 @@ _finish_buffer from inside that function. - @@ -1756,7 +1672,6 @@ _finish_buffer from inside that function. - @@ -1774,7 +1689,6 @@ _finish_buffer from inside that function. - @@ -1793,7 +1707,6 @@ _finish_buffer from inside that function. - @@ -1812,7 +1725,6 @@ _finish_buffer from inside that function. - @@ -1828,7 +1740,6 @@ _finish_buffer from inside that function. - @@ -1844,7 +1755,6 @@ _finish_buffer from inside that function. - @@ -1863,7 +1773,6 @@ _finish_buffer from inside that function. - @@ -1879,7 +1788,6 @@ _finish_buffer from inside that function. - @@ -1892,7 +1800,6 @@ _finish_buffer from inside that function. - @@ -1905,7 +1812,6 @@ _finish_buffer from inside that function. - @@ -1918,7 +1824,6 @@ _finish_buffer from inside that function. - @@ -1940,7 +1845,6 @@ _finish_buffer from inside that function. - @@ -1959,7 +1863,6 @@ _finish_buffer from inside that function. - @@ -1975,7 +1878,6 @@ _finish_buffer from inside that function. - @@ -1991,7 +1893,6 @@ _finish_buffer from inside that function. - @@ -2007,7 +1908,6 @@ _finish_buffer from inside that function. - @@ -2029,7 +1929,6 @@ _finish_buffer from inside that function. - %TRUE if the negotiation succeeded, else %FALSE. @@ -2044,7 +1943,6 @@ _finish_buffer from inside that function. - @@ -2063,7 +1961,6 @@ _finish_buffer from inside that function. - @@ -2082,7 +1979,6 @@ _finish_buffer from inside that function. - @@ -2100,7 +1996,6 @@ _finish_buffer from inside that function. - The sample that is about to be aggregated. It may hold a #GstBuffer or a #GstBufferList. The contents of its info structure is subclass-dependent, @@ -2128,9 +2023,7 @@ _finish_buffer from inside that function. Pads managed by a #GstAggregator subclass. This class used to live in gst-plugins-bad and was moved to core. - - @@ -2144,7 +2037,6 @@ This class used to live in gst-plugins-bad and was moved to core. - @@ -2162,7 +2054,6 @@ This class used to live in gst-plugins-bad and was moved to core. Drop the buffer currently queued in @pad. - TRUE if there was a buffer queued in @pad, or FALSE if not. @@ -2178,7 +2069,6 @@ This class used to live in gst-plugins-bad and was moved to core. This checks if a pad has a buffer available that will be returned by a call to gst_aggregator_pad_peek_buffer() or gst_aggregator_pad_pop_buffer(). - %TRUE if the pad has a buffer available as the next thing. @@ -2191,7 +2081,6 @@ gst_aggregator_pad_pop_buffer(). - %TRUE if the pad is EOS, otherwise %FALSE. @@ -2204,7 +2093,6 @@ gst_aggregator_pad_pop_buffer(). - A reference to the buffer in @pad or NULL if no buffer was queued. You should unref the buffer after @@ -2220,7 +2108,6 @@ usage. Steal the ref to the buffer currently queued in @pad. - The buffer in @pad or NULL if no buffer was queued. You should unref the buffer after usage. @@ -2264,13 +2151,11 @@ usage. - - @@ -2286,7 +2171,6 @@ usage. - @@ -2309,12 +2193,8 @@ usage. - - - - - - + + Start at running time 0. @@ -2329,21 +2209,18 @@ selected by the `start-time` property. - - - @@ -2352,7 +2229,6 @@ selected by the `start-time` property. Obtains current drain status (ie. whether EOS has been received and the parser is now processing the frames at the end of the stream) - base parse instance @@ -2360,15 +2236,12 @@ the parser is now processing the frames at the end of the stream) - - - @@ -2376,7 +2249,6 @@ the parser is now processing the frames at the end of the stream) Obtains current sync status. - base parse instance @@ -2385,7 +2257,6 @@ the parser is now processing the frames at the end of the stream) Gives the pointer to the sink #GstPad object of the element. - base parse instance @@ -2394,7 +2265,6 @@ the parser is now processing the frames at the end of the stream) Gives the pointer to the source #GstPad object of the element. - base parse instance @@ -2402,42 +2272,36 @@ the parser is now processing the frames at the end of the stream) - - - - - - @@ -2445,7 +2309,6 @@ the parser is now processing the frames at the end of the stream) Gives the pointer to the #GstPad object of the element. - base sink instance @@ -2453,49 +2316,42 @@ the parser is now processing the frames at the end of the stream) - - - - - - - @@ -2504,42 +2360,36 @@ the parser is now processing the frames at the end of the stream) - - - - - - @@ -2547,7 +2397,6 @@ the parser is now processing the frames at the end of the stream) Gives the pointer to the #GstPad object of the element. - base source instance @@ -2555,28 +2404,24 @@ the parser is now processing the frames at the end of the stream) - - - - @@ -2584,12 +2429,10 @@ the parser is now processing the frames at the end of the stream) The name of the templates for the sink pad. - Gives the pointer to the sink #GstPad object of the element. - base transform instance @@ -2598,12 +2441,10 @@ the parser is now processing the frames at the end of the stream) The name of the templates for the source pad. - Gives the pointer to the source #GstPad object of the element. - base transform instance @@ -2611,7 +2452,6 @@ the parser is now processing the frames at the end of the stream) - @@ -2622,7 +2462,6 @@ the parser is now processing the frames at the end of the stream) used. This macro can used be to initialize a variable, but it cannot be assigned to a variable. In that case you have to use gst_bit_reader_init(). - Data from which the #GstBitReader should read @@ -2633,28 +2472,24 @@ gst_bit_reader_init(). - - - - @@ -2665,7 +2500,6 @@ gst_bit_reader_init(). used. This macro can used be to initialize a variable, but it cannot be assigned to a variable. In that case you have to use gst_byte_reader_init(). - Data from which the #GstByteReader should read @@ -2676,7 +2510,6 @@ gst_byte_reader_init(). - @@ -2818,9 +2651,7 @@ Things that subclass need to take care of: overridden) will then use these rates to perform obvious conversions. These rates are also used to update (estimated) duration at regular frame intervals. - - @@ -2843,7 +2674,6 @@ Things that subclass need to take care of: - @@ -2857,7 +2687,6 @@ Things that subclass need to take care of: - @@ -2871,7 +2700,6 @@ Things that subclass need to take care of: - @@ -2888,7 +2716,6 @@ Things that subclass need to take care of: - @@ -2902,7 +2729,6 @@ Things that subclass need to take care of: - @@ -2916,7 +2742,6 @@ Things that subclass need to take care of: - @@ -2930,7 +2755,6 @@ Things that subclass need to take care of: - @@ -2944,7 +2768,6 @@ Things that subclass need to take care of: - @@ -2958,7 +2781,6 @@ Things that subclass need to take care of: - @@ -2972,7 +2794,6 @@ Things that subclass need to take care of: - @@ -2983,7 +2804,6 @@ Things that subclass need to take care of: - @@ -2998,7 +2818,6 @@ Things that subclass need to take care of: to only add keyframe entries. @force allows to bypass checks, such as whether the stream is (upstream) seekable, another entry is already "close" to the new entry, etc. - #gboolean indicating whether entry was added @@ -3028,7 +2847,6 @@ to the new entry, etc. Default implementation of #GstBaseParseClass.convert(). - %TRUE if conversion was successful. @@ -3060,7 +2878,6 @@ to the new entry, etc. Drains the adapter until it is empty. It decreases the min_frame_size to match the current adapter size and calls chain method until the adapter is emptied or chain returns with error. - @@ -3083,7 +2900,6 @@ ignored for any but the above purpose/information). Note that the latter buffer is invalidated by this call, whereas the caller retains ownership of @frame. - a #GstFlowReturn that should be escalated to caller (of caller) @@ -3110,7 +2926,6 @@ with gst_base_parse_merge_tags(). Note that this is provided for convenience, and the subclass is not required to use this and can still do tag handling on its own. - @@ -3136,7 +2951,6 @@ does some timestamp and segment handling. Takes ownership of frame's buffer, though caller retains ownership of @frame. This must be called with sinkpad STREAM_LOCK held. - #GstFlowReturn @@ -3160,7 +2974,6 @@ By default, announced average bitrate is estimated. The average bitrate is used to estimate the total duration of the stream and to estimate a seek position, if there's no index and the format is syncable (see gst_base_parse_set_syncable()). - @@ -3181,7 +2994,6 @@ when it is able to determine duration and/or notices a change in the media duration. Alternatively, if @interval is non-zero (default), then stream duration is determined based on estimated bitrate, and updated every @interval frames. - @@ -3210,7 +3022,6 @@ and timestamping. When performing segment clipping, or seeking to a specific location, a corresponding decoder might need an initial @lead_in and a following @lead_out number of frames to ensure the desired segment is entirely filled upon decoding. - @@ -3241,7 +3052,6 @@ entirely filled upon decoding. Set if frames carry timing information which the subclass can (generally) parse and provide. In particular, intrinsic (rather than estimated) time can be obtained following a seek. - @@ -3261,7 +3071,6 @@ can be obtained following a seek. versa. While this is generally correct for audio data, it may not be otherwise. Sub-classes implementing such formats should disable timestamp inferring. - @@ -3280,7 +3089,6 @@ timestamp inferring. Sets the minimum and maximum (which may likely be equal) latency introduced by the parsing process. If there is such a latency, which depends on the particular parsing of the format, it typically corresponds to 1 frame duration. - @@ -3302,7 +3110,6 @@ particular parsing of the format, it typically corresponds to 1 frame duration.< Subclass can use this function to tell the base class that it needs to be given buffers of at least @min_size bytes. - @@ -3326,7 +3133,6 @@ pushed through unmodified, i.e. no #GstBaseParseClass.handle_frame() will be invoked, but #GstBaseParseClass.pre_push_frame() will still be invoked, so subclass can perform as much or as little is appropriate for passthrough semantics in #GstBaseParseClass.pre_push_frame(). - @@ -3346,7 +3152,6 @@ passthrough semantics in #GstBaseParseClass.pre_push_frame(). interpolation (previous timestamp + duration), which is incorrect for data streams with reordering, where PTS can go backward. Sub-classes implementing such formats should disable PTS interpolation. - @@ -3365,7 +3170,6 @@ implementing such formats should disable PTS interpolation. Set if frame starts can be identified. This is set by default and determines whether seeking based on bitrate averages is possible for a format/stream. - @@ -3389,7 +3193,6 @@ cases, the correct timestamps will occur in the stream after the start of the frame, but before the start of the actual picture data. This function can be used to set the timestamps based on the offset into the frame data that the picture starts. - @@ -3441,14 +3244,12 @@ the implementation (standard behaviour). Subclasses can override any of the available virtual methods or not, as needed. At minimum @handle_frame needs to be overridden. - the parent class - @@ -3461,7 +3262,6 @@ needed. At minimum @handle_frame needs to be overridden. - @@ -3474,7 +3274,6 @@ needed. At minimum @handle_frame needs to be overridden. - @@ -3490,7 +3289,6 @@ needed. At minimum @handle_frame needs to be overridden. - @@ -3509,7 +3307,6 @@ needed. At minimum @handle_frame needs to be overridden. - @@ -3525,7 +3322,6 @@ needed. At minimum @handle_frame needs to be overridden. - @@ -3550,7 +3346,6 @@ needed. At minimum @handle_frame needs to be overridden. - @@ -3566,7 +3361,6 @@ needed. At minimum @handle_frame needs to be overridden. - @@ -3582,7 +3376,6 @@ needed. At minimum @handle_frame needs to be overridden. - @@ -3598,7 +3391,6 @@ needed. At minimum @handle_frame needs to be overridden. - @@ -3614,7 +3406,6 @@ needed. At minimum @handle_frame needs to be overridden. - @@ -3630,7 +3421,6 @@ needed. At minimum @handle_frame needs to be overridden. - @@ -3658,7 +3448,6 @@ from and to the subclass w.r.t. the particular frame in question (rather than global parameters). Some of these may apply to each parsing stage, others only to some a particular one. These parameters are effectively zeroed at start of each frame's processing, i.e. parsing virtual method invocation sequence. - input data to be parsed for frames. @@ -3705,7 +3494,6 @@ of each frame's processing, i.e. parsing virtual method invocation sequence.Allocates a new #GstBaseParseFrame. This function is mainly for bindings, elements written in C should usually allocate the frame on the stack and then use gst_base_parse_frame_init() to initialise it. - a newly-allocated #GstBaseParseFrame. Free with gst_base_parse_frame_free() when no longer needed. @@ -3730,7 +3518,6 @@ then use gst_base_parse_frame_init() to initialise it. Copies a #GstBaseParseFrame. - A copy of @frame @@ -3744,7 +3531,6 @@ then use gst_base_parse_frame_init() to initialise it. Frees the provided @frame. - @@ -3761,7 +3547,6 @@ all public fields are zero-ed and a private flag is set to make sure gst_base_parse_frame_free() only frees the contents but not the actual frame. Use this function to initialise a #GstBaseParseFrame allocated on the stack. - @@ -3775,7 +3560,6 @@ allocated on the stack. Flags to be used in a #GstBaseParseFrame. - no flag @@ -3805,9 +3589,7 @@ allocated on the stack. when the first non-queued frame is finished - - - + #GstBaseSink is the base class for sink elements in GStreamer, such as xvimagesink or filesink. It is a layer on top of #GstElement that provides a @@ -3922,9 +3704,7 @@ rate, for example. The #GstBaseSink:async property can be used to instruct the sink to never perform an ASYNC state change. This feature is mostly usable when dealing with non-synchronized streams or sparse streams. - - @@ -3938,7 +3718,6 @@ with non-synchronized streams or sparse streams. - @@ -3952,7 +3731,6 @@ with non-synchronized streams or sparse streams. - @@ -3966,7 +3744,6 @@ with non-synchronized streams or sparse streams. - @@ -3980,7 +3757,6 @@ with non-synchronized streams or sparse streams. - @@ -4000,7 +3776,6 @@ with non-synchronized streams or sparse streams. - @@ -4014,7 +3789,6 @@ with non-synchronized streams or sparse streams. - @@ -4028,7 +3802,6 @@ with non-synchronized streams or sparse streams. - @@ -4042,7 +3815,6 @@ with non-synchronized streams or sparse streams. - @@ -4056,7 +3828,6 @@ with non-synchronized streams or sparse streams. - @@ -4070,7 +3841,6 @@ with non-synchronized streams or sparse streams. - @@ -4084,7 +3854,6 @@ with non-synchronized streams or sparse streams. - @@ -4098,7 +3867,6 @@ with non-synchronized streams or sparse streams. - @@ -4112,7 +3880,6 @@ with non-synchronized streams or sparse streams. - @@ -4123,7 +3890,6 @@ with non-synchronized streams or sparse streams. - @@ -4134,7 +3900,6 @@ with non-synchronized streams or sparse streams. - @@ -4145,7 +3910,6 @@ with non-synchronized streams or sparse streams. - @@ -4156,7 +3920,6 @@ with non-synchronized streams or sparse streams. - @@ -4176,7 +3939,6 @@ to preroll, this function will perform the preroll and will then block until the element state is changed. This function should be called with the PREROLL_LOCK held. - %GST_FLOW_OK if the preroll completed and processing can continue. Any other return value should be returned from the render vmethod. @@ -4196,7 +3958,6 @@ continue. Any other return value should be returned from the render vmethod. Get the number of bytes that the sink will pull when it is operating in pull mode. - the number of bytes @sink will pull in pull mode. @@ -4211,7 +3972,6 @@ mode. Checks if @sink is currently configured to drop buffers which are outside the current segment - %TRUE if the sink is configured to drop buffers outside the current segment. @@ -4231,7 +3991,6 @@ rendering. This property can be used to generate thumbnails. The #GstCaps on the sample can be used to determine the type of the buffer. Free-function: gst_sample_unref - a #GstSample. gst_sample_unref() after usage. This function returns %NULL when no buffer has arrived in the @@ -4247,7 +4006,6 @@ Free-function: gst_sample_unref Get the currently configured latency. - The configured latency. @@ -4261,7 +4019,6 @@ Free-function: gst_sample_unref Get the maximum amount of bits per second that the sink will render. - the maximum number of bits per second @sink will render. @@ -4276,7 +4033,6 @@ Free-function: gst_sample_unref Gets the max lateness value. See gst_base_sink_set_max_lateness() for more details. - The maximum time in nanoseconds that a buffer can be late before it is dropped and not rendered. A value of -1 means an @@ -4294,7 +4050,6 @@ unlimited time. Get the processing deadline of @sink. see gst_base_sink_set_processing_deadline() for more information about the processing deadline. - the processing deadline @@ -4309,7 +4064,6 @@ the processing deadline. Get the render delay of @sink. see gst_base_sink_set_render_delay() for more information about the render delay. - the render delay of @sink. @@ -4328,7 +4082,6 @@ with name `application/x-gst-base-sink-stats` with the following fields: - "average-rate" G_TYPE_DOUBLE average frame rate - "dropped" G_TYPE_UINT64 Number of dropped frames - "rendered" G_TYPE_UINT64 Number of rendered frames - pointer to #GstStructure @@ -4343,7 +4096,6 @@ with name `application/x-gst-base-sink-stats` with the following fields: Checks if @sink is currently configured to synchronize against the clock. - %TRUE if the sink is configured to synchronize against the clock. @@ -4358,7 +4110,6 @@ clock. Get the time that will be inserted between frames to control the maximum buffers per second. - the number of nanoseconds @sink will put between frames. @@ -4372,7 +4123,6 @@ maximum buffers per second. Get the synchronisation offset of @sink. - The synchronisation offset. @@ -4387,7 +4137,6 @@ maximum buffers per second. Checks if @sink is currently configured to perform asynchronous state changes to PAUSED. - %TRUE if the sink is configured to perform asynchronous state changes. @@ -4403,7 +4152,6 @@ changes. Checks if @sink is currently configured to store the last received sample in the last-sample property. - %TRUE if the sink is configured to store the last received sample. @@ -4418,7 +4166,6 @@ the last-sample property. Checks if @sink is currently configured to send Quality-of-Service events upstream. - %TRUE if the sink is configured to perform Quality-of-Service. @@ -4441,7 +4188,6 @@ for the latency introduced by the upstream elements by setting the @min_latency to a strictly positive value. This function is mostly used by subclasses. - %TRUE if the query succeeded. @@ -4474,7 +4220,6 @@ This function is mostly used by subclasses. disabled, the sink will immediately go to PAUSED instead of waiting for a preroll buffer. This feature is useful if the sink does not synchronize against the clock or when it is dealing with sparse streams. - @@ -4492,7 +4237,6 @@ against the clock or when it is dealing with sparse streams. Set the number of bytes that the sink will pull when it is operating in pull mode. - @@ -4509,7 +4253,6 @@ mode. Configure @sink to drop buffers which are outside the current segment - @@ -4527,7 +4270,6 @@ mode. Configures @sink to store the last received sample in the last-sample property. - @@ -4544,7 +4286,6 @@ property. Set the maximum amount of bits per second that the sink will render. - @@ -4564,7 +4305,6 @@ property. used to decide if a buffer should be dropped or not based on the buffer timestamp and the current clock time. A value of -1 means an unlimited time. - @@ -4585,7 +4325,6 @@ for processing the buffer. This is added to the latency of live pipelines. This function is usually called by subclasses. - @@ -4602,7 +4341,6 @@ This function is usually called by subclasses. Configures @sink to send Quality-of-Service events upstream. - @@ -4627,7 +4365,6 @@ After calling this function, this sink will report additional latency and other sinks will adjust their latency to delay the rendering of their media. This function is usually called by subclasses. - @@ -4648,7 +4385,6 @@ This function is usually called by subclasses. possible. If @sync is %TRUE, the timestamps of the incoming buffers will be used to schedule the exact render time of its contents. - @@ -4667,7 +4403,6 @@ contents. Set the time that will be inserted between rendered buffers. This can be used to control the maximum buffers per second that the sink will render. - @@ -4687,7 +4422,6 @@ will render. render buffers earlier than their timestamp. A positive value will delay rendering. This function can be used to fix playback of badly timestamped buffers. - @@ -4714,7 +4448,6 @@ receiving an EOS event in the ::event vmethod or when handling buffers in The @time argument should be the running_time of when the timeout should happen and will be adjusted with any latency and offset configured in the sink. - #GstFlowReturn @@ -4750,7 +4483,6 @@ the #GstBaseSinkClass.render() vmethod. The @time argument should be the running_time of when this method should return and is not adjusted with any latency or offset configured in the sink. - #GstClockReturn @@ -4789,7 +4521,6 @@ returns %GST_FLOW_FLUSHING). This function should only be called with the PREROLL_LOCK held, like in the render function. - %GST_FLOW_OK if the preroll completed and processing can continue. Any other return value should be returned from the render vmethod. @@ -4944,14 +4675,12 @@ used to fix synchronisation in bad files. Subclasses can override any of the available virtual methods or not, as needed. At the minimum, the @render method should be overridden to output/present buffers. - Element parent class - @@ -4967,7 +4696,6 @@ output/present buffers. - @@ -4983,7 +4711,6 @@ output/present buffers. - @@ -4999,7 +4726,6 @@ output/present buffers. - @@ -5015,7 +4741,6 @@ output/present buffers. - @@ -5037,7 +4762,6 @@ output/present buffers. - @@ -5053,7 +4777,6 @@ output/present buffers. - @@ -5066,7 +4789,6 @@ output/present buffers. - @@ -5079,7 +4801,6 @@ output/present buffers. - @@ -5092,7 +4813,6 @@ output/present buffers. - @@ -5105,7 +4825,6 @@ output/present buffers. - @@ -5121,7 +4840,6 @@ output/present buffers. - @@ -5137,7 +4855,6 @@ output/present buffers. - @@ -5153,7 +4870,6 @@ output/present buffers. - @@ -5169,7 +4885,6 @@ output/present buffers. - @@ -5185,7 +4900,6 @@ output/present buffers. - @@ -5201,7 +4915,6 @@ output/present buffers. - @@ -5217,7 +4930,6 @@ output/present buffers. - @@ -5237,9 +4949,7 @@ output/present buffers. - - - + This is a generic base class for source elements. The following types of sources are supported: @@ -5353,9 +5063,7 @@ with the gst_element_send_event() function on the element or its parent bin. After the EOS has been sent to the element, the application should wait for an EOS message to be posted on the pipeline's bus. Once this EOS message is received, it may safely shut down the entire pipeline. - - @@ -5377,7 +5085,6 @@ received, it may safely shut down the entire pipeline. Ask the subclass to create a buffer with @offset and @size, the default implementation will call alloc and fill. - @@ -5397,7 +5104,6 @@ implementation will call alloc and fill. - @@ -5411,7 +5117,6 @@ implementation will call alloc and fill. - @@ -5425,7 +5130,6 @@ implementation will call alloc and fill. - @@ -5439,7 +5143,6 @@ implementation will call alloc and fill. - @@ -5459,7 +5162,6 @@ implementation will call alloc and fill. - @@ -5474,7 +5176,6 @@ implementation will call alloc and fill. Called to get the caps to report. - @@ -5488,7 +5189,6 @@ implementation will call alloc and fill. - @@ -5504,7 +5204,6 @@ implementation will call alloc and fill. Given @buffer, return @start and @end time when it should be pushed out. The base class will sync on the clock using these times. - @@ -5524,7 +5223,6 @@ out. The base class will sync on the clock using these times. - @@ -5542,7 +5240,6 @@ if #GstBaseSrcClass.negotiate() fails. Do not call this in the #GstBaseSrcClass.fill() vmethod. Call this in #GstBaseSrcClass.create() or in #GstBaseSrcClass.alloc(), _before_ any buffer is allocated. - %TRUE if the negotiation succeeded, else %FALSE. @@ -5555,7 +5252,6 @@ buffer is allocated. - @@ -5572,7 +5268,6 @@ buffer is allocated. - @@ -5587,7 +5282,6 @@ buffer is allocated. Set new caps on the basesrc source pad. - %TRUE if the caps could be set @@ -5604,7 +5298,6 @@ buffer is allocated. - @@ -5615,7 +5308,6 @@ buffer is allocated. - @@ -5626,7 +5318,6 @@ buffer is allocated. - @@ -5637,7 +5328,6 @@ buffer is allocated. - @@ -5652,7 +5342,6 @@ buffer is allocated. used by the base class and its @params. Unref the @allocator after usage. - @@ -5674,7 +5363,6 @@ used Get the number of bytes that @src will push out with each buffer. - the number of bytes pushed with each buffer. @@ -5687,7 +5375,6 @@ used - the instance of the #GstBufferPool used by the src; unref it after usage. @@ -5702,7 +5389,6 @@ by the src; unref it after usage. Query if @src timestamps outgoing buffers based on the current running_time. - %TRUE if the base class will automatically timestamp outgoing buffers. @@ -5716,7 +5402,6 @@ by the src; unref it after usage. Get the current async behaviour of @src. See also gst_base_src_set_async(). - %TRUE if @src is operating in async mode. @@ -5730,7 +5415,6 @@ by the src; unref it after usage. Check if an element is in live mode. - %TRUE if element is in live mode. @@ -5750,7 +5434,6 @@ if #GstBaseSrcClass.negotiate() fails. Do not call this in the #GstBaseSrcClass.fill() vmethod. Call this in #GstBaseSrcClass.create() or in #GstBaseSrcClass.alloc(), _before_ any buffer is allocated. - %TRUE if the negotiation succeeded, else %FALSE. @@ -5770,7 +5453,6 @@ as the stream-lock needs to be held. The format for the new segment will be the current format of the source, as configured with gst_base_src_set_format() Use gst_base_src_new_segment() - %TRUE if preparation of the seamless segment succeeded. @@ -5804,7 +5486,6 @@ of the source, as configured with gst_base_src_set_format(). The format of @src must not be %GST_FORMAT_UNDEFINED and the format should be configured via gst_base_src_set_format() before calling this method. - %TRUE if preparation of new segment succeeded. @@ -5827,7 +5508,6 @@ to the difference between the running time and the timestamp of the first buffer. This function is mostly used by subclasses. - %TRUE if the query succeeded. @@ -5856,7 +5536,6 @@ This function is mostly used by subclasses. close, start, stop, play and pause virtual methods will be executed in a different thread and are thus allowed to perform blocking operations. Any blocking operation should be unblocked with the unlock vmethod. - @@ -5882,7 +5561,6 @@ when a buffer outside of the currently configured segment is pushed if @automatic_eos is %TRUE. Since 1.16, if @automatic_eos is %FALSE an EOS will be pushed only when the #GstBaseSrcClass.create() implementation returns %GST_FLOW_EOS. - @@ -5900,7 +5578,6 @@ returns %GST_FLOW_EOS. Set the number of bytes that @src will push out with each buffer. When @blocksize is set to -1, a default length will be used. - @@ -5917,7 +5594,6 @@ returns %GST_FLOW_EOS. Set new caps on the basesrc source pad. - %TRUE if the caps could be set @@ -5937,7 +5613,6 @@ returns %GST_FLOW_EOS. Configure @src to automatically timestamp outgoing buffers based on the current running_time of the pipeline. This property is mostly useful for live sources. - @@ -5956,7 +5631,6 @@ sources. If not @dynamic, size is only updated when needed, such as when trying to read past current tracked size. Otherwise, size is checked for upon each read. - @@ -5979,7 +5653,6 @@ If a format of GST_FORMAT_BYTES is set, the element will be able to operate in pull mode if the #GstBaseSrcClass.is_seekable() returns %TRUE. This function must only be called in states < %GST_STATE_PAUSED. - @@ -6003,7 +5676,6 @@ will therefore not be able to participate in the PREROLL phase of a pipeline. To signal this fact to the application and the pipeline, the state change return value of the live source will be GST_STATE_CHANGE_NO_PREROLL. - @@ -6023,7 +5695,6 @@ be GST_STATE_CHANGE_NO_PREROLL. start method, it should call gst_base_src_start_complete() when the start operation completes either from the same thread or from an asynchronous helper thread. - @@ -6040,7 +5711,6 @@ helper thread. Wait until the start operation completes. - a #GstFlowReturn. @@ -6069,7 +5739,6 @@ function the behaviour is undefined. Subclasses must only call this function once per create function call and subclasses must only call this function when the source operates in push mode. - @@ -6093,7 +5762,6 @@ This function will block until a state change to PLAYING happens (in which case this function returns %GST_FLOW_OK) or the processing must be stopped due to a state change to READY or a FLUSH event (in which case this function returns %GST_FLOW_FLUSHING). - %GST_FLOW_OK if @src is PLAYING and processing can continue. Any other return value should be returned from the create vmethod. @@ -6182,14 +5850,12 @@ continue. Any other return value should be returned from the create vmethod.Subclasses can override any of the available virtual methods or not, as needed. At the minimum, the @create method should be overridden to produce buffers. - Element parent class - @@ -6205,7 +5871,6 @@ buffers. - %TRUE if the negotiation succeeded, else %FALSE. @@ -6220,7 +5885,6 @@ buffers. - @@ -6236,7 +5900,6 @@ buffers. - %TRUE if the caps could be set @@ -6255,7 +5918,6 @@ buffers. - @@ -6271,7 +5933,6 @@ buffers. - @@ -6284,7 +5945,6 @@ buffers. - @@ -6297,7 +5957,6 @@ buffers. - @@ -6319,7 +5978,6 @@ buffers. - @@ -6335,7 +5993,6 @@ buffers. - @@ -6348,7 +6005,6 @@ buffers. - @@ -6367,7 +6023,6 @@ buffers. - @@ -6383,7 +6038,6 @@ buffers. - @@ -6396,7 +6050,6 @@ buffers. - @@ -6409,7 +6062,6 @@ buffers. - @@ -6425,7 +6077,6 @@ buffers. - @@ -6441,7 +6092,6 @@ buffers. - @@ -6463,7 +6113,6 @@ buffers. - @@ -6485,7 +6134,6 @@ buffers. - @@ -6513,7 +6161,6 @@ buffers. The #GstElement flags that a basesrc element may have. - has source is starting @@ -6524,9 +6171,7 @@ buffers. offset to define more flags - - - + This base class is for filter elements that process data. Elements that are suitable for implementation using #GstBaseTransform are ones @@ -6632,9 +6277,7 @@ It provides for: * Implied %TRUE if no transform function is implemented. * Implied %FALSE if ONLY transform function is implemented. - - @@ -6651,7 +6294,6 @@ It provides for: - @@ -6665,7 +6307,6 @@ It provides for: - @@ -6682,7 +6323,6 @@ It provides for: - @@ -6696,7 +6336,6 @@ It provides for: - @@ -6716,7 +6355,6 @@ It provides for: - @@ -6736,7 +6374,6 @@ It provides for: - @@ -6750,7 +6387,6 @@ It provides for: - @@ -6767,7 +6403,6 @@ It provides for: - @@ -6784,7 +6419,6 @@ It provides for: - @@ -6801,7 +6435,6 @@ It provides for: - @@ -6818,7 +6451,6 @@ It provides for: - @@ -6835,7 +6467,6 @@ It provides for: - @@ -6849,7 +6480,6 @@ It provides for: - @@ -6863,7 +6493,6 @@ It provides for: - @@ -6874,7 +6503,6 @@ It provides for: - @@ -6885,7 +6513,6 @@ It provides for: - @@ -6902,7 +6529,6 @@ It provides for: - @@ -6919,7 +6545,6 @@ It provides for: - @@ -6939,7 +6564,6 @@ It provides for: - @@ -6953,7 +6577,6 @@ It provides for: - @@ -6973,7 +6596,6 @@ It provides for: - @@ -7003,7 +6625,6 @@ It provides for: used by the base class and its @params. Unref the @allocator after use. - @@ -7024,7 +6645,6 @@ used - the instance of the #GstBufferPool used by @trans; free it after use @@ -7039,7 +6659,6 @@ by @trans; free it after use See if @trans is configured as a in_place transform. - %TRUE if the transform is configured in in_place mode. @@ -7055,7 +6674,6 @@ MT safe. See if @trans is configured as a passthrough transform. - %TRUE if the transform is configured in passthrough mode. @@ -7071,7 +6689,6 @@ MT safe. Queries if the transform will handle QoS. - %TRUE if QoS is enabled. @@ -7100,7 +6717,6 @@ allocated. It will be default be called when handling an ALLOCATION query or at the very beginning of the default #GstBaseTransformClass.submit_input_buffer() implementation. - %TRUE if the negotiation succeeded, else %FALSE. @@ -7116,7 +6732,6 @@ implementation. Instructs @trans to request renegotiation upstream. This function is typically called after properties on the transform were set that influence the input format. - @@ -7131,7 +6746,6 @@ influence the input format. Instructs @trans to renegotiate a new downstream transform on the next buffer. This function is typically called after properties on the transform were set that influence the output format. - @@ -7151,7 +6765,6 @@ correctly, i.e. it can assume that the buffer contains neutral data but must unset the flag if the output is no neutral data. MT safe. - @@ -7174,7 +6787,6 @@ to the transform_ip function. * Always %FALSE if ONLY transform function is implemented. MT safe. - @@ -7198,7 +6810,6 @@ Always %TRUE for filters which don't implement either a transform or transform_ip or generate_output method. MT safe. - @@ -7225,7 +6836,6 @@ passthrough transforms but prefer to do something else, like a capsfilter. MT safe. - @@ -7244,7 +6854,6 @@ MT safe. Enable or disable QoS handling in the transform. MT safe. - @@ -7265,7 +6874,6 @@ when a QOS event is received but subclasses can provide custom information when needed. MT safe. - @@ -7295,7 +6903,6 @@ can be used by subclasses when they have already negotiated their caps but found a change in them (or computed new information). This way, they can notify downstream about that change without losing any buffer. - %TRUE if the caps could be sent downstream %FALSE otherwise @@ -7347,7 +6954,6 @@ downstream needed. At minimum either @transform or @transform_ip need to be overridden. If the element can overwrite the input data with the results (data is of the same type and quantity) it should provide @transform_ip. - Element parent class @@ -7368,7 +6974,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7390,7 +6995,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7412,7 +7016,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7431,7 +7034,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7450,7 +7052,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7469,7 +7070,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7485,7 +7085,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7507,7 +7106,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7526,7 +7124,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7554,7 +7151,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7573,7 +7169,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7586,7 +7181,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7599,7 +7193,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7615,7 +7208,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7631,7 +7223,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7650,7 +7241,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7669,7 +7259,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7691,7 +7280,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7707,7 +7295,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7726,7 +7313,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7742,7 +7328,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7761,7 +7346,6 @@ same type and quantity) it should provide @transform_ip. - @@ -7781,14 +7365,11 @@ same type and quantity) it should provide @transform_ip. - - - + #GstBitReader provides a bit reader that can read any number of bits from a memory buffer. It provides functions for reading any number of bits into 8, 16, 32 and 64 bit variables. - Data from which the bit reader will read @@ -7816,7 +7397,6 @@ into 8, 16, 32 and 64 bit variables. Frees a #GstBitReader instance, which was previously allocated by gst_bit_reader_new(). - @@ -7829,7 +7409,6 @@ gst_bit_reader_new(). Read @nbits bits into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -7851,7 +7430,6 @@ gst_bit_reader_new(). Read @nbits bits into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -7873,7 +7451,6 @@ gst_bit_reader_new(). Read @nbits bits into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -7895,7 +7472,6 @@ gst_bit_reader_new(). Read @nbits bits into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -7917,7 +7493,6 @@ gst_bit_reader_new(). Returns the current position of a #GstBitReader instance in bits. - The current position of @reader in bits. @@ -7931,7 +7506,6 @@ gst_bit_reader_new(). Returns the remaining number of bits of a #GstBitReader instance. - The remaining number of bits of @reader instance. @@ -7945,7 +7519,6 @@ gst_bit_reader_new(). Returns the total number of bits of a #GstBitReader instance. - The total number of bits of @reader instance. @@ -7960,7 +7533,6 @@ gst_bit_reader_new(). Initializes a #GstBitReader instance to read from @data. This function can be called on already initialized instances. - @@ -7983,7 +7555,6 @@ can be called on already initialized instances. Read @nbits bits into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -8005,7 +7576,6 @@ can be called on already initialized instances. Read @nbits bits into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -8027,7 +7597,6 @@ can be called on already initialized instances. Read @nbits bits into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -8049,7 +7618,6 @@ can be called on already initialized instances. Read @nbits bits into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -8071,7 +7639,6 @@ can be called on already initialized instances. Sets the new position of a #GstBitReader instance to @pos in bits. - %TRUE if the position could be set successfully, %FALSE otherwise. @@ -8090,7 +7657,6 @@ otherwise. Skips @nbits bits of the #GstBitReader instance. - %TRUE if @nbits bits could be skipped, %FALSE otherwise. @@ -8108,7 +7674,6 @@ otherwise. Skips until the next byte. - %TRUE if successful, %FALSE otherwise. @@ -8124,7 +7689,6 @@ otherwise. Create a new #GstBitReader instance, which will read from @data. Free-function: gst_bit_reader_free - a new #GstBitReader instance @@ -8148,7 +7712,6 @@ Free-function: gst_bit_reader_free #GstBitWriter provides a bit writer that can write any number of bits into a memory buffer. It provides functions for writing any number of bits into 8, 16, 32 and 64 bit variables. - Allocated @data for bit writer to write @@ -8174,7 +7737,6 @@ number of bits into 8, 16, 32 and 64 bit variables. Write trailing bit to align last byte of @data. @trailing_bit can only be 1 or 0. - %TRUE if successful, %FALSE otherwise. @@ -8192,7 +7754,6 @@ only be 1 or 0. Frees @bitwriter and the allocated data inside. - @@ -8208,7 +7769,6 @@ only be 1 or 0. returned as #GstBuffer. Free-function: gst_buffer_unref - a new allocated #GstBuffer wrapping the data inside. gst_buffer_unref() after usage. @@ -8226,7 +7786,6 @@ Free-function: gst_buffer_unref returned. Free-function: g_free - the current data. g_free() after usage. @@ -8243,7 +7802,6 @@ Free-function: g_free Get written data pointer - data pointer @@ -8256,7 +7814,6 @@ Free-function: g_free - @@ -8268,7 +7825,6 @@ Free-function: g_free Get size of written @data - size of bits written in @data @@ -8282,7 +7838,6 @@ Free-function: g_free Initializes @bitwriter to an empty instance. - @@ -8297,7 +7852,6 @@ Free-function: g_free Initializes @bitwriter with the given memory area @data. IF @initialized is %TRUE it is possible to read @size bits from the #GstBitWriter from the beginning. - @@ -8325,7 +7879,6 @@ Free-function: g_free Initializes a #GstBitWriter instance and allocates the given data @size. - @@ -8346,7 +7899,6 @@ Free-function: g_free Write @nbits bits of @value to #GstBitWriter. - %TRUE if successful, %FALSE otherwise. @@ -8368,7 +7920,6 @@ Free-function: g_free Write @nbits bits of @value to #GstBitWriter. - %TRUE if successful, %FALSE otherwise. @@ -8390,7 +7941,6 @@ Free-function: g_free Write @nbits bits of @value to #GstBitWriter. - %TRUE if successful, %FALSE otherwise. @@ -8412,7 +7962,6 @@ Free-function: g_free Write @nbits bits of @value to #GstBitWriter. - %TRUE if successful, %FALSE otherwise. @@ -8434,7 +7983,6 @@ Free-function: g_free Write @nbytes bytes of @data to #GstBitWriter. - %TRUE if successful, %FALSE otherwise. @@ -8456,7 +8004,6 @@ Free-function: g_free Resets @bitwriter and frees the data if it's owned by @bitwriter. - @@ -8471,7 +8018,6 @@ Free-function: g_free Resets @bitwriter and returns the current data as #GstBuffer. Free-function: gst_buffer_unref - a new allocated #GstBuffer wrapping the current data. gst_buffer_unref() after usage. @@ -8488,7 +8034,6 @@ Free-function: gst_buffer_unref Resets @bitwriter and returns the current data. Free-function: g_free - the current data. g_free() after usage. @@ -8504,7 +8049,6 @@ Free-function: g_free - @@ -8521,7 +8065,6 @@ Free-function: g_free Creates a new, empty #GstBitWriter instance. Free-function: gst_bit_writer_free - a new, empty #GstByteWriter instance @@ -8533,7 +8076,6 @@ Free-function: gst_bit_writer_free #GstBitWriter from the beginning. Free-function: gst_bit_writer_free - a new #GstBitWriter instance @@ -8557,7 +8099,6 @@ Free-function: gst_bit_writer_free Creates a #GstBitWriter instance with the given initial data size. Free-function: gst_bit_writer_free - a new #GstBitWriter instance @@ -8581,7 +8122,6 @@ signed/unsigned, little/big endian integers of 8, 16, 24, 32 and 64 bits and functions for reading little/big endian floating points numbers of 32 and 64 bits. It also provides functions to read NUL-terminated strings in various character encodings. - Data from which the bit reader will read @@ -8608,7 +8148,6 @@ in various character encodings. Returns a newly-allocated copy of the current data position if at least @size bytes are left and updates the current position. Free with g_free() when no longer needed. - %TRUE if successful, %FALSE otherwise. @@ -8646,7 +8185,6 @@ This function will fail if no NUL-terminator was found in in the data. Note: there is no peek or get variant of this function to ensure correct byte alignment of the UTF-16 string. - %TRUE if a string could be read, %FALSE otherwise. The string put into @str must be freed with g_free() when no longer needed. @@ -8681,7 +8219,6 @@ This function will fail if no NUL-terminator was found in in the data. Note: there is no peek or get variant of this function to ensure correct byte alignment of the UTF-32 string. - %TRUE if a string could be read, %FALSE otherwise. The string put into @str must be freed with g_free() when no longer needed. @@ -8710,7 +8247,6 @@ for any NUL-terminated string with a character width of 8 bits, so ASCII, UTF-8, ISO-8859-N etc. No input checking for valid UTF-8 is done. This function will fail if no NUL-terminator was found in in the data. - %TRUE if a string could be read into @str, %FALSE otherwise. The string put into @str must be freed with g_free() when no longer needed. @@ -8733,7 +8269,6 @@ This function will fail if no NUL-terminator was found in in the data. Frees a #GstByteReader instance, which was previously allocated by gst_byte_reader_new(). - @@ -8748,7 +8283,6 @@ gst_byte_reader_new(). Returns a constant pointer to the current data position if at least @size bytes are left and updates the current position. - %TRUE if successful, %FALSE otherwise. @@ -8774,7 +8308,6 @@ updates the current position. Read a 32 bit big endian floating point value into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -8793,7 +8326,6 @@ and update the current position. Read a 32 bit little endian floating point value into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -8812,7 +8344,6 @@ and update the current position. Read a 64 bit big endian floating point value into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -8831,7 +8362,6 @@ and update the current position. Read a 64 bit little endian floating point value into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -8850,7 +8380,6 @@ and update the current position. Read a signed 16 bit big endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -8869,7 +8398,6 @@ and update the current position. Read a signed 16 bit little endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -8888,7 +8416,6 @@ and update the current position. Read a signed 24 bit big endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -8907,7 +8434,6 @@ and update the current position. Read a signed 24 bit little endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -8926,7 +8452,6 @@ and update the current position. Read a signed 32 bit big endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -8945,7 +8470,6 @@ and update the current position. Read a signed 32 bit little endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -8964,7 +8488,6 @@ and update the current position. Read a signed 64 bit big endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -8983,7 +8506,6 @@ and update the current position. Read a signed 64 bit little endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -9001,7 +8523,6 @@ and update the current position. Read a signed 8 bit integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -9019,7 +8540,6 @@ and update the current position. Returns the current position of a #GstByteReader instance in bytes. - The current position of @reader in bytes. @@ -9033,7 +8553,6 @@ and update the current position. Returns the remaining number of bytes of a #GstByteReader instance. - The remaining number of bytes of @reader instance. @@ -9047,7 +8566,6 @@ and update the current position. Returns the total number of bytes of a #GstByteReader instance. - The total number of bytes of @reader instance. @@ -9069,7 +8587,6 @@ UTF-8, ISO-8859-N etc. No input checking for valid UTF-8 is done. This function will fail if no NUL-terminator was found in in the data. - %TRUE if a string could be found, %FALSE otherwise. @@ -9095,7 +8612,6 @@ formats and make sure that one doesn't read beyond the size of the sub-chunk. Unlike gst_byte_reader_peek_sub_reader(), this function also modifies the position of @reader and moves it forward by @size bytes. - FALSE on error or if @reader does not contain @size more bytes from the current position, and otherwise TRUE @@ -9119,7 +8635,6 @@ position of @reader and moves it forward by @size bytes. Read an unsigned 16 bit big endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -9138,7 +8653,6 @@ and update the current position. Read an unsigned 16 bit little endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -9157,7 +8671,6 @@ and update the current position. Read an unsigned 24 bit big endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -9176,7 +8689,6 @@ and update the current position. Read an unsigned 24 bit little endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -9195,7 +8707,6 @@ and update the current position. Read an unsigned 32 bit big endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -9214,7 +8725,6 @@ and update the current position. Read an unsigned 32 bit little endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -9233,7 +8743,6 @@ and update the current position. Read an unsigned 64 bit big endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -9252,7 +8761,6 @@ and update the current position. Read an unsigned 64 bit little endian integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -9270,7 +8778,6 @@ and update the current position. Read an unsigned 8 bit integer into @val and update the current position. - %TRUE if successful, %FALSE otherwise. @@ -9289,7 +8796,6 @@ and update the current position. Initializes a #GstByteReader instance to read from @data. This function can be called on already initialized instances. - @@ -9322,7 +8828,6 @@ out. It is an error to call this function without making sure that there is enough data (offset+size bytes) in the byte reader. - offset of the first match, or -1 if no match was found. @@ -9382,7 +8887,6 @@ out. It is an error to call this function without making sure that there is enough data (offset+size bytes) in the byte reader. - offset of the first match, or -1 if no match was found. @@ -9419,7 +8923,6 @@ enough data (offset+size bytes) in the byte reader. Returns a constant pointer to the current data position if at least @size bytes are left and keeps the current position. - %TRUE if successful, %FALSE otherwise. @@ -9445,7 +8948,6 @@ keeps the current position. Read a 32 bit big endian floating point value into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9464,7 +8966,6 @@ but keep the current position. Read a 32 bit little endian floating point value into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9483,7 +8984,6 @@ but keep the current position. Read a 64 bit big endian floating point value into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9502,7 +9002,6 @@ but keep the current position. Read a 64 bit little endian floating point value into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9521,7 +9020,6 @@ but keep the current position. Read a signed 16 bit big endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9540,7 +9038,6 @@ but keep the current position. Read a signed 16 bit little endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9559,7 +9056,6 @@ but keep the current position. Read a signed 24 bit big endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9578,7 +9074,6 @@ but keep the current position. Read a signed 24 bit little endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9597,7 +9092,6 @@ but keep the current position. Read a signed 32 bit big endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9616,7 +9110,6 @@ but keep the current position. Read a signed 32 bit little endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9635,7 +9128,6 @@ but keep the current position. Read a signed 64 bit big endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9654,7 +9146,6 @@ but keep the current position. Read a signed 64 bit little endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9672,7 +9163,6 @@ but keep the current position. Read a signed 8 bit integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9698,7 +9188,6 @@ UTF-8, ISO-8859-N etc. No input checking for valid UTF-8 is done. This function will fail if no NUL-terminator was found in in the data. - %TRUE if a string could be skipped, %FALSE otherwise. @@ -9724,7 +9213,6 @@ formats and make sure that one doesn't read beyond the size of the sub-chunk. Unlike gst_byte_reader_get_sub_reader(), this function does not modify the current position of @reader. - FALSE on error or if @reader does not contain @size more bytes from the current position, and otherwise TRUE @@ -9748,7 +9236,6 @@ current position of @reader. Read an unsigned 16 bit big endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9767,7 +9254,6 @@ but keep the current position. Read an unsigned 16 bit little endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9786,7 +9272,6 @@ but keep the current position. Read an unsigned 24 bit big endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9805,7 +9290,6 @@ but keep the current position. Read an unsigned 24 bit little endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9824,7 +9308,6 @@ but keep the current position. Read an unsigned 32 bit big endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9843,7 +9326,6 @@ but keep the current position. Read an unsigned 32 bit little endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9862,7 +9344,6 @@ but keep the current position. Read an unsigned 64 bit big endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9881,7 +9362,6 @@ but keep the current position. Read an unsigned 64 bit little endian integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9899,7 +9379,6 @@ but keep the current position. Read an unsigned 8 bit integer into @val but keep the current position. - %TRUE if successful, %FALSE otherwise. @@ -9917,7 +9396,6 @@ but keep the current position. Sets the new position of a #GstByteReader instance to @pos in bytes. - %TRUE if the position could be set successfully, %FALSE otherwise. @@ -9936,7 +9414,6 @@ otherwise. Skips @nbytes bytes of the #GstByteReader instance. - %TRUE if @nbytes bytes could be skipped, %FALSE otherwise. @@ -9959,7 +9436,6 @@ advancing the current position to the byte after the string. No input checking for valid UTF-16 is done. This function will fail if no NUL-terminator was found in in the data. - %TRUE if a string could be skipped, %FALSE otherwise. @@ -9978,7 +9454,6 @@ advancing the current position to the byte after the string. No input checking for valid UTF-32 is done. This function will fail if no NUL-terminator was found in in the data. - %TRUE if a string could be skipped, %FALSE otherwise. @@ -9997,7 +9472,6 @@ any NUL-terminated string with a character width of 8 bits, so ASCII, UTF-8, ISO-8859-N etc. No input checking for valid UTF-8 is done. This function will fail if no NUL-terminator was found in in the data. - %TRUE if a string could be skipped, %FALSE otherwise. @@ -10013,7 +9487,6 @@ This function will fail if no NUL-terminator was found in in the data. Create a new #GstByteReader instance, which will read from @data. Free-function: gst_byte_reader_free - a new #GstByteReader instance @@ -10040,7 +9513,6 @@ for writing/reading signed/unsigned, little/big endian integers of 8, 16, 24, 32 and 64 bits and functions for reading little/big endian floating points numbers of 32 and 64 bits. It also provides functions to write/read NUL-terminated strings in various character encodings. - #GstByteReader parent @@ -10065,7 +9537,6 @@ in various character encodings. Checks if enough free space from the current write cursor is available and reallocates if necessary. - %TRUE if at least @size bytes are still available @@ -10083,7 +9554,6 @@ available and reallocates if necessary. Writes @size bytes containing @value to @writer. - %TRUE if the value could be written @@ -10105,7 +9575,6 @@ available and reallocates if necessary. Frees @writer and all memory allocated by it. - @@ -10121,7 +9590,6 @@ available and reallocates if necessary. the current data, which is returned as #GstBuffer. Free-function: gst_buffer_unref - the current data as buffer. gst_buffer_unref() after usage. @@ -10139,7 +9607,6 @@ Free-function: gst_buffer_unref the current data, which is returned. Free-function: g_free - the current data. g_free() after usage. @@ -10154,7 +9621,6 @@ Free-function: g_free Returns the remaining size of data that can still be written. If -1 is returned the remaining size is only limited by system resources. - the remaining size of data that can still be written @@ -10168,7 +9634,6 @@ Free-function: g_free Initializes @writer to an empty instance - @@ -10183,7 +9648,6 @@ Free-function: g_free Initializes @writer with the given memory area. If @initialized is %TRUE it is possible to read @size bytes from the #GstByteWriter from the beginning. - @@ -10210,7 +9674,6 @@ read @size bytes from the #GstByteWriter from the beginning. Initializes @writer with the given initial data size. - @@ -10231,7 +9694,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes @size bytes of @data to @writer. - %TRUE if the data could be written @@ -10257,7 +9719,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes @size bytes of @data to @writer. - %TRUE if the value could be written @@ -10281,7 +9742,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a big endian 32 bit float to @writer. - %TRUE if the value could be written @@ -10299,7 +9759,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a little endian 32 bit float to @writer. - %TRUE if the value could be written @@ -10317,7 +9776,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a big endian 64 bit float to @writer. - %TRUE if the value could be written @@ -10335,7 +9793,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a little endian 64 bit float to @writer. - %TRUE if the value could be written @@ -10353,7 +9810,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a signed big endian 16 bit integer to @writer. - %TRUE if the value could be written @@ -10371,7 +9827,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a signed little endian 16 bit integer to @writer. - %TRUE if the value could be written @@ -10389,7 +9844,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a signed big endian 24 bit integer to @writer. - %TRUE if the value could be written @@ -10407,7 +9861,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a signed little endian 24 bit integer to @writer. - %TRUE if the value could be written @@ -10425,7 +9878,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a signed big endian 32 bit integer to @writer. - %TRUE if the value could be written @@ -10443,7 +9895,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a signed little endian 32 bit integer to @writer. - %TRUE if the value could be written @@ -10461,7 +9912,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a signed big endian 64 bit integer to @writer. - %TRUE if the value could be written @@ -10479,7 +9929,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a signed little endian 64 bit integer to @writer. - %TRUE if the value could be written @@ -10497,7 +9946,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a signed 8 bit integer to @writer. - %TRUE if the value could be written @@ -10515,7 +9963,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a NUL-terminated UTF16 string to @writer (including the terminator). - %TRUE if the value could be written @@ -10535,7 +9982,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a NUL-terminated UTF32 string to @writer (including the terminator). - %TRUE if the value could be written @@ -10555,7 +10001,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a NUL-terminated UTF8 string to @writer (including the terminator). - %TRUE if the value could be written @@ -10573,7 +10018,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a unsigned big endian 16 bit integer to @writer. - %TRUE if the value could be written @@ -10591,7 +10035,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a unsigned little endian 16 bit integer to @writer. - %TRUE if the value could be written @@ -10609,7 +10052,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a unsigned big endian 24 bit integer to @writer. - %TRUE if the value could be written @@ -10627,7 +10069,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a unsigned little endian 24 bit integer to @writer. - %TRUE if the value could be written @@ -10645,7 +10086,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a unsigned big endian 32 bit integer to @writer. - %TRUE if the value could be written @@ -10663,7 +10103,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a unsigned little endian 32 bit integer to @writer. - %TRUE if the value could be written @@ -10681,7 +10120,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a unsigned big endian 64 bit integer to @writer. - %TRUE if the value could be written @@ -10699,7 +10137,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a unsigned little endian 64 bit integer to @writer. - %TRUE if the value could be written @@ -10717,7 +10154,6 @@ read @size bytes from the #GstByteWriter from the beginning. Writes a unsigned 8 bit integer to @writer. - %TRUE if the value could be written @@ -10736,7 +10172,6 @@ read @size bytes from the #GstByteWriter from the beginning. Resets @writer and frees the data if it's owned by @writer. - @@ -10751,7 +10186,6 @@ owned by @writer. Resets @writer and returns the current data as buffer. Free-function: gst_buffer_unref - the current data as buffer. gst_buffer_unref() after usage. @@ -10768,7 +10202,6 @@ Free-function: gst_buffer_unref Resets @writer and returns the current data. Free-function: g_free - the current data. g_free() after usage. @@ -10787,7 +10220,6 @@ usage. Creates a new, empty #GstByteWriter instance Free-function: gst_byte_writer_free - a new, empty #GstByteWriter instance @@ -10799,7 +10231,6 @@ memory area. If @initialized is %TRUE it is possible to read @size bytes from the #GstByteWriter from the beginning. Free-function: gst_byte_writer_free - a new #GstByteWriter instance @@ -10824,7 +10255,6 @@ Free-function: gst_byte_writer_free initial data size. Free-function: gst_byte_writer_free - a new #GstByteWriter instance @@ -10842,14 +10272,12 @@ Free-function: gst_byte_writer_free - - @@ -10862,7 +10290,6 @@ the buffer, this value is of type gint64 and may be negative. This allow properly handling streams with frame reordering where the first DTS may be negative. If the initial DTS was not set, this value will be set to %G_MININT64. - A #GstCollectData. @@ -10871,7 +10298,6 @@ set to %G_MININT64. Check if running DTS value store is valid. - A #GstCollectData. @@ -10879,7 +10305,6 @@ set to %G_MININT64. - @@ -10889,7 +10314,6 @@ set to %G_MININT64. Get the stream lock of @pads. The stream lock is used to coordinate and serialize execution among the various streams being collected, and in protecting the resources used to accomplish this. - a #GstCollectPads @@ -10899,7 +10323,6 @@ protecting the resources used to accomplish this. A flags word containing #GstCollectPadsStateFlags flags set on this collected pad. - a #GstCollectData. @@ -10908,7 +10331,6 @@ on this collected pad. Gives the status of a specific flag on a collected pad. - a #GstCollectData. @@ -10920,7 +10342,6 @@ on this collected pad. Sets a state flag on a collected pad. - a #GstCollectData. @@ -10932,7 +10353,6 @@ on this collected pad. Clears a state flag on a collected pad. - a #GstCollectData. @@ -10944,7 +10364,6 @@ on this collected pad. Lock the stream lock of @pads. - a #GstCollectPads @@ -10953,7 +10372,6 @@ on this collected pad. Unlock the stream lock of @pads. - a #GstCollectPads @@ -10962,7 +10380,6 @@ on this collected pad. Structure used by the collect_pads. - owner #GstCollectPads @@ -10990,9 +10407,7 @@ on this collected pad. - - @@ -11008,7 +10423,6 @@ on this collected pad. A function that will be called when the #GstCollectData will be freed. It is passed the pointer to the structure and should free any custom memory and resources allocated for it. - @@ -11019,9 +10433,7 @@ memory and resources allocated for it. - - - + Manages a set of pads that operate in collect mode. This means that control is given to the manager of this object when all pads have data. @@ -11059,12 +10471,10 @@ is given to the manager of this object when all pads have data. CollectPads element is not waiting for data to be collected on non-waiting pads. Thus these pads may but need not have data when the callback is called. All pads are in waiting mode by default. - Create a new instance of #GstCollectPads. MT safe. - a new #GstCollectPads, or %NULL in case of an error. @@ -11096,7 +10506,6 @@ The pad will be automatically activated in push mode when @pads is started. MT safe. - a new #GstCollectData to identify the new pad. Or %NULL if wrong parameters are supplied. @@ -11135,7 +10544,6 @@ This function should be called with @pads STREAM_LOCK held, such as in the callback. MT safe. - The maximum number of bytes queued on all pads. This function returns 0 if a pad has no queued buffer. @@ -11155,7 +10563,6 @@ to running time, or clips the buffer if outside configured segment. Since 1.6, this clipping function also sets the DTS parameter of the GstCollectData structure. This version of the running time DTS can be negative. G_MININT64 is used to indicate invalid value. - @@ -11186,7 +10593,6 @@ negative. G_MININT64 is used to indicate invalid value. Default #GstCollectPads event handling that elements should always chain up to to ensure proper operation. Element might however indicate event should not be forwarded downstream. - @@ -11216,7 +10622,6 @@ This function should be called with @pads STREAM_LOCK held, such as in the callback. MT safe. - The number of bytes flushed This can be less than @size and is 0 if the pad was end-of-stream. @@ -11243,7 +10648,6 @@ should be called with the @pads STREAM_LOCK held, such as in the callback handler. MT safe. - The buffer in @data or %NULL if no buffer is queued. should unref the buffer after usage. @@ -11266,7 +10670,6 @@ should be called with the @pads STREAM_LOCK held, such as in the callback handler. MT safe. - The buffer in @data or %NULL if no buffer was queued. You should unref the buffer after usage. @@ -11287,7 +10690,6 @@ buffer was queued. You should unref the buffer after usage. Default #GstCollectPads query handling that elements should always chain up to to ensure proper operation. Element might however indicate query should not be forwarded downstream. - @@ -11317,7 +10719,6 @@ This function should be called with @pads STREAM_LOCK held, such as in the callback. MT safe. - A sub buffer. The size of the buffer can be less that requested. A return of %NULL signals that the pad is @@ -11347,7 +10748,6 @@ gst_collect_pads_add_pad(). The pad will be deactivated automatically when @pads is stopped. MT safe. - %TRUE if the pad could be removed. @@ -11370,7 +10770,6 @@ If a buffer is passed, the callback owns a reference and must unref it. MT safe. - @@ -11392,7 +10791,6 @@ MT safe. Install a clipping function that is called right after a buffer is received on a pad managed by @pads. See #GstCollectPadsClipFunction for more info. - @@ -11415,7 +10813,6 @@ on a pad managed by @pads. See #GstCollectPadsClipFunction for more info. Set the timestamp comparison function. MT safe. - @@ -11443,7 +10840,6 @@ held when calling a number of CollectPads functions, it should be acquired if so (unusually) needed. MT safe. - @@ -11466,7 +10862,6 @@ MT safe. Install a flush function that is called when the internal state of all pads should be flushed as part of flushing seek handling. See #GstCollectPadsFlushFunction for more info. - @@ -11493,7 +10888,6 @@ Caller must ensure that downstream streaming (thread) is not blocked, e.g. by sending a FLUSH_START downstream. MT safe. - @@ -11520,7 +10914,6 @@ gst_collect_pads_set_buffer_function() callback. If this callback is set, the former will be unset. MT safe. - @@ -11548,7 +10941,6 @@ held when calling a number of CollectPads functions, it should be acquired if so (unusually) needed. MT safe. - @@ -11576,7 +10968,6 @@ This function should be called with @pads STREAM_LOCK held, such as in the callback. MT safe. - @@ -11600,7 +10991,6 @@ MT safe. Default #GstCollectPads event handling for the src pad of elements. Elements can chain up to this to let flushing seek event handling be done by #GstCollectPads. - @@ -11623,7 +11013,6 @@ be done by #GstCollectPads. Starts the processing of data in the collect_pads. MT safe. - @@ -11639,7 +11028,6 @@ MT safe. will also unblock any blocking operations. MT safe. - @@ -11658,7 +11046,6 @@ This function should be called with @pads STREAM_LOCK held, such as in the callback. MT safe. - A sub buffer. The size of the buffer can be less that requested. A return of %NULL signals that the pad is @@ -11706,7 +11093,6 @@ end-of-stream. Unref the buffer after use. A function that will be called when a (considered oldest) buffer can be muxed. If all pads have reached EOS, this function is called with %NULL @buffer and %NULL @data. - %GST_FLOW_OK for success @@ -11731,7 +11117,6 @@ and %NULL @data. - @@ -11750,7 +11135,6 @@ the pad to perform clipping of @inbuffer. This function takes ownership of @inbuffer and should output a buffer in @outbuffer or return %NULL in @outbuffer if the buffer should be dropped. - a #GstFlowReturn that corresponds to the result of clipping. @@ -11780,7 +11164,6 @@ This function takes ownership of @inbuffer and should output a buffer in A function for comparing two timestamps of buffers or newsegments collected on one pad. - Integer less than zero when first timestamp is deemed older than the second one. Zero if the timestamps are deemed equally old. @@ -11819,7 +11202,6 @@ This function takes ownership of @inbuffer and should output a buffer in ownership of the event and is responsible for chaining up (to gst_collect_pads_event_default()) or dropping events (such typical cases being handled by the default handler). - %TRUE if the pad could handle the event @@ -11850,7 +11232,6 @@ The function should flush any internal state of the element and the state of all the pads. It should clear only the state not directly managed by the @pads object. It is therefore not necessary to call gst_collect_pads_set_flushing nor gst_collect_pads_clear from this function. - @@ -11867,7 +11248,6 @@ gst_collect_pads_set_flushing nor gst_collect_pads_clear from this function. A function that will be called when all pads have received data. - %GST_FLOW_OK for success @@ -11883,14 +11263,11 @@ gst_collect_pads_set_flushing nor gst_collect_pads_clear from this function. - - - + A function that will be called while processing a query. It takes ownership of the query and is responsible for chaining up (to events downstream (with gst_pad_event_default()). - %TRUE if the pad could handle the event @@ -11915,7 +11292,6 @@ events downstream (with gst_pad_event_default()). - Set if collectdata's pad is EOS. @@ -11937,14 +11313,12 @@ events downstream (with gst_pad_event_default()). - - @@ -11954,13 +11328,11 @@ events downstream (with gst_pad_event_default()). #GstDataQueue is an object that handles threadsafe queueing of objects. It also provides size-related functionality. This object should be used for any #GstElement that wishes to provide some sort of queueing functionality. - Creates a new #GstDataQueue. If @fullcallback or @emptycallback are supplied, then the #GstDataQueue will call the respective callback to signal full or empty condition. If the callbacks are NULL the #GstDataQueue will instead emit 'full' and 'empty' signals. - a new #GstDataQueue. @@ -11987,7 +11359,6 @@ or not. - @@ -11998,7 +11369,6 @@ or not. - @@ -12010,7 +11380,6 @@ or not. Pop and unref the head-most #GstMiniObject with the given #GType. - %TRUE if an element was removed. @@ -12030,7 +11399,6 @@ or not. Flushes all the contents of the @queue. Any call to #gst_data_queue_push and #gst_data_queue_pop will be released. MT safe. - @@ -12043,7 +11411,6 @@ MT safe. Get the current level of the queue. - @@ -12061,7 +11428,6 @@ MT safe. Queries if there are any items in the @queue. MT safe. - %TRUE if @queue is empty. @@ -12077,7 +11443,6 @@ MT safe. Queries if @queue is full. This check will be done using the #GstDataQueueCheckFullFunction registered with @queue. MT safe. - %TRUE if @queue is full. @@ -12092,7 +11457,6 @@ MT safe. Inform the queue that the limits for the fullness check have changed and that any blocking gst_data_queue_push() should be unblocked to recheck the limits. - @@ -12108,7 +11472,6 @@ any blocking gst_data_queue_push() should be unblocked to recheck the limits. - %TRUE if an @item was successfully retrieved from the @queue. @@ -12129,7 +11492,6 @@ MT safe. empty, the call will block until at least one item is available, OR the @queue is set to the flushing state. MT safe. - %TRUE if an @item was successfully retrieved from the @queue. @@ -12155,7 +11517,6 @@ Note that this function has slightly different semantics than gst_pad_push() and gst_pad_push_event(): this function only takes ownership of @item and the #GstMiniObject contained in @item if the push was successful. If %FALSE is returned, the caller is responsible for freeing @item and its contents. - %TRUE if the @item was successfully pushed on the @queue. @@ -12181,7 +11542,6 @@ Note that this function has slightly different semantics than gst_pad_push() and gst_pad_push_event(): this function only takes ownership of @item and the #GstMiniObject contained in @item if the push was successful. If %FALSE is returned, the caller is responsible for freeing @item and its contents. - %TRUE if the @item was successfully pushed on the @queue. @@ -12205,7 +11565,6 @@ away with a return value of %FALSE. While the @queue is in flushing state, all calls to those two functions will return %FALSE. MT Safe. - @@ -12263,7 +11622,6 @@ properties. The prototype of the function used to inform the queue that it should be considered as full. - %TRUE if the queue should be considered full. @@ -12292,13 +11650,11 @@ considered as full. - - @@ -12311,7 +11667,6 @@ considered as full. - @@ -12329,7 +11684,6 @@ considered as full. - @@ -12343,7 +11697,6 @@ considered as full. - @@ -12359,7 +11712,6 @@ considered as full. Structure used by #GstDataQueue. You can supply a different structure, as long as the top of the structure is identical to this structure. - the #GstMiniObject to queue. @@ -12389,12 +11741,9 @@ This function should also drop the reference to @object the owner of the - - - + Structure describing the size of a queue. - number of buffers @@ -12440,10 +11789,8 @@ These rules are: %GST_FLOW_ERROR or below, GST_FLOW_NOT_NEGOTIATED and GST_FLOW_FLUSHING are returned immediately from the gst_flow_combiner_update_flow() function. - Creates a new #GstFlowCombiner, use gst_flow_combiner_free() to free it. - A new #GstFlowCombiner @@ -12451,7 +11798,6 @@ returned immediately from the gst_flow_combiner_update_flow() function. Adds a new #GstPad to the #GstFlowCombiner. - @@ -12468,7 +11814,6 @@ returned immediately from the gst_flow_combiner_update_flow() function. Removes all pads from a #GstFlowCombiner and resets it to its initial state. - @@ -12481,7 +11826,6 @@ returned immediately from the gst_flow_combiner_update_flow() function. Frees a #GstFlowCombiner struct and all its internal data. - @@ -12494,7 +11838,6 @@ returned immediately from the gst_flow_combiner_update_flow() function. Increments the reference count on the #GstFlowCombiner. - the #GstFlowCombiner. @@ -12508,7 +11851,6 @@ returned immediately from the gst_flow_combiner_update_flow() function. Removes a #GstPad from the #GstFlowCombiner. - @@ -12525,7 +11867,6 @@ returned immediately from the gst_flow_combiner_update_flow() function. Reset flow combiner and all pads to their initial state without removing pads. - @@ -12538,7 +11879,6 @@ returned immediately from the gst_flow_combiner_update_flow() function. Decrements the reference count on the #GstFlowCombiner. - @@ -12556,7 +11896,6 @@ The #GstFlowReturn parameter should be the last flow return update for a pad in this #GstFlowCombiner. It will use this value to be able to shortcut some combinations and avoid looking over all pads again. e.g. The last combined return is the same as the latest obtained #GstFlowReturn. - The combined #GstFlowReturn @@ -12580,7 +11919,6 @@ The #GstFlowReturn parameter should be the last flow return update for a pad in this #GstFlowCombiner. It will use this value to be able to shortcut some combinations and avoid looking over all pads again. e.g. The last combined return is the same as the latest obtained #GstFlowReturn. - The combined #GstFlowReturn @@ -12602,161 +11940,138 @@ return is the same as the latest obtained #GstFlowReturn. - - - - - - - - - - - - - - - - - - - - - - - @@ -12782,9 +12097,7 @@ addition to the ::create method. Seeking, flushing, scheduling and sync is all handled by this base class. - - @@ -12798,7 +12111,6 @@ base class. - @@ -12812,7 +12124,6 @@ base class. - @@ -12838,14 +12149,12 @@ base class. Subclasses can override any of the available virtual methods or not, as needed. At the minimum, the @fill method should be overridden to produce buffers. - Element parent class - @@ -12861,7 +12170,6 @@ buffers. - @@ -12877,7 +12185,6 @@ buffers. - @@ -12901,10 +12208,8 @@ buffers. #GstQueueArray is an object that provides standard queue functionality based on an array instead of linked lists. This reduces the overhead caused by memory management by a large factor. - Clears queue @array and frees all memory associated to it. - @@ -12917,7 +12222,6 @@ caused by memory management by a large factor. Drops the queue element at position @idx from queue @array. - the dropped element @@ -12937,7 +12241,6 @@ caused by memory management by a large factor. Drops the queue element at position @idx from queue @array and copies the data of the element or structure that was removed into @p_struct if @p_struct is set (not NULL). - TRUE on success, or FALSE on error @@ -12961,7 +12264,6 @@ data of the element or structure that was removed into @p_struct if Finds an element in the queue @array, either by comparing every element with @func or by looking up @data if no compare function @func is provided, and returning the index of the found element. - Index of the found element or -1 if nothing was found. @@ -12983,7 +12285,6 @@ and returning the index of the found element. Frees queue @array and all memory associated to it. - @@ -12996,7 +12297,6 @@ and returning the index of the found element. Returns the length of the queue @array - the length of the queue @array. @@ -13010,7 +12310,6 @@ and returning the index of the found element. Checks if the queue @array is empty. - %TRUE if the queue @array is empty @@ -13025,7 +12324,6 @@ and returning the index of the found element. Returns the head of the queue @array and does not remove it from the queue. - The head of the queue @@ -13039,7 +12337,6 @@ remove it from the queue. Returns the head of the queue @array without removing it from the queue. - pointer to element or struct, or NULL if @array was empty. The data pointed to by the returned pointer stays valid only as long as @@ -13055,7 +12352,6 @@ remove it from the queue. Returns the item at @idx in @array, but does not remove it from the queue. - The item, or %NULL if @idx was out of bounds @@ -13071,7 +12367,6 @@ remove it from the queue. Returns the item at @idx in @array, but does not remove it from the queue. - The item, or %NULL if @idx was out of bounds @@ -13087,7 +12382,6 @@ remove it from the queue. Returns the tail of the queue @array, but does not remove it from the queue. - The tail of the queue @@ -13101,7 +12395,6 @@ remove it from the queue. Returns the tail of the queue @array, but does not remove it from the queue. - The tail of the queue @@ -13116,7 +12409,6 @@ remove it from the queue. Returns and head of the queue @array and removes it from the queue. - The head of the queue @@ -13130,7 +12422,6 @@ it from the queue. Returns the head of the queue @array and removes it from the queue. - pointer to element or struct, or NULL if @array was empty. The data pointed to by the returned pointer stays valid only as long as @@ -13147,7 +12438,6 @@ it from the queue. Returns the tail of the queue @array and removes it from the queue. - The tail of the queue @@ -13162,7 +12452,6 @@ it from the queue. Returns the tail of the queue @array and removes it from the queue. - The tail of the queue @@ -13176,7 +12465,6 @@ it from the queue. Pushes @data to the tail of the queue @array. - @@ -13192,7 +12480,6 @@ it from the queue. - @@ -13216,7 +12503,6 @@ pointer to the element to clear, rather than the element itself. Note that in contrast with other uses of #GDestroyNotify functions, @clear_func is expected to clear the contents of the array element it is given, but not free the element itself. - @@ -13234,7 +12520,6 @@ the array element it is given, but not free the element itself. Allocates a new #GstQueueArray object with an initial queue size of @initial_size. - a new #GstQueueArray object @@ -13249,7 +12534,6 @@ queue size of @initial_size. Allocates a new #GstQueueArray object for elements (e.g. structures) of size @struct_size, with an initial queue size of @initial_size. - a new #GstQueueArray object @@ -13274,7 +12558,6 @@ stored in @buffer. The contents of @buffer is invalid for any other return value. This function is supposed to behave exactly like a #GstPadGetRangeFunction. - GST_FLOW_OK for success @@ -13306,7 +12589,6 @@ This function is supposed to behave exactly like a #GstPadGetRangeFunction.Create a new #GstBitReader instance, which will read from @data. Free-function: gst_bit_reader_free - a new #GstBitReader instance @@ -13329,7 +12611,6 @@ Free-function: gst_bit_reader_free Creates a new, empty #GstBitWriter instance. Free-function: gst_bit_writer_free - a new, empty #GstByteWriter instance @@ -13341,7 +12622,6 @@ Free-function: gst_bit_writer_free #GstBitWriter from the beginning. Free-function: gst_bit_writer_free - a new #GstBitWriter instance @@ -13365,7 +12645,6 @@ Free-function: gst_bit_writer_free Creates a #GstBitWriter instance with the given initial data size. Free-function: gst_bit_writer_free - a new #GstBitWriter instance @@ -13382,7 +12661,6 @@ Free-function: gst_bit_writer_free - @@ -13391,7 +12669,6 @@ Free-function: gst_bit_writer_free - @@ -13403,7 +12680,6 @@ Free-function: gst_bit_writer_free Create a new #GstByteReader instance, which will read from @data. Free-function: gst_byte_reader_free - a new #GstByteReader instance @@ -13430,7 +12706,6 @@ NUL-terminated string with a character width of 8 bits, so ASCII, UTF-8, ISO-8859-N etc. This function will fail if no NUL-terminator was found in in the data. - a #GstByteReader instance @@ -13448,7 +12723,6 @@ any NUL-terminated string with a character width of 8 bits, so ASCII, UTF-8, ISO-8859-N etc. This function will fail if no NUL-terminator was found in in the data. - a #GstByteReader instance @@ -13459,7 +12733,6 @@ This function will fail if no NUL-terminator was found in in the data. Creates a new, empty #GstByteWriter instance Free-function: gst_byte_writer_free - a new, empty #GstByteWriter instance @@ -13471,7 +12744,6 @@ memory area. If @initialized is %TRUE it is possible to read @size bytes from the #GstByteWriter from the beginning. Free-function: gst_byte_writer_free - a new #GstByteWriter instance @@ -13496,7 +12768,6 @@ Free-function: gst_byte_writer_free initial data size. Free-function: gst_byte_writer_free - a new #GstByteWriter instance @@ -13516,7 +12787,6 @@ Free-function: gst_byte_writer_free Write a NUL-terminated string to @writer (including the terminator). The string is assumed to be in an 8-bit encoding (e.g. ASCII,UTF-8 or ISO-8859-1). - #GstByteWriter instance @@ -13535,7 +12805,6 @@ typefinding in push mode from a chain function. Allocates a new #GstQueueArray object with an initial queue size of @initial_size. - a new #GstQueueArray object @@ -13550,7 +12819,6 @@ queue size of @initial_size. Allocates a new #GstQueueArray object for elements (e.g. structures) of size @struct_size, with an initial queue size of @initial_size. - a new #GstQueueArray object @@ -13570,7 +12838,6 @@ of size @struct_size, with an initial queue size of @initial_size. Tries to find what type of data is flowing from the given source #GstPad. Free-function: gst_caps_unref - the #GstCaps corresponding to the data stream. Returns %NULL if no #GstCaps matches the data stream. @@ -13600,7 +12867,6 @@ and the caps with the highest probability will be returned, or %NULL if the content of the buffer could not be identified. Free-function: gst_caps_unref - the #GstCaps corresponding to the data, or %NULL if no type could be found. The caller should free the caps @@ -13640,7 +12906,6 @@ functions for the given extension, which might speed up the typefinding in many cases. Free-function: gst_caps_unref - the #GstCaps corresponding to the data, or %NULL if no type could be found. The caller should free the caps @@ -13680,7 +12945,6 @@ and the caps with the highest probability will be returned, or %NULL if the content of @data could not be identified. Free-function: gst_caps_unref - the #GstCaps corresponding to the data, or %NULL if no type could be found. The caller should free the caps @@ -13726,7 +12990,6 @@ functions for the given extension, which might speed up the typefinding in many cases. Free-function: gst_caps_unref - the #GstCaps corresponding to the data, or %NULL if no type could be found. The caller should free the caps @@ -13767,7 +13030,6 @@ of rank. The caps of the first typefinder that can handle @extension will be returned. Free-function: gst_caps_unref - the #GstCaps corresponding to @extension, or %NULL if no type could be found. The caller should free @@ -13800,7 +13062,6 @@ functions for the given extension, which might speed up the typefinding in many cases. Free-function: gst_caps_unref - the #GstCaps corresponding to the data stream. Returns %NULL if no #GstCaps matches the data stream. @@ -13848,7 +13109,6 @@ tag size, for example). When @extension is not %NULL, this function will first try the typefind functions for the given extension, which might speed up the typefinding in many cases. - the last %GstFlowReturn from pulling a buffer or %GST_FLOW_OK if typefinding was successful. diff --git a/gir-files/GstCheck-1.0.gir b/gir-files/GstCheck-1.0.gir index 6b32e7c06..891bfdfe2 100644 --- a/gir-files/GstCheck-1.0.gir +++ b/gir-files/GstCheck-1.0.gir @@ -11,15 +11,11 @@ and/or use gtk-doc annotations. --> - - - - #GstHarness is meant to make writing unit test for GStreamer much easier. It can be thought of as a way of treating a #GstElement as a black box, @@ -111,7 +107,6 @@ and then feeding it data with: |[<!-- language="C" --> gst_harness_push_from_src (h); ]| - the element inside the harness @@ -139,7 +134,6 @@ gst_harness_push_from_src (h); Adds a #GstElement to an empty #GstHarness MT safe. - @@ -181,7 +175,6 @@ srcpad that is then linked to the harness sinkpad, similar to the Links the specified #GstPad the @GstHarness srcpad. MT safe. - @@ -202,7 +195,6 @@ perhaps the srcpad did not exist at the time of creating the harness, like a demuxer that provides a sometimes-pad after receiving data. MT safe. - @@ -222,7 +214,6 @@ MT safe. and then attches the supplied #GstHarness to the bin. MT safe. - @@ -243,7 +234,6 @@ MT safe. by using normal gst_pad_add_probe syntax MT safe. - @@ -283,7 +273,6 @@ MT safe. receiving an allocation query. MT safe. - @@ -307,7 +296,6 @@ MT safe. directly create a sink-harness using the @sink_element_name name specified. MT safe. - @@ -333,7 +321,6 @@ this is better achieved using gst_harness_new directly on the sink. If a sink-harness already exists it will be replaced. MT safe. - @@ -353,7 +340,6 @@ MT safe. instead of just an element name. See gst_harness_add_src_parse for details. MT safe. - @@ -373,7 +359,6 @@ MT safe. directly create a src-harness using the @src_element_name name specified. MT safe. - @@ -405,7 +390,6 @@ spin out of control producing buffers as fast as possible. If a src-harness already exists it will be replaced. MT safe. - @@ -433,7 +417,6 @@ data), but also by allowing you to set properties like "is-live" directly on the elements. MT safe. - @@ -457,7 +440,6 @@ gst_clock_wait_id internally. The number of #GstBuffers currently in the #GstHarness sinkpad #GAsyncQueue MT safe. - a #guint number of buffers in the queue @@ -475,7 +457,6 @@ This number includes buffers that have been dropped as well as buffers that have already been pulled out. MT safe. - a #guint number of buffers received @@ -496,7 +477,6 @@ same time, ensuring that one thread can't register another wait before both are released. MT safe. - a @gboolean %TRUE if the "crank" was successful, %FALSE if not. @@ -523,7 +503,6 @@ that are dependent on this. A "crank" can be though of as the notion of manually driving the clock forward to its next logical step. MT safe. - a @gboolean %TRUE if the "crank" was successful, %FALSE if not. @@ -540,7 +519,6 @@ MT safe. configured #GstAllocator and #GstAllocationParams MT safe. - a #GstBuffer of size @size @@ -561,7 +539,6 @@ MT safe. to a file. MT safe. - @@ -580,7 +557,6 @@ MT safe. The number of #GstEvents currently in the #GstHarness sinkpad #GAsyncQueue MT safe. - a #guint number of events in the queue @@ -598,7 +574,6 @@ This number includes events handled by the harness as well as events that have already been pulled out. MT safe. - a #guint number of events received @@ -617,7 +592,6 @@ MT safe. harnessed elements for properties and/or signals. MT safe. - a #GstElement or %NULL if not found @@ -639,7 +613,6 @@ that are residing inside the #GstHarness, by using normal g_object_get syntax. MT safe. - @@ -668,7 +641,6 @@ MT safe. allocation query. MT safe. - @@ -693,7 +665,6 @@ MT safe. typically with gst_harness_push or gst_harness_push_from_src. MT safe. - a #GstClockTime with the timestamp or %GST_CLOCK_TIME_NONE if no #GstBuffer has been pushed on the #GstHarness srcpad @@ -711,7 +682,6 @@ MT safe. needed. MT safe. - a #GstTestClock, or %NULL if the testclock is not present. @@ -734,7 +704,6 @@ starting to produce buffers. Hence, for src #GstElement you must call gst_harness_play() explicitly. MT safe. - @@ -751,7 +720,6 @@ will timeout in 60 seconds. This is the standard way of getting a buffer from a harnessed #GstElement. MT safe. - a #GstBuffer or %NULL if timed out. @@ -768,7 +736,6 @@ MT safe. Timeouts after 60 seconds similar to gst_harness_pull. MT safe. - a #GstEvent or %NULL if timed out. @@ -784,7 +751,6 @@ MT safe. Pulls a #GstBuffer from the #GAsyncQueue on the #GstHarness sinkpad. The pull will block until an EOS event is received, or timeout in 60 seconds. MT safe. - %TRUE on success, %FALSE on timeout. @@ -806,7 +772,6 @@ MT safe. Timeouts after 60 seconds similar to gst_harness_pull. MT safe. - a #GstEvent or %NULL if timed out. @@ -823,7 +788,6 @@ MT safe. interacting with an harnessed element. MT safe. - a #GstFlowReturn with the result from the push @@ -845,7 +809,6 @@ the fact that you often want to do exactly this in your test: Push one buffer in, and inspect the outcome. MT safe. - a #GstBuffer or %NULL if timed out. @@ -865,7 +828,6 @@ MT safe. Pushes an #GstEvent on the #GstHarness srcpad. MT safe. - a #gboolean with the result from the push @@ -890,7 +852,6 @@ of 4 steps: 4: Push the same #GstBuffer into the main-#GstHarness (see: gst_harness_push) MT safe. - a #GstFlowReturn with the result of the push @@ -907,7 +868,6 @@ MT safe. See gst_harness_push_from_src for details. MT safe. - a #GstFlowReturn with the result of the push @@ -923,7 +883,6 @@ MT safe. Pushes an #GstEvent on the #GstHarness sinkpad. MT safe. - a #gboolean with the result from the push @@ -943,7 +902,6 @@ MT safe. Get the min latency reported by any harnessed #GstElement. MT safe. - a #GstClockTime with min latency @@ -961,7 +919,6 @@ that are residing inside the #GstHarness, by using normal g_object_set syntax. MT safe. - @@ -993,7 +950,6 @@ gst_clock_id_wait() so it can't be controlled by the #GstTestClock, since it otherwise would produce buffers as fast as possible. MT safe. - @@ -1008,7 +964,6 @@ MT safe. Sets the @GstHarness srcpad and sinkpad caps. MT safe. - @@ -1031,7 +986,6 @@ MT safe. Sets the @GstHarness srcpad and sinkpad caps using strings. MT safe. - @@ -1055,7 +1009,6 @@ MT safe. #GstElement inside the sinkpads #GAsyncQueue, they are instead unreffed. MT safe. - @@ -1086,7 +1039,6 @@ is providing data for the main-harness. Forwarding is enabled by default. MT safe. - @@ -1106,7 +1058,6 @@ MT safe. query. MT safe. - @@ -1129,7 +1080,6 @@ MT safe. Sets the @GstHarness sinkpad caps. MT safe. - @@ -1148,7 +1098,6 @@ MT safe. Sets the @GstHarness sinkpad caps using a string. MT safe. - @@ -1168,7 +1117,6 @@ MT safe. can legally be pushed from the harness to the element. MT safe. - @@ -1188,7 +1136,6 @@ MT safe. any buffers can legally be pushed from the harness to the element. MT safe. - @@ -1207,7 +1154,6 @@ MT safe. Advance the #GstTestClock to a specific time. MT safe. - a @gboolean %TRUE if the time could be set. %FALSE if not. @@ -1225,7 +1171,6 @@ MT safe. Sets the min latency reported by #GstHarness when receiving a latency-query - @@ -1245,7 +1190,6 @@ MT safe. Will abort the pushing if any one push fails. MT safe. - a #GstFlowReturn with the result of the push @@ -1269,7 +1213,6 @@ of data at the same time, as well as cases when one crank does not equal one buffer to push and v.v. MT safe. - a #GstFlowReturn with the result of the push @@ -1296,7 +1239,6 @@ some #GstEvents are being transferred automagically. Look at sink_forward_pad for details. MT safe. - a #gboolean with the result of the push @@ -1313,7 +1255,6 @@ MT safe. iteration allowing you to do something nasty. MT safe. - a #GstHarnessThread @@ -1346,7 +1287,6 @@ each call to the @callback Call g_object_set with @name and @value in intervals of @sleep microseconds MT safe. - a #GstHarnessThread @@ -1375,7 +1315,6 @@ each g_object_set with @name and @value Push a #GstBuffer in intervals of @sleep microseconds. MT safe. - a #GstHarnessThread @@ -1408,7 +1347,6 @@ each call to gst_pad_push Push a #GstBuffer returned by @func in intervals of @sleep microseconds. MT safe. - a #GstHarnessThread @@ -1451,7 +1389,6 @@ each call to gst_pad_push @sleep microseconds MT safe. - a #GstHarnessThread @@ -1477,7 +1414,6 @@ each gst_event_push with @event in intervals of @sleep microseconds. MT safe. - a #GstHarnessThread @@ -1512,7 +1448,6 @@ each call to gst_pad_push @sleep microseconds. MT safe. - a #GstHarnessThread @@ -1538,7 +1473,6 @@ each gst_event_push with @event in intervals of @sleep microseconds. MT safe. - a #GstHarnessThread @@ -1572,7 +1506,6 @@ each call to gst_pad_push Call gst_element_request_pad in intervals of @sleep microseconds MT safe. - a #GstHarnessThread @@ -1610,7 +1543,6 @@ each gst_element_request_pad back again, only pausing for @sleep microseconds every time. MT safe. - a #GstHarnessThread @@ -1630,7 +1562,6 @@ each state-change Pulls all pending data from the harness and returns it as a single data slice. - a pointer to the data, newly allocated. Free with g_free() when no longer needed. Will return %NULL if there is no @@ -1650,7 +1581,6 @@ data slice. Pulls all pending data from the harness and returns it as a single buffer. - the data as a buffer. Unref with gst_buffer_unref() when no longer needed. @@ -1665,7 +1595,6 @@ data slice. Pulls all pending data from the harness and returns it as a single #GBytes. - a pointer to the data, newly allocated. Free with g_free() when no longer needed. @@ -1682,7 +1611,6 @@ data slice. Tears down a @GstHarness, freeing all resources allocated using it. MT safe. - @@ -1699,7 +1627,6 @@ gst_harness_pull this will not wait for any buffers if not any are present, and return %NULL straight away. MT safe. - a #GstBuffer or %NULL if no buffers are present in the #GAsyncQueue @@ -1716,7 +1643,6 @@ MT safe. See gst_harness_try_pull for details. MT safe. - a #GstEvent or %NULL if no buffers are present in the #GAsyncQueue @@ -1733,7 +1659,6 @@ MT safe. See gst_harness_try_pull for details. MT safe. - a #GstEvent or %NULL if no buffers are present in the #GAsyncQueue @@ -1749,7 +1674,6 @@ MT safe. The number of #GstEvents currently in the #GstHarness srcpad #GAsyncQueue MT safe. - a #guint number of events in the queue @@ -1767,7 +1691,6 @@ This number includes events handled by the harness as well as events that have already been pulled out. MT safe. - a #guint number of events received @@ -1783,7 +1706,6 @@ MT safe. Sets the system #GstClock on the @GstHarness #GstElement MT safe. - @@ -1798,7 +1720,6 @@ MT safe. Sets the #GstTestClock on the #GstHarness #GstElement MT safe. - @@ -1816,7 +1737,6 @@ where you want to make sure that an expected number of waits have been reached. MT safe. - a @gboolean %TRUE if the waits have been registered, %FALSE if not. (Could be that it timed out waiting or that more waits than waits was found) @@ -1843,7 +1763,6 @@ the #GstTestClock assumes the #GstElement sinkpad is named "sink" and srcpad is named "src" MT safe. - a #GstHarness, or %NULL if the harness could not be created @@ -1861,7 +1780,6 @@ not be created an #GstElement to it. MT safe. - a #GstHarness, or %NULL if the harness could not be created @@ -1872,7 +1790,6 @@ not be created Creates a new harness. MT safe. - a #GstHarness, or %NULL if the harness could not be created @@ -1913,7 +1830,6 @@ srcpad that is then linked to the harness sinkpad, similar to the and then attches the harness to the bin. MT safe. - a #GstHarness, or %NULL if the harness could not be created @@ -1932,7 +1848,6 @@ that generic padtemplates are used for the harness src and sinkpads, which will be sufficient in most usecases. MT safe. - a #GstHarness, or %NULL if the harness could not be created @@ -1962,7 +1877,6 @@ srcpad except you specify the factoryname of the #GstElement MT safe. - a #GstHarness, or %NULL if the harness could not be created @@ -1992,7 +1906,6 @@ srcpad assumes the #GstElement sinkpad is named "sink" and srcpad is named "src" MT safe. - a #GstHarness, or %NULL if the harness could not be created @@ -2019,7 +1932,6 @@ not be created Stop the running #GstHarnessThread MT safe. - @@ -2032,7 +1944,6 @@ MT safe. - @@ -2048,7 +1959,6 @@ MT safe. - @@ -2063,22 +1973,17 @@ MT safe. - - - + Opaque handle representing a GstHarness stress testing thread. - - - @@ -2086,31 +1991,26 @@ MT safe. Opaque consistency checker handle. - - - - - @@ -2261,12 +2161,10 @@ clock notification. Since #GstTestClock is only supposed to be used in unit tests it calls g_assert(), g_assert_cmpint() or g_assert_cmpuint() to validate all function arguments. This will highlight any issues with the unit test code itself. - Creates a new test clock with its time set to zero. MT safe. - a #GstTestClock cast to #GstClock. @@ -2276,7 +2174,6 @@ MT safe. Creates a new test clock with its time set to the specified time. MT safe. - a #GstTestClock cast to #GstClock. @@ -2292,7 +2189,6 @@ MT safe. Finds the latest time inside the list. MT safe. - @@ -2312,7 +2208,6 @@ time of @test_clock is monotonically increasing, therefore providing a @delta which is negative or zero is a programming error. MT safe. - @@ -2335,7 +2230,6 @@ MT safe. 3: Release the #GstClockID wait. A "crank" can be though of as the notion of manually driving the clock forward to its next logical step. - %TRUE if the crank was successful, %FALSE otherwise. @@ -2353,7 +2247,6 @@ MT safe. Retrieve the requested time for the next pending clock notification. MT safe. - a #GstClockTime set to the time of the next pending clock notification. If no clock notifications have been requested @@ -2372,7 +2265,6 @@ notification. If no clock notifications have been requested given by @id. MT safe. - %TRUE if the clock has been asked to provide the given clock notification, %FALSE otherwise. @@ -2394,7 +2286,6 @@ notification, %FALSE otherwise. requested from the @test_clock. MT safe. - the number of pending clock notifications. @@ -2411,7 +2302,6 @@ MT safe. be triggered given the current time of the @test_clock. MT safe. - %TRUE if @pending_id is the next clock notification to be triggered, %FALSE otherwise. @@ -2433,7 +2323,6 @@ notification to look for Processes and releases the pending ID. MT safe. - @@ -2452,7 +2341,6 @@ MT safe. Processes and releases the pending IDs in the list. MT safe. - @@ -2472,7 +2360,6 @@ MT safe. MT safe. - a #GstClockID containing the next pending clock notification. @@ -2493,7 +2380,6 @@ which is earlier or equal to the time of the clock as given by gst_clock_get_time() is a programming error. MT safe. - @@ -2513,7 +2399,6 @@ MT safe. @test_clock, or the timeout expires. MT safe. - a @gboolean %TRUE if the waits have been registered, %FALSE if not. (Could be that it timed out waiting or that more waits than waits was found) @@ -2548,7 +2433,6 @@ MT safe. #GstTestClock. MT safe. - @@ -2577,7 +2461,6 @@ timeout for this wait, see the main description of #GstTestClock. A reference to the pending clock notification is stored in @pending_id. MT safe. - @@ -2598,7 +2481,6 @@ with information about the pending clock notification @test_clock. There is no timeout for this wait, see the main description of #GstTestClock. use gst_test_clock_wait_for_multiple_pending_ids() instead. - @@ -2633,52 +2515,15 @@ this property contains the value 0. The class of a #GstTestClock, which has no virtual methods to override. - the parent class structure - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Sets up a data probe on the given pad which will raise assertions if the data flow is inconsistent. - %TRUE if the pad was added @@ -2696,7 +2541,6 @@ data flow is inconsistent. Frees the allocated data and probes associated with @consist. - @@ -2710,7 +2554,6 @@ data flow is inconsistent. Sets up a data probe on the given pad which will raise assertions if the data flow is inconsistent. - A #GstStreamConsistency structure used to track data flow. @@ -2724,7 +2567,6 @@ data flow is inconsistent. Reset the stream checker's internal variables. - @@ -2756,7 +2598,6 @@ inside the 'check' directories of various GStreamer packages. assumes the #GstElement sinkpad is named "sink" and srcpad is named "src" MT safe. - a #GstHarness, or %NULL if the harness could not be created @@ -2774,7 +2615,6 @@ not be created an #GstElement to it. MT safe. - a #GstHarness, or %NULL if the harness could not be created @@ -2785,7 +2625,6 @@ not be created Creates a new harness. MT safe. - a #GstHarness, or %NULL if the harness could not be created @@ -2826,7 +2665,6 @@ srcpad that is then linked to the harness sinkpad, similar to the and then attches the harness to the bin. MT safe. - a #GstHarness, or %NULL if the harness could not be created @@ -2845,7 +2683,6 @@ that generic padtemplates are used for the harness src and sinkpads, which will be sufficient in most usecases. MT safe. - a #GstHarness, or %NULL if the harness could not be created @@ -2875,7 +2712,6 @@ srcpad except you specify the factoryname of the #GstElement MT safe. - a #GstHarness, or %NULL if the harness could not be created @@ -2905,7 +2741,6 @@ srcpad assumes the #GstElement sinkpad is named "sink" and srcpad is named "src" MT safe. - a #GstHarness, or %NULL if the harness could not be created @@ -2929,7 +2764,6 @@ not be created - @@ -2940,7 +2774,6 @@ not be created - @@ -2953,7 +2786,6 @@ not be created - @@ -2970,7 +2802,6 @@ not be created - @@ -2979,7 +2810,6 @@ not be created - @@ -2992,7 +2822,6 @@ not be created - @@ -3007,7 +2836,6 @@ not be created - @@ -3016,7 +2844,6 @@ not be created - @@ -3029,7 +2856,6 @@ not be created - @@ -3039,7 +2865,6 @@ not be created Stop the running #GstHarnessThread MT safe. - diff --git a/gir-files/GstController-1.0.gir b/gir-files/GstController-1.0.gir index bd8460f3a..cab2ab512 100644 --- a/gir-files/GstController-1.0.gir +++ b/gir-files/GstController-1.0.gir @@ -14,11 +14,9 @@ and/or use gtk-doc annotations. --> A value mapping object that attaches multiple control sources to a guint gobject properties representing a color. A control value of 0.0 will turn the color component off and a value of 1.0 will be the color level. - Create a new control-binding that attaches the given #GstControlSource to the #GObject property. - the new #GstARGBControlBinding @@ -91,7 +89,6 @@ color component off and a value of 1.0 will be the color level. The class structure of #GstARGBControlBinding. - Parent class @@ -103,21 +100,18 @@ color component off and a value of 1.0 will be the color level. - - - @@ -127,7 +121,6 @@ color component off and a value of 1.0 will be the color level. An internal structure for value+time and various temporary values used for interpolation. This "inherits" from GstTimedValue. - timestamp of the value change @@ -137,9 +130,7 @@ GstTimedValue. - - @@ -148,7 +139,6 @@ GstTimedValue. - @@ -167,7 +157,6 @@ GstTimedValue. Copies a #GstControlPoint - A copy of @cp @@ -181,7 +170,6 @@ GstTimedValue. Frees all data allocated by a #GstControlPoint instance. - @@ -194,21 +182,18 @@ GstTimedValue. - - - @@ -221,12 +206,10 @@ non-absolute direct control binding is used, the value range [0.0 ... 1.0] is mapped to full target property range, and all values outside the range will be clipped. An absolute control binding will not do any value transformations. - Create a new control-binding that attaches the #GstControlSource to the #GObject property. It will map the control source range [0.0 ... 1.0] to the full target property range, and clip all values outside this range. - the new #GstDirectControlBinding @@ -250,7 +233,6 @@ the full target property range, and clip all values outside this range. Create a new control-binding that attaches the #GstControlSource to the #GObject property. It will directly map the control source values to the target property range without any transformations. - the new #GstDirectControlBinding @@ -298,14 +280,12 @@ target property range without any transformations. - - @@ -314,7 +294,6 @@ target property range without any transformations. The class structure of #GstDirectControlBinding. - Parent class @@ -327,7 +306,6 @@ target property range without any transformations. Function to map a control-value to the target GValue. - @@ -348,7 +326,6 @@ target property range without any transformations. Function to map a control-value to the target plain data type. - @@ -368,119 +345,102 @@ target property range without any transformations. - - - - - - - - - - - - - - - - - @@ -495,10 +455,8 @@ gst_interpolation_control_source_new(), bind it to a #GParamSpec and set some control points by calling gst_timed_value_control_source_set(). All functions are MT-safe. - This returns a new, unbound #GstInterpolationControlSource. - a new, unbound #GstInterpolationControlSource. @@ -520,7 +478,6 @@ All functions are MT-safe. - @@ -530,9 +487,7 @@ All functions are MT-safe. - - - + The various interpolation modes available. @@ -560,10 +515,8 @@ gst_lfo_control_source_new(), bind it to a #GParamSpec and set the relevant properties. All functions are MT-safe. - This returns a new, unbound #GstLFOControlSource. - a new, unbound #GstLFOControlSource. @@ -611,7 +564,6 @@ To get a n nanosecond shift to the left use - @@ -621,9 +573,7 @@ To get a n nanosecond shift to the left use - - - + The various waveform modes available. @@ -643,42 +593,36 @@ To get a n nanosecond shift to the left use - - - - - - @@ -686,12 +630,10 @@ To get a n nanosecond shift to the left use A #GstControlBinding that forwards requests to another #GstControlBinding - #GstProxyControlBinding forwards all access to data or `sync_values()` requests from @property_name on @object to the control binding at @ref_property_name on @ref_object. - a new #GstControlBinding that proxies the control interface between properties on different #GstObject's @@ -734,7 +676,6 @@ properties on different #GstObject's Opaque #GstProxyControlBindingClass struct - @@ -745,56 +686,48 @@ properties on different #GstObject's - - - - - - - - @@ -807,14 +740,12 @@ When overriding bind, chain up first to give this bind implementation a chance to setup things. All functions are MT-safe. - Find last value before given timestamp in control point list. If all values in the control point list come after the given timestamp or no values exist, %NULL is returned. For use in control source implementations. - the found #GSequenceIter or %NULL @@ -833,7 +764,6 @@ For use in control source implementations. Returns a read-only copy of the list of #GstTimedValue for the given property. Free the list after done with it. - a copy of the list, or %NULL if the property isn't handled by the controller @@ -850,7 +780,6 @@ of the list, or %NULL if the property isn't handled by the controller Get the number of control points that are set. - the number of control points that are set. @@ -864,7 +793,6 @@ of the list, or %NULL if the property isn't handled by the controller Set the value of given controller-handled property at a certain time. - FALSE if the values couldn't be set, TRUE otherwise. @@ -886,7 +814,6 @@ of the list, or %NULL if the property isn't handled by the controller Sets multiple timed values at once. - FALSE if the values couldn't be set, TRUE otherwise. @@ -908,7 +835,6 @@ with #GstTimedValue items Used to remove the value of given controller-handled property at a certain time. - FALSE if the value couldn't be unset (i.e. not found, TRUE otherwise. @@ -926,7 +852,6 @@ time. Used to remove all time-stamped values of given controller-handled property - @@ -998,7 +923,6 @@ time. - @@ -1008,9 +932,7 @@ time. - - - + #GstTriggerControlSource is a #GstControlSource, that returns values from user-given control points. It allows for a tolerance on the time-stamps. @@ -1020,10 +942,8 @@ gst_trigger_control_source_new(), bind it to a #GParamSpec and set some control points by calling gst_timed_value_control_source_set(). All functions are MT-safe. - This returns a new, unbound #GstTriggerControlSource. - a new, unbound #GstTriggerControlSource. @@ -1045,7 +965,6 @@ All functions are MT-safe. - @@ -1055,12 +974,9 @@ All functions are MT-safe. - - - + Reset the controlled value cache. - diff --git a/gir-files/GstGL-1.0.gir b/gir-files/GstGL-1.0.gir index aaae38e5f..093d18558 100644 --- a/gir-files/GstGL-1.0.gir +++ b/gir-files/GstGL-1.0.gir @@ -12,32 +12,26 @@ and/or use gtk-doc annotations. --> An option that can be activated on bufferpools to request OpenGL synchronization metadata on buffers from the pool. - String used for %GST_GL_TEXTURE_TARGET_2D as a #GstBufferPool pool option - String used for %GST_GL_TEXTURE_TARGET_EXTERNAL_OES as a #GstBufferPool pool option - String used for %GST_GL_TEXTURE_TARGET_RECTANGLE as a #GstBufferPool pool option - Name of the caps feature indicating the use of GL buffers - Name of the caps feature for indicating the use of #GstGLMemory - @@ -61,7 +55,6 @@ synchronization metadata on buffers from the pool. Any OpenGL API - The #GstGLAPI represented by @api_s @@ -74,7 +67,6 @@ synchronization metadata on buffers from the pool. - A space separated string of the OpenGL api's enabled in @api @@ -88,7 +80,6 @@ synchronization metadata on buffers from the pool. - the size of the struct (including and subclass data) @@ -139,7 +130,6 @@ synchronization metadata on buffers from the pool. - a copy of the #GstGLAllocationParams specified by @src or %NULL on failure @@ -155,7 +145,6 @@ synchronization metadata on buffers from the pool. Copies the dynamically allocated data from @src to @dest. Direct subclasses should call this function in their own overridden copy function. - @@ -172,7 +161,6 @@ should call this function in their own overridden copy function. Frees the #GstGLAllocationParams and all associated data. - @@ -186,7 +174,6 @@ should call this function in their own overridden copy function. Frees the dynamically allocated data in @params. Direct subclasses should call this function in their own overridden free function. - @@ -200,7 +187,6 @@ should call this function in their own overridden free function. @notify will be called once for each allocated memory using these @params when freeing the memory. - whether the parameters could be initialized @@ -260,7 +246,6 @@ when freeing the memory. Copies the parameters from @src into @dest. The subclass must compose copy functions from the superclass. - @@ -278,7 +263,6 @@ functions from the superclass. Free any dynamically allocated data. The subclass must call the superclass' free. - @@ -292,7 +276,6 @@ free. #GstGLAsyncDebug an opaque structure and should only be accessed through the provided API. - @@ -333,7 +316,6 @@ provided API. Frees @ad - @@ -349,7 +331,6 @@ provided API. gst_gl_async_debug_output_log_msg() will not output any messages but subsequent calls to gst_gl_async_debug_store_log_msg() will overwrite previous messages. - @@ -363,7 +344,6 @@ messages. Initialize @ad. Intended for use with #GstGLAsyncDebug's that are embedded in other structs. - @@ -376,7 +356,6 @@ in other structs. Outputs a previously stored debug message. - @@ -389,7 +368,6 @@ in other structs. Stores a debug message for later output by gst_gl_async_debug_output_log_msg() - @@ -434,7 +412,6 @@ in other structs. Stores a debug message for later output by gst_gl_async_debug_output_log_msg() - @@ -479,7 +456,6 @@ in other structs. unfreeze the debug output. See gst_gl_async_debug_freeze() for what freezing means - @@ -493,7 +469,6 @@ in other structs. Unset any dynamically allocated data. Intended for use with #GstGLAsyncDebug's that are embedded in other structs. - @@ -506,7 +481,6 @@ in other structs. Free with gst_gl_async_debug_free() - a new #GstGLAsyncDebug @@ -514,7 +488,6 @@ in other structs. - @@ -529,9 +502,7 @@ in other structs. context. It also provided some wrappers around #GstBaseTransform's `start()`, `stop()` and `set_caps()` virtual methods that ensure an OpenGL context is available and current in the calling thread. - - @@ -548,7 +519,6 @@ context is available and current in the calling thread. - @@ -559,7 +529,6 @@ context is available and current in the calling thread. - @@ -570,7 +539,6 @@ context is available and current in the calling thread. - Whether an OpenGL context could be retrieved or created successfully @@ -583,7 +551,6 @@ context is available and current in the calling thread. - the #GstGLContext found by @filter @@ -628,7 +595,6 @@ context is available and current in the calling thread. The base class for GStreamer GL Filter. - @@ -638,7 +604,6 @@ context is available and current in the calling thread. - @@ -651,7 +616,6 @@ context is available and current in the calling thread. - @@ -664,7 +628,6 @@ context is available and current in the calling thread. - @@ -687,15 +650,12 @@ context is available and current in the calling thread. - - - + GstGLBaseMemory is a #GstMemory subclass providing the basis of support for the mapping of GL buffers. Data is uploaded or downloaded from the GPU as is necessary. - the parent object @@ -743,7 +703,6 @@ Data is uploaded or downloaded from the GPU as is necessary. Note: only intended for subclass usage to allocate the system memory buffer on demand. If there is already a non-NULL data pointer in @gl_mem->data, then this function imply returns TRUE. - whether the system memory could be allocated @@ -757,7 +716,6 @@ then this function imply returns TRUE. Initializes @mem with the required parameters - @@ -797,7 +755,6 @@ then this function imply returns TRUE. - whether the copy succeeded. @@ -822,7 +779,6 @@ then this function imply returns TRUE. - a new #GstGLBaseMemory from @allocator with the requested @params. @@ -841,7 +797,6 @@ then this function imply returns TRUE. Initializes the GL Base Memory allocator. It is safe to call this function multiple times. This must be called before any other GstGLBaseMemory operation. - @@ -849,9 +804,7 @@ multiple times. This must be called before any other GstGLBaseMemory operation. Opaque #GstGLBaseMemoryAllocator struct - - a newly allocated #GstGLBaseMemory from @allocator and @params @@ -881,7 +834,6 @@ multiple times. This must be called before any other GstGLBaseMemory operation. Note: not called with a GL context current - a newly allocated #GstGLBaseMemory from @allocator and @params @@ -898,7 +850,6 @@ multiple times. This must be called before any other GstGLBaseMemory operation. - the parent class @@ -935,7 +886,6 @@ multiple times. This must be called before any other GstGLBaseMemory operation. Also see gst_memory_copy(); - the newly copied #GstGLMemory or %NULL @@ -958,7 +908,6 @@ multiple times. This must be called before any other GstGLBaseMemory operation. As this virtual method is called with an OpenGL context current, use this function to allocate and OpenGL resources needed for your application - whether the creation succeeded @@ -972,7 +921,6 @@ function to allocate and OpenGL resources needed for your application Destroy any resources allocated throughout the lifetime of @mem - @@ -985,7 +933,6 @@ function to allocate and OpenGL resources needed for your application Also see gst_memory_map(); - the mapped pointer @@ -1007,7 +954,6 @@ function to allocate and OpenGL resources needed for your application Also see gst_memory_unmap(); - @@ -1055,9 +1001,7 @@ function to allocate and OpenGL resources needed for your application context. It also provided some wrappers around #GstBaseSrc's `start()` and `stop()` virtual methods that ensure an OpenGL context is available and current in the calling thread. - - @@ -1071,7 +1015,6 @@ current in the calling thread. - @@ -1082,7 +1025,6 @@ current in the calling thread. - @@ -1129,7 +1071,6 @@ current in the calling thread. The base class for GStreamer GL Video sources. - @@ -1139,7 +1080,6 @@ current in the calling thread. - @@ -1152,7 +1092,6 @@ current in the calling thread. - @@ -1165,7 +1104,6 @@ current in the calling thread. - @@ -1185,15 +1123,12 @@ current in the calling thread. - - - + GstGLBuffer is a #GstMemory subclass providing support for the mapping of GL buffers. Data is uploaded or downloaded from the GPU as is necessary. - the parent object @@ -1213,14 +1148,12 @@ Data is uploaded or downloaded from the GPU as is necessary. Initializes the GL Buffer allocator. It is safe to call this function multiple times. This must be called before any other #GstGLBuffer operation. - - parent object @@ -1239,7 +1172,6 @@ multiple times. This must be called before any other #GstGLBuffer operation. - a new #GstGLBufferAllocationParams for allocating OpenGL buffer objects @@ -1271,7 +1203,6 @@ multiple times. This must be called before any other #GstGLBuffer operation. Opaque #GstGLBufferAllocator struct - @@ -1283,7 +1214,6 @@ multiple times. This must be called before any other #GstGLBuffer operation. The #GstGLBufferAllocatorClass only contains private data - @@ -1302,9 +1232,7 @@ A #GstGLBufferPool is created with gst_gl_buffer_pool_new() %GST_BUFFER_POOL_OPTION_VIDEO_META, the VideoAligment buffer pool option %GST_BUFFER_POOL_OPTION_VIDEO_ALIGNMENT as well as the OpenGL specific %GST_BUFFER_POOL_OPTION_GL_SYNC_META buffer pool option. - - a #GstBufferPool that allocates buffers with #GstGLMemory @@ -1333,7 +1261,6 @@ A #GstGLBufferPool is created with gst_gl_buffer_pool_new() The #GstGLBufferPoolClass structure contains only private data - @@ -1343,9 +1270,7 @@ A #GstGLBufferPool is created with gst_gl_buffer_pool_new() - - - + #GstGLColorConvert is an object that converts between color spaces and/or formats using OpenGL Shaders. @@ -1356,9 +1281,7 @@ conversion performed with gst_gl_color_convert_perform(). The glcolorconvertelement provides a GStreamer element that uses #GstGLColorConvert to convert between video formats and color spaces. - - a new #GstGLColorConvert object @@ -1372,7 +1295,6 @@ The glcolorconvertelement provides a GStreamer element that uses Provides an implementation of #GstBaseTransformClass.fixate_caps() - the fixated #GstCaps @@ -1398,7 +1320,6 @@ The glcolorconvertelement provides a GStreamer element that uses Provides an implementation of #GstBaseTransformClass.transform_caps() - the converted #GstCaps @@ -1424,7 +1345,6 @@ The glcolorconvertelement provides a GStreamer element that uses Provides an implementation of #GstBaseTransformClass.decide_allocation() - whether the allocation parameters were successfully chosen @@ -1443,7 +1363,6 @@ The glcolorconvertelement provides a GStreamer element that uses Converts the data contained by @inbuf using the formats specified by the #GstCaps passed to gst_gl_color_convert_set_caps() - a converted #GstBuffer or %NULL @@ -1461,7 +1380,6 @@ The glcolorconvertelement provides a GStreamer element that uses Initializes @convert with the information required for conversion. - @@ -1521,7 +1439,6 @@ The glcolorconvertelement provides a GStreamer element that uses The #GstGLColorConvertClass struct only contains private data - @@ -1531,17 +1448,13 @@ The glcolorconvertelement provides a GStreamer element that uses - - - + #GstGLContext wraps an OpenGL context object in a uniform API. As a result of the limitation on OpenGL context, this object is not thread safe unless specified and must only be activated in a single thread. - Create a new #GstGLContext with the specified @display - a new #GstGLContext @@ -1563,7 +1476,6 @@ active. @context_type must not be %GST_GL_PLATFORM_NONE or %GST_GL_PLATFORM_ANY @available_apis must not be %GST_GL_API_NONE or %GST_GL_API_ANY - a #GstGLContext wrapping @handle @@ -1592,7 +1504,6 @@ active. for @name in the OpenGL shared libraries or in the current process. See also: gst_gl_context_get_proc_address() - an address pointing to @name or %NULL @@ -1610,7 +1521,6 @@ See also: gst_gl_context_get_proc_address() See also gst_gl_context_activate(). - the #GstGLContext active in the current thread or %NULL @@ -1619,7 +1529,6 @@ See also: gst_gl_context_get_proc_address() If an error occurs, @major and @minor are not modified and %GST_GL_API_NONE is returned. - The version supported by the OpenGL context current in the calling thread or %GST_GL_API_NONE @@ -1641,7 +1550,6 @@ returned. - The OpenGL context handle current in the calling thread or %NULL @@ -1658,7 +1566,6 @@ returned. to retrieve @name. See also gst_gl_context_get_proc_address(). - a function pointer for @name, or %NULL @@ -1683,7 +1590,6 @@ See also gst_gl_context_get_proc_address(). In OpenGL terms, calls eglMakeCurrent or similar with this context and the currently set window. See gst_gl_context_set_window() for details. - Whether the activation succeeded @@ -1705,7 +1611,6 @@ currently set window. See gst_gl_context_set_window() for details. Note: Most features require that the context be created before it is possible to determine their existence and so will fail if that is not the case. - Whether @feature is supported by @context @@ -1722,7 +1627,6 @@ case. - @@ -1733,7 +1637,6 @@ case. - @@ -1750,7 +1653,6 @@ case. - @@ -1765,7 +1667,6 @@ case. The currently available API may be limited by the #GstGLDisplay in use and/or the #GstGLWindow chosen. - the available OpenGL api @@ -1779,7 +1680,6 @@ the #GstGLWindow chosen. Gets the backing OpenGL context used by @context. - The platform specific backing OpenGL context @@ -1793,7 +1693,6 @@ the #GstGLWindow chosen. Gets the OpenGL platform that used by @context. - The platform specific backing OpenGL context @@ -1808,7 +1707,6 @@ the #GstGLWindow chosen. Get the version of the OpenGL platform (GLX, EGL, etc) used. Only valid after a call to gst_gl_context_create(). - @@ -1830,7 +1728,6 @@ after a call to gst_gl_context_create(). Swap the front and back buffers on the window attached to @context. This will display the frame on the next refresh cycle. - @@ -1846,7 +1743,6 @@ This will display the frame on the next refresh cycle. In OpenGL terms, calls eglMakeCurrent or similar with this context and the currently set window. See gst_gl_context_set_window() for details. - Whether the activation succeeded @@ -1864,7 +1760,6 @@ currently set window. See gst_gl_context_set_window() for details. Note: This will always fail for two wrapped #GstGLContext's - whether @context and @other_context are able to share OpenGL resources. @@ -1887,7 +1782,6 @@ currently set window. See gst_gl_context_set_window() for details. Note: Most features require that the context be created before it is possible to determine their existence and so will fail if that is not the case. - Whether @feature is supported by @context @@ -1904,7 +1798,6 @@ case. - whether whether the current framebuffer is complete @@ -1922,7 +1815,6 @@ case. - whether OpenGL context implements the required api and specified version. @@ -1949,7 +1841,6 @@ version. Unbind the current framebuffer - @@ -1964,7 +1855,6 @@ version. Clear's the currently set shader from the GL state machine. Note: must be called in the GL thread. - @@ -1984,7 +1874,6 @@ If an error occurs, and @error is not %NULL, then error will contain details of the error and %FALSE will be returned. Should only be called once. - whether the context could successfully be created @@ -2005,7 +1894,6 @@ Should only be called once. Should only be called after gst_gl_context_create() has been successfully called for this context. - @@ -2020,7 +1908,6 @@ called for this context. Fills @context's info (version, extensions, vtable, etc) from the GL context in the current thread. Typically used with wrapped contexts to allow wrapped contexts to be used as regular #GstGLContext's. - @@ -2032,7 +1919,6 @@ allow wrapped contexts to be used as regular #GstGLContext's. - the #GstGLDisplay associated with this @context @@ -2049,7 +1935,6 @@ allow wrapped contexts to be used as regular #GstGLContext's. The currently available API may be limited by the #GstGLDisplay in use and/or the #GstGLWindow chosen. - the available OpenGL api @@ -2063,7 +1948,6 @@ the #GstGLWindow chosen. Gets the backing OpenGL context used by @context. - The platform specific backing OpenGL context @@ -2077,7 +1961,6 @@ the #GstGLWindow chosen. Gets the OpenGL platform that used by @context. - The platform specific backing OpenGL context @@ -2092,7 +1975,6 @@ the #GstGLWindow chosen. Get the version of the OpenGL platform (GLX, EGL, etc) used. Only valid after a call to gst_gl_context_create(). - @@ -2115,7 +1997,6 @@ after a call to gst_gl_context_create(). Returns the OpenGL version implemented by @context. See gst_gl_context_get_gl_api() for retrieving the OpenGL api implemented by @context. - @@ -2154,7 +2035,6 @@ e.g. |[<!-- language="C" --> void (GSTGLAPI *PFN_glGetIntegerv) (GLenum name, GLint * ret) ]| - a function pointer or %NULL @@ -2171,7 +2051,6 @@ void (GSTGLAPI *PFN_glGetIntegerv) (GLenum name, GLint * ret) - The #GThread, @context is current in or NULL @@ -2184,7 +2063,6 @@ void (GSTGLAPI *PFN_glGetIntegerv) (GLenum name, GLint * ret) - the currently set window @@ -2197,7 +2075,6 @@ void (GSTGLAPI *PFN_glGetIntegerv) (GLenum name, GLint * ret) - Whether the #GstGLContext has been shared with another #GstGLContext @@ -2211,7 +2088,6 @@ void (GSTGLAPI *PFN_glGetIntegerv) (GLenum name, GLint * ret) Will internally set @context as shared with @share - @@ -2230,7 +2106,6 @@ void (GSTGLAPI *PFN_glGetIntegerv) (GLenum name, GLint * ret) Set's the current window on @context to @window. The window can only be changed before gst_gl_context_create() has been called and the @window is not already running. - Whether the window was successfully updated @@ -2247,7 +2122,6 @@ already running. - Whether @context supports the combination of @version with @profile @@ -2268,7 +2142,6 @@ already running. - whether @context supports the 'precision' specifier in GLSL shaders @@ -2289,7 +2162,6 @@ already running. - whether @context supports the 'precision highp' specifier in GLSL shaders @@ -2312,7 +2184,6 @@ already running. Swap the front and back buffers on the window attached to @context. This will display the frame on the next refresh cycle. - @@ -2327,7 +2198,6 @@ This will display the frame on the next refresh cycle. Execute @func in the OpenGL thread of @context with @data MT-safe - @@ -2369,13 +2239,11 @@ MT-safe - - @@ -2383,7 +2251,6 @@ MT-safe - The platform specific backing OpenGL context @@ -2398,7 +2265,6 @@ MT-safe - the available OpenGL api @@ -2413,7 +2279,6 @@ MT-safe - The platform specific backing OpenGL context @@ -2428,7 +2293,6 @@ MT-safe - @@ -2444,7 +2308,6 @@ MT-safe - Whether the activation succeeded @@ -2463,7 +2326,6 @@ MT-safe - @@ -2476,7 +2338,6 @@ MT-safe - @@ -2495,7 +2356,6 @@ MT-safe - @@ -2508,7 +2368,6 @@ MT-safe - @@ -2522,7 +2381,6 @@ MT-safe - Whether @feature is supported by @context @@ -2541,7 +2399,6 @@ MT-safe - @@ -2594,12 +2451,9 @@ MT-safe - - - + Represents a function to run in the GL thread with @context and @data - @@ -2635,16 +2489,13 @@ platform and window system specific functionality. > other toolkit/library functionality is accessed. Failure to do so could > result in sudden application abortion during execution. The most notably > example of such a function is X11's XInitThreads\(). - - a new #GstGLDisplay - a new #GstGLWindow for @display or %NULL. @@ -2657,7 +2508,6 @@ platform and window system specific functionality. - the native handle for the display @@ -2670,7 +2520,6 @@ platform and window system specific functionality. - whether @context was successfully added. %FALSE may be returned if there already exists another context for @context's active thread. @@ -2691,7 +2540,6 @@ Must be called with the object lock held. It requires the display's object lock to be held. - whether a new context could be created. @@ -2712,7 +2560,6 @@ Must be called with the object lock held. - a new #GstGLWindow for @display or %NULL. @@ -2729,7 +2576,6 @@ Must be called with the object lock held. application and elements to request a specific set of OpenGL API's based on what they support. See gst_gl_context_get_gl_api() for the retrieving the API supported by a #GstGLContext. - @@ -2750,7 +2596,6 @@ API supported by a #GstGLContext. Execute @compare_func over the list of windows stored by @display. The first argument to @compare_func is the #GstGLWindow being checked and the second argument is @data. - The first #GstGLWindow that causes a match from @compare_func @@ -2773,7 +2618,6 @@ second argument is @data. see gst_gl_display_filter_gl_api() for what the returned value represents - the #GstGLAPI configured for @display @@ -2786,7 +2630,6 @@ second argument is @data. - @@ -2797,7 +2640,6 @@ second argument is @data. - the #GstGLContext current on @thread or %NULL @@ -2816,7 +2658,6 @@ Must be called with the object lock held. - the native handle for the display @@ -2829,7 +2670,6 @@ Must be called with the object lock held. - the #GstGLDisplayType of @display @@ -2843,7 +2683,6 @@ Must be called with the object lock held. Must be called with the object lock held. - @@ -2859,7 +2698,6 @@ Must be called with the object lock held. - if @window could be removed from @display @@ -2879,7 +2717,6 @@ Must be called with the object lock held. Execute @compare_func over the list of windows stored by @display. The first argument to @compare_func is the #GstGLWindow being checked and the second argument is @data. - The first #GstGLWindow that causes a match from @compare_func @@ -2940,13 +2777,11 @@ display's object lock held. - - the native handle for the display @@ -2961,7 +2796,6 @@ display's object lock held. - a new #GstGLWindow for @display or %NULL. @@ -2980,9 +2814,7 @@ display's object lock held. - - - + no display type @@ -3021,9 +2853,7 @@ display's object lock held. #GstGLFilter helps to implement simple OpenGL filter elements taking a single input and producing a single output with a #GstGLFramebuffer - - @@ -3034,7 +2864,6 @@ single input and producing a single output with a #GstGLFramebuffer - @@ -3052,7 +2881,6 @@ single input and producing a single output with a #GstGLFramebuffer Calls filter_texture vfunc with correctly mapped #GstGLMemorys - whether the transformation succeeded @@ -3073,7 +2901,6 @@ single input and producing a single output with a #GstGLFramebuffer - @@ -3084,7 +2911,6 @@ single input and producing a single output with a #GstGLFramebuffer - @@ -3101,7 +2927,6 @@ single input and producing a single output with a #GstGLFramebuffer - @@ -3125,7 +2950,6 @@ single input and producing a single output with a #GstGLFramebuffer modifies is the necessary vertex/index buffers and, if necessary, a Vertex Array Object for drawing a fullscreen quad. Framebuffer state, any shaders, viewport state, etc must be setup by the caller. - @@ -3138,7 +2962,6 @@ any shaders, viewport state, etc must be setup by the caller. Calls filter_texture vfunc with correctly mapped #GstGLMemorys - whether the transformation succeeded @@ -3160,7 +2983,6 @@ any shaders, viewport state, etc must be setup by the caller. Transforms @input into @output using @func on through FBO. - the return value of @func @@ -3192,7 +3014,6 @@ any shaders, viewport state, etc must be setup by the caller. Transforms @input into @output using @shader with a FBO. See also: gst_gl_filter_render_to_target() - @@ -3279,13 +3100,11 @@ See also: gst_gl_filter_render_to_target() - - @@ -3304,7 +3123,6 @@ See also: gst_gl_filter_render_to_target() - @@ -3323,7 +3141,6 @@ See also: gst_gl_filter_render_to_target() - whether the transformation succeeded @@ -3346,7 +3163,6 @@ See also: gst_gl_filter_render_to_target() - @@ -3359,7 +3175,6 @@ See also: gst_gl_filter_render_to_target() - @@ -3386,7 +3201,6 @@ See also: gst_gl_filter_render_to_target() - whether the render succeeded @@ -3472,7 +3286,6 @@ See also: gst_gl_filter_render_to_target() Two 16-bit components stored in the R and G texture components - the #GstGLFormat necessary for holding the data in @plane of @vinfo @@ -3493,7 +3306,6 @@ See also: gst_gl_filter_render_to_target() - Whether @format is supported by @context based on the OpenGL API, version, or available OpenGL extension/s. @@ -3513,7 +3325,6 @@ See also: gst_gl_filter_render_to_target() Get the unsized format and type from @format for usage in glReadPixels, glTex{Sub}Image*, glTexImage* and similar functions. - @@ -3533,7 +3344,6 @@ glTex{Sub}Image*, glTexImage* and similar functions. - the number of bytes the specified @format, @type combination takes per pixel @@ -3562,9 +3372,7 @@ gst_gl_framebuffer_attach() Note: OpenGL framebuffers are not shareable resources so cannot be used between multiple OpenGL contexts. - - a new #GstGLFramebuffer @@ -3577,7 +3385,6 @@ between multiple OpenGL contexts. - a new #GstGLFramebuffer with a depth buffer of @width and @height @@ -3599,7 +3406,6 @@ between multiple OpenGL contexts. attach @mem to @attachment_point - @@ -3620,7 +3426,6 @@ between multiple OpenGL contexts. Bind @fb into the current thread - @@ -3634,7 +3439,6 @@ between multiple OpenGL contexts. Perform the steps necessary to have the output of a glDraw* command in @func update the contents of @mem. - the result of executing @func @@ -3661,7 +3465,6 @@ between multiple OpenGL contexts. Retrieve the effective dimensions from the current attachments attached to @fb. - @@ -3681,7 +3484,6 @@ between multiple OpenGL contexts. - the OpenGL id for @fb @@ -3718,7 +3520,6 @@ between multiple OpenGL contexts. Opaque #GstGLFramebufferClass struct - @@ -3730,7 +3531,6 @@ between multiple OpenGL contexts. callback definition for operating through a #GstGLFramebuffer object - @@ -3741,15 +3541,12 @@ between multiple OpenGL contexts. - - - + Structure containing function pointers to OpenGL functions. Each field is named exactly the same as the OpenGL function without the `gl` prefix. - GstGLMemory is a #GstGLBaseMemory subclass providing support for the mapping of @@ -3759,7 +3556,6 @@ OpenGL textures. with #GstGLVideoAllocationParams. Data is uploaded or downloaded from the GPU as is necessary. - the parent #GstGLBaseMemory object @@ -3811,7 +3607,6 @@ Data is uploaded or downloaded from the GPU as is necessary. Copies @gl_mem into the texture specified by @tex_id. The format of @tex_id is specified by @tex_format, @width and @height. - Whether the copy succeeded @@ -3846,7 +3641,6 @@ is specified by @tex_format, @width and @height. Copies the texture in #GstGLMemory into the texture specified by @tex_id, @out_target, @out_tex_format, @out_width and @out_height. - whether the copy succeeded. @@ -3879,7 +3673,6 @@ is specified by @tex_format, @width and @height. - the #GstGLFormat of @gl_mem @@ -3892,7 +3685,6 @@ is specified by @tex_format, @width and @height. - the texture height of @gl_mem @@ -3905,7 +3697,6 @@ is specified by @tex_format, @width and @height. - the OpenGL texture handle of @gl_mem @@ -3918,7 +3709,6 @@ is specified by @tex_format, @width and @height. - the #GstGLTextureTarget of @gl_mem @@ -3931,7 +3721,6 @@ is specified by @tex_format, @width and @height. - the texture width of @gl_mem @@ -3946,7 +3735,6 @@ is specified by @tex_format, @width and @height. Initializes @mem with the required parameters. @info is assumed to have already have been modified with gst_video_info_align(). - @@ -4007,7 +3795,6 @@ to `GL_PIXEL_PACK_BUFFER`. Otherwise @write_pointer is the byte offset into the currently bound `GL_PIXEL_PACK_BUFFER` buffer to store the result of glReadPixels. See the OpenGL specification for glReadPixels for more details. - whether theread operation succeeded @@ -4027,7 +3814,6 @@ details. Reads the texture in @read_pointer into @gl_mem. See gst_gl_memory_read_pixels() for what @read_pointer signifies. - @@ -4045,13 +3831,11 @@ See gst_gl_memory_read_pixels() for what @read_pointer signifies. Initializes the GL Base Texture allocator. It is safe to call this function multiple times. This must be called before any other GstGLMemory operation. - - whether the buffer was correctly setup @@ -4092,9 +3876,7 @@ multiple times. This must be called before any other GstGLMemory operation. Opaque #GstGLMemoryAllocator struct - - the default #GstGLMemoryAllocator supported by @context @@ -4117,7 +3899,6 @@ multiple times. This must be called before any other GstGLMemory operation. - @@ -4144,7 +3925,6 @@ multiple times. This must be called before any other GstGLMemory operation. - @@ -4170,7 +3950,6 @@ output as the RGBA texture. Otherwise, if @respecify is %FALSE, then the copy is performed per texel using glCopyTexImage. See the OpenGL specification for details on the mappings between texture formats. - Whether the copy succeeded @@ -4212,7 +3991,6 @@ mappings between texture formats. Transfer the texture data from the texture into the PBO if necessary. - @@ -4225,7 +4003,6 @@ mappings between texture formats. Transfer the texture data from the PBO into the texture if necessary. - @@ -4237,7 +4014,6 @@ mappings between texture formats. - @@ -4245,7 +4021,6 @@ mappings between texture formats. Opaque #GstGLMemoryPBOAllocator struct - @@ -4257,7 +4032,6 @@ mappings between texture formats. Only contains private data - @@ -4269,9 +4043,7 @@ mappings between texture formats. Opaque #GstGLOverlayCompositor object - - @@ -4282,7 +4054,6 @@ mappings between texture formats. - @@ -4293,7 +4064,6 @@ mappings between texture formats. - @@ -4304,7 +4074,6 @@ mappings between texture formats. - @@ -4315,7 +4084,6 @@ mappings between texture formats. - @@ -4364,7 +4132,6 @@ mappings between texture formats. - @@ -4398,7 +4165,6 @@ mappings between texture formats. any OpenGL platform - The #GstGLPlatform represented by @platform_s @@ -4411,7 +4177,6 @@ mappings between texture formats. - A space separated string of the OpenGL platforms enabled in @platform @@ -4427,7 +4192,6 @@ mappings between texture formats. A #GstGLQuery represents and holds an OpenGL query object. Various types of queries can be run or counters retrieved. - @@ -4453,7 +4217,6 @@ queries can be run or counters retrieved. Record the result of a counter - @@ -4466,7 +4229,6 @@ queries can be run or counters retrieved. End counting the query - @@ -4479,7 +4241,6 @@ queries can be run or counters retrieved. Frees a #GstGLQuery - @@ -4491,7 +4252,6 @@ queries can be run or counters retrieved. - @@ -4511,7 +4271,6 @@ queries can be run or counters retrieved. - the result of the query @@ -4525,7 +4284,6 @@ queries can be run or counters retrieved. Start counting the query - @@ -4538,7 +4296,6 @@ queries can be run or counters retrieved. Free any dynamically allocated resources - @@ -4553,7 +4310,6 @@ queries can be run or counters retrieved. Performs a GST_QUERY_CONTEXT query of type "gst.gl.local_context" on all #GstPads in @element of @direction for the local OpenGL context used by GStreamer elements. - whether @context_ptr contains a #GstGLContext @@ -4576,7 +4332,6 @@ GStreamer elements. Free with gst_gl_query_free() - a new #GstGLQuery @@ -4610,7 +4365,6 @@ OpenGL renderbuffers. #GstGLRenderbuffer is created or wrapped through gst_gl_base_memory_alloc() with #GstGLRenderbufferAllocationParams. - @@ -4639,7 +4393,6 @@ with #GstGLRenderbufferAllocationParams. - the #GstGLFormat of @gl_mem @@ -4652,7 +4405,6 @@ with #GstGLRenderbufferAllocationParams. - the configured height of @gl_mem @@ -4665,7 +4417,6 @@ with #GstGLRenderbufferAllocationParams. - the OpenGL renderbuffer handle of @gl_mem @@ -4678,7 +4429,6 @@ with #GstGLRenderbufferAllocationParams. - the configured width of @gl_mem @@ -4693,7 +4443,6 @@ with #GstGLRenderbufferAllocationParams. Initializes the GL Base Texture allocator. It is safe to call this function multiple times. This must be called before any other GstGLRenderbuffer operation. - @@ -4701,7 +4450,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio Allocation parameters - @@ -4723,7 +4471,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - a new #GstGLRenderbufferAllocationParams for allocating #GstGLRenderbuffer's @@ -4752,7 +4499,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - a new #GstGLRenderbufferAllocationParams for wrapping @gl_handle as a renderbuffer @@ -4796,7 +4542,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio Opaque #GstGLRenderbufferAllocator struct - @@ -4808,7 +4553,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio The #GstGLRenderbufferAllocatorClass only contains private data - @@ -4854,7 +4598,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio any OpenGL/OpenGL|ES profile - the #GstGLSLProfile of @string or %GST_GLSL_PROFILE_NONE on error @@ -4867,7 +4610,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - the name for @profile or %NULL on error @@ -4882,9 +4624,7 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio #GstGLSLStage holds and represents a single OpenGL shader stage. - - a new #GstGLSLStage of the specified @type @@ -4901,7 +4641,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - @@ -4912,7 +4651,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - @@ -4923,7 +4661,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - a new #GstGLSLStage of the specified @type @@ -4952,7 +4689,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - a new #GstGLSLStage of the specified @type @@ -4988,7 +4724,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - whether the compilation succeeded @@ -5001,7 +4736,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - The GL handle for this shader stage @@ -5014,7 +4748,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - The GLSL profile for the current shader stage @@ -5027,7 +4760,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - The GL shader type for this shader stage @@ -5040,7 +4772,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - The GLSL version for the current shader stage @@ -5054,7 +4785,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio Replaces the current shader string with @str. - @@ -5100,7 +4830,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio Opaque #GstGLSLStageClass struct - @@ -5110,9 +4839,7 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - - - + GLSL version list @@ -5167,7 +4894,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio version 450 (valid for compatibility/core desktop GL) - the #GstGLSLVersion of @string or %GST_GLSL_VERSION_NONE on error @@ -5182,7 +4908,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio Note: this function expects either a `#version` GLSL preprocesser directive or a valid GLSL version and/or profile. - TRUE if a valid `#version` string was found, FALSE otherwise @@ -5203,7 +4928,6 @@ or a valid GLSL version and/or profile. - the combined GLSL `#version` string for @version and @profile @@ -5220,7 +4944,6 @@ or a valid GLSL version and/or profile. - the name of @version or %NULL on error @@ -5234,31 +4957,26 @@ or a valid GLSL version and/or profile. - - - - Note: must be called in the GL thread - a new empty @shader @@ -5272,7 +4990,6 @@ or a valid GLSL version and/or profile. Note: must be called in the GL thread - a default @shader or %NULL on failure @@ -5290,7 +5007,6 @@ the shader will be linked. On error, %NULL will be returned and @error will contain the details of the error. Note: must be called in the GL thread - a new @shader with the specified stages. @@ -5315,7 +5031,6 @@ Note: must be called in the GL thread %NULL will be returned and @error will contain the details of the error. Note: must be called in the GL thread - a new @shader with the specified stages. @@ -5336,7 +5051,6 @@ Note: must be called in the GL thread - a passthrough shader string for copying an input external-oes texture to the output @@ -5358,7 +5072,6 @@ Note: must be called in the GL thread - a passthrough shader string for copying an input texture to the output @@ -5387,7 +5100,6 @@ GLSL ES context where there is no default precision specified. Practically, this will return the string 'precision mediump float' or 'precision highp float' depending on if high precision floats are determined to be supported. - a shader string defining the precision of float types based on @context, @version and @profile @@ -5413,7 +5125,6 @@ determined to be supported. with gst_glsl_stage_compile(). Note: must be called in the GL thread - whether @stage could be attached to @shader @@ -5434,7 +5145,6 @@ Note: must be called in the GL thread with gst_glsl_stage_compile(). Note: must be called in the GL thread - whether @stage could be attached to @shader @@ -5453,7 +5163,6 @@ Note: must be called in the GL thread Bind attribute @name to the specified location @index using `glBindAttributeLocation()`. - @@ -5475,7 +5184,6 @@ Note: must be called in the GL thread Bind attribute @name to the specified location @index using `glBindFragDataLocation()`. - @@ -5498,7 +5206,6 @@ Note: must be called in the GL thread Compiles @stage and attaches it to @shader. Note: must be called in the GL thread - whether @stage could be compiled and attached to @shader @@ -5519,7 +5226,6 @@ Note: must be called in the GL thread to @shader with gst_gl_shader_attach() or gst_gl_shader_attach_unlocked(). Note: must be called in the GL thread - @@ -5539,7 +5245,6 @@ Note: must be called in the GL thread to @shader with gst_gl_shader_attach() or gst_gl_shader_attach_unlocked(). Note: must be called in the GL thread - @@ -5555,7 +5260,6 @@ Note: must be called in the GL thread - the attribute index for @name in @shader or -1 on failure @@ -5572,7 +5276,6 @@ Note: must be called in the GL thread - the GL program handle for this shader @@ -5586,7 +5289,6 @@ Note: must be called in the GL thread Note: must be called in the GL thread - whether @shader has been successfully linked @@ -5602,7 +5304,6 @@ Note: must be called in the GL thread Links the current list of #GstGLSLStage's in @shader. Note: must be called in the GL thread - whether @shader could be linked together. @@ -5618,7 +5319,6 @@ Note: must be called in the GL thread Releases the shader and stages. Note: must be called in the GL thread - @@ -5633,7 +5333,6 @@ Note: must be called in the GL thread Releases the shader and stages. Note: must be called in the GL thread - @@ -5646,7 +5345,6 @@ Note: must be called in the GL thread Perform `glUniform1f()` for @name on @shader - @@ -5667,7 +5365,6 @@ Note: must be called in the GL thread Perform `glUniform1fv()` for @name on @shader - @@ -5694,7 +5391,6 @@ Note: must be called in the GL thread Perform `glUniform1i()` for @name on @shader - @@ -5715,7 +5411,6 @@ Note: must be called in the GL thread Perform `glUniform1iv()` for @name on @shader - @@ -5742,7 +5437,6 @@ Note: must be called in the GL thread Perform `glUniform2f()` for @name on @shader - @@ -5767,7 +5461,6 @@ Note: must be called in the GL thread Perform `glUniform2fv()` for @name on @shader - @@ -5794,7 +5487,6 @@ Note: must be called in the GL thread Perform `glUniform2i()` for @name on @shader - @@ -5819,7 +5511,6 @@ Note: must be called in the GL thread Perform `glUniform2iv()` for @name on @shader - @@ -5846,7 +5537,6 @@ Note: must be called in the GL thread Perform `glUniform3f()` for @name on @shader - @@ -5875,7 +5565,6 @@ Note: must be called in the GL thread Perform `glUniform3fv()` for @name on @shader - @@ -5902,7 +5591,6 @@ Note: must be called in the GL thread Perform `glUniform3i()` for @name on @shader - @@ -5931,7 +5619,6 @@ Note: must be called in the GL thread Perform `glUniform3iv()` for @name on @shader - @@ -5958,7 +5645,6 @@ Note: must be called in the GL thread Perform `glUniform4f()` for @name on @shader - @@ -5991,7 +5677,6 @@ Note: must be called in the GL thread Perform `glUniform4fv()` for @name on @shader - @@ -6018,7 +5703,6 @@ Note: must be called in the GL thread Perform `glUniform4i()` for @name on @shader - @@ -6051,7 +5735,6 @@ Note: must be called in the GL thread Perform `glUniform4iv()` for @name on @shader - @@ -6078,7 +5761,6 @@ Note: must be called in the GL thread Perform `glUniformMatrix2fv()` for @name on @shader - @@ -6107,7 +5789,6 @@ Note: must be called in the GL thread Perform `glUniformMatrix2x3fv()` for @name on @shader - @@ -6136,7 +5817,6 @@ Note: must be called in the GL thread Perform `glUniformMatrix2x4fv()` for @name on @shader - @@ -6165,7 +5845,6 @@ Note: must be called in the GL thread Perform `glUniformMatrix3fv()` for @name on @shader - @@ -6194,7 +5873,6 @@ Note: must be called in the GL thread Perform `glUniformMatrix3x2fv()` for @name on @shader - @@ -6223,7 +5901,6 @@ Note: must be called in the GL thread Perform `glUniformMatrix3x4fv()` for @name on @shader - @@ -6252,7 +5929,6 @@ Note: must be called in the GL thread Perform `glUniformMatrix4fv()` for @name on @shader - @@ -6281,7 +5957,6 @@ Note: must be called in the GL thread Perform `glUniformMatrix4x2fv()` for @name on @shader - @@ -6310,7 +5985,6 @@ Note: must be called in the GL thread Perform `glUniformMatrix4x3fv()` for @name on @shader - @@ -6341,7 +6015,6 @@ Note: must be called in the GL thread Mark's @shader as being used for the next GL draw command. Note: must be called in the GL thread and @shader must have been linked. - @@ -6371,14 +6044,11 @@ Note: must be called in the GL thread and @shader must have been linked. - - - - + Output anaglyph type to generate when downmixing to mono @@ -6394,7 +6064,6 @@ Note: must be called in the GL thread and @shader must have been linked. #GstGLSyncMeta provides the ability to synchronize the OpenGL command stream with the CPU or with other OpenGL contexts. - the parent #GstMeta @@ -6409,7 +6078,6 @@ with the CPU or with other OpenGL contexts. - @@ -6425,7 +6093,6 @@ with the CPU or with other OpenGL contexts. - @@ -6441,7 +6108,6 @@ with the CPU or with other OpenGL contexts. - @@ -6457,7 +6123,6 @@ with the CPU or with other OpenGL contexts. - @@ -6473,7 +6138,6 @@ with the CPU or with other OpenGL contexts. - @@ -6489,7 +6153,6 @@ with the CPU or with other OpenGL contexts. - @@ -6505,7 +6168,6 @@ with the CPU or with other OpenGL contexts. - @@ -6527,7 +6189,6 @@ with the CPU or with other OpenGL contexts. - @@ -6543,7 +6204,6 @@ with the CPU or with other OpenGL contexts. - @@ -6559,7 +6219,6 @@ with the CPU or with other OpenGL contexts. Set a sync point to possibly wait on at a later time. - @@ -6577,7 +6236,6 @@ with the CPU or with other OpenGL contexts. Insert a wait into @context's command stream ensuring all previous OpenGL commands before @sync_meta have completed. - @@ -6596,7 +6254,6 @@ commands before @sync_meta have completed. Perform a wait so that the sync point has passed from the CPU's perspective What that means, is that all GL operations changing CPU-visible data before the sync point are now visible. - @@ -6612,7 +6269,6 @@ the sync point are now visible. - @@ -6632,7 +6288,6 @@ the sync point are now visible. external oes texture target - the #GstGLTextureTarget that's equiavalant to @target or %GST_GL_TEXTURE_TARGET_NONE @@ -6646,7 +6301,6 @@ the sync point are now visible. - the #GstGLTextureTarget represented by @str or %GST_GL_TEXTURE_TARGET_NONE @@ -6660,7 +6314,6 @@ the sync point are now visible. - a string representing the @GstBufferPoolOption specified by @target @@ -6673,7 +6326,6 @@ the sync point are now visible. - the OpenGL value for binding the @target with glBindTexture() and similar functions or 0 @@ -6687,7 +6339,6 @@ the sync point are now visible. - the stringified version of @target or %NULL @@ -6704,9 +6355,7 @@ the sync point are now visible. #GstGLUpload is an object that uploads data from system memory into GL textures. A #GstGLUpload can be created with gst_gl_upload_new() - - a new #GstGLUpload object @@ -6719,13 +6368,11 @@ A #GstGLUpload can be created with gst_gl_upload_new() - - @@ -6747,7 +6394,6 @@ A #GstGLUpload can be created with gst_gl_upload_new() Uploads @buffer using the transformation specified by gst_gl_upload_set_caps() creating a new #GstBuffer in @outbuf_ptr. - whether the upload was successful @@ -6769,7 +6415,6 @@ gst_gl_upload_set_caps() creating a new #GstBuffer in @outbuf_ptr. Adds the required allocation parameters to support uploading. - @@ -6790,7 +6435,6 @@ gst_gl_upload_set_caps() creating a new #GstBuffer in @outbuf_ptr. Initializes @upload with the information required for upload. - whether @in_caps and @out_caps could be set on @upload @@ -6811,7 +6455,6 @@ gst_gl_upload_set_caps() creating a new #GstBuffer in @outbuf_ptr. - @@ -6825,7 +6468,6 @@ gst_gl_upload_set_caps() creating a new #GstBuffer in @outbuf_ptr. - @@ -6864,7 +6506,6 @@ gst_gl_upload_set_caps() creating a new #GstBuffer in @outbuf_ptr. The #GstGLUploadClass struct only contains private data - @@ -6874,9 +6515,7 @@ gst_gl_upload_set_caps() creating a new #GstBuffer in @outbuf_ptr. - - - + No further processing required @@ -6895,7 +6534,6 @@ gst_gl_upload_set_caps() creating a new #GstBuffer in @outbuf_ptr. - the parent #GstGLAllocationParams structure @@ -6926,7 +6564,6 @@ gst_gl_upload_set_caps() creating a new #GstBuffer in @outbuf_ptr. - a new #GstGLVideoAllocationParams for allocating #GstGLMemory's @@ -6963,7 +6600,6 @@ gst_gl_upload_set_caps() creating a new #GstBuffer in @outbuf_ptr. - a new #GstGLVideoAllocationParams for wrapping @wrapped_data @@ -7015,7 +6651,6 @@ gst_gl_upload_set_caps() creating a new #GstBuffer in @outbuf_ptr. @gl_handle is defined by the specific OpenGL handle being wrapped For #GstGLMemory and #GstGLMemoryPBO it is an OpenGL texture id. Other memory types may define it to require a different type of parameter. - a new #GstGLVideoAllocationParams for wrapping @gl_handle @@ -7064,7 +6699,6 @@ Other memory types may define it to require a different type of parameter. - a new #GstGLVideoAllocationParams for wrapping @tex_id @@ -7115,7 +6749,6 @@ Other memory types may define it to require a different type of parameter. Copy and set any dynamically allocated resources in @dest_vid. Intended for subclass usage only to chain up at the end of a subclass copy function. - @@ -7133,7 +6766,6 @@ for subclass usage only to chain up at the end of a subclass copy function. Unset and free any dynamically allocated resources. Intended for subclass usage only to chain up at the end of a subclass free function. - @@ -7146,7 +6778,6 @@ usage only to chain up at the end of a subclass free function. Intended for subclass usage - initializes @params with the parameters specified @@ -7221,9 +6852,7 @@ usage only to chain up at the end of a subclass free function. Convert stereoscopic/multiview video using fragment shaders. - - a new #GstGLViewConvert @@ -7231,7 +6860,6 @@ usage only to chain up at the end of a subclass free function. Provides an implementation of #GstBaseTransformClass.fixate_caps() - the fixated #GstCaps @@ -7257,7 +6885,6 @@ usage only to chain up at the end of a subclass free function. Retrieve the processed output buffer placing the output in @outbuf_ptr. - a #GstFlowReturn @@ -7276,7 +6903,6 @@ usage only to chain up at the end of a subclass free function. Converts the data contained by @inbuf using the formats specified by the #GstCaps passed to gst_gl_view_convert_set_caps() - a converted #GstBuffer or %NULL @@ -7295,7 +6921,6 @@ usage only to chain up at the end of a subclass free function. Reset @viewconvert to the default state. Further operation will require setting the caps with gst_gl_view_convert_set_caps(). - @@ -7308,7 +6933,6 @@ setting the caps with gst_gl_view_convert_set_caps(). Initializes @viewconvert with the information required for conversion. - @@ -7329,7 +6953,6 @@ setting the caps with gst_gl_view_convert_set_caps(). Set @context on @viewconvert - @@ -7346,7 +6969,6 @@ setting the caps with gst_gl_view_convert_set_caps(). Submit @input to be processed by @viewconvert - a #GstFlowReturn @@ -7368,7 +6990,6 @@ setting the caps with gst_gl_view_convert_set_caps(). Provides an implementation of #GstBaseTransformClass.transform_caps() - the converted #GstCaps @@ -7466,7 +7087,6 @@ setting the caps with gst_gl_view_convert_set_caps(). Opaque #GstGLViewConvertClass struct - @@ -7476,15 +7096,11 @@ setting the caps with gst_gl_view_convert_set_caps(). - - - + GstGLWindow represents a window that elements can render into. A window can either be a user visible window (onscreen) or hidden (offscreen). - - a new #GstGLWindow using @display's connection @@ -7497,7 +7113,6 @@ either be a user visible window (onscreen) or hidden (offscreen). - @@ -7509,7 +7124,6 @@ either be a user visible window (onscreen) or hidden (offscreen). Checks if @window controls the GL viewport. - %TRUE if @window controls the GL viewport, otherwise %FALSE @@ -7523,7 +7137,6 @@ either be a user visible window (onscreen) or hidden (offscreen). Redraw the window contents. Implementations should invoke the draw callback. - @@ -7535,7 +7148,6 @@ either be a user visible window (onscreen) or hidden (offscreen). - the windowing system display handle for this @window @@ -7548,7 +7160,6 @@ either be a user visible window (onscreen) or hidden (offscreen). - the window handle we are currently rendering into @@ -7566,7 +7177,6 @@ events are forwarded upstream as navigation events. In some window systems 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 @window. - @@ -7583,7 +7193,6 @@ from the @window. Query whether @window has output surface or not - %TRUE if @window has useable output surface @@ -7596,7 +7205,6 @@ from the @window. - @@ -7608,7 +7216,6 @@ from the @window. Queue resizing of @window. - @@ -7621,7 +7228,6 @@ from the @window. Quit the runloop's execution. - @@ -7634,7 +7240,6 @@ from the @window. Start the execution of the runloop. - @@ -7648,7 +7253,6 @@ from the @window. Invoke @callback with data on the window thread. @callback is guaranteed to have executed when this function returns. - @@ -7670,7 +7274,6 @@ have executed when this function returns. Invoke @callback with @data on the window thread. The callback may not have been executed when this function returns. - @@ -7696,7 +7299,6 @@ have been executed when this function returns. Set the preferred width and height of the window. Implementations are free to ignore this information. - @@ -7718,7 +7320,6 @@ to ignore this information. Tell a @window that it should render into a specific region of the window according to the #GstVideoOverlay interface. - whether the specified region could be set @@ -7749,7 +7350,6 @@ according to the #GstVideoOverlay interface. Sets the window that this @window should render into. Some implementations require this to be called with a valid handle before drawing can commence. - @@ -7766,7 +7366,6 @@ require this to be called with a valid handle before drawing can commence. Present the window to the screen. - @@ -7779,7 +7378,6 @@ require this to be called with a valid handle before drawing can commence. Checks if @window controls the GL viewport. - %TRUE if @window controls the GL viewport, otherwise %FALSE @@ -7793,7 +7391,6 @@ require this to be called with a valid handle before drawing can commence. Redraw the window contents. Implementations should invoke the draw callback. - @@ -7805,7 +7402,6 @@ require this to be called with a valid handle before drawing can commence. - the #GstGLContext associated with this @window @@ -7818,7 +7414,6 @@ require this to be called with a valid handle before drawing can commence. - the windowing system display handle for this @window @@ -7831,7 +7426,6 @@ require this to be called with a valid handle before drawing can commence. - @@ -7851,7 +7445,6 @@ require this to be called with a valid handle before drawing can commence. - the window handle we are currently rendering into @@ -7869,7 +7462,6 @@ events are forwarded upstream as navigation events. In some window systems 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 @window. - @@ -7886,7 +7478,6 @@ from the @window. Query whether @window has output surface or not - %TRUE if @window has useable output surface @@ -7900,7 +7491,6 @@ from the @window. Queue resizing of @window. - @@ -7913,7 +7503,6 @@ from the @window. Quit the runloop's execution. - @@ -7926,7 +7515,6 @@ from the @window. Resize @window to the given @width and @height. - @@ -7947,7 +7535,6 @@ from the @window. Start the execution of the runloop. - @@ -7959,7 +7546,6 @@ from the @window. - @@ -7978,7 +7564,6 @@ from the @window. Invoke @callback with data on the window thread. @callback is guaranteed to have executed when this function returns. - @@ -8000,7 +7585,6 @@ have executed when this function returns. Invoke @callback with @data on the window thread. The callback may not have been executed when this function returns. - @@ -8024,7 +7608,6 @@ have been executed when this function returns. - @@ -8049,7 +7632,6 @@ have been executed when this function returns. Notify a @window about a scroll event. A scroll signal holding the event coordinates will be emitted. - @@ -8078,7 +7660,6 @@ coordinates will be emitted. Sets the callback called when the window is about to close. - @@ -8103,7 +7684,6 @@ coordinates will be emitted. Sets the draw callback called every time gst_gl_window_draw() is called - @@ -8129,7 +7709,6 @@ coordinates will be emitted. Set the preferred width and height of the window. Implementations are free to ignore this information. - @@ -8151,7 +7730,6 @@ to ignore this information. Tell a @window that it should render into a specific region of the window according to the #GstVideoOverlay interface. - whether the specified region could be set @@ -8181,7 +7759,6 @@ according to the #GstVideoOverlay interface. Sets the resize callback called every time a resize of the window occurs. - @@ -8207,7 +7784,6 @@ according to the #GstVideoOverlay interface. Sets the window that this @window should render into. Some implementations require this to be called with a valid handle before drawing can commence. - @@ -8224,7 +7800,6 @@ require this to be called with a valid handle before drawing can commence. Present the window to the screen. - @@ -8357,7 +7932,6 @@ require this to be called with a valid handle before drawing can commence. - @@ -8368,14 +7942,12 @@ require this to be called with a valid handle before drawing can commence. - Parent class - the windowing system display handle for this @window @@ -8390,7 +7962,6 @@ require this to be called with a valid handle before drawing can commence. - @@ -8408,7 +7979,6 @@ require this to be called with a valid handle before drawing can commence. - the window handle we are currently rendering into @@ -8423,7 +7993,6 @@ require this to be called with a valid handle before drawing can commence. - @@ -8437,7 +8006,6 @@ require this to be called with a valid handle before drawing can commence. - @@ -8451,7 +8019,6 @@ require this to be called with a valid handle before drawing can commence. - @@ -8465,7 +8032,6 @@ require this to be called with a valid handle before drawing can commence. - @@ -8487,7 +8053,6 @@ require this to be called with a valid handle before drawing can commence. - @@ -8513,7 +8078,6 @@ require this to be called with a valid handle before drawing can commence. - @@ -8526,7 +8090,6 @@ require this to be called with a valid handle before drawing can commence. - @@ -8539,7 +8102,6 @@ require this to be called with a valid handle before drawing can commence. - @@ -8557,7 +8119,6 @@ require this to be called with a valid handle before drawing can commence. - @@ -8579,7 +8140,6 @@ require this to be called with a valid handle before drawing can commence. - @@ -8593,7 +8153,6 @@ require this to be called with a valid handle before drawing can commence. - whether the specified region could be set @@ -8624,7 +8183,6 @@ require this to be called with a valid handle before drawing can commence. - @@ -8638,7 +8196,6 @@ require this to be called with a valid handle before drawing can commence. - %TRUE if @window controls the GL viewport, otherwise %FALSE @@ -8653,7 +8210,6 @@ require this to be called with a valid handle before drawing can commence. - %TRUE if @window has useable output surface @@ -8689,11 +8245,8 @@ require this to be called with a valid handle before drawing can commence. - - - + - @@ -8712,58 +8265,47 @@ require this to be called with a valid handle before drawing can commence. GL Allocation flag indicating that the implementation should allocate the necessary resources. - GL allocation flag indicating the allocation of a GL buffer. - Values >= than #GST_GL_ALLOCATION_PARAMS_ALLOC_FLAG_USER can be used for user-defined purposes. - GL allocation flag indicating the allocation of 2D video frames - GL Allocation flag for using the provided GPU handle as storage. - GL Allocation flag for using the provided system memory data as storage. - The name for %GST_GL_API_GLES1 used in various places - The name for %GST_GL_API_GLES2 used in various places - The name for %GST_GL_API_OPENGL3 used in various places - The name for %GST_GL_API_OPENGL used in various places - Stores a debug message in @ad for later output - the #GstGLAsyncDebug to store the message in @@ -8786,49 +8328,42 @@ user-defined purposes. - - - - - - - @@ -8836,60 +8371,51 @@ user-defined purposes. The name of the GL buffer allocator - - - - - - - - - @@ -8897,115 +8423,95 @@ user-defined purposes. The name of the GL buffer allocator - - - - - - - The currently supported formats that can be converted - The currently supported #GstCaps that can be converted - - - - - - - - - - - - @@ -9013,81 +8519,69 @@ user-defined purposes. The name used in #GstContext queries for requesting a #GstGLDisplay - - - - - - - - - - - - @@ -9095,39 +8589,33 @@ user-defined purposes. The name of the GL memory allocator - - - - - - @@ -9135,62 +8623,52 @@ user-defined purposes. The name of the GL Memory PBO allocator - - List of video formats that are supported by #GstGLMemory - - - - - - - - @@ -9198,32 +8676,27 @@ user-defined purposes. The name of the GL renderbuffer allocator - - - - - @@ -9231,63 +8704,53 @@ user-defined purposes. String used for %GST_GL_TEXTURE_TARGET_2D in things like caps values - String used for %GST_GL_TEXTURE_TARGET_EXTERNAL_OES in things like caps values - String used for %GST_GL_TEXTURE_TARGET_RECTANGLE in things like caps values - - - - - - - - @@ -9295,7 +8758,6 @@ user-defined purposes. Cast to the current function type for generic window callbacks - the function to cast @@ -9303,28 +8765,24 @@ user-defined purposes. - - - - @@ -9332,7 +8790,6 @@ user-defined purposes. Cast to the current function type for window resize callbacks - the function to cast @@ -9340,266 +8797,228 @@ user-defined purposes. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -9611,11 +9030,9 @@ user-defined purposes. Combining #GST_MAP_GL with #GST_MAP_WRITE has the same semantics as though you are writing to OpenGL. Conversely, combining #GST_MAP_GL with #GST_MAP_READ has the same semantics as though you are reading from OpenGL. - - the #GstGLSyncMeta added to #GstBuffer @@ -9632,7 +9049,6 @@ you are writing to OpenGL. Conversely, combining #GST_MAP_GL with - the #GstGLSyncMeta added to #GstBuffer @@ -9653,14 +9069,12 @@ you are writing to OpenGL. Conversely, combining #GST_MAP_GL with - - the currently set #GstGLAllocationParams or %NULL @@ -9674,7 +9088,6 @@ you are writing to OpenGL. Conversely, combining #GST_MAP_GL with Sets @params on @config - @@ -9690,7 +9103,6 @@ you are writing to OpenGL. Conversely, combining #GST_MAP_GL with - Whether @display was in @context @@ -9708,7 +9120,6 @@ you are writing to OpenGL. Conversely, combining #GST_MAP_GL with Sets @display on @context - @@ -9724,7 +9135,6 @@ you are writing to OpenGL. Conversely, combining #GST_MAP_GL with - The #GstGLAPI represented by @api_s @@ -9737,7 +9147,6 @@ you are writing to OpenGL. Conversely, combining #GST_MAP_GL with - A space separated string of the OpenGL api's enabled in @api @@ -9751,14 +9160,12 @@ you are writing to OpenGL. Conversely, combining #GST_MAP_GL with Free with gst_gl_async_debug_free() - a new #GstGLAsyncDebug - a new #GstGLBaseMemory from @allocator with the requested @params. @@ -9783,7 +9190,6 @@ you are writing to OpenGL. Conversely, combining #GST_MAP_GL with Initializes the GL Base Memory allocator. It is safe to call this function multiple times. This must be called before any other GstGLBaseMemory operation. - @@ -9791,13 +9197,11 @@ multiple times. This must be called before any other GstGLBaseMemory operation. Initializes the GL Buffer allocator. It is safe to call this function multiple times. This must be called before any other #GstGLBuffer operation. - - whether @name is in the space separated list of @ext @@ -9820,21 +9224,18 @@ multiple times. This must be called before any other #GstGLBuffer operation. - - - @@ -9864,7 +9265,6 @@ retrieval. This also performs a #GstContext query (if necessary) for an optional application provided #GstGLContext using the name "gst.gl.app_context". The returned #GstGLContext will be shared with a GStreamer created OpenGL context. - whether a #GstGLDisplay exists in @display_ptr @@ -9885,7 +9285,6 @@ The returned #GstGLContext will be shared with a GStreamer created OpenGL contex - the #GstGLFormat necessary for holding the data in @plane of @vinfo @@ -9906,7 +9305,6 @@ The returned #GstGLContext will be shared with a GStreamer created OpenGL contex - Whether @format is supported by @context based on the OpenGL API, version, or available OpenGL extension/s. @@ -9926,7 +9324,6 @@ The returned #GstGLContext will be shared with a GStreamer created OpenGL contex Get the unsized format and type from @format for usage in glReadPixels, glTex{Sub}Image*, glTexImage* and similar functions. - @@ -9946,7 +9343,6 @@ glTex{Sub}Image*, glTexImage* and similar functions. - the number of bytes the specified @format, @type combination takes per pixel @@ -9965,7 +9361,6 @@ per pixel Retrieve the size in bytes of a video plane of data with a certain alignment - @@ -9985,7 +9380,6 @@ per pixel - difference between the supposed start of the plane from the @info and where the data from the previous plane ends. @@ -10007,7 +9401,6 @@ per pixel - Whether the @query was successfully responded to from the passed @display, @context, and @other_context. @@ -10042,7 +9435,6 @@ OpenGL capable elements. Retrieve's the #GstGLDisplay or #GstGLContext in @context and places the result in @display or @other_context respectively. - whether the @display or @other_context could be set successfully @@ -10069,7 +9461,6 @@ result in @display or @other_context respectively. Inserts a marker into a GL debug stream. Requires the 'gldebugmarker' debug category to be at least %GST_LEVEL_FIXME. - @@ -10091,19 +9482,16 @@ debug category to be at least %GST_LEVEL_FIXME. Initializes the GL Base Texture allocator. It is safe to call this function multiple times. This must be called before any other GstGLMemory operation. - - - whether the buffer was correctly setup @@ -10142,7 +9530,6 @@ multiple times. This must be called before any other GstGLMemory operation. - The #GstGLPlatform represented by @platform_s @@ -10155,7 +9542,6 @@ multiple times. This must be called before any other GstGLMemory operation. - A space separated string of the OpenGL platforms enabled in @platform @@ -10168,7 +9554,6 @@ multiple times. This must be called before any other GstGLMemory operation. - @@ -10188,7 +9573,6 @@ multiple times. This must be called before any other GstGLMemory operation.Performs a GST_QUERY_CONTEXT query of type "gst.gl.local_context" on all #GstPads in @element of @direction for the local OpenGL context used by GStreamer elements. - whether @context_ptr contains a #GstGLContext @@ -10211,7 +9595,6 @@ GStreamer elements. Free with gst_gl_query_free() - a new #GstGLQuery @@ -10228,7 +9611,6 @@ GStreamer elements. - @@ -10247,13 +9629,11 @@ GStreamer elements. Initializes the GL Base Texture allocator. It is safe to call this function multiple times. This must be called before any other GstGLRenderbuffer operation. - - the sized internal format specified by @format and @type that can be used in @context @@ -10275,25 +9655,21 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - - - - the #GstGLTextureTarget that's equiavalant to @target or %GST_GL_TEXTURE_TARGET_NONE @@ -10307,7 +9683,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - the #GstGLTextureTarget represented by @str or %GST_GL_TEXTURE_TARGET_NONE @@ -10321,7 +9696,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - a string representing the @GstBufferPoolOption specified by @target @@ -10334,7 +9708,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - the OpenGL value for binding the @target with glBindTexture() and similar functions or 0 @@ -10348,7 +9721,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - the stringified version of @target or %NULL @@ -10362,7 +9734,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio See gst_gl_value_set_texture_target_from_mask() for what entails a mask - the mask of #GstGLTextureTarget's in @value @@ -10375,7 +9746,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - whether the @target could be set on @value @@ -10394,7 +9764,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio A mask is a bitwise OR of (1 << target) where target is a valid #GstGLTextureTarget - whether the @target_mask could be set on @value @@ -10411,7 +9780,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - The minimum supported #GstGLSLVersion available for @gl_api, @maj and @min @@ -10444,7 +9812,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - the #GstGLSLProfile of @string or %GST_GLSL_PROFILE_NONE on error @@ -10457,7 +9824,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio - the name for @profile or %NULL on error @@ -10472,7 +9838,6 @@ multiple times. This must be called before any other GstGLRenderbuffer operatio Note: this function first searches the first 1 kilobytes for a `#version` preprocessor directive and then executes gst_glsl_version_profile_from_string(). - TRUE if a valid `#version` string was found, FALSE otherwise @@ -10493,7 +9858,6 @@ preprocessor directive and then executes gst_glsl_version_profile_from_string(). - the #GstGLSLVersion of @string or %GST_GLSL_VERSION_NONE on error @@ -10508,7 +9872,6 @@ preprocessor directive and then executes gst_glsl_version_profile_from_string(). Note: this function expects either a `#version` GLSL preprocesser directive or a valid GLSL version and/or profile. - TRUE if a valid `#version` string was found, FALSE otherwise @@ -10529,7 +9892,6 @@ or a valid GLSL version and/or profile. - the combined GLSL `#version` string for @version and @profile @@ -10546,7 +9908,6 @@ or a valid GLSL version and/or profile. - the name of @version or %NULL on error @@ -10566,7 +9927,6 @@ or a valid GLSL version and/or profile. formats. - whether the memory at @mem is a #GstGLBaseMemory @@ -10579,7 +9939,6 @@ formats. - whether the memory at @mem is a #GstGLBuffer @@ -10592,7 +9951,6 @@ formats. - whether the memory at @mem is a #GstGLMemory @@ -10605,7 +9963,6 @@ formats. - whether the memory at @mem is a #GstGLMemoryPBO @@ -10618,7 +9975,6 @@ formats. - whether the memory at @mem is a #GstGLRenderbuffer diff --git a/gir-files/GstGLEGL-1.0.gir b/gir-files/GstGLEGL-1.0.gir index 6b8e7ac2a..30fbb7295 100644 --- a/gir-files/GstGLEGL-1.0.gir +++ b/gir-files/GstGLEGL-1.0.gir @@ -10,24 +10,17 @@ and/or use gtk-doc annotations. --> - - - - the contents of a #GstGLDisplayEGL are private and should only be accessed through the provided API - Create a new #GstGLDisplayEGL using the default EGL_DEFAULT_DISPLAY. - a new #GstGLDisplayEGL or %NULL - @@ -42,7 +35,6 @@ through the provided API This function will return the same value for multiple calls with the same @display. - a new #GstGLDisplayEGL @@ -58,7 +50,6 @@ This function will return the same value for multiple calls with the same Attempts to create a new `EGLDisplay` from @display. If @type is %GST_GL_DISPLAY_TYPE_ANY, then @display must be 0. @type must not be %GST_GL_DISPLAY_TYPE_NONE. - A `EGLDisplay` or `EGL_NO_DISPLAY` @@ -90,7 +81,6 @@ This function will return the same value for multiple calls with the same - @@ -100,99 +90,69 @@ This function will return the same value for multiple calls with the same - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #GstGLDisplayEGL represents a connection to an EGL `EGLDisplay` handle created internally (gst_gl_display_egl_new()) or wrapped by the application @@ -203,6 +163,5 @@ internally (gst_gl_display_egl_new()) or wrapped by the application (gst_gl_display_egl_device_new()) or wrapped by the application (gst_gl_display_egl_device_new_with_egl_device()) - diff --git a/gir-files/GstGLWayland-1.0.gir b/gir-files/GstGLWayland-1.0.gir index 865c8dc0b..f6ead9af4 100644 --- a/gir-files/GstGLWayland-1.0.gir +++ b/gir-files/GstGLWayland-1.0.gir @@ -13,11 +13,9 @@ and/or use gtk-doc annotations. --> the contents of a #GstGLDisplayWayland are private and should only be accessed through the provided API - Create a new #GstGLDisplayWayland from the wayland display name. See `wl_display_connect`() for details on what is a valid name. - a new #GstGLDisplayWayland or %NULL @@ -31,7 +29,6 @@ for details on what is a valid name. Creates a new display connection from a wl_display Display. - a new #GstGLDisplayWayland @@ -71,7 +68,6 @@ for details on what is a valid name. - @@ -82,35 +78,30 @@ for details on what is a valid name. - - - - - diff --git a/gir-files/GstGLX11-1.0.gir b/gir-files/GstGLX11-1.0.gir index 6bdcb7f73..d1ec60d37 100644 --- a/gir-files/GstGLX11-1.0.gir +++ b/gir-files/GstGLX11-1.0.gir @@ -13,11 +13,9 @@ and/or use gtk-doc annotations. --> the contents of a #GstGLDisplayX11 are private and should only be accessed through the provided API - Create a new #GstGLDisplayX11 from the x11 display name. See `XOpenDisplay`() for details on what is a valid name. - a new #GstGLDisplayX11 or %NULL @@ -31,7 +29,6 @@ for details on what is a valid name. Creates a new display connection from a X11 Display. - a new #GstGLDisplayX11 @@ -65,7 +62,6 @@ for details on what is a valid name. - @@ -76,35 +72,30 @@ for details on what is a valid name. - - - - - diff --git a/gir-files/GstMpegts-1.0.gir b/gir-files/GstMpegts-1.0.gir index 5e84fbc6d..926e376a0 100644 --- a/gir-files/GstMpegts-1.0.gir +++ b/gir-files/GstMpegts-1.0.gir @@ -12,7 +12,6 @@ and/or use gtk-doc annotations. --> the various ATSC specifications. Consult the relevant specifications for more details. - @@ -60,7 +59,6 @@ Consult the relevant specifications for more details. Event Information Table (ATSC) - The source id @@ -78,7 +76,6 @@ Consult the relevant specifications for more details. An ATSC EIT Event - The event id @@ -110,7 +107,6 @@ Consult the relevant specifications for more details. Extended Text Table (ATSC) - @@ -131,7 +127,6 @@ Consult the relevant specifications for more details. Master Guide Table (A65) - The protocol version @@ -153,7 +148,6 @@ Consult the relevant specifications for more details. - @@ -161,7 +155,6 @@ Consult the relevant specifications for more details. Source from a @GstMpegtsAtscMGT - #GstMpegtsAtscMGTTableType @@ -185,7 +178,6 @@ Consult the relevant specifications for more details. - @@ -196,7 +188,6 @@ Consult the relevant specifications for more details. - The ISO639 language code @@ -211,7 +202,6 @@ Consult the relevant specifications for more details. Region Rating Table (A65) - The protocol version @@ -239,14 +229,12 @@ Consult the relevant specifications for more details. - - @@ -264,14 +252,12 @@ Consult the relevant specifications for more details. - - the abbreviated ratings @@ -285,7 +271,6 @@ Consult the relevant specifications for more details. - @@ -293,7 +278,6 @@ Consult the relevant specifications for more details. System Time Table (A65) - The protocol version @@ -328,13 +312,11 @@ Consult the relevant specifications for more details. - - @@ -347,7 +329,6 @@ Consult the relevant specifications for more details. A string segment - The compression type @@ -368,7 +349,6 @@ Consult the relevant specifications for more details. - @@ -379,7 +359,6 @@ Consult the relevant specifications for more details. - @@ -403,7 +382,6 @@ Consult the relevant specifications for more details. Represents both: Terrestrial Virtual Channel Table (A65) Cable Virtual Channel Table (A65) - The transport stream @@ -427,7 +405,6 @@ Consult the relevant specifications for more details. Source from a @GstMpegtsAtscVCT, can be used both for TVCT and CVCT tables - The short name of a source @@ -497,7 +474,6 @@ Consult the relevant specifications for more details. DVB Bouquet Association Table (EN 300 468) - @@ -510,7 +486,6 @@ Consult the relevant specifications for more details. - @@ -525,7 +500,6 @@ Consult the relevant specifications for more details. Cable Delivery System Descriptor (EN 300 468 v.1.13.1) - the frequency in Hz (Hertz) @@ -547,7 +521,6 @@ Consult the relevant specifications for more details. - @@ -559,7 +532,6 @@ Consult the relevant specifications for more details. - @@ -568,7 +540,6 @@ Consult the relevant specifications for more details. - @@ -586,7 +557,6 @@ Consult the relevant specifications for more details. - @@ -605,7 +575,6 @@ Consult the relevant specifications for more details. - @@ -617,7 +586,6 @@ Consult the relevant specifications for more details. - @@ -642,7 +610,6 @@ Consult the relevant specifications for more details. - @@ -677,7 +644,6 @@ These values correspond to the registered descriptor type from the various DVB specifications. Consult the relevant specifications for more details. - @@ -814,7 +780,6 @@ These values correspond to the registered extended descriptor type from the various DVB specifications. Consult the relevant specifications for more details. - @@ -857,7 +822,6 @@ Consult the relevant specifications for more details. - the transport id @@ -886,7 +850,6 @@ Consult the relevant specifications for more details. - @@ -897,7 +860,6 @@ Consult the relevant specifications for more details. - The #GstMpegtsDVBLinkageEvent or %NULL if an error happened @@ -910,7 +872,6 @@ Consult the relevant specifications for more details. - an #GstMpegtsDVBLinkageExtendedEvent array or %NULL if an error happened @@ -925,7 +886,6 @@ Consult the relevant specifications for more details. - The #GstMpegtsDVBLinkageMobileHandOver or %NULL if an error happened @@ -939,7 +899,6 @@ Consult the relevant specifications for more details. - @@ -951,7 +910,6 @@ Consult the relevant specifications for more details. - @@ -987,7 +945,6 @@ Consult the relevant specifications for more details. - @@ -998,7 +955,6 @@ Consult the relevant specifications for more details. - @@ -1014,7 +970,6 @@ Consult the relevant specifications for more details. Linkage Type (EN 300 468 v.1.13.1) - @@ -1047,7 +1002,6 @@ Consult the relevant specifications for more details. - @@ -1056,7 +1010,6 @@ Consult the relevant specifications for more details. - @@ -1077,7 +1030,6 @@ Consult the relevant specifications for more details. - the id of a service @@ -1091,7 +1043,6 @@ Consult the relevant specifications for more details. The type of service of a channel. As specified in Table 87 of ETSI EN 300 468 v1.13.1 - @@ -1153,7 +1104,6 @@ As specified in Table 87 of ETSI EN 300 468 v1.13.1 The type of teletext page. As specified in Table 100 of ETSI EN 300 468 v1.13.1 - @@ -1166,7 +1116,6 @@ As specified in Table 100 of ETSI EN 300 468 v1.13.1 - the data broadcast id @@ -1191,7 +1140,6 @@ As specified in Table 100 of ETSI EN 300 468 v1.13.1 - @@ -1207,7 +1155,6 @@ As specified in Table 100 of ETSI EN 300 468 v1.13.1 For more details, refer to the ITU H.222.0 or ISO/IEC 13818-1 specifications and other specifications mentioned in the documentation. - the type of descriptor @@ -1232,7 +1179,6 @@ two bytes are the @tag and @length. Frees @desc - @@ -1245,7 +1191,6 @@ two bytes are the @tag and @length. Extracts the Conditional Access information from @descriptor. - %TRUE if parsing succeeded, else %FALSE. @@ -1277,7 +1222,6 @@ two bytes are the @tag and @length. Extracts the cable delivery system information from @descriptor. - %TRUE if parsing succeeded, else %FALSE. @@ -1295,7 +1239,6 @@ two bytes are the @tag and @length. Extracts the bouquet name from @descriptor. - %TRUE if parsing succeeded, else %FALSE. @@ -1312,7 +1255,6 @@ two bytes are the @tag and @length. Extracts ca id's from @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1334,7 +1276,6 @@ are found in http://www.dvbservices.com Extracts the DVB component information from @descriptor. - %TRUE if parsing succeeded, else %FALSE. @@ -1352,7 +1293,6 @@ are found in http://www.dvbservices.com Extracts the DVB content information from @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1372,7 +1312,6 @@ are found in http://www.dvbservices.com Parses out the data broadcast from the @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1390,7 +1329,6 @@ are found in http://www.dvbservices.com Parses out the data broadcast id from the @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1418,7 +1356,6 @@ are found in http://www.dvbservices.com Extracts the DVB extended event information from @descriptor. - %TRUE if parsing succeeded, else %FALSE. @@ -1436,7 +1373,6 @@ are found in http://www.dvbservices.com Parses out a list of frequencies from the @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1461,7 +1397,6 @@ depending on @offset Extracts the DVB linkage information from @descriptor. - %TRUE if parsing succeeded, else %FALSE. @@ -1479,7 +1414,6 @@ depending on @offset Parses out the multilingual bouquet name from the @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1501,7 +1435,6 @@ a #GstMpegtsDvbMultilingualBouquetNameItem Parses out the multilingual component from the @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1527,7 +1460,6 @@ a #GstMpegtsDvbMultilingualComponentItem Parses out the multilingual network name from the @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1549,7 +1481,6 @@ a #GstMpegtsDvbMultilingualNetworkNameItem Parses out the multilingual service name from the @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1571,7 +1502,6 @@ a #GstMpegtsDvbMultilingualServiceNameItem Parses out the dvb network name from the @descriptor: - %TRUE if the parsing happened correctly, else %FALSE. @@ -1589,7 +1519,6 @@ a #GstMpegtsDvbMultilingualServiceNameItem Extracts the DVB parental rating information from @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1610,7 +1539,6 @@ a #GstMpegtsDvbMultilingualServiceNameItem Parses out the private data specifier from the @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1639,7 +1567,6 @@ registered by http://www.dvbservices.com/ Parses out the scrambling mode from the @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1661,7 +1588,6 @@ administered by the DVB Common Scrambling Algorithm Custodian. Extracts the dvb service information from @descriptor. - %TRUE if parsing succeeded, else %FALSE. @@ -1687,7 +1613,6 @@ administered by the DVB Common Scrambling Algorithm Custodian. Parses out a list of services from the @descriptor: - %TRUE if the parsing happened correctly, else %FALSE. @@ -1708,7 +1633,6 @@ the list of services Extracts the DVB short event information from @descriptor. - %TRUE if parsing succeeded, else %FALSE. @@ -1734,7 +1658,6 @@ the list of services Extracts the component tag from @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1752,7 +1675,6 @@ the list of services Parses out the stuffing bytes from the @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1773,7 +1695,6 @@ the list of services Note: Use #gst_tag_get_language_code if you want to get the the ISO 639-1 language code from the returned ISO 639-2 one. - %TRUE if parsing succeeded, else %FALSE. @@ -1806,7 +1727,6 @@ ISO 639-1 language code from the returned ISO 639-2 one. - The number of entries in @descriptor @@ -1820,7 +1740,6 @@ ISO 639-1 language code from the returned ISO 639-2 one. Parses out the DVB-T2 delivery system from the @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -1838,7 +1757,6 @@ ISO 639-1 language code from the returned ISO 639-2 one. Parses teletext number @idx in the @descriptor. The language is in ISO639 format. - FALSE on out-of-bounds and errors @@ -1870,7 +1788,6 @@ ISO 639-1 language code from the returned ISO 639-2 one. Find the number of teletext entries in @descriptor - Number of teletext entries @@ -1887,7 +1804,6 @@ ISO 639-1 language code from the returned ISO 639-2 one. Note: Use #gst_tag_get_language_code if you want to get the the ISO 639-1 language code from the returned ISO 639-2 one. - %TRUE if parsing succeeded, else %FALSE. @@ -1908,7 +1824,6 @@ ISO 639-1 language code from the returned ISO 639-2 one. Note: Use #gst_tag_get_language_code if you want to get the the ISO 639-1 language code from the returned ISO 639-2 one. - %TRUE if parsing succeeded, else %FALSE. @@ -1933,7 +1848,6 @@ ISO 639-1 language code from the returned ISO 639-2 one. - The number of languages in @descriptor @@ -1947,7 +1861,6 @@ ISO 639-1 language code from the returned ISO 639-2 one. Extracts the logical channels from @descriptor. - %TRUE if parsing succeeded, else %FALSE. @@ -1965,7 +1878,6 @@ ISO 639-1 language code from the returned ISO 639-2 one. Extracts the satellite delivery system information from @descriptor. - %TRUE if parsing succeeded, else %FALSE. @@ -1983,7 +1895,6 @@ ISO 639-1 language code from the returned ISO 639-2 one. Parses out the terrestrial delivery system from the @descriptor. - %TRUE if the parsing happened correctly, else %FALSE. @@ -2001,7 +1912,6 @@ ISO 639-1 language code from the returned ISO 639-2 one. Creates a #GstMpegtsDescriptor with custom @tag and @data - #GstMpegtsDescriptor @@ -2025,7 +1935,6 @@ ISO 639-1 language code from the returned ISO 639-2 one. Creates a #GstMpegtsDescriptor with custom @tag, @tag_extension and @data - #GstMpegtsDescriptor @@ -2055,7 +1964,6 @@ ISO 639-1 language code from the returned ISO 639-2 one. Creates a #GstMpegtsDescriptor to be a %GST_MTS_DESC_DVB_NETWORK_NAME, with the network name @name. The data field of the #GstMpegtsDescriptor will be allocated, and transferred to the caller. - the #GstMpegtsDescriptor or %NULL on fail @@ -2071,7 +1979,6 @@ will be allocated, and transferred to the caller. Fills a #GstMpegtsDescriptor to be a %GST_MTS_DESC_DVB_SERVICE. The data field of the #GstMpegtsDescriptor will be allocated, and transferred to the caller. - the #GstMpegtsDescriptor or %NULL on fail @@ -2092,7 +1999,6 @@ and transferred to the caller. - @@ -2118,7 +2024,6 @@ and transferred to the caller. Creates a %GST_MTS_DESC_ISO_639_LANGUAGE #GstMpegtsDescriptor with a single language - #GstMpegtsDescriptor, %NULL on failure @@ -2132,7 +2037,6 @@ a single language Creates a %GST_MTS_DESC_REGISTRATION #GstMpegtsDescriptor - #GstMpegtsDescriptor, %NULL on failure @@ -2162,7 +2066,6 @@ These values correspond to the registered descriptor type from the base MPEG-TS specifications (ITU H.222.0 | ISO/IEC 13818-1). Consult the relevant specifications for more details. - @@ -2274,7 +2177,6 @@ Consult the relevant specifications for more details. a multilingual bouquet name entry - the ISO 639 language code @@ -2285,7 +2187,6 @@ Consult the relevant specifications for more details. - the ISO 639 language code @@ -2297,7 +2198,6 @@ Consult the relevant specifications for more details. a multilingual network name entry - the ISO 639 language code @@ -2309,7 +2209,6 @@ Consult the relevant specifications for more details. a multilingual service name entry - the ISO 639 language code @@ -2325,7 +2224,6 @@ Consult the relevant specifications for more details. Event Information Table (EN 300 468) - @@ -2353,7 +2251,6 @@ Consult the relevant specifications for more details. Event from a @GstMpegtsEIT - @@ -2378,7 +2275,6 @@ Consult the relevant specifications for more details. Extended Event Descriptor (EN 300 468 v.1.13.1) - @@ -2399,7 +2295,6 @@ Consult the relevant specifications for more details. - @@ -2411,7 +2306,6 @@ Consult the relevant specifications for more details. - @@ -2424,7 +2318,6 @@ Consult the relevant specifications for more details. the various ISDB specifications. Consult the relevant specifications for more details. - @@ -2491,7 +2384,6 @@ Consult the relevant specifications for more details. - @@ -2506,7 +2398,6 @@ Consult the relevant specifications for more details. - @@ -2518,7 +2409,6 @@ Consult the relevant specifications for more details. - @@ -2529,7 +2419,6 @@ Consult the relevant specifications for more details. - @@ -2541,7 +2430,6 @@ Consult the relevant specifications for more details. - @@ -2556,14 +2444,12 @@ Consult the relevant specifications for more details. These values correspond to miscellaneous descriptor types that are not yet identified from known specifications. - - @@ -2597,7 +2483,6 @@ not yet identified from known specifications. Network Information Table (ISO/IEC 13818-1 / EN 300 468) - Whether this NIT corresponds to the actual stream @@ -2620,7 +2505,6 @@ not yet identified from known specifications. Allocates and initializes a #GstMpegtsNIT. - A newly allocated #GstMpegtsNIT @@ -2628,7 +2512,6 @@ not yet identified from known specifications. - @@ -2642,7 +2525,6 @@ not yet identified from known specifications. Allocates and initializes a #GstMpegtsNITStream - A newly allocated #GstMpegtsNITStream @@ -2654,7 +2536,6 @@ not yet identified from known specifications. The program_number is contained in the subtable_extension field of the container #GstMpegtsSection. - PID of the stream containing PCR @@ -2676,7 +2557,6 @@ container #GstMpegtsSection. Allocates and initializes a new #GstMpegtsPMT. - #GstMpegtsPMT @@ -2685,7 +2565,6 @@ container #GstMpegtsSection. An individual stream definition. - the type of stream. See #GstMpegtsStreamType @@ -2703,7 +2582,6 @@ stream Allocates and initializes a new #GstMpegtsPMTStream. - #GstMpegtsPMTStream @@ -2711,7 +2589,6 @@ stream - @@ -2723,7 +2600,6 @@ stream A program entry from a Program Association Table (ITU H.222.0, ISO/IEC 13818-1). - the program number @@ -2734,7 +2610,6 @@ stream Allocates a new #GstMpegtsPatProgram. - A newly allocated #GstMpegtsPatProgram @@ -2745,7 +2620,6 @@ stream Running status of a service. Corresponds to table 6 of ETSI EN 300 468 (v1.13.0) - @@ -2760,7 +2634,6 @@ Corresponds to table 6 of ETSI EN 300 468 (v1.13.0) - @@ -2800,7 +2673,6 @@ Corresponds to table 6 of ETSI EN 300 468 (v1.13.0) Allocates and initializes a #GstMpegtsSCTESIT. - A newly allocated #GstMpegtsSCTESIT @@ -2808,7 +2680,6 @@ Corresponds to table 6 of ETSI EN 300 468 (v1.13.0) - @@ -2823,7 +2694,6 @@ Corresponds to table 6 of ETSI EN 300 468 (v1.13.0) - @@ -2836,7 +2706,6 @@ Corresponds to table 6 of ETSI EN 300 468 (v1.13.0) - @@ -2881,7 +2750,6 @@ Corresponds to table 6 of ETSI EN 300 468 (v1.13.0) Allocates and initializes a #GstMpegtsSCTESpliceEvent. - A newly allocated #GstMpegtsSCTESpliceEvent @@ -2890,7 +2758,6 @@ Corresponds to table 6 of ETSI EN 300 468 (v1.13.0) Service Description Table (EN 300 468) - Network ID of the originating delivery system @@ -2911,7 +2778,6 @@ Corresponds to table 6 of ETSI EN 300 468 (v1.13.0) Allocates and initializes a #GstMpegtsSDT. - A newly allocated #GstMpegtsSDT @@ -2919,7 +2785,6 @@ Corresponds to table 6 of ETSI EN 300 468 (v1.13.0) - The program number this table belongs to @@ -2948,7 +2813,6 @@ Corresponds to table 6 of ETSI EN 300 468 (v1.13.0) Allocates and initializes a #GstMpegtsSDTService. - A newly allocated #GstMpegtsSDTService @@ -2956,14 +2820,12 @@ Corresponds to table 6 of ETSI EN 300 468 (v1.13.0) - - @@ -2971,7 +2833,6 @@ Corresponds to table 6 of ETSI EN 300 468 (v1.13.0) Satellite Delivery System Descriptor (EN 300 468 v.1.13.1) - the frequency in kHz (kiloHertz) @@ -3011,7 +2872,6 @@ else in the western part. - @@ -3022,7 +2882,6 @@ else in the western part. - @@ -3036,7 +2895,6 @@ else in the western part. Type of mpeg-ts streams for SCTE - SCTE-27 Subtitling @@ -3068,7 +2926,6 @@ Signaling (OC-SP-ETV-AM1.0.1-120614) For more details, refer to the ITU H.222.0 or ISO/IEC 13818-1 specifications and other specifications mentioned in the documentation. - @@ -3144,7 +3001,6 @@ returned. Note: it is the responsibility of the caller to ensure @data does point to the beginning of the section. - A new #GstMpegtsSection if the data was valid, else %NULL @@ -3170,7 +3026,6 @@ should contain the table_id field). Returns the #GstMpegtsAtscVCT contained in the @section - The #GstMpegtsAtscVCT contained in the section, or %NULL if an error happened. @@ -3185,7 +3040,6 @@ happened. Returns the #GstMpegtsAtscEIT contained in the @section. - The #GstMpegtsAtscEIT contained in the section, or %NULL if an error happened. @@ -3200,7 +3054,6 @@ happened. Returns the #GstMpegtsAtscETT contained in the @section. - The #GstMpegtsAtscETT contained in the section, or %NULL if an error happened. @@ -3215,7 +3068,6 @@ happened. Returns the #GstMpegtsAtscMGT contained in the @section. - The #GstMpegtsAtscMGT contained in the section, or %NULL if an error happened. @@ -3230,7 +3082,6 @@ happened. Returns the #GstMpegtsAtscRRT contained in the @section. - The #GstMpegtsAtscRRT contained in the section, or %NULL if an error happened. @@ -3245,7 +3096,6 @@ happened. Returns the #GstMpegtsAtscSTT contained in the @section. - The #GstMpegtsAtscSTT contained in the section, or %NULL if an error happened. @@ -3260,7 +3110,6 @@ happened. Returns the #GstMpegtsAtscVCT contained in the @section - The #GstMpegtsAtscVCT contained in the section, or %NULL if an error happened. @@ -3275,7 +3124,6 @@ happened. Returns the #GstMpegtsBAT contained in the @section. - The #GstMpegtsBAT contained in the section, or %NULL if an error happened. @@ -3291,7 +3139,6 @@ happened. Returns the array of #GstMpegtsDescriptor contained in the Conditional Access Table. - The #GstMpegtsDescriptor contained in the section, or %NULL if an error @@ -3309,7 +3156,6 @@ happened. Release with #g_array_unref when done. Gets the original unparsed section data. - The original unparsed section data. @@ -3323,7 +3169,6 @@ happened. Release with #g_array_unref when done. Returns the #GstMpegtsEIT contained in the @section. - The #GstMpegtsEIT contained in the section, or %NULL if an error happened. @@ -3338,7 +3183,6 @@ happened. Returns the #GstMpegtsNIT contained in the @section. - The #GstMpegtsNIT contained in the section, or %NULL if an error happened. @@ -3358,7 +3202,6 @@ Returns the array of #GstMpegtsPatProgram contained in the section. Note: The PAT "transport_id" field corresponds to the "subtable_extension" field of the provided @section. - The #GstMpegtsPatProgram contained in the section, or %NULL if an error @@ -3376,7 +3219,6 @@ happened. Release with #g_ptr_array_unref when done. Returns the #GstMpegtsPMT contained in the @section. - The #GstMpegtsPMT contained in the section, or %NULL if an error happened. @@ -3391,7 +3233,6 @@ happened. Returns the #GstMpegtsSCTESIT contained in the @section. - The #GstMpegtsSCTESIT contained in the section, or %NULL if an error happened. @@ -3406,7 +3247,6 @@ happened. Returns the #GstMpegtsSDT contained in the @section. - The #GstMpegtsSDT contained in the section, or %NULL if an error happened. @@ -3421,7 +3261,6 @@ happened. Returns the #GstDateTime of the TDT - The #GstDateTime contained in the section, or %NULL if an error happened. Release with #gst_date_time_unref when done. @@ -3436,7 +3275,6 @@ if an error happened. Release with #gst_date_time_unref when done. Returns the #GstMpegtsTOT contained in the @section. - The #GstMpegtsTOT contained in the section, or %NULL if an error happened. @@ -3451,7 +3289,6 @@ happened. Returns the array of #GstMpegtsDescriptor contained in the section - The #GstMpegtsDescriptor contained in the section, or %NULL if an error @@ -3470,7 +3307,6 @@ happened. Release with #g_array_unref when done. If the data in @section has already been packetized, the data pointer is returned immediately. Otherwise, the data field is allocated and populated. - pointer to section data, or %NULL on fail @@ -3489,7 +3325,6 @@ immediately. Otherwise, the data field is allocated and populated. Creates a custom #GstEvent with a @GstMpegtsSection. The #GstEvent is sent to the @element #GstElement. - %TRUE if the event is sent @@ -3506,7 +3341,6 @@ The #GstEvent is sent to the @element #GstElement. - the #GstMpegtsSection @@ -3519,7 +3353,6 @@ The #GstEvent is sent to the @element #GstElement. - @@ -3530,7 +3363,6 @@ The #GstEvent is sent to the @element #GstElement. - @@ -3542,7 +3374,6 @@ The #GstEvent is sent to the @element #GstElement. Ownership of @nit is taken. The data in @nit is managed by the #GstMpegtsSection - the #GstMpegtsSection @@ -3556,7 +3387,6 @@ The #GstEvent is sent to the @element #GstElement. Creates a PAT #GstMpegtsSection from the @programs array of #GstMpegtsPatPrograms - a #GstMpegtsSection @@ -3576,7 +3406,6 @@ The #GstEvent is sent to the @element #GstElement. Creates a #GstMpegtsSection from @pmt that is bound to @pid - #GstMpegtsSection @@ -3594,7 +3423,6 @@ The #GstEvent is sent to the @element #GstElement. Ownership of @sit is taken. The data in @sit is managed by the #GstMpegtsSection - the #GstMpegtsSection @@ -3611,7 +3439,6 @@ The #GstEvent is sent to the @element #GstElement. Ownership of @sdt is taken. The data in @sdt is managed by the #GstMpegtsSection - the #GstMpegtsSection @@ -3630,7 +3457,6 @@ The #GstEvent is sent to the @element #GstElement. These are the registered ATSC table_id variants. see also: #GstMpegtsSectionTableID - @@ -3672,7 +3498,6 @@ see also: #GstMpegtsSectionTableID These are the registered DVB table_id variants. see also: #GstMpegtsSectionTableID - @@ -3756,7 +3581,6 @@ see also: #GstMpegtsSectionTableID These are the registered SCTE table_id variants. see also: #GstMpegtsSectionTableID - SCTE-18 Emergency Alert System @@ -3788,7 +3612,6 @@ These are the registered ITU H.222.0 | ISO/IEC 13818-1 table_id variants. see also #GstMpegtsSectionATSCTableID, #GstMpegtsSectionDVBTableID, and #GstMpegtsSectionSCTETableID - @@ -3822,7 +3645,6 @@ see also #GstMpegtsSectionATSCTableID, #GstMpegtsSectionDVBTableID, and Types of #GstMpegtsSection that the library handles. - Unknown section type @@ -3888,7 +3710,6 @@ on the variant of mpeg-ts being used (Bluray, ATSC, DVB, ...), other types might also be used, but will not conflict with these. Corresponds to table 2-34 of ITU H.222.0 | ISO/IEC 13818-1 - ITU-T | ISO/IEC Reserved @@ -4029,7 +3850,6 @@ profiles defined in Annex A for service-compatible stereoscopic 3D services - id of the cell @@ -4047,7 +3867,6 @@ profiles defined in Annex A for service-compatible stereoscopic 3D services - id of the sub cell @@ -4059,7 +3878,6 @@ profiles defined in Annex A for service-compatible stereoscopic 3D services describe DVB-T2 transmissions according to EN 302 755 - @@ -4090,7 +3908,6 @@ profiles defined in Annex A for service-compatible stereoscopic 3D services - @@ -4103,7 +3920,6 @@ profiles defined in Annex A for service-compatible stereoscopic 3D services Time Offset Table (EN 300 468) - @@ -4116,7 +3932,6 @@ profiles defined in Annex A for service-compatible stereoscopic 3D services Terrestrial Delivery System Descriptor (EN 300 468 v.1.13.1) - the frequency in Hz (Hertz) @@ -4163,7 +3978,6 @@ profiles defined in Annex A for service-compatible stereoscopic 3D services - @@ -4188,7 +4002,6 @@ profiles defined in Annex A for service-compatible stereoscopic 3D services - @@ -4201,7 +4014,6 @@ profiles defined in Annex A for service-compatible stereoscopic 3D services - @@ -4223,7 +4035,6 @@ profiles defined in Annex A for service-compatible stereoscopic 3D services Creates a #GstMpegtsDescriptor with custom @tag and @data - #GstMpegtsDescriptor @@ -4247,7 +4058,6 @@ profiles defined in Annex A for service-compatible stereoscopic 3D services Creates a #GstMpegtsDescriptor with custom @tag, @tag_extension and @data - #GstMpegtsDescriptor @@ -4277,7 +4087,6 @@ profiles defined in Annex A for service-compatible stereoscopic 3D servicesCreates a #GstMpegtsDescriptor to be a %GST_MTS_DESC_DVB_NETWORK_NAME, with the network name @name. The data field of the #GstMpegtsDescriptor will be allocated, and transferred to the caller. - the #GstMpegtsDescriptor or %NULL on fail @@ -4293,7 +4102,6 @@ will be allocated, and transferred to the caller. Fills a #GstMpegtsDescriptor to be a %GST_MTS_DESC_DVB_SERVICE. The data field of the #GstMpegtsDescriptor will be allocated, and transferred to the caller. - the #GstMpegtsDescriptor or %NULL on fail @@ -4314,7 +4122,6 @@ and transferred to the caller. - @@ -4340,7 +4147,6 @@ and transferred to the caller. Creates a %GST_MTS_DESC_ISO_639_LANGUAGE #GstMpegtsDescriptor with a single language - #GstMpegtsDescriptor, %NULL on failure @@ -4354,7 +4160,6 @@ a single language Creates a %GST_MTS_DESC_REGISTRATION #GstMpegtsDescriptor - #GstMpegtsDescriptor, %NULL on failure @@ -4377,7 +4182,6 @@ a single language - @@ -4389,7 +4193,6 @@ a single language Extracts the #GstMpegtsSection contained in the @event #GstEvent - The extracted #GstMpegtsSection @@ -4406,7 +4209,6 @@ a single language Note: To look for descriptors that can be present more than once in an array of descriptors, iterate the #GArray manually. - the first descriptor matching @tag, else %NULL. @@ -4428,14 +4230,12 @@ of #GstMpegtsDescriptor Initializes the MPEG-TS helper library. Must be called before any usage. - Creates a new #GstMessage for a @GstMpegtsSection. - The new #GstMessage to be posted, or %NULL if the section is not valid. @@ -4454,7 +4254,6 @@ section is not valid. Returns the #GstMpegtsSection contained in a message. - the contained #GstMpegtsSection, or %NULL. @@ -4471,7 +4270,6 @@ section is not valid. array. Note: The data provided in @buffer will not be copied. - an array of the parsed descriptors or %NULL if there was an error. @@ -4493,7 +4291,6 @@ Release with #g_array_unref when done with it. Allocates a new #GPtrArray for #GstMpegtsPatProgram - A newly allocated #GPtrArray @@ -4504,7 +4301,6 @@ Release with #g_array_unref when done with it. Allocates and initializes a new INSERT command #GstMpegtsSCTESIT setup to cancel the specified @event_id. - A newly allocated #GstMpegtsSCTESIT @@ -4518,7 +4314,6 @@ setup to cancel the specified @event_id. Allocates and initializes a NULL command #GstMpegtsSCTESIT. - A newly allocated #GstMpegtsSCTESIT @@ -4530,7 +4325,6 @@ setup to cancel the specified @event_id. If the @splice_time is #G_MAXUINT64 then the event will be immediate as opposed to for the target @splice_time. - A newly allocated #GstMpegtsSCTESIT @@ -4555,7 +4349,6 @@ If the @splice_time is #G_MAXUINT64 then the event will be immediate as opposed to for the target @splice_time. If the @duration is 0 it won't be specified in the event. - A newly allocated #GstMpegtsSCTESIT @@ -4576,7 +4369,6 @@ If the @duration is 0 it won't be specified in the event. - the #GstMpegtsSection @@ -4589,7 +4381,6 @@ If the @duration is 0 it won't be specified in the event. - @@ -4600,7 +4391,6 @@ If the @duration is 0 it won't be specified in the event. - @@ -4612,7 +4402,6 @@ If the @duration is 0 it won't be specified in the event. Ownership of @nit is taken. The data in @nit is managed by the #GstMpegtsSection - the #GstMpegtsSection @@ -4626,7 +4415,6 @@ If the @duration is 0 it won't be specified in the event. Creates a PAT #GstMpegtsSection from the @programs array of #GstMpegtsPatPrograms - a #GstMpegtsSection @@ -4646,7 +4434,6 @@ If the @duration is 0 it won't be specified in the event. Creates a #GstMpegtsSection from @pmt that is bound to @pid - #GstMpegtsSection @@ -4664,7 +4451,6 @@ If the @duration is 0 it won't be specified in the event. Ownership of @sit is taken. The data in @sit is managed by the #GstMpegtsSection - the #GstMpegtsSection @@ -4681,7 +4467,6 @@ If the @duration is 0 it won't be specified in the event. Ownership of @sdt is taken. The data in @sdt is managed by the #GstMpegtsSection - the #GstMpegtsSection @@ -4694,14 +4479,12 @@ If the @duration is 0 it won't be specified in the event. - - diff --git a/gir-files/GstNet-1.0.gir b/gir-files/GstNet-1.0.gir index baf4dd812..76dbe80dc 100644 --- a/gir-files/GstNet-1.0.gir +++ b/gir-files/GstNet-1.0.gir @@ -12,70 +12,60 @@ and/or use gtk-doc annotations. --> - - - - - - - - - - @@ -83,32 +73,27 @@ and/or use gtk-doc annotations. --> The size of the packets sent between network clocks. - - - - - @@ -118,7 +103,6 @@ and/or use gtk-doc annotations. --> #GstNetAddressMeta can be used to store a network address (a #GSocketAddress) in a #GstBuffer so that it network elements can track the to and from address of the buffer. - the parent type @@ -128,7 +112,6 @@ of the buffer. - @@ -157,12 +140,10 @@ gst_pipeline_use_clock(). If you set a #GstBus on the clock via the "bus" object property, it will send @GST_MESSAGE_ELEMENT messages with an attached #GstStructure containing statistics about clock accuracy and network traffic. - Create a new #GstNetClientClock that will report the time provided by the #GstNetTimeProvider on @remote_address and @remote_port. - a new #GstClock that receives a time from the remote clock. @@ -224,7 +205,6 @@ clock. - @@ -234,16 +214,13 @@ clock. - - - + #GstNetControlMessageMeta can be used to store control messages (ancillary data) which was received with or is to be sent alongside the buffer data. When used with socket sinks and sources which understand this meta it allows sending and receiving ancillary data such as unix credentials (See #GUnixCredentialsMessage) and Unix file descriptions (See #GUnixFDMessage). - the parent type @@ -253,7 +230,6 @@ sending and receiving ancillary data such as unix credentials (See - @@ -262,7 +238,6 @@ sending and receiving ancillary data such as unix credentials (See Various functions for receiving, sending an serializing #GstNetTimePacket structures. - the local time when this packet was sent @@ -280,7 +255,6 @@ If @buffer is %NULL, the local and remote times will be set to #GST_CLOCK_TIME_NONE. MT safe. Caller owns return value (gst_net_time_packet_free to free). - The new #GstNetTimePacket. @@ -296,7 +270,6 @@ MT safe. Caller owns return value (gst_net_time_packet_free to free). Make a copy of @packet. - a copy of @packet, free with gst_net_time_packet_free(). @@ -310,7 +283,6 @@ MT safe. Caller owns return value (gst_net_time_packet_free to free). Free @packet. - @@ -325,7 +297,6 @@ MT safe. Caller owns return value (gst_net_time_packet_free to free). Sends a #GstNetTimePacket over a socket. MT safe. - TRUE if successful, FALSE in case an error occurred. @@ -352,7 +323,6 @@ suitable for passing to write(2) or sendto(2) for communication over the network. MT safe. Caller owns return value (g_free to free). - A newly allocated sequence of #GST_NET_TIME_PACKET_SIZE bytes. @@ -367,7 +337,6 @@ MT safe. Caller owns return value (g_free to free). Receives a #GstNetTimePacket over a socket. Handles interrupted system calls, but otherwise returns NULL on error. - a new #GstNetTimePacket, or NULL on error. Free with gst_net_time_packet_free() when done. @@ -395,11 +364,9 @@ After creating the object, a client clock such as #GstNetClientClock can query the exposed clock over the network for its values. The #GstNetTimeProvider typically wraps the clock used by a #GstPipeline. - Allows network clients to get the current time of @clock. - the new #GstNetTimeProvider, or NULL on error @@ -448,7 +415,6 @@ The #GstNetTimeProvider typically wraps the clock used by a #GstPipeline. - @@ -458,15 +424,11 @@ The #GstNetTimeProvider typically wraps the clock used by a #GstPipeline. - - - + - Create a new #GstNtpClock that will report the time provided by the NTPv4 server on @remote_address and @remote_port. - a new #GstClock that receives a time from the remote clock. @@ -504,7 +466,6 @@ clock. - @@ -515,14 +476,12 @@ clock. - - @@ -531,23 +490,18 @@ clock. PTP clock identification that can be passed to gst_ptp_init() to automatically select one based on the MAC address of interfaces - - - - - @@ -572,7 +526,6 @@ To gather statistics about the PTP clock synchronization, gst_ptp_statistics_callback_add() can be used. This gives the application the possibility to collect all kinds of statistics from the clock synchronization. - Creates a new PTP clock instance that exports the PTP time of the master clock in @domain. This clock can be slaved to other clocks as needed. @@ -585,7 +538,6 @@ times from the PTP master clock on the network. Once this happens the GstPtpClock::internal-clock property will become non-NULL. You can check this with gst_clock_wait_for_sync(), the GstClock::synced signal and gst_clock_is_synced(). - A new #GstClock @@ -627,7 +579,6 @@ gst_clock_is_synced(). Opaque #GstPtpClockClass structure. - parented to #GstSystemClockClass @@ -638,9 +589,7 @@ gst_clock_is_synced(). - - - + The statistics can be the following structures: @@ -678,7 +627,6 @@ GST_PTP_STATISTICS_TIME_UPDATED: "rate" G_TYPE_DOUBLE Internal/external rate If %FALSE is returned, the callback is removed and never called again. - @@ -699,7 +647,6 @@ If %FALSE is returned, the callback is removed and never called again. Attaches @addr as metadata in a #GstNetAddressMeta to @buffer. - a #GstNetAddressMeta connected to @buffer @@ -717,7 +664,6 @@ If %FALSE is returned, the callback is removed and never called again. Attaches @message as metadata in a #GstNetControlMessageMeta to @buffer. - a #GstNetControlMessageMeta connected to @buffer @@ -735,7 +681,6 @@ If %FALSE is returned, the callback is removed and never called again. Find the #GstNetAddressMeta on @buffer. - the #GstNetAddressMeta or %NULL when there is no such metadata on @buffer. @@ -749,7 +694,6 @@ is no such metadata on @buffer. - @@ -760,25 +704,21 @@ is no such metadata on @buffer. gstreamer plugins. - - - - @@ -786,7 +726,6 @@ gstreamer plugins. Receives a #GstNetTimePacket over a socket. Handles interrupted system calls, but otherwise returns NULL on error. - a new #GstNetTimePacket, or NULL on error. Free with gst_net_time_packet_free() when done. @@ -805,7 +744,6 @@ calls, but otherwise returns NULL on error. Configures IP_TOS value of socket, i.e. sets QoS DSCP. - TRUE if successful, FALSE in case an error occurred. @@ -825,7 +763,6 @@ calls, but otherwise returns NULL on error. Deinitialize the GStreamer PTP subsystem and stop the PTP clock. If there are any remaining GstPtpClock instances, they won't be further synchronized to the PTP network clock. - @@ -840,7 +777,6 @@ generated from the MAC address of the first network interface. This function is automatically called by gst_ptp_clock_new() with default parameters if it wasn't called before. - %TRUE if the GStreamer PTP clock subsystem could be initialized. @@ -860,7 +796,6 @@ parameters if it wasn't called before. Check if the GStreamer PTP clock subsystem is initialized. - %TRUE if the GStreamer PTP clock subsystem is initialized. @@ -869,7 +804,6 @@ parameters if it wasn't called before. Check if PTP clocks are generally supported on this system, and if previous initializations did not fail. - %TRUE if PTP clocks are generally supported on this system, and previous initializations did not fail. @@ -879,7 +813,6 @@ previous initializations did not fail. Installs a new statistics callback for gathering PTP statistics. See GstPtpStatisticsCallback for a list of statistics that are provided. - Id for the callback that can be passed to gst_ptp_statistics_callback_remove() @@ -903,7 +836,6 @@ gst_ptp_statistics_callback_remove() Removes a PTP statistics callback that was previously added with gst_ptp_statistics_callback_add(). - diff --git a/gir-files/GstPbutils-1.0.gir b/gir-files/GstPbutils-1.0.gir index cb25e1517..34c822851 100644 --- a/gir-files/GstPbutils-1.0.gir +++ b/gir-files/GstPbutils-1.0.gir @@ -11,49 +11,39 @@ and/or use gtk-doc annotations. --> - - - - - - - - - - @@ -67,9 +57,7 @@ changes). It also provides several background shading effects. These effects are applied to a previous picture before the `render()` implementation can draw a new frame. - - @@ -83,7 +71,6 @@ new frame. - @@ -100,7 +87,6 @@ new frame. - @@ -133,13 +119,11 @@ new frame. - - @@ -152,7 +136,6 @@ new frame. - @@ -171,7 +154,6 @@ new frame. - @@ -186,9 +168,7 @@ new frame. - - - + Different types of supported background shading functions. @@ -223,7 +203,6 @@ new frame. - @@ -240,7 +219,6 @@ new frame. - @@ -251,56 +229,48 @@ new frame. - - - - - - - - @@ -323,10 +293,8 @@ By default this will use the GLib default main context unless you have set a custom context using g_main_context_push_thread_default(). All the information is returned in a #GstDiscovererInfo structure. - Creates a new #GstDiscoverer with the provided timeout. - The new #GstDiscoverer. If an error occurred when creating the discoverer, @err will be set @@ -343,7 +311,6 @@ free it when no longer needed using g_error_free(). - @@ -360,7 +327,6 @@ free it when no longer needed using g_error_free(). - @@ -371,7 +337,6 @@ free it when no longer needed using g_error_free(). - @@ -385,7 +350,6 @@ free it when no longer needed using g_error_free(). - @@ -400,7 +364,6 @@ free it when no longer needed using g_error_free(). A copy of @uri will be made internally, so the caller can safely g_free() afterwards. - the result of the scanning. Can be %NULL if an error occurred. @@ -424,7 +387,6 @@ been called. A copy of @uri will be made internally, so the caller can safely g_free() afterwards. - %TRUE if the @uri was successfully appended to the list of pending uris, else %FALSE @@ -445,7 +407,6 @@ uris, else %FALSE Allow asynchronous discovering of URIs to take place. A #GMainLoop must be available for #GstDiscoverer to properly work in asynchronous mode. - @@ -459,7 +420,6 @@ asynchronous mode. Stop the discovery of any pending URIs and clears the list of pending URIS (if any). - @@ -550,7 +510,6 @@ thread. #GstDiscovererStreamInfo specific to audio streams. - the average or nominal bitrate of the stream in bits/second. @@ -563,7 +522,6 @@ thread. - the channel-mask of the stream, refer to gst_audio_channel_positions_from_mask() for more @@ -578,7 +536,6 @@ information. - the number of channels in the stream. @@ -591,7 +548,6 @@ information. - the number of bits used per sample in each channel. @@ -604,7 +560,6 @@ information. - the language of the stream, or NULL if unknown. @@ -617,7 +572,6 @@ information. - the maximum bitrate of the stream in bits/second. @@ -630,7 +584,6 @@ information. - the sample rate of the stream in Hertz. @@ -644,13 +597,11 @@ information. - - @@ -663,7 +614,6 @@ information. - @@ -676,7 +626,6 @@ information. - @@ -695,7 +644,6 @@ information. - @@ -718,7 +666,6 @@ information. #GstDiscovererStreamInfo specific to container streams. - the list of #GstDiscovererStreamInfo this container stream offers. @@ -740,7 +687,6 @@ Free with gst_discoverer_stream_info_list_free() after usage. Parses a #GVariant as produced by gst_discoverer_info_to_variant() back to a #GstDiscovererInfo. - A newly-allocated #GstDiscovererInfo. @@ -753,7 +699,6 @@ back to a #GstDiscovererInfo. - A copy of the #GstDiscovererInfo @@ -767,7 +712,6 @@ back to a #GstDiscovererInfo. Finds all the #GstDiscovererAudioInfo contained in @info - A #GList of matching #GstDiscovererStreamInfo. The caller should free it with @@ -785,7 +729,6 @@ gst_discoverer_stream_info_list_free(). Finds all the #GstDiscovererContainerInfo contained in @info - A #GList of matching #GstDiscovererStreamInfo. The caller should free it with @@ -802,7 +745,6 @@ gst_discoverer_stream_info_list_free(). - the duration of the URI in #GstClockTime (nanoseconds). @@ -815,7 +757,6 @@ gst_discoverer_stream_info_list_free(). - whether the URI is live. @@ -830,7 +771,6 @@ gst_discoverer_stream_info_list_free(). This functions is deprecated since version 1.4, use #gst_discoverer_info_get_missing_elements_installer_details - Miscellaneous information stored as a #GstStructure (for example: information about missing plugins). If you wish to use the @@ -846,7 +786,6 @@ gst_discoverer_stream_info_list_free(). Get the installer details for missing elements - An array of strings containing information about how to install the various missing elements @@ -865,7 +804,6 @@ for the missing element - the result of the discovery as a #GstDiscovererResult. @@ -878,7 +816,6 @@ for the missing element - the whether the URI is seekable. @@ -891,7 +828,6 @@ for the missing element - the structure (or topology) of the URI as a #GstDiscovererStreamInfo. @@ -907,7 +843,6 @@ gst_discoverer_stream_info_unref() after usage. - the list of all streams contained in the #info. Free after usage @@ -926,7 +861,6 @@ with gst_discoverer_stream_info_list_free(). Finds the #GstDiscovererStreamInfo contained in @info that match the given @streamtype. - A #GList of matching #GstDiscovererStreamInfo. The caller should free it with @@ -948,7 +882,6 @@ gst_discoverer_stream_info_list_free(). Finds all the #GstDiscovererSubtitleInfo contained in @info - A #GList of matching #GstDiscovererStreamInfo. The caller should free it with @@ -965,7 +898,6 @@ gst_discoverer_stream_info_list_free(). - all tags contained in the URI. If you wish to use the tags after the life-time of @info, you will need to copy them. @@ -979,7 +911,6 @@ the tags after the life-time of @info, you will need to copy them. - TOC contained in the URI. If you wish to use the TOC after the life-time of @info, you will need to copy it. @@ -993,7 +924,6 @@ the TOC after the life-time of @info, you will need to copy it. - the URI to which this information corresponds to. Copy it if you wish to use it after the life-time of @info. @@ -1008,7 +938,6 @@ Copy it if you wish to use it after the life-time of @info. Finds all the #GstDiscovererVideoInfo contained in @info - A #GList of matching #GstDiscovererStreamInfo. The caller should free it with @@ -1030,7 +959,6 @@ through gst_discoverer_info_from_variant(). Note that any #GstToc (s) that might have been discovered will not be serialized for now. - A newly-allocated #GVariant representing @info. @@ -1048,9 +976,7 @@ what needs to be serialized. - - - + Result values for the discovery process. @@ -1112,7 +1038,6 @@ for the audio and video streams respectively. Decrements the reference count of all contained #GstDiscovererStreamInfo and fress the #GList. - @@ -1126,7 +1051,6 @@ and fress the #GList. - the #GstCaps of the stream. Unref with #gst_caps_unref after usage. @@ -1142,7 +1066,6 @@ and fress the #GList. This functions is deprecated since version 1.4, use #gst_discoverer_info_get_missing_elements_installer_details - additional information regarding the stream (for example codec version, profile, etc..). If you wish to use the #GstStructure @@ -1157,7 +1080,6 @@ after the life-time of @info you will need to copy it. - the next #GstDiscovererStreamInfo in a chain. %NULL for final streams. @@ -1172,7 +1094,6 @@ Unref with #gst_discoverer_stream_info_unref after usage. - the previous #GstDiscovererStreamInfo in a chain. %NULL for starting points. Unref with #gst_discoverer_stream_info_unref @@ -1187,7 +1108,6 @@ after usage. - the stream ID of this stream. If you wish to use the stream ID after the life-time of @info you will need to copy it. @@ -1201,7 +1121,6 @@ use the stream ID after the life-time of @info you will need to copy it. - a human readable name for the stream type of the given @info (ex : "audio", "container",...). @@ -1215,7 +1134,6 @@ use the stream ID after the life-time of @info you will need to copy it. - the tags contained in this stream. If you wish to use the tags after the life-time of @info you will need to copy them. @@ -1229,7 +1147,6 @@ use the tags after the life-time of @info you will need to copy them. - the TOC contained in this stream. If you wish to use the TOC after the life-time of @info you will need to copy it. @@ -1247,7 +1164,6 @@ use the TOC after the life-time of @info you will need to copy it. #GstDiscovererStreamInfo specific to subtitle streams (this includes text and image based ones). - the language of the stream, or NULL if unknown. @@ -1263,7 +1179,6 @@ image based ones). #GstDiscovererStreamInfo specific to video streams (this includes images). - the average or nominal bitrate of the video stream in bits/second. @@ -1276,7 +1191,6 @@ image based ones). - the depth in bits of the video stream. @@ -1289,7 +1203,6 @@ image based ones). - the framerate of the video stream (denominator). @@ -1302,7 +1215,6 @@ image based ones). - the framerate of the video stream (numerator). @@ -1315,7 +1227,6 @@ image based ones). - the height of the video stream in pixels. @@ -1328,7 +1239,6 @@ image based ones). - the maximum bitrate of the video stream in bits/second. @@ -1341,7 +1251,6 @@ image based ones). - the Pixel Aspect Ratio (PAR) of the video stream (denominator). @@ -1354,7 +1263,6 @@ image based ones). - the Pixel Aspect Ratio (PAR) of the video stream (numerator). @@ -1367,7 +1275,6 @@ image based ones). - the width of the video stream in pixels. @@ -1380,7 +1287,6 @@ image based ones). - %TRUE if the video stream corresponds to an image (i.e. only contains one frame). @@ -1394,7 +1300,6 @@ one frame). - %TRUE if the stream is interlaced, else %FALSE. @@ -1408,7 +1313,6 @@ one frame). - @@ -1417,14 +1321,12 @@ one frame). #GstEncodingTarget category for recording and capture. Targets within this category are optimized for low latency encoding. - #GstEncodingTarget category for device-specific targets. The name of the target will usually be the constructor and model of the device, and that target will contain #GstEncodingProfiles suitable for that device. - @@ -1432,7 +1334,6 @@ and that target will contain #GstEncodingProfiles suitable for that device. - @@ -1440,7 +1341,6 @@ usually used for a particular file extension. The name of the target will usually be the name of the online service and that target will contain #GstEncodingProfiles suitable for that online service. - @@ -1449,32 +1349,27 @@ Those targets can be lossless and/or provide very fast random access content. The name of the target will usually be the container type or editing target, and that target will contain #GstEncodingProfiles suitable for editing or storage. - - - - - @@ -1482,13 +1377,11 @@ storage. Variant of #GstEncodingProfile for audio streams. - Creates a new #GstEncodingAudioProfile All provided allocatable arguments will be internally copied, so can be safely freed/unreferenced after calling this method. - the newly created #GstEncodingAudioProfile. @@ -1515,15 +1408,11 @@ NULL. See gst_encoding_profile_get_restriction() for more details. - - - + Encoding profiles for containers. Keeps track of a list of #GstEncodingProfile - Creates a new #GstEncodingContainerProfile. - The newly created #GstEncodingContainerProfile. @@ -1553,7 +1442,6 @@ NULL. See gst_encoding_profile_get_restriction() for more details. No copy of @profile will be made, if you wish to use it elsewhere after this method you should increment its reference count. - %TRUE if the @stream was properly added, else %FALSE. @@ -1572,7 +1460,6 @@ method you should increment its reference count. Checks if @container contains a #GstEncodingProfile identical to @profile. - %TRUE if @container contains a #GstEncodingProfile identical to @profile, else %FALSE. @@ -1590,7 +1477,6 @@ to @profile, else %FALSE. - the list of contained #GstEncodingProfile. @@ -1606,16 +1492,12 @@ the list of contained #GstEncodingProfile. - - - + The opaque base class object for all encoding profiles. This contains generic information like name, description, format and preset. - Find the #GstEncodingProfile with the specified name and category. - The matching #GstEncodingProfile or %NULL. @@ -1640,7 +1522,6 @@ provided, it will default to the encoding profile called `default`. Creates a #GstEncodingProfile matching the formats from the given #GstDiscovererInfo. Streams other than audio or video (eg, subtitles), are currently ignored. - The new #GstEncodingProfile or %NULL. @@ -1654,7 +1535,6 @@ subtitles), are currently ignored. Makes a deep copy of @self - The copy of @self @@ -1669,7 +1549,6 @@ subtitles), are currently ignored. Get whether the format that has been negotiated in at some point can be renegotiated later during the encoding. - @@ -1681,7 +1560,6 @@ later during the encoding. - the description of the profile, can be %NULL. @@ -1694,7 +1572,6 @@ later during the encoding. - a suitable file extension for @profile, or NULL. @@ -1707,7 +1584,6 @@ later during the encoding. - the #GstCaps corresponding to the media format used in the profile. Unref after usage. @@ -1722,7 +1598,6 @@ in the profile. Unref after usage. Computes the full output caps that this @profile will be able to consume. - The full caps the given @profile can consume. Call gst_caps_unref() when you are done with the caps. @@ -1736,7 +1611,6 @@ gst_caps_unref() when you are done with the caps. - the name of the profile, can be %NULL. @@ -1749,7 +1623,6 @@ gst_caps_unref() when you are done with the caps. - The number of times the profile is used in its parent container profile. If 0, it is not a mandatory stream. @@ -1763,7 +1636,6 @@ container profile. If 0, it is not a mandatory stream. - the name of the #GstPreset to be used in the profile. This is the name that has been set when saving the preset. @@ -1777,7 +1649,6 @@ This is the name that has been set when saving the preset. - the name of the #GstPreset factory to be used in the profile. @@ -1790,7 +1661,6 @@ This is the name that has been set when saving the preset. - The restriction #GstCaps to apply before the encoder that will be used in the profile. The fields present in restriction caps are @@ -1808,7 +1678,6 @@ Can be %NULL. Unref after usage. - #TRUE if the stream represented by @profile should use a single segment before the encoder, #FALSE otherwise. This means that buffers will be retimestamped @@ -1823,7 +1692,6 @@ and segments will be eat so as to appear as one segment. - the human-readable name of the type of @profile. @@ -1836,7 +1704,6 @@ and segments will be eat so as to appear as one segment. - @@ -1848,7 +1715,6 @@ and segments will be eat so as to appear as one segment. Checks whether the two #GstEncodingProfile are equal - %TRUE if @a and @b are equal, else %FALSE. @@ -1867,7 +1733,6 @@ and segments will be eat so as to appear as one segment. Sets whether the format that has been negotiated in at some point can be renegotiated later during the encoding. - @@ -1886,7 +1751,6 @@ during the encoding Set @description as the given description for the @profile. A copy of @description will be made internally. - @@ -1903,7 +1767,6 @@ during the encoding Set whether the profile should be used or not. - @@ -1920,7 +1783,6 @@ during the encoding Sets the media format used in the profile. - @@ -1938,7 +1800,6 @@ during the encoding Set @name as the given name for the @profile. A copy of @name will be made internally. - @@ -1956,7 +1817,6 @@ internally. Set the number of time the profile is used in its parent container profile. If 0, it is not a mandatory stream - @@ -1975,7 +1835,6 @@ container profile. If 0, it is not a mandatory stream Sets the name of the #GstElement that implements the #GstPreset interface to use for the profile. This is the name that has been set when saving the preset. - @@ -1992,7 +1851,6 @@ This is the name that has been set when saving the preset. Sets the name of the #GstPreset's factory to be used in the profile. - @@ -2011,7 +1869,6 @@ This is the name that has been set when saving the preset. Set the restriction #GstCaps to apply before the encoder that will be used in the profile. See gst_encoding_profile_get_restriction() for more about restrictions. Does not apply to #GstEncodingContainerProfile. - @@ -2032,7 +1889,6 @@ eat so as to appear as one segment. > *NOTE*: Single segment is not property supported when using > #encodebin:avoid-reencoding - @@ -2052,9 +1908,7 @@ single segment before the encoder, #FALSE otherwise. - - - + Collection of #GstEncodingProfile for a specific target or use-case. @@ -2071,7 +1925,6 @@ The @category *should* be one of the existing well-defined categories, like #GST_ENCODING_CATEGORY_DEVICE, but it *can* be a application or user specific category if needed. - The newly created #GstEncodingTarget or %NULL if there was an error. @@ -2107,7 +1960,6 @@ and returns it. If the category name is specified only targets from that category will be searched for. - The #GstEncodingTarget if available, else %NULL. @@ -2128,7 +1980,6 @@ valid for target names). Opens the provided file and returns the contained #GstEncodingTarget. - The #GstEncodingTarget contained in the file, else %NULL @@ -2148,7 +1999,6 @@ a unique name within the profile. The @target will steal a reference to the @profile. If you wish to use the profile after calling this method, you should increase its reference count. - %TRUE if the profile was added, else %FALSE. @@ -2165,7 +2015,6 @@ count. - The category of the @target. For example: #GST_ENCODING_CATEGORY_DEVICE. @@ -2179,7 +2028,6 @@ count. - The description of the @target. @@ -2192,7 +2040,6 @@ count. - The name of the @target. @@ -2205,7 +2052,6 @@ count. - The path to the @target file. @@ -2218,7 +2064,6 @@ count. - The matching #GstEncodingProfile, or %NULL. @@ -2235,7 +2080,6 @@ count. - A list of #GstEncodingProfile(s) this @target handles. @@ -2252,7 +2096,6 @@ count. Saves the @target to a default user-local directory. - %TRUE if the target was correctly saved, else %FALSE. @@ -2266,7 +2109,6 @@ count. Saves the @target to the provided file location. - %TRUE if the target was correctly saved, else %FALSE. @@ -2285,7 +2127,6 @@ count. Variant of #GstEncodingProfile for video streams, allows specifying the @pass. - Creates a new #GstEncodingVideoProfile @@ -2297,7 +2138,6 @@ please refer to the gst_encoding_video_profile_set_pass() documentation. If you wish to use/force a constant framerate please refer to the gst_encoding_video_profile_set_variableframerate() documentation. - the newly created #GstEncodingVideoProfile. @@ -2325,7 +2165,6 @@ NULL. See gst_encoding_profile_get_restriction() for more details. Get the pass number if this is part of a multi-pass profile. - The pass number. Starts at 1 for multi-pass. 0 if this is not a multi-pass profile @@ -2341,7 +2180,6 @@ not a multi-pass profile > *NOTE*: Fixed framerate won't be enforced when #encodebin:avoid-reencoding > is set. - Whether non-constant video framerate is allowed for encoding. @@ -2357,7 +2195,6 @@ not a multi-pass profile Sets the pass number of this video profile. The first pass profile should have this value set to 1. If this video profile isn't part of a multi-pass profile, you may set it to 0 (the default value). - @@ -2377,7 +2214,6 @@ you may set it to 0 (the default value). framerate. If set to %FALSE (default value), then the incoming stream will be normalized by dropping/duplicating frames in order to produce a constance framerate. - @@ -2393,109 +2229,92 @@ constance framerate. - - - + - - - - - - - - - - - - - - - @@ -2504,10 +2323,8 @@ constance framerate. Opaque context structure for the plugin installation. Use the provided API to set details on it. - Creates a new #GstInstallPluginsContext. - a new #GstInstallPluginsContext. Free with gst_install_plugins_context_free() when no longer needed @@ -2516,7 +2333,6 @@ gst_install_plugins_context_free() when no longer needed Copies a #GstInstallPluginsContext. - A copy of @ctx @@ -2530,7 +2346,6 @@ gst_install_plugins_context_free() when no longer needed Frees a #GstInstallPluginsContext. - @@ -2547,7 +2362,6 @@ should ask for confirmation or not before searching for missing plugins. If set, this option will be passed to the installer via a --interaction=[show-confirm-search|hide-confirm-search] command line option. - @@ -2571,7 +2385,6 @@ A desktop file ID is the basename of the desktop file, including the If set, the desktop file ID will be passed to the installer via a --desktop-id= command line option. - @@ -2605,7 +2418,6 @@ like this: startup_id = g_strdup_printf ("_TIME%u", timestamp); ... ]| - @@ -2643,7 +2455,6 @@ window like this: ##endif ... ]| - @@ -2663,7 +2474,6 @@ window like this: The prototype of the callback function that will be called once the external plugin installer program has returned. You only need to provide a callback function if you are using the asynchronous interface. - @@ -2736,7 +2546,6 @@ program and to what extent the requested plugins could be installed. with a status code. This function returns English strings and should not be used for user messages. It is here only to assist in debugging. - a descriptive string for the status code in @ret @@ -2750,7 +2559,6 @@ in debugging. - @@ -2758,23 +2566,19 @@ in debugging. The major version of GStreamer's gst-plugins-base libraries at compile time. - The micro version of GStreamer's gst-plugins-base libraries at compile time. - The minor version of GStreamer's gst-plugins-base libraries at compile time. - The nano version of GStreamer's gst-plugins-base libraries at compile time. Actual releases have 0, GIT versions have 1, prerelease versions have 2-... - @@ -2783,7 +2587,6 @@ Actual releases have 0, GIT versions have 1, prerelease versions have 2-... - %TRUE if the level and profile could be set, %FALSE otherwise. @@ -2809,7 +2612,6 @@ If mpegversion is 4, the "base-profile" field is also set in @caps. Returns the channels of the given AAC stream. - The channels or 0 if the channel could not be determined. @@ -2831,7 +2633,6 @@ If mpegversion is 4, the "base-profile" field is also set in @caps. Translates the sample rate to the index corresponding to it in AAC spec. - The AAC index for this sample rate, -1 if the rate is not a valid AAC sample rate. @@ -2858,7 +2659,6 @@ most significant bit of the first byte: next 24 bits define the actual sample frequency, and subsequent fields are appropriately shifted). * Bit 9:12 contains the channel configuration - The level as a const string and %NULL if the level could not be determined. @@ -2883,7 +2683,6 @@ determined. Returns the profile of the given AAC stream as a string. The profile is normally determined using the AudioObjectType field which is in the first 5 bits of @audio_config - The profile as a const string and %NULL if the profile could not be determined. @@ -2907,7 +2706,6 @@ determined. Translates the sample rate index found in AAC headers to the actual sample rate. - The sample rate if sr_idx is valid, 0 otherwise. @@ -2930,7 +2728,6 @@ rate. Translates the sample rate index found in AAC headers to the actual sample rate. - The sample rate if @sr_idx is valid, 0 otherwise. @@ -2947,7 +2744,6 @@ rate. Sets the level and profile in @caps if it can be determined from @sps. See gst_codec_utils_h264_get_level() and gst_codec_utils_h264_get_profile() for more details on the parameters. - %TRUE if the level and profile could be set, %FALSE otherwise. @@ -2973,7 +2769,6 @@ for more details on the parameters. Converts the level indication (level_idc) in the stream's sequence parameter set into a string. The SPS is expected to have the same format as for gst_codec_utils_h264_get_profile(). - The level as a const string, or %NULL if there is an error. @@ -2993,7 +2788,6 @@ same format as for gst_codec_utils_h264_get_profile(). Transform a level string from the caps into the level_idc - the level_idc or 0 if the level is unknown @@ -3020,7 +2814,6 @@ byte. * Bit 12 - constraint_set3_flag * Bit 13:15 - Reserved * Bit 16:24 - Level indication - The profile as a const string, or %NULL if there is an error. @@ -3043,7 +2836,6 @@ byte. @profile_tier_level. See gst_codec_utils_h265_get_level(), gst_codec_utils_h265_get_tier() and gst_codec_utils_h265_get_profile() for more details on the parameters. - %TRUE if the level, tier, profile could be set, %FALSE otherwise. @@ -3070,7 +2862,6 @@ for more details on the parameters. Converts the level indication (general_level_idc) in the stream's profile_tier_level structure into a string. The profiel_tier_level is expected to have the same format as for gst_codec_utils_h264_get_profile(). - The level as a const string, or %NULL if there is an error. @@ -3091,7 +2882,6 @@ expected to have the same format as for gst_codec_utils_h264_get_profile(). Transform a level string from the caps into the level_idc - the level_idc or 0 if the level is unknown @@ -3120,7 +2910,6 @@ with bit 0 being the most significant bit of the first byte. * Bit 43 - general_frame_only_constraint_flag * Bit 44:87 - See below * Bit 88:95 - general_level_idc - The profile as a const string, or %NULL if there is an error. @@ -3143,7 +2932,6 @@ with bit 0 being the most significant bit of the first byte. Converts the tier indication (general_tier_flag) in the stream's profile_tier_level structure into a string. The profile_tier_level is expected to have the same format as for gst_codec_utils_h264_get_profile(). - The tier as a const string, or %NULL if there is an error. @@ -3167,7 +2955,6 @@ is expected to have the same format as for gst_codec_utils_h264_get_profile(). - %TRUE if the level and profile could be set, %FALSE otherwise. @@ -3195,7 +2982,6 @@ parameters. a string. @vis_obj_seq is expected to be the data following the visual object sequence start code. Only the first byte (profile_and_level_indication) is used. - The level as a const string, or NULL if there is an error. @@ -3219,7 +3005,6 @@ object sequence start code. Only the first byte a string. @vis_obj_seq is expected to be the data following the visual object sequence start code. Only the first byte (profile_and_level_indication) is used. - The profile as a const string, or NULL if there is an error. @@ -3240,7 +3025,6 @@ object sequence start code. Only the first byte Creates Opus caps from the given parameters. - The #GstCaps, or %NULL if the parameters would lead to invalid Opus caps. @@ -3278,7 +3062,6 @@ invalid Opus caps. Creates Opus caps from the given OpusHead @header and comment header @comments. - The #GstCaps. @@ -3296,7 +3079,6 @@ invalid Opus caps. Creates OpusHead header from the given parameters. - The #GstBuffer containing the OpusHead. @@ -3340,7 +3122,6 @@ invalid Opus caps. Parses Opus caps and fills the different fields with defaults if possible. - %TRUE if parsing was successful, %FALSE otherwise. @@ -3380,7 +3161,6 @@ invalid Opus caps. Parses the OpusHead header. - %TRUE if parsing was successful, %FALSE otherwise. @@ -3428,7 +3208,6 @@ invalid Opus caps. Increments the reference count of @info. - a #GstDiscovererInfo @@ -3437,7 +3216,6 @@ invalid Opus caps. Decrements the reference count of @info. - a #GstDiscovererInfo @@ -3446,7 +3224,6 @@ invalid Opus caps. Increments the reference count of @info. - a #GstDiscovererStreamInfo @@ -3455,7 +3232,6 @@ invalid Opus caps. Decrements the reference count of @info. - a #GstDiscovererStreamInfo @@ -3768,7 +3544,6 @@ defining a list of folder containing encoding target files. List all available #GstEncodingTarget for the specified category, or all categories if @categoryname is %NULL. - The list of #GstEncodingTarget @@ -3785,7 +3560,6 @@ Can be %NULL. Lists all #GstEncodingTarget categories present on disk. - A list of #GstEncodingTarget categories. @@ -3796,7 +3570,6 @@ of #GstEncodingTarget categories. Increases the reference count of the @profile. - a #GstEncodingProfile @@ -3805,7 +3578,6 @@ of #GstEncodingTarget categories. Decreases the reference count of the @profile, possibly freeing the @profile. - a #GstEncodingProfile @@ -3814,7 +3586,6 @@ of #GstEncodingTarget categories. Increases the reference count of the @target. - a #GstEncodingTarget @@ -3823,7 +3594,6 @@ of #GstEncodingTarget categories. Decreases the reference count of the @target, possibly freeing it. - a #GstEncodingTarget @@ -4147,7 +3917,6 @@ application via the provided API, such as gst_missing_element_message_new(). It is possible to request the installation of multiple missing plugins in one go (as might be required if there is a demuxer for a certain format installed but no suitable video decoder and no suitable audio decoder). - result code whether an external installer could be started @@ -4177,7 +3946,6 @@ installed but no suitable video decoder and no suitable audio decoder). Checks whether plugin installation (initiated by this application only) is currently in progress. - TRUE if plugin installation is in progress, otherwise FALSE @@ -4188,7 +3956,6 @@ is currently in progress. with a status code. This function returns English strings and should not be used for user messages. It is here only to assist in debugging. - a descriptive string for the status code in @ret @@ -4205,7 +3972,6 @@ in debugging. current environment. This currently only checks whether the helper script that is to be provided by the distribution or operating system vendor exists. - TRUE if plugin installation is likely to be supported. @@ -4220,7 +3986,6 @@ a non-GLib main loop is running and the user wants to run it in a separate thread and marshal the result back asynchronously into the main thread using the other non-GLib main loop. You should almost always use gst_install_plugins_async() instead of this function. - the result of the installation. @@ -4241,7 +4006,6 @@ gst_install_plugins_async() instead of this function. Checks whether @msg is a missing plugins message. - %TRUE if @msg is a missing-plugins message, otherwise %FALSE. @@ -4262,7 +4026,6 @@ This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing. - a newly-allocated detail string, or NULL on error. Free string with g_free() when not needed any longer. @@ -4279,7 +4042,6 @@ missing. Creates a missing-plugin message for @element to notify the application that a decoder element for a particular set of (fixed) caps is missing. This function is mainly for use in plugins. - a new #GstMessage, or NULL on error @@ -4304,7 +4066,6 @@ This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing. - a newly-allocated detail string, or NULL on error. Free string with g_free() when not needed any longer. @@ -4322,7 +4083,6 @@ missing. Creates a missing-plugin message for @element to notify the application that a certain required element is missing. This function is mainly for use in plugins. - a new #GstMessage, or NULL on error @@ -4348,7 +4108,6 @@ This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing. - a newly-allocated detail string, or NULL on error. Free string with g_free() when not needed any longer. @@ -4365,7 +4124,6 @@ missing. Creates a missing-plugin message for @element to notify the application that an encoder element for a particular set of (fixed) caps is missing. This function is mainly for use in plugins. - a new #GstMessage, or NULL on error @@ -4389,7 +4147,6 @@ a valid missing-plugin message. This function is mainly for applications that need a human-readable string describing a missing plugin, given a previously collected missing-plugin message - a newly-allocated description string, or NULL on error. Free string with g_free() when not needed any longer. @@ -4409,7 +4166,6 @@ gst_install_plugins_async() or gst_install_plugins_sync(). This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions. - a newly-allocated detail string, or NULL on error. Free string with g_free() when not needed any longer. @@ -4431,7 +4187,6 @@ This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing. - a newly-allocated detail string, or NULL on error. Free string with g_free() when not needed any longer. @@ -4449,7 +4204,6 @@ missing. Creates a missing-plugin message for @element to notify the application that a sink element for a particular URI protocol is missing. This function is mainly for use in plugins. - a new #GstMessage, or NULL on error @@ -4475,7 +4229,6 @@ This function is mainly for applications that call external plugin installation mechanisms using one of the two above-mentioned functions in the case where the application knows exactly what kind of plugin it is missing. - a newly-allocated detail string, or NULL on error. Free string with g_free() when not needed any longer. @@ -4493,7 +4246,6 @@ missing. Creates a missing-plugin message for @element to notify the application that a source element for a particular URI protocol is missing. This function is mainly for use in plugins. - a new #GstMessage, or NULL on error @@ -4512,7 +4264,6 @@ function is mainly for use in plugins. Adds a codec tag describing the format specified by @caps to @taglist. - TRUE if a codec tag was added, FALSE otherwise. @@ -4541,7 +4292,6 @@ to be seen by the user. Should never return NULL unless @caps is invalid. Also see the convenience function gst_pb_utils_add_codec_description_to_tag_list(). - a newly-allocated description string, or NULL on error. Free string with g_free() when not needed any longer. @@ -4562,7 +4312,6 @@ Should never return NULL unless @factory_name or @caps are invalid. This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message. - a newly-allocated description string, or NULL on error. Free string with g_free() when not needed any longer. @@ -4583,7 +4332,6 @@ return NULL unless @factory_name is invalid. This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message. - a newly-allocated description string, or NULL on error. Free string with g_free() when not needed any longer. @@ -4604,7 +4352,6 @@ Should never return NULL unless @factory_name or @caps are invalid. This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message. - a newly-allocated description string, or NULL on error. Free string with g_free() when not needed any longer. @@ -4625,7 +4372,6 @@ seen by the user. Should never return NULL unless @protocol is invalid. This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message. - a newly-allocated description string, or NULL on error. Free string with g_free() when not needed any longer. @@ -4646,7 +4392,6 @@ seen by the user. Should never return NULL unless @protocol is invalid. This function is mainly for internal use, applications would typically use gst_missing_plugin_message_get_description() to get a description of a missing feature from a missing-plugin message. - a newly-allocated description string, or NULL on error. Free string with g_free() when not needed any longer. @@ -4666,14 +4411,12 @@ plugins should call it from their plugin_init function. This function may be called multiple times. It will do nothing if the library has already been initialised. - Gets the version number of the GStreamer Plugins Base libraries. - @@ -4700,7 +4443,6 @@ library has already been initialised. This function returns a string that is useful for describing this version of GStreamer's gst-plugins-base libraries to the outside world: user agent strings, logging, about dialogs ... - a newly allocated string describing this version of gst-plugins-base diff --git a/gir-files/GstPlayer-1.0.gir b/gir-files/GstPlayer-1.0.gir index aa70cf86c..9f1a5fa32 100644 --- a/gir-files/GstPlayer-1.0.gir +++ b/gir-files/GstPlayer-1.0.gir @@ -13,322 +13,276 @@ and/or use gtk-doc annotations. --> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Creates a new #GstPlayer instance that uses @signal_dispatcher to dispatch signals to some event loop system, or emits signals directly if NULL is @@ -337,7 +291,6 @@ passed. See gst_player_g_main_context_signal_dispatcher_new(). Video is going to be rendered by @video_renderer, or if %NULL is provided no special video set up will be done and some default handling will be performed. - a new #GstPlayer instance @@ -354,7 +307,6 @@ performed. - current position update interval in milliseconds @@ -367,7 +319,6 @@ performed. - %TRUE if accurate seeking is enabled @@ -382,7 +333,6 @@ performed. Return the user agent which has been configured using gst_player_config_set_user_agent() if any. - the configured agent, or %NULL @@ -397,7 +347,6 @@ gst_player_config_set_user_agent() if any. set interval in milliseconds between two position-updated signals. pass 0 to stop updating the position. - @@ -422,7 +371,6 @@ If accurate seeking is disabled, elements will seek as close as the request position without slowing down seeking too much. Accurate seeking is disabled by default. - @@ -441,7 +389,6 @@ Accurate seeking is disabled by default. Set the user agent to pass to the server if @player needs to connect to a server during playback. This is typically used when playing HTTP or RTSP streams. - @@ -457,7 +404,6 @@ or RTSP streams. - A #GList of matching #GstPlayerAudioInfo. @@ -473,7 +419,6 @@ matching #GstPlayerAudioInfo. - A #GList of matching #GstPlayerSubtitleInfo. @@ -489,7 +434,6 @@ matching #GstPlayerSubtitleInfo. - A #GList of matching #GstPlayerVideoInfo. @@ -506,7 +450,6 @@ matching #GstPlayerVideoInfo. Frees a %NULL terminated array of #GstPlayerVisualization. - @@ -518,7 +461,6 @@ matching #GstPlayerVideoInfo. - a %NULL terminated array containing all available @@ -531,7 +473,6 @@ matching #GstPlayerVideoInfo. Retrieve the current value of audio-video-offset property - The current value of audio-video-offset in nanoseconds @@ -545,7 +486,6 @@ matching #GstPlayerVideoInfo. Retrieve the current value of the indicated @type. - The current value of @type, between [0,1]. In case of error -1 is returned. @@ -566,7 +506,6 @@ matching #GstPlayerVideoInfo. Get a copy of the current configuration of the player. This configuration can either be modified and used for the gst_player_set_config() call or it must be freed after usage. - a copy of the current configuration of @player. Use gst_structure_free() after usage or gst_player_set_config(). @@ -581,7 +520,6 @@ gst_structure_free() after usage or gst_player_set_config(). A Function to get current audio #GstPlayerAudioInfo instance. - current audio track. @@ -597,7 +535,6 @@ The caller should free it with g_object_unref() A Function to get current subtitle #GstPlayerSubtitleInfo instance. - current subtitle track. @@ -613,7 +550,6 @@ The caller should free it with g_object_unref() A Function to get current video #GstPlayerVideoInfo instance. - current video track. @@ -628,7 +564,6 @@ The caller should free it with g_object_unref() - Name of the currently enabled visualization. g_free() after usage. @@ -643,7 +578,6 @@ The caller should free it with g_object_unref() Retrieves the duration of the media stream that self represents. - the duration of the currently-playing media stream, in nanoseconds. @@ -658,7 +592,6 @@ nanoseconds. A Function to get the current media info #GstPlayerMediaInfo instance. - media info instance. @@ -674,7 +607,6 @@ The caller should free it with g_object_unref() Retrieve the current value of the indicated @type. - The current value of @type, Default: 0x00000000 "none @@ -688,7 +620,6 @@ The caller should free it with g_object_unref() Retrieve the current value of the indicated @type. - The current value of @type, Default: -1 "none" @@ -701,7 +632,6 @@ The caller should free it with g_object_unref() - %TRUE if the currently-playing stream is muted. @@ -714,7 +644,6 @@ The caller should free it with g_object_unref() - The internal playbin instance @@ -727,7 +656,6 @@ The caller should free it with g_object_unref() - the absolute position time, in nanoseconds, of the currently-playing stream. @@ -741,7 +669,6 @@ currently-playing stream. - current playback rate @@ -755,7 +682,6 @@ currently-playing stream. current subtitle URI - URI of the current external subtitle. g_free() after usage. @@ -770,7 +696,6 @@ currently-playing stream. Retrieve the current value of subtitle-video-offset property - The current value of subtitle-video-offset in nanoseconds @@ -784,7 +709,6 @@ currently-playing stream. Gets the URI of the currently-playing stream. - a string containing the URI of the currently-playing stream. g_free() after usage. @@ -804,7 +728,6 @@ Currently supported settings are: - width, height of type G_TYPE_INT - pixel-aspect-ratio of type GST_TYPE_FRACTION Except for GST_PLAYER_THUMBNAIL_RAW_NATIVE format, if no config is set, pixel-aspect-ratio would be 1/1 - Current video snapshot sample or %NULL on failure @@ -826,7 +749,6 @@ Currently supported settings are: Returns the current volume level, as a percentage between 0 and 1. - the volume as percentage between 0 and 1. @@ -840,7 +762,6 @@ Currently supported settings are: Checks whether the @player has color balance support available. - %TRUE if @player has color balance support. Otherwise, %FALSE. @@ -855,7 +776,6 @@ Currently supported settings are: Pauses the current stream. - @@ -868,7 +788,6 @@ Currently supported settings are: Request to play the loaded stream. - @@ -882,7 +801,6 @@ Currently supported settings are: Seeks the currently-playing stream to the absolute @position time in nanoseconds. - @@ -898,7 +816,6 @@ in nanoseconds. - %TRUE or %FALSE @@ -918,7 +835,6 @@ Sets the audio track @stream_idex. Enable or disable the current audio track. - @@ -935,7 +851,6 @@ Sets the audio track @stream_idex. Sets audio-video-offset property by value of @offset - @@ -953,7 +868,6 @@ Sets the audio track @stream_idex. Sets the current value of the indicated channel @type to the passed value. - @@ -982,7 +896,6 @@ and active configuration will remain. the player. This function takes ownership of @config. - %TRUE when the configuration could be set. @@ -1001,7 +914,6 @@ This function takes ownership of @config. Sets the current value of the indicated mode @type to the passed value. - @@ -1019,7 +931,6 @@ value. Sets the current value of the indicated mode @type to the passed value. - @@ -1036,7 +947,6 @@ value. %TRUE if the currently-playing stream should be muted. - @@ -1053,7 +963,6 @@ value. Playback at specified rate - @@ -1069,7 +978,6 @@ value. - %TRUE or %FALSE @@ -1089,7 +997,6 @@ Sets the subtitle stack @stream_index. Enable or disable the current subtitle track. - @@ -1108,7 +1015,6 @@ Sets the subtitle stack @stream_index. Sets the external subtitle URI. This should be combined with a call to gst_player_set_subtitle_track_enabled(@player, TRUE) so the subtitles are actually rendered. - @@ -1125,7 +1031,6 @@ rendered. Sets subtitle-video-offset property by value of @offset - @@ -1142,7 +1047,6 @@ rendered. Sets the next URI to play. - @@ -1158,7 +1062,6 @@ rendered. - %TRUE or %FALSE @@ -1178,7 +1081,6 @@ Sets the video track @stream_index. Enable or disable the current video track. - @@ -1194,7 +1096,6 @@ Sets the video track @stream_index. - %TRUE if the visualizations was set correctly. Otherwise, %FALSE. @@ -1214,7 +1115,6 @@ Sets the video track @stream_index. Enable or disable the visualization. - @@ -1231,7 +1131,6 @@ Sets the video track @stream_index. Sets the volume level of the stream as a percentage between 0 and 1. - @@ -1249,7 +1148,6 @@ Sets the video track @stream_index. Stops playing the current stream and resets to the first position in the stream. - @@ -1435,9 +1333,7 @@ in the stream. #GstPlayerStreamInfo specific to audio streams. - - the audio bitrate in #GstPlayerAudioInfo. @@ -1450,7 +1346,6 @@ in the stream. - the number of audio channels in #GstPlayerAudioInfo. @@ -1463,7 +1358,6 @@ in the stream. - the language of the stream, or NULL if unknown. @@ -1476,7 +1370,6 @@ in the stream. - the audio maximum bitrate in #GstPlayerAudioInfo. @@ -1489,7 +1382,6 @@ in the stream. - the audio sample rate in #GstPlayerAudioInfo. @@ -1502,12 +1394,8 @@ in the stream. - - - - - - + + hue or color balance. @@ -1524,7 +1412,6 @@ gain. Gets a string representing the given color balance type. - a string with the name of the color balance type. @@ -1544,7 +1431,6 @@ gain. Gets a string representing the given error. - a string with the given error. @@ -1563,12 +1449,10 @@ gain. - Creates a new GstPlayerSignalDispatcher that uses @application_context, or the thread default one if %NULL is used. See gst_player_new(). - the new GstPlayerSignalDispatcher @@ -1584,14 +1468,10 @@ or the thread default one if %NULL is used. See gst_player_new(). - - - + Structure containing the media information of a URI. - - A #GList of matching #GstPlayerAudioInfo. @@ -1607,7 +1487,6 @@ matching #GstPlayerAudioInfo. - the container format. @@ -1620,7 +1499,6 @@ matching #GstPlayerAudioInfo. - duration of the media. @@ -1635,7 +1513,6 @@ matching #GstPlayerAudioInfo. Function to get the image (or preview-image) stored in taglist. Application can use `gst_sample_*_()` API's to get caps, buffer etc. - GstSample or NULL. @@ -1648,7 +1525,6 @@ Application can use `gst_sample_*_()` API's to get caps, buffer etc. - number of audio streams. @@ -1661,7 +1537,6 @@ Application can use `gst_sample_*_()` API's to get caps, buffer etc. - number of total streams. @@ -1674,7 +1549,6 @@ Application can use `gst_sample_*_()` API's to get caps, buffer etc. - number of subtitle streams. @@ -1687,7 +1561,6 @@ Application can use `gst_sample_*_()` API's to get caps, buffer etc. - number of video streams. @@ -1700,7 +1573,6 @@ Application can use `gst_sample_*_()` API's to get caps, buffer etc. - A #GList of matching #GstPlayerStreamInfo. @@ -1716,7 +1588,6 @@ matching #GstPlayerStreamInfo. - A #GList of matching #GstPlayerSubtitleInfo. @@ -1732,7 +1603,6 @@ matching #GstPlayerSubtitleInfo. - the tags contained in media info. @@ -1745,7 +1615,6 @@ matching #GstPlayerSubtitleInfo. - the media title. @@ -1758,7 +1627,6 @@ matching #GstPlayerSubtitleInfo. - the URI associated with #GstPlayerMediaInfo. @@ -1771,7 +1639,6 @@ matching #GstPlayerSubtitleInfo. - A #GList of matching #GstPlayerVideoInfo. @@ -1787,7 +1654,6 @@ matching #GstPlayerVideoInfo. - %TRUE if the media is live. @@ -1800,7 +1666,6 @@ matching #GstPlayerVideoInfo. - %TRUE if the media is seekable. @@ -1813,13 +1678,9 @@ matching #GstPlayerVideoInfo. - - - + - - @@ -1843,7 +1704,6 @@ matching #GstPlayerVideoInfo. - @@ -1854,13 +1714,11 @@ matching #GstPlayerVideoInfo. - - @@ -1885,7 +1743,6 @@ matching #GstPlayerVideoInfo. - @@ -1913,7 +1770,6 @@ stream. Gets a string representing the given state. - a string with the name of the state. @@ -1930,9 +1786,7 @@ stream. Base structure for information concerning a media stream. Depending on the stream type, one can find more media-specific information in #GstPlayerVideoInfo, #GstPlayerAudioInfo, #GstPlayerSubtitleInfo. - - the #GstCaps of the stream. @@ -1946,7 +1800,6 @@ the stream type, one can find more media-specific information in A string describing codec used in #GstPlayerStreamInfo. - codec string or NULL on unknown. @@ -1960,7 +1813,6 @@ the stream type, one can find more media-specific information in Function to get stream index from #GstPlayerStreamInfo instance. - the stream index of this stream. @@ -1975,7 +1827,6 @@ the stream type, one can find more media-specific information in Function to return human readable name for the stream type of the given @info (ex: "audio", "video", "subtitle") - a human readable name @@ -1988,7 +1839,6 @@ of the given @info (ex: "audio", "video", "subtitle") - the tags contained in this stream. @@ -2001,14 +1851,10 @@ of the given @info (ex: "audio", "video", "subtitle") - - - + #GstPlayerStreamInfo specific to subtitle streams. - - the language of the stream, or NULL if unknown. @@ -2021,14 +1867,10 @@ of the given @info (ex: "audio", "video", "subtitle") - - - + #GstPlayerStreamInfo specific to video streams. - - the current bitrate of video in #GstPlayerVideoInfo. @@ -2041,7 +1883,6 @@ of the given @info (ex: "audio", "video", "subtitle") - @@ -2061,7 +1902,6 @@ of the given @info (ex: "audio", "video", "subtitle") - the height of video in #GstPlayerVideoInfo. @@ -2074,7 +1914,6 @@ of the given @info (ex: "audio", "video", "subtitle") - the maximum bitrate of video in #GstPlayerVideoInfo. @@ -2088,7 +1927,6 @@ of the given @info (ex: "audio", "video", "subtitle") Returns the pixel aspect ratio in @par_n and @par_d - @@ -2108,7 +1946,6 @@ of the given @info (ex: "audio", "video", "subtitle") - the width of video in #GstPlayerVideoInfo. @@ -2121,14 +1958,10 @@ of the given @info (ex: "audio", "video", "subtitle") - - - + - - @@ -2140,7 +1973,6 @@ of the given @info (ex: "audio", "video", "subtitle") - @@ -2158,7 +1990,6 @@ of the given @info (ex: "audio", "video", "subtitle") Tell an overlay that it has been exposed. This will redraw the current frame in the drawable even if the pipeline is PAUSED. - @@ -2172,7 +2003,6 @@ in the drawable even if the pipeline is PAUSED. Return the currently configured render rectangle. See gst_player_video_overlay_video_renderer_set_render_rectangle() for details. - @@ -2200,7 +2030,6 @@ for details. - The currently set, platform specific window handle @@ -2224,7 +2053,6 @@ 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. - @@ -2254,7 +2082,6 @@ do not support subwindows. Sets the platform specific window handle into which the video should be rendered - @@ -2276,13 +2103,9 @@ should be rendered - - - + - - @@ -2297,13 +2120,11 @@ should be rendered - - @@ -2320,7 +2141,6 @@ should be rendered A #GstPlayerVisualization descriptor. - name of the visualization. @@ -2332,7 +2152,6 @@ should be rendered Makes a copy of the #GstPlayerVisualization. The result must be freed using gst_player_visualization_free(). - an allocated copy of @vis. @@ -2346,7 +2165,6 @@ freed using gst_player_visualization_free(). Frees a #GstPlayerVisualization. - @@ -2360,7 +2178,6 @@ freed using gst_player_visualization_free(). Gets a string representing the given color balance type. - a string with the name of the color balance type. @@ -2375,7 +2192,6 @@ freed using gst_player_visualization_free(). Gets a string representing the given error. - a string with the given error. @@ -2394,7 +2210,6 @@ freed using gst_player_visualization_free(). Gets a string representing the given state. - a string with the name of the state. diff --git a/gir-files/GstRtp-1.0.gir b/gir-files/GstRtp-1.0.gir index 19bb6fa45..8e4c3ab97 100644 --- a/gir-files/GstRtp-1.0.gir +++ b/gir-files/GstRtp-1.0.gir @@ -9,42 +9,36 @@ and/or use gtk-doc annotations. --> - - - - - - @@ -61,7 +55,6 @@ An RTCP buffer consists of 1 or more #GstRTCPPacket structures that you can retrieve with gst_rtcp_buffer_get_first_packet(). #GstRTCPPacket acts as a pointer into the RTCP buffer; you can move to the next packet with gst_rtcp_packet_move_to_next(). - @@ -71,7 +64,6 @@ gst_rtcp_packet_move_to_next(). Add a new packet of @type to @rtcp. @packet will point to the newly created packet. - %TRUE if the packet could be created. This function returns %FALSE if the max mtu is exceeded for the buffer. @@ -95,7 +87,6 @@ if the max mtu is exceeded for the buffer. Initialize a new #GstRTCPPacket pointer that points to the first packet in @rtcp. - TRUE if the packet existed in @rtcp. @@ -113,7 +104,6 @@ if the max mtu is exceeded for the buffer. Get the number of RTCP packets in @rtcp. - the number of RTCP packets in @rtcp. @@ -131,7 +121,6 @@ after gst_rtcp_buffer_map() and after adding the RTCP items to the new buffer. The function adjusts the size of @rtcp with the total length of all the added packets. - @@ -145,7 +134,6 @@ added packets. Open @buffer for reading or writing, depending on @flags. The resulting RTCP buffer state is stored in @rtcp. - @@ -167,7 +155,6 @@ buffer state is stored in @rtcp. Create a new buffer for constructing RTCP packets. The packet will have a maximum size of @mtu. - A newly allocated buffer. @@ -183,7 +170,6 @@ maximum size of @mtu. Create a new buffer and set the data to a copy of @len bytes of @data and the size to @len. The data will be freed when the buffer is freed. - A newly allocated buffer with a copy of @data and of size @len. @@ -205,7 +191,6 @@ is freed. Create a new buffer and set the data and size of the buffer to @data and @len respectively. @data will be freed when the buffer is unreffed, so this function transfers ownership of @data to the new buffer. - A newly allocated buffer with @data and of size @len. @@ -226,7 +211,6 @@ function transfers ownership of @data to the new buffer. Check if the data pointed to by @buffer is a valid RTCP packet using gst_rtcp_buffer_validate_data(). - TRUE if @buffer is a valid RTCP packet. @@ -243,7 +227,6 @@ gst_rtcp_buffer_validate_data(). non-reduced size RTCP packet. Use this function to validate a packet before using the other functions in this module. - TRUE if the data points to a valid RTCP packet. @@ -269,7 +252,6 @@ this module. This function is updated to support reduced size rtcp packets according to RFC 5506 and will validate full compound RTCP packets as well as reduced size RTCP packets. - TRUE if the data points to a valid RTCP packet. @@ -290,7 +272,6 @@ size RTCP packets. Check if the data pointed to by @buffer is a valid RTCP packet using gst_rtcp_buffer_validate_reduced(). - TRUE if @buffer is a valid RTCP packet. @@ -352,7 +333,6 @@ gst_rtcp_buffer_validate_reduced(). Data structure that points to a packet at @offset in @buffer. The size of the structure is made public to allow stack allocations. - pointer to RTCP buffer @@ -386,7 +366,6 @@ The size of the structure is made public to allow stack allocations. Add profile-specific extension @data to @packet. If @packet already contains profile-specific extension @data will be appended to the existing extension. - %TRUE if the profile specific extension data was added. @@ -410,7 +389,6 @@ extension. Add a new report block to @packet with the given values. - %TRUE if the packet was created. This function can return %FALSE if the max MTU is exceeded or the number of report blocks is greater than @@ -454,7 +432,6 @@ the max MTU is exceeded or the number of report blocks is greater than Get the application-dependent data attached to a RTPFB or PSFB @packet. - A pointer to the data @@ -469,7 +446,6 @@ the max MTU is exceeded or the number of report blocks is greater than Get the length of the application-dependent data attached to an APP @packet. - The length of data in 32-bit words. @@ -483,7 +459,6 @@ the max MTU is exceeded or the number of report blocks is greater than Get the name field of the APP @packet. - The 4-byte name field, not zero-terminated. @@ -497,7 +472,6 @@ the max MTU is exceeded or the number of report blocks is greater than Get the SSRC/CSRC field of the APP @packet. - The SSRC/CSRC. @@ -511,7 +485,6 @@ the max MTU is exceeded or the number of report blocks is greater than Get the subtype field of the APP @packet. - The subtype. @@ -526,7 +499,6 @@ the max MTU is exceeded or the number of report blocks is greater than Set the length of the application-dependent data attached to an APP @packet. - %TRUE if there was enough space in the packet to add this much data. @@ -545,7 +517,6 @@ data. Set the name field of the APP @packet. - @@ -562,7 +533,6 @@ data. Set the SSRC/CSRC field of the APP @packet. - @@ -579,7 +549,6 @@ data. Set the subtype field of the APP @packet. - @@ -596,7 +565,6 @@ data. Add @ssrc to the BYE @packet. - %TRUE if the ssrc was added. This function can return %FALSE if the max MTU is exceeded or the number of sources blocks is greater than @@ -616,7 +584,6 @@ the max MTU is exceeded or the number of sources blocks is greater than Adds @len SSRCs in @ssrc to BYE @packet. - %TRUE if the all the SSRCs were added. This function can return %FALSE if the max MTU is exceeded or the number of sources blocks is greater than @@ -642,7 +609,6 @@ the max MTU is exceeded or the number of sources blocks is greater than Get the @nth SSRC of the BYE @packet. - The @nth SSRC of @packet. @@ -660,7 +626,6 @@ the max MTU is exceeded or the number of sources blocks is greater than Get the reason in @packet. - The reason for the BYE @packet or NULL if the packet did not contain a reason string. The string must be freed with g_free() after usage. @@ -675,7 +640,6 @@ a reason string. The string must be freed with g_free() after usage. Get the length of the reason string. - The length of the reason string or 0 when there is no reason string present. @@ -690,7 +654,6 @@ present. Get the number of SSRC fields in @packet. - The number of SSRC fields in @packet. @@ -704,7 +667,6 @@ present. Set the reason string to @reason in @packet. - TRUE if the string could be set. @@ -723,7 +685,6 @@ present. The profile-specific extension data is copied into a new allocated memory area @data. This must be freed with g_free() after usage. - %TRUE if there was valid data. @@ -747,7 +708,6 @@ memory area @data. This must be freed with g_free() after usage. Get the Feedback Control Information attached to a RTPFB or PSFB @packet. - a pointer to the FCI @@ -762,7 +722,6 @@ memory area @data. This must be freed with g_free() after usage. Get the length of the Feedback Control Information attached to a RTPFB or PSFB @packet. - The length of the FCI in 32-bit words. @@ -776,7 +735,6 @@ RTPFB or PSFB @packet. Get the media SSRC field of the RTPFB or PSFB @packet. - the media SSRC. @@ -790,7 +748,6 @@ RTPFB or PSFB @packet. Get the sender SSRC field of the RTPFB or PSFB @packet. - the sender SSRC. @@ -804,7 +761,6 @@ RTPFB or PSFB @packet. Get the feedback message type of the FB @packet. - The feedback message type. @@ -819,7 +775,6 @@ RTPFB or PSFB @packet. Set the length of the Feedback Control Information attached to a RTPFB or PSFB @packet. - %TRUE if there was enough space in the packet to add this much FCI @@ -837,7 +792,6 @@ RTPFB or PSFB @packet. Set the media SSRC field of the RTPFB or PSFB @packet. - @@ -854,7 +808,6 @@ RTPFB or PSFB @packet. Set the sender SSRC field of the RTPFB or PSFB @packet. - @@ -871,7 +824,6 @@ RTPFB or PSFB @packet. Set the feedback message type of the FB @packet. - @@ -888,7 +840,6 @@ RTPFB or PSFB @packet. Get the count field in @packet. - The count field in @packet or -1 if @packet does not point to a valid packet. @@ -904,7 +855,6 @@ valid packet. Get the length field of @packet. This is the length of the packet in 32-bit words minus one. - The length field of @packet. @@ -918,7 +868,6 @@ valid packet. Get the packet padding of the packet pointed to by @packet. - If the packet has the padding bit set. @@ -931,7 +880,6 @@ valid packet. - %TRUE if there was valid data. @@ -954,7 +902,6 @@ valid packet. - The number of 32-bit words containing profile-specific extension data from @packet. @@ -970,7 +917,6 @@ valid packet. Parse the values of the @nth report block in @packet and store the result in the values. - @@ -1015,7 +961,6 @@ the values. Get the number of report blocks in @packet. - The number of report blocks in @packet. @@ -1029,7 +974,6 @@ the values. Get the packet type of the packet pointed to by @packet. - The packet type or GST_RTCP_TYPE_INVALID when @packet is not pointing to a valid packet. @@ -1045,7 +989,6 @@ pointing to a valid packet. Move the packet pointer @packet to the next packet in the payload. Use gst_rtcp_buffer_get_first_packet() to initialize @packet. - TRUE if @packet is pointing to a valid packet after calling this function. @@ -1060,7 +1003,6 @@ function. Removes the packet pointed to by @packet and moves pointer to the next one - TRUE if @packet is pointing to a valid packet after calling this function. @@ -1075,7 +1017,6 @@ function. Get the ssrc field of the RR @packet. - the ssrc. @@ -1089,7 +1030,6 @@ function. Set the ssrc field of the RR @packet. - @@ -1106,7 +1046,6 @@ function. Add a new SDES entry to the current item in @packet. - %TRUE if the item could be added, %FALSE if the MTU has been reached. @@ -1135,7 +1074,6 @@ reached. Add a new SDES item for @ssrc to @packet. - %TRUE if the item could be added, %FALSE if the maximum amount of items has been exceeded for the SDES packet or the MTU has been reached. @@ -1155,7 +1093,6 @@ items has been exceeded for the SDES packet or the MTU has been reached. This function is like gst_rtcp_packet_sdes_get_entry() but it returns a null-terminated copy of the data instead. use g_free() after usage. - %TRUE if there was valid data. @@ -1183,7 +1120,6 @@ null-terminated copy of the data instead. use g_free() after usage. Move to the first SDES entry in the current item. - %TRUE if there was a first entry. @@ -1197,7 +1133,6 @@ null-terminated copy of the data instead. use g_free() after usage. Move to the first SDES item in @packet. - TRUE if there was a first item. @@ -1217,7 +1152,6 @@ bytes. When @type refers to a text item, @data will point to a UTF8 string. Note that this UTF8 string is NOT null-terminated. Use gst_rtcp_packet_sdes_copy_entry() to get a null-terminated copy of the entry. - %TRUE if there was valid data. @@ -1245,7 +1179,6 @@ gst_rtcp_packet_sdes_copy_entry() to get a null-terminated copy of the entry. Get the number of items in the SDES packet @packet. - The number of items in @packet. @@ -1259,7 +1192,6 @@ gst_rtcp_packet_sdes_copy_entry() to get a null-terminated copy of the entry. Get the SSRC of the current SDES item. - the SSRC of the current item. @@ -1273,7 +1205,6 @@ gst_rtcp_packet_sdes_copy_entry() to get a null-terminated copy of the entry. Move to the next SDES entry in the current item. - %TRUE if there was a next entry. @@ -1287,7 +1218,6 @@ gst_rtcp_packet_sdes_copy_entry() to get a null-terminated copy of the entry. Move to the next SDES item in @packet. - TRUE if there was a next item. @@ -1303,7 +1233,6 @@ gst_rtcp_packet_sdes_copy_entry() to get a null-terminated copy of the entry.Set the @nth new report block in @packet with the given values. Note: Not implemented. - @@ -1348,7 +1277,6 @@ Note: Not implemented. Parse the SR sender info and store the values. - @@ -1381,7 +1309,6 @@ Note: Not implemented. Set the given values in the SR packet @packet. - @@ -1414,7 +1341,6 @@ Note: Not implemented. Move to the first extended report block in XR @packet. - TRUE if there was a first extended report block. @@ -1427,7 +1353,6 @@ Note: Not implemented. - The number of 32-bit words containing type-specific block data from @packet. @@ -1442,7 +1367,6 @@ Note: Not implemented. Get the extended report block type of the XR @packet. - The extended report block type. @@ -1456,7 +1380,6 @@ Note: Not implemented. Parse the extended report block for DLRR report block type. - %TRUE if the report block is correctly parsed. @@ -1486,7 +1409,6 @@ Note: Not implemented. Retrieve the packet receipt time of @seq which ranges in [begin_seq, end_seq). - %TRUE if the report block returns the receipt time correctly. @@ -1508,7 +1430,6 @@ Note: Not implemented. Parse the Packet Recept Times Report Block from a XR @packet - %TRUE if the report block is correctly parsed. @@ -1538,7 +1459,6 @@ Note: Not implemented. Parse the extended report block for Loss RLE and Duplicated LRE block type. - %TRUE if the report block is correctly parsed. @@ -1572,7 +1492,6 @@ Note: Not implemented. Retrieve actual chunk data. - %TRUE if the report block returns chunk correctly. @@ -1593,7 +1512,6 @@ Note: Not implemented. - %TRUE if the report block returns the reference time correctly. @@ -1611,7 +1529,6 @@ Note: Not implemented. Get the ssrc field of the XR @packet. - the ssrc. @@ -1625,7 +1542,6 @@ Note: Not implemented. Extract a basic information from static summary report block of XR @packet. - %TRUE if the report block is correctly parsed. @@ -1652,7 +1568,6 @@ Note: Not implemented. Extract jitter information from the statistics summary. If the jitter flag in a block header is set as zero, all of jitters will be zero. - %TRUE if the report block is correctly parsed. @@ -1683,7 +1598,6 @@ a block header is set as zero, all of jitters will be zero. Get the number of lost or duplicate packets. If the flag in a block header is set as zero, @lost_packets or @dup_packets will be zero. - %TRUE if the report block is correctly parsed. @@ -1705,7 +1619,6 @@ is set as zero, @lost_packets or @dup_packets will be zero. Extract the value of ttl for ipv4, or hop limit for ipv6. - %TRUE if the report block is correctly parsed. @@ -1738,7 +1651,6 @@ is set as zero, @lost_packets or @dup_packets will be zero. - %TRUE if the report block is correctly parsed. @@ -1767,7 +1679,6 @@ is set as zero, @lost_packets or @dup_packets will be zero. - %TRUE if the report block is correctly parsed. @@ -1788,7 +1699,6 @@ is set as zero, @lost_packets or @dup_packets will be zero. - %TRUE if the report block is correctly parsed. @@ -1809,7 +1719,6 @@ is set as zero, @lost_packets or @dup_packets will be zero. - %TRUE if the report block is correctly parsed. @@ -1834,7 +1743,6 @@ is set as zero, @lost_packets or @dup_packets will be zero. - %TRUE if the report block is correctly parsed. @@ -1851,7 +1759,6 @@ is set as zero, @lost_packets or @dup_packets will be zero. - %TRUE if the report block is correctly parsed. @@ -1872,7 +1779,6 @@ is set as zero, @lost_packets or @dup_packets will be zero. - %TRUE if the report block is correctly parsed. @@ -1901,7 +1807,6 @@ is set as zero, @lost_packets or @dup_packets will be zero. - %TRUE if the report block is correctly parsed. @@ -1931,7 +1836,6 @@ is set as zero, @lost_packets or @dup_packets will be zero. Move to the next extended report block in XR @packet. - TRUE if there was a next extended report block. @@ -2037,44 +1941,36 @@ according to the [IANA registry](https://www.iana.org/assignments/rtcp-xr-block- The maximum amount of SSRCs in a BYE packet. - The maximum amount of Receiver report blocks in RR and SR messages. - The maximum text length for an SDES item. - The maximum amount of SDES items. - Mask for version, padding bit and packet type pair allowing reduced size packets, basically it accepts other types than RR and SR - Mask for version, padding bit and packet type pair - Valid value for the first two bytes of an RTCP packet after applying #GST_RTCP_VALID_MASK to them. - The supported RTCP version 2. - @@ -2106,7 +2002,6 @@ GstRTPBaseAudioPayload derives from GstRTPBasePayload, the child element must set any variables or call/override any functions required by that base class. The child element does not need to override any other functions specific to GstRTPBaseAudioPayload. - Create an RTP buffer and store @payload_len bytes of the adapter as the payload. Set the timestamp on the new buffer to @timestamp before pushing @@ -2114,7 +2009,6 @@ the buffer downstream. If @payload_len is -1, all pending bytes will be flushed. If @timestamp is -1, the timestamp will be calculated automatically. - a #GstFlowReturn @@ -2136,7 +2030,6 @@ If @payload_len is -1, all pending bytes will be flushed. If @timestamp is Gets the internal adapter used by the depayloader. - a #GstAdapter. @@ -2152,7 +2045,6 @@ If @payload_len is -1, all pending bytes will be flushed. If @timestamp is Create an RTP buffer and store @payload_len bytes of @data as the payload. Set the timestamp on the new buffer to @timestamp before pushing the buffer downstream. - a #GstFlowReturn @@ -2181,7 +2073,6 @@ the buffer downstream. Tells #GstRTPBaseAudioPayload that the child element is for a frame based audio codec - @@ -2194,7 +2085,6 @@ audio codec Sets the options for frame based audio codecs. - @@ -2216,7 +2106,6 @@ audio codec Tells #GstRTPBaseAudioPayload that the child element is for a sample based audio codec - @@ -2229,7 +2118,6 @@ audio codec Sets the options for sample based audio codecs. - @@ -2246,7 +2134,6 @@ audio codec Sets the options for sample based audio codecs. - @@ -2290,7 +2177,6 @@ audio codec Base class for audio RTP payloader. - the parent class @@ -2301,14 +2187,10 @@ audio codec - - - + Provides a base class for RTP depayloaders - - @@ -2322,7 +2204,6 @@ audio codec - @@ -2336,7 +2217,6 @@ audio codec - @@ -2350,7 +2230,6 @@ audio codec - @@ -2364,7 +2243,6 @@ audio codec - @@ -2379,7 +2257,6 @@ audio codec Queries whether #GstRTPSourceMeta will be added to depayloaded buffers. - %TRUE if source-info is enabled. @@ -2397,7 +2274,6 @@ audio codec This function will by default apply the last incoming timestamp on the outgoing buffer when it didn't have a timestamp already. - a #GstFlowReturn. @@ -2416,7 +2292,6 @@ the outgoing buffer when it didn't have a timestamp already. Push @out_list to the peer of @filter. This function takes ownership of @out_list. - a #GstFlowReturn. @@ -2434,7 +2309,6 @@ the outgoing buffer when it didn't have a timestamp already. Enable or disable adding #GstRTPSourceMeta to depayloaded buffers. - @@ -2508,14 +2382,12 @@ the last processed buffer and current state of the stream being depayloaded: Base class for RTP depayloaders. - the parent class - @@ -2531,7 +2403,6 @@ the last processed buffer and current state of the stream being depayloaded: - @@ -2547,7 +2418,6 @@ the last processed buffer and current state of the stream being depayloaded: - @@ -2563,7 +2433,6 @@ the last processed buffer and current state of the stream being depayloaded: - @@ -2579,7 +2448,6 @@ the last processed buffer and current state of the stream being depayloaded: - @@ -2599,14 +2467,10 @@ the last processed buffer and current state of the stream being depayloaded: - - - + Provides a base class for RTP payloaders - - @@ -2623,7 +2487,6 @@ the last processed buffer and current state of the stream being depayloaded: - @@ -2637,7 +2500,6 @@ the last processed buffer and current state of the stream being depayloaded: - @@ -2654,7 +2516,6 @@ the last processed buffer and current state of the stream being depayloaded: - @@ -2668,7 +2529,6 @@ the last processed buffer and current state of the stream being depayloaded: - @@ -2682,7 +2542,6 @@ the last processed buffer and current state of the stream being depayloaded: - @@ -2700,7 +2559,6 @@ the last processed buffer and current state of the stream being depayloaded: minimum @csrc_count CSRCs, a payload length of @payload_len and padding of @pad_len. If @payload has #GstRTPBasePayload:source-info %TRUE additional CSRCs may be allocated and filled with RTP source information. - A newly allocated buffer that can hold an RTP packet with given parameters. @@ -2729,7 +2587,6 @@ parameters. Count the total number of RTP sources found in the meta of @buffer, which will be automically added by gst_rtp_base_payload_allocate_output_buffer(). If #GstRTPBasePayload:source-info is %FALSE the count will be 0. - The number of sources. @@ -2748,7 +2605,6 @@ If #GstRTPBasePayload:source-info is %FALSE the count will be 0. Check if the packet with @size and @duration would exceed the configured maximum size. - %TRUE if the packet of @size and @duration would exceed the configured MTU or max_ptime. @@ -2772,7 +2628,6 @@ configured MTU or max_ptime. Queries whether the payloader will add contributing sources (CSRCs) to the RTP header from #GstRTPSourceMeta. - %TRUE if source-info is enabled. @@ -2789,7 +2644,6 @@ RTP header from #GstRTPSourceMeta. seqnum and timestamp of the RTP buffer will be updated first. This function takes ownership of @buffer. - a #GstFlowReturn. @@ -2810,7 +2664,6 @@ This function takes ownership of @buffer. seqnum and timestamp of the RTP buffer will be updated first. This function takes ownership of @list. - a #GstFlowReturn. @@ -2830,7 +2683,6 @@ This function takes ownership of @list. Set the rtp options of the payloader. These options will be set in the caps of the payloader. Subclasses must call this method before calling gst_rtp_base_payload_push() or gst_rtp_base_payload_set_outcaps(). - @@ -2862,7 +2714,6 @@ gst_rtp_base_payload_push() or gst_rtp_base_payload_set_outcaps(). Variable arguments should be in the form field name, field type (as a GType), value(s). The last variable argument should be NULL. - %TRUE if the caps could be set. @@ -2885,7 +2736,6 @@ Variable arguments should be in the form field name, field type Enable or disable adding contributing sources to RTP packets from #GstRTPSourceMeta. - @@ -3065,14 +2915,12 @@ the last processed buffer and current state of the stream being payloaded: Base class for audio RTP payloader. - the parent class - @@ -3091,7 +2939,6 @@ the last processed buffer and current state of the stream being payloaded: - @@ -3107,7 +2954,6 @@ the last processed buffer and current state of the stream being payloaded: - @@ -3123,7 +2969,6 @@ the last processed buffer and current state of the stream being payloaded: - @@ -3139,7 +2984,6 @@ the last processed buffer and current state of the stream being payloaded: - @@ -3155,7 +2999,6 @@ the last processed buffer and current state of the stream being payloaded: - @@ -3178,14 +3021,11 @@ the last processed buffer and current state of the stream being payloaded: - - - + The GstRTPBuffer helper functions makes it easy to parse and create regular #GstBuffer objects that contain RTP payloads. These buffers are typically of 'application/x-rtp' #GstCaps. - pointer to RTP buffer @@ -3220,7 +3060,6 @@ It will not work if there is already a header extension that does not follow the mechanism described in RFC 5285 or if there is a header extension with a two bytes header as described in RFC 5285. In that case, use gst_rtp_buffer_add_extension_twobytes_header() - %TRUE if header extension could be added @@ -3254,7 +3093,6 @@ It will not work if there is already a header extension that does not follow the mechanism described in RFC 5285 or if there is a header extension with a one byte header as described in RFC 5285. In that case, use gst_rtp_buffer_add_extension_onebyte_header() - %TRUE if header extension could be added @@ -3286,7 +3124,6 @@ gst_rtp_buffer_add_extension_onebyte_header() Get the CSRC at index @idx in @buffer. - the CSRC at index @idx in host order. @@ -3304,7 +3141,6 @@ gst_rtp_buffer_add_extension_onebyte_header() Get the CSRC count of the RTP packet in @buffer. - the CSRC count of @buffer. @@ -3318,7 +3154,6 @@ gst_rtp_buffer_add_extension_onebyte_header() Check if the extension bit is set on the RTP packet in @buffer. - TRUE if @buffer has the extension bit set. @@ -3339,7 +3174,6 @@ the extension data (not including the extension header) is placed in a new If @rtp did not contain an extension, this function will return %NULL, with @bits unchanged. If there is an extension header but no extension data then an empty #GBytes will be returned. - A new #GBytes if an extension header was present and %NULL otherwise. @@ -3363,7 +3197,6 @@ the length of @data in 32 bits words. If @buffer did not contain an extension, this function will return %FALSE with @bits, @data and @wordlen unchanged. - TRUE if @buffer had the extension bit set. @@ -3392,7 +3225,6 @@ with @bits, @data and @wordlen unchanged. Parses RFC 5285 style header extensions with a one byte header. It will return the nth extension with the requested id. - TRUE if @buffer had the requested header extension @@ -3426,7 +3258,6 @@ return the nth extension with the requested id. Parses RFC 5285 style header extensions with a two bytes header. It will return the nth extension with the requested id. - TRUE if @buffer had the requested header extension @@ -3464,7 +3295,6 @@ return the nth extension with the requested id. Return the total length of the header in @buffer. This include the length of the fixed header, the CSRC list and the extension header. - The total length of the header in @buffer. @@ -3478,7 +3308,6 @@ the fixed header, the CSRC list and the extension header. Check if the marker bit is set on the RTP packet in @buffer. - TRUE if @buffer has the marker bit set. @@ -3492,7 +3321,6 @@ the fixed header, the CSRC list and the extension header. Return the total length of the packet in @buffer. - The total length of the packet in @buffer. @@ -3506,7 +3334,6 @@ the fixed header, the CSRC list and the extension header. Check if the padding bit is set on the RTP packet in @buffer. - TRUE if @buffer has the padding bit set. @@ -3521,7 +3348,6 @@ the fixed header, the CSRC list and the extension header. Get a pointer to the payload data in @buffer. This pointer is valid as long as a reference to @buffer is held. - A pointer to the payload data in @buffer. @@ -3540,7 +3366,6 @@ to the payload data in @buffer. Create a buffer of the payload of the RTP packet in @buffer. This function will internally create a subbuffer of @buffer so that a memcpy can be avoided. - A new buffer with the data of the payload. @@ -3556,7 +3381,6 @@ avoided. Similar to gst_rtp_buffer_get_payload, but more suitable for language bindings usage. The return value is a pointer to a #GBytes structure containing the payload data in @rtp. - A new #GBytes containing the payload data in @rtp. @@ -3570,7 +3394,6 @@ containing the payload data in @rtp. Get the length of the payload of the RTP packet in @buffer. - The length of the payload in @buffer. @@ -3586,7 +3409,6 @@ containing the payload data in @rtp. Create a subbuffer of the payload of the RTP packet in @buffer. @offset bytes are skipped in the payload and the subbuffer will be of size @len. If @len is -1 the total payload starting from @offset is subbuffered. - A new buffer with the specified data of the payload. @@ -3608,7 +3430,6 @@ If @len is -1 the total payload starting from @offset is subbuffered. Get the payload type of the RTP packet in @buffer. - The payload type. @@ -3622,7 +3443,6 @@ If @len is -1 the total payload starting from @offset is subbuffered. Get the sequence number of the RTP packet in @buffer. - The sequence number in host order. @@ -3636,7 +3456,6 @@ If @len is -1 the total payload starting from @offset is subbuffered. Get the SSRC of the RTP packet in @buffer. - the SSRC of @buffer in host order. @@ -3650,7 +3469,6 @@ If @len is -1 the total payload starting from @offset is subbuffered. Get the timestamp of the RTP packet in @buffer. - The timestamp in host order. @@ -3664,7 +3482,6 @@ If @len is -1 the total payload starting from @offset is subbuffered. Get the version number of the RTP packet in @buffer. - The version of @buffer. @@ -3681,7 +3498,6 @@ If @len is -1 the total payload starting from @offset is subbuffered. @len. If @len is 0, the padding is removed. NOTE: This function does not work correctly. - @@ -3698,7 +3514,6 @@ NOTE: This function does not work correctly. Modify the CSRC at index @idx in @buffer to @csrc. - @@ -3719,7 +3534,6 @@ NOTE: This function does not work correctly. Set the extension bit on the RTP packet in @buffer to @extension. - @@ -3738,7 +3552,6 @@ NOTE: This function does not work correctly. Set the extension bit of the rtp buffer and fill in the @bits and @length of the extension header. If the existing extension data is not large enough, it will be made larger. - True if done. @@ -3761,7 +3574,6 @@ the extension, excluding the extension header ( therefore zero is a valid length Set the marker bit on the RTP packet in @buffer to @marker. - @@ -3779,7 +3591,6 @@ the extension, excluding the extension header ( therefore zero is a valid length Set the total @rtp size to @len. The data in the buffer will be made larger if needed. Any padding will be removed from the packet. - @@ -3796,7 +3607,6 @@ larger if needed. Any padding will be removed from the packet. Set the padding bit on the RTP packet in @buffer to @padding. - @@ -3813,7 +3623,6 @@ larger if needed. Any padding will be removed from the packet. Set the payload type of the RTP packet in @buffer to @payload_type. - @@ -3830,7 +3639,6 @@ larger if needed. Any padding will be removed from the packet. Set the sequence number of the RTP packet in @buffer to @seq. - @@ -3847,7 +3655,6 @@ larger if needed. Any padding will be removed from the packet. Set the SSRC on the RTP packet in @buffer to @ssrc. - @@ -3864,7 +3671,6 @@ larger if needed. Any padding will be removed from the packet. Set the timestamp of the RTP packet in @buffer to @timestamp. - @@ -3881,7 +3687,6 @@ larger if needed. Any padding will be removed from the packet. Set the version of the RTP packet in @buffer to @version. - @@ -3898,7 +3703,6 @@ larger if needed. Any padding will be removed from the packet. Unmap @rtp previously mapped with gst_rtp_buffer_map(). - @@ -3915,7 +3719,6 @@ a payload length of @payload_len and padding of @pad_len. @buffer must be writable and all previous memory in @buffer will be freed. If @pad_len is >0, the padding bit will be set. All other RTP header fields will be set to 0/FALSE. - @@ -3941,7 +3744,6 @@ will be set to 0/FALSE. Calculate the header length of an RTP packet with @csrc_count CSRC entries. An RTP packet can have at most 15 CSRC entries. - The length of an RTP header with @csrc_count CSRC entries. @@ -3956,7 +3758,6 @@ An RTP packet can have at most 15 CSRC entries. Calculate the total length of an RTP packet with a payload size of @payload_len, a padding of @pad_len and a @csrc_count CSRC entries. - The total length of an RTP header with given parameters. @@ -3979,7 +3780,6 @@ a padding of @pad_len and a @csrc_count CSRC entries. Calculate the length of the payload of an RTP packet with size @packet_len, a padding of @pad_len and a @csrc_count CSRC entries. - The length of the payload of an RTP packet with given parameters. @@ -4002,7 +3802,6 @@ a padding of @pad_len and a @csrc_count CSRC entries. Compare two sequence numbers, taking care of wraparounds. This function returns the difference between @seqnum1 and @seqnum2. - a negative value if @seqnum1 is bigger than @seqnum2, 0 if they are equal or a positive value if @seqnum1 is smaller than @segnum2. @@ -4021,7 +3820,6 @@ are equal or a positive value if @seqnum1 is smaller than @segnum2. Get the default clock-rate for the static payload type @payload_type. - the default clock rate or -1 if the payload type is not static or the clock-rate is undefined. @@ -4043,7 +3841,6 @@ This function is able to handle both forward and backward timestamps taking into account: - timestamp wraparound making sure that the returned value is properly increased. - timestamp unwraparound making sure that the returned value is properly decreased. - The extended timestamp of @timestamp or 0 if the result can't go anywhere backwards. @@ -4064,7 +3861,6 @@ into account: on the #GBytes you get from gst_rtp_buffer_get_extension_bytes. Parses RFC 5285 style header extensions with a one byte header. It will return the nth extension with the requested id. - TRUE if @bytes had the requested header extension @@ -4101,7 +3897,6 @@ return the nth extension with the requested id. Map the contents of @buffer into @rtp. - %TRUE if @buffer could be mapped. @@ -4125,7 +3920,6 @@ return the nth extension with the requested id. Allocate a new #GstBuffer with enough data to hold an RTP packet with @csrc_count CSRCs, a payload length of @payload_len and padding of @pad_len. All other RTP header fields will be set to 0/FALSE. - A newly allocated buffer that can hold an RTP packet with given parameters. @@ -4151,7 +3945,6 @@ parameters. @packet_len long. The length of the payload depends on @pad_len and @csrc_count and can be calculated with gst_rtp_buffer_calc_payload_len(). All RTP header fields will be set to 0/FALSE. - A newly allocated buffer that can hold an RTP packet of @packet_len. @@ -4175,7 +3968,6 @@ All RTP header fields will be set to 0/FALSE. Create a new buffer and set the data to a copy of @len bytes of @data and the size to @len. The data will be freed when the buffer is freed. - A newly allocated buffer with a copy of @data and of size @len. @@ -4198,7 +3990,6 @@ is freed. Create a new buffer and set the data and size of the buffer to @data and @len respectively. @data will be freed when the buffer is unreffed, so this function transfers ownership of @data to the new buffer. - A newly allocated buffer with @data and of size @len. @@ -4343,7 +4134,6 @@ Reserved for RTCP conflict avoidance: 72-76 Structure holding default payload type information. - payload type, -1 means dynamic @@ -4381,7 +4171,6 @@ mostly used to get the default clock-rate and bandwidth for dynamic payload types specified with @media and @encoding name. The search for @encoding_name will be performed in a case insensitive way. - a #GstRTPPayloadInfo or NULL when no info could be found. @@ -4401,7 +4190,6 @@ The search for @encoding_name will be performed in a case insensitive way. Get the #GstRTPPayloadInfo for @payload_type. This function is mostly used to get the default clock-rate and bandwidth for static payload types specified with @payload_type. - a #GstRTPPayloadInfo or NULL when no info could be found. @@ -4434,7 +4222,6 @@ types specified with @payload_type. Meta describing the source(s) of the buffer. - parent #GstMeta @@ -4459,7 +4246,6 @@ types specified with @payload_type. Appends @csrc to the list of contributing sources in @meta. - %TRUE if all elements in @csrc was added, %FALSE otherwise. @@ -4481,7 +4267,6 @@ types specified with @payload_type. Count the total number of RTP sources found in @meta, both SSRC and CSRC. - The number of RTP sources @@ -4495,7 +4280,6 @@ types specified with @payload_type. Sets @ssrc in @meta. If @ssrc is %NULL the ssrc of @meta will be unset. - %TRUE on success, %FALSE otherwise. @@ -4512,98 +4296,84 @@ types specified with @payload_type. - - - - - - - - - - - - - - @@ -4611,7 +4381,6 @@ types specified with @payload_type. Get access to the configured MTU of @payload. - a #GstRTPBasePayload @@ -4620,7 +4389,6 @@ types specified with @payload_type. Get access to the configured payload type of @payload. - a #GstRTPBasePayload @@ -4629,7 +4397,6 @@ types specified with @payload_type. Get access to the sinkpad of @payload. - a #GstRTPBasePayload @@ -4638,7 +4405,6 @@ types specified with @payload_type. Get access to the srcpad of @payload. - a #GstRTPBasePayload @@ -4646,108 +4412,82 @@ types specified with @payload_type. - - - - - - - - - - - - - - - - - - - - - - - - - Check if @pt is a dynamic payload type. - a payload type @@ -4755,77 +4495,59 @@ types specified with @payload_type. - - - - - - - - - - - - - - - - The supported RTP version 2. - Attaches RTP source information to @buffer. - the #GstRTPSourceMeta on @buffer. @@ -4851,7 +4573,6 @@ types specified with @payload_type. Find the #GstRTPSourceMeta on @buffer. - the #GstRTPSourceMeta or %NULL when there is no such metadata on @buffer. @@ -4875,7 +4596,6 @@ and get session bandwidth information. Open @buffer for reading or writing, depending on @flags. The resulting RTCP buffer state is stored in @rtcp. - @@ -4897,7 +4617,6 @@ buffer state is stored in @rtcp. Create a new buffer for constructing RTCP packets. The packet will have a maximum size of @mtu. - A newly allocated buffer. @@ -4913,7 +4632,6 @@ maximum size of @mtu. Create a new buffer and set the data to a copy of @len bytes of @data and the size to @len. The data will be freed when the buffer is freed. - A newly allocated buffer with a copy of @data and of size @len. @@ -4935,7 +4653,6 @@ is freed. Create a new buffer and set the data and size of the buffer to @data and @len respectively. @data will be freed when the buffer is unreffed, so this function transfers ownership of @data to the new buffer. - A newly allocated buffer with @data and of size @len. @@ -4956,7 +4673,6 @@ function transfers ownership of @data to the new buffer. Check if the data pointed to by @buffer is a valid RTCP packet using gst_rtcp_buffer_validate_data(). - TRUE if @buffer is a valid RTCP packet. @@ -4973,7 +4689,6 @@ gst_rtcp_buffer_validate_data(). non-reduced size RTCP packet. Use this function to validate a packet before using the other functions in this module. - TRUE if the data points to a valid RTCP packet. @@ -4999,7 +4714,6 @@ this module. This function is updated to support reduced size rtcp packets according to RFC 5506 and will validate full compound RTCP packets as well as reduced size RTCP packets. - TRUE if the data points to a valid RTCP packet. @@ -5020,7 +4734,6 @@ size RTCP packets. Check if the data pointed to by @buffer is a valid RTCP packet using gst_rtcp_buffer_validate_reduced(). - TRUE if @buffer is a valid RTCP packet. @@ -5037,7 +4750,6 @@ gst_rtcp_buffer_validate_reduced(). the NTP time of an SR RTCP message and contains, in the upper 32 bits, the number of seconds since 1900 and, in the lower 32 bits, the fractional seconds. The resulting value will be the number of nanoseconds since 1970. - the UNIX time for @ntptime in nanoseconds. @@ -5052,7 +4764,6 @@ seconds. The resulting value will be the number of nanoseconds since 1970. Convert @name into a @GstRTCPSDESType. @name is typically a key in a #GstStructure containing SDES items. - the #GstRTCPSDESType for @name or #GST_RTCP_SDES_PRIV when @name is a private sdes item. @@ -5068,7 +4779,6 @@ is a private sdes item. Converts @type to the string equivalent. The string is typically used as a key in a #GstStructure containing SDES items. - the string equivalent of @type @@ -5086,7 +4796,6 @@ pass a value with nanoseconds since 1970. The NTP time will, in the upper 32 bits, contain the number of seconds since 1900 and, in the lower 32 bits, the fractional seconds. The resulting value can be used as an ntptime for constructing SR RTCP packets. - the NTP time for @unixtime. @@ -5104,7 +4813,6 @@ a payload length of @payload_len and padding of @pad_len. @buffer must be writable and all previous memory in @buffer will be freed. If @pad_len is >0, the padding bit will be set. All other RTP header fields will be set to 0/FALSE. - @@ -5130,7 +4838,6 @@ will be set to 0/FALSE. Calculate the header length of an RTP packet with @csrc_count CSRC entries. An RTP packet can have at most 15 CSRC entries. - The length of an RTP header with @csrc_count CSRC entries. @@ -5145,7 +4852,6 @@ An RTP packet can have at most 15 CSRC entries. Calculate the total length of an RTP packet with a payload size of @payload_len, a padding of @pad_len and a @csrc_count CSRC entries. - The total length of an RTP header with given parameters. @@ -5168,7 +4874,6 @@ a padding of @pad_len and a @csrc_count CSRC entries. Calculate the length of the payload of an RTP packet with size @packet_len, a padding of @pad_len and a @csrc_count CSRC entries. - The length of the payload of an RTP packet with given parameters. @@ -5191,7 +4896,6 @@ a padding of @pad_len and a @csrc_count CSRC entries. Compare two sequence numbers, taking care of wraparounds. This function returns the difference between @seqnum1 and @seqnum2. - a negative value if @seqnum1 is bigger than @seqnum2, 0 if they are equal or a positive value if @seqnum1 is smaller than @segnum2. @@ -5210,7 +4914,6 @@ are equal or a positive value if @seqnum1 is smaller than @segnum2. Get the default clock-rate for the static payload type @payload_type. - the default clock rate or -1 if the payload type is not static or the clock-rate is undefined. @@ -5232,7 +4935,6 @@ This function is able to handle both forward and backward timestamps taking into account: - timestamp wraparound making sure that the returned value is properly increased. - timestamp unwraparound making sure that the returned value is properly decreased. - The extended timestamp of @timestamp or 0 if the result can't go anywhere backwards. @@ -5253,7 +4955,6 @@ into account: on the #GBytes you get from gst_rtp_buffer_get_extension_bytes. Parses RFC 5285 style header extensions with a one byte header. It will return the nth extension with the requested id. - TRUE if @bytes had the requested header extension @@ -5290,7 +4991,6 @@ return the nth extension with the requested id. Map the contents of @buffer into @rtp. - %TRUE if @buffer could be mapped. @@ -5314,7 +5014,6 @@ return the nth extension with the requested id. Allocate a new #GstBuffer with enough data to hold an RTP packet with @csrc_count CSRCs, a payload length of @payload_len and padding of @pad_len. All other RTP header fields will be set to 0/FALSE. - A newly allocated buffer that can hold an RTP packet with given parameters. @@ -5340,7 +5039,6 @@ parameters. @packet_len long. The length of the payload depends on @pad_len and @csrc_count and can be calculated with gst_rtp_buffer_calc_payload_len(). All RTP header fields will be set to 0/FALSE. - A newly allocated buffer that can hold an RTP packet of @packet_len. @@ -5364,7 +5062,6 @@ All RTP header fields will be set to 0/FALSE. Create a new buffer and set the data to a copy of @len bytes of @data and the size to @len. The data will be freed when the buffer is freed. - A newly allocated buffer with a copy of @data and of size @len. @@ -5387,7 +5084,6 @@ is freed. Create a new buffer and set the data and size of the buffer to @data and @len respectively. @data will be freed when the buffer is unreffed, so this function transfers ownership of @data to the new buffer. - A newly allocated buffer with @data and of size @len. @@ -5409,7 +5105,6 @@ function transfers ownership of @data to the new buffer. Reads the NTP time from the @size NTP-56 extension bytes in @data and store the result in @ntptime. - %TRUE on success. @@ -5434,7 +5129,6 @@ result in @ntptime. Reads the NTP time from the @size NTP-64 extension bytes in @data and store the result in @ntptime. - %TRUE on success. @@ -5459,7 +5153,6 @@ result in @ntptime. Writes the NTP time in @ntptime to the format required for the NTP-56 header extension. @data must hold at least #GST_RTP_HDREXT_NTP_56_SIZE bytes. - %TRUE on success. @@ -5482,7 +5175,6 @@ extension. @data must hold at least #GST_RTP_HDREXT_NTP_56_SIZE bytes. Writes the NTP time in @ntptime to the format required for the NTP-64 header extension. @data must hold at least #GST_RTP_HDREXT_NTP_64_SIZE bytes. - %TRUE on success. @@ -5508,7 +5200,6 @@ mostly used to get the default clock-rate and bandwidth for dynamic payload types specified with @media and @encoding name. The search for @encoding_name will be performed in a case insensitive way. - a #GstRTPPayloadInfo or NULL when no info could be found. @@ -5528,7 +5219,6 @@ The search for @encoding_name will be performed in a case insensitive way. Get the #GstRTPPayloadInfo for @payload_type. This function is mostly used to get the default clock-rate and bandwidth for static payload types specified with @payload_type. - a #GstRTPPayloadInfo or NULL when no info could be found. @@ -5541,13 +5231,11 @@ types specified with @payload_type. - - diff --git a/gir-files/GstRtsp-1.0.gir b/gir-files/GstRtsp-1.0.gir index 4b0f2f133..2dce0a05c 100644 --- a/gir-files/GstRtsp-1.0.gir +++ b/gir-files/GstRtsp-1.0.gir @@ -11,7 +11,6 @@ and/or use gtk-doc annotations. --> - @@ -19,7 +18,6 @@ and/or use gtk-doc annotations. --> RTSP Authentication credentials - a #GstRTSPAuthMethod @@ -47,7 +45,6 @@ and/or use gtk-doc annotations. --> RTSP Authentication parameter - The name of the parameter @@ -57,7 +54,6 @@ and/or use gtk-doc annotations. --> - @@ -68,7 +64,6 @@ and/or use gtk-doc annotations. --> - @@ -82,10 +77,8 @@ and/or use gtk-doc annotations. --> This object manages the RTSP connection to the server. It provides function to receive and send bytes and messages. - Clear the list of authentication directives stored in @conn. - @@ -99,7 +92,6 @@ to receive and send bytes and messages. Close the connected @conn. After this call, the connection is in the same state as when it was first created. - #GST_RTSP_OK on success. @@ -118,7 +110,6 @@ forever. If @timeout contains a valid timeout, this function will return #GST_RTSP_ETIMEOUT after the timeout expired. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK when a connection could be made. @@ -141,7 +132,6 @@ forever. If @timeout contains a valid timeout, this function will return #GST_RTSP_ETIMEOUT after the timeout expired. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK when a connection could be made. @@ -165,7 +155,6 @@ forever. If @timeout contains a valid timeout, this function will return @response will contain a response to the tunneling request messages. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK when a connection could be made. @@ -193,7 +182,6 @@ forever. If @timeout contains a valid timeout, this function will return @response will contain a response to the tunneling request messages. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK when a connection could be made. @@ -223,7 +211,6 @@ gst_rtsp_connection_free(). If @conn2 is %NULL then only the base64 decoding context will be setup for @conn. - return GST_RTSP_OK on success. @@ -243,7 +230,6 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for Start or stop the flushing action on @conn. When flushing, all current and future actions on @conn will return #GST_RTSP_EINTR until the connection is set to non-flushing mode again. - #GST_RTSP_OK. @@ -261,7 +247,6 @@ is set to non-flushing mode again. Close and free @conn. - #GST_RTSP_OK on success. @@ -275,7 +260,6 @@ is set to non-flushing mode again. Retrieve the IP address of the other end of @conn. - The IP address as a string. this value remains valid until the connection is closed. @@ -290,7 +274,6 @@ connection is closed. Get the file descriptor for reading. - the file descriptor used for reading or %NULL on error. The file descriptor remains valid until the connection is closed. @@ -304,7 +287,6 @@ error. The file descriptor remains valid until the connection is closed. - %TRUE if the #GstRTSPConnection remembers the session id in the last response to set it on any further request. @@ -326,7 +308,6 @@ over TLS. For server side connections, this function will create a GTlsServerConnection when called the first time and will return that same connection on subsequent calls. The server is then responsible for configuring the TLS connection. - the TLS connection for @conn. @@ -342,7 +323,6 @@ calls. The server is then responsible for configuring the TLS connection. Gets the anchor certificate authorities database that will be used after a server certificate can't be verified with the default certificate database. - the anchor certificate authorities database, or NULL if no database has been previously set. Use g_object_unref() to release the @@ -360,7 +340,6 @@ certificate database. Gets a #GTlsInteraction object to be used when the connection or certificate database need to interact with the user. This will be used to prompt the user for passwords where necessary. - a reference on the #GTlsInteraction. Use g_object_unref() to release. @@ -376,7 +355,6 @@ g_object_unref() to release. Gets the TLS validation flags used to verify the peer certificate when a TLS connection is established. - the validationg flags. @@ -390,7 +368,6 @@ when a TLS connection is established. Get the tunnel session id the connection. - returns a non-empty string if @conn is being tunneled over HTTP. @@ -404,7 +381,6 @@ when a TLS connection is established. Retrieve the URL of the other end of @conn. - The URL. This value remains valid until the connection is freed. @@ -419,7 +395,6 @@ connection is freed. Get the file descriptor for writing. - the file descriptor used for writing or NULL on error. The file descriptor remains valid until the connection is closed. @@ -434,7 +409,6 @@ error. The file descriptor remains valid until the connection is closed. Get the tunneling state of the connection. - if @conn is using HTTP tunneling. @@ -448,7 +422,6 @@ error. The file descriptor remains valid until the connection is closed. Calculate the next timeout for @conn, storing the result in @timeout. - #GST_RTSP_OK. @@ -466,7 +439,6 @@ error. The file descriptor remains valid until the connection is closed. Calculate the next timeout for @conn - #the next timeout in microseconds @@ -487,7 +459,6 @@ with #GST_RTSP_OK, @revents will contain a bitmask of available operations on @timeout can be %NULL, in which case this function might block forever. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK on success. @@ -520,7 +491,6 @@ with #GST_RTSP_OK, @revents will contain a bitmask of available operations on @timeout can be 0, in which case this function might block forever. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK on success. @@ -550,7 +520,6 @@ the specified @timeout. @timeout can be %NULL, in which case this function might block forever. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK on success. @@ -580,7 +549,6 @@ the specified @timeout. @timeout can be 0, in which case this function might block forever. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK on success. @@ -610,7 +578,6 @@ the specified @timeout. @timeout can be %NULL, in which case this function might block forever. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK on success. @@ -636,7 +603,6 @@ the specified @timeout. @timeout can be 0, in which case this function might block forever. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK on success. @@ -658,7 +624,6 @@ This function can be cancelled with gst_rtsp_connection_flush(). Reset the timeout of @conn. - #GST_RTSP_OK. @@ -676,7 +641,6 @@ the specified @timeout. @timeout can be %NULL, in which case this function might block forever. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK on success. @@ -702,7 +666,6 @@ the specified @timeout. @timeout can be %NULL, in which case this function might block forever. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK on success. @@ -734,7 +697,6 @@ the specified @timeout. @timeout can be 0, in which case this function might block forever. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK on Since. @@ -766,7 +728,6 @@ the specified @timeout. @timeout can be 0, in which case this function might block forever. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK on success. @@ -793,7 +754,6 @@ signal and be performed after the default checks of #GstRTSPConnection (checking against the #GTlsDatabase with the given #GTlsCertificateFlags) have failed. If no #GTlsDatabase is set on this connection, only @func will be called. - @@ -819,7 +779,6 @@ be called. Configure @conn for authentication mode @method with @user and @pass as the user and password respectively. - #GST_RTSP_OK. @@ -849,7 +808,6 @@ methods #GST_RTSP_AUTH_NONE and #GST_RTSP_AUTH_BASIC. For #GST_RTSP_AUTH_DIGEST, directives should be taken from the digest challenge in the WWW-Authenticate response header and can include realm, domain, nonce, opaque, stale, algorithm, qop as per RFC2617. - @@ -872,7 +830,6 @@ nonce, opaque, stale, algorithm, qop as per RFC2617. Configure @conn to use the specified Content-Length limit. Both requests and responses are validated. If content-length is exceeded, ENOMEM error will be returned. - @@ -891,7 +848,6 @@ exceeded, ENOMEM error will be returned. By setting the HTTP mode to %TRUE the message parsing will support HTTP messages in addition to the RTSP messages. It will also disable the automatic handling of setting up an HTTP tunnel. - @@ -908,7 +864,6 @@ automatic handling of setting up an HTTP tunnel. Set the IP address of the server. - @@ -925,7 +880,6 @@ automatic handling of setting up an HTTP tunnel. Set the proxy host and port. - #GST_RTSP_OK. @@ -947,7 +901,6 @@ automatic handling of setting up an HTTP tunnel. Configure @conn to use the specified DSCP value. - #GST_RTSP_OK on success. @@ -968,7 +921,6 @@ automatic handling of setting up an HTTP tunnel. response received and force it onto any further requests. The default value is %TRUE - @@ -987,7 +939,6 @@ The default value is %TRUE Sets the anchor certificate authorities database. This certificate database will be used to verify the server's certificate in case it can't be verified with the default certificate database first. - @@ -1006,7 +957,6 @@ can't be verified with the default certificate database first. Sets a #GTlsInteraction object to be used when the connection or certificate database need to interact with the user. This will be used to prompt the user for passwords where necessary. - @@ -1024,7 +974,6 @@ user for passwords where necessary. Sets the TLS validation flags to be used to verify the peer certificate when a TLS connection is established. - TRUE if the validation flags are set correctly, or FALSE if @conn is NULL or is not a TLS connection. @@ -1044,7 +993,6 @@ certificate when a TLS connection is established. Set the HTTP tunneling state of the connection. This must be configured before the @conn is connected. - @@ -1065,7 +1013,6 @@ the specified @timeout. @timeout can be %NULL, in which case this function might block forever. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK on success. @@ -1095,7 +1042,6 @@ the specified @timeout. @timeout can be 0, in which case this function might block forever. This function can be cancelled with gst_rtsp_connection_flush(). - #GST_RTSP_OK on success. @@ -1122,7 +1068,6 @@ This function can be cancelled with gst_rtsp_connection_flush(). Accept a new connection on @socket and create a new #GstRTSPConnection for handling communication on new socket. - #GST_RTSP_OK when @conn contains a valid connection. @@ -1148,7 +1093,6 @@ The connection will not yet attempt to connect to @url, use gst_rtsp_connection_connect(). A copy of @url will be made. - #GST_RTSP_OK when @conn contains a valid connection. @@ -1168,7 +1112,6 @@ A copy of @url will be made. Create a new #GstRTSPConnection for handling communication on the existing socket @socket. The @initial_buffer contains zero terminated data already read from @socket which should be used before starting to read new data. - #GST_RTSP_OK when @conn contains a valid connection. @@ -1198,7 +1141,6 @@ read from @socket which should be used before starting to read new data. - @@ -1229,9 +1171,7 @@ read from @socket which should be used before starting to read new data. This interface is implemented e.g. by the Windows Media Streaming RTSP exentension (rtspwms) and the RealMedia RTSP extension (rtspreal). - - @@ -1248,7 +1188,6 @@ read from @socket which should be used before starting to read new data. - @@ -1262,7 +1201,6 @@ read from @socket which should be used before starting to read new data. - @@ -1276,7 +1214,6 @@ read from @socket which should be used before starting to read new data. - @@ -1290,7 +1227,6 @@ read from @socket which should be used before starting to read new data. - @@ -1307,7 +1243,6 @@ read from @socket which should be used before starting to read new data. - @@ -1324,7 +1259,6 @@ read from @socket which should be used before starting to read new data. - @@ -1338,7 +1272,6 @@ read from @socket which should be used before starting to read new data. - @@ -1355,7 +1288,6 @@ read from @socket which should be used before starting to read new data. - @@ -1369,7 +1301,6 @@ read from @socket which should be used before starting to read new data. - @@ -1383,7 +1314,6 @@ read from @socket which should be used before starting to read new data. - @@ -1400,7 +1330,6 @@ read from @socket which should be used before starting to read new data. - @@ -1414,7 +1343,6 @@ read from @socket which should be used before starting to read new data. - @@ -1428,7 +1356,6 @@ read from @socket which should be used before starting to read new data. - @@ -1442,7 +1369,6 @@ read from @socket which should be used before starting to read new data. - @@ -1459,7 +1385,6 @@ read from @socket which should be used before starting to read new data. - @@ -1476,7 +1401,6 @@ read from @socket which should be used before starting to read new data. - @@ -1490,7 +1414,6 @@ read from @socket which should be used before starting to read new data. - @@ -1507,7 +1430,6 @@ read from @socket which should be used before starting to read new data. - @@ -1521,7 +1443,6 @@ read from @socket which should be used before starting to read new data. - @@ -1550,13 +1471,11 @@ read from @socket which should be used before starting to read new data. An interface representing RTSP extensions. - - @@ -1572,7 +1491,6 @@ read from @socket which should be used before starting to read new data. - @@ -1588,7 +1506,6 @@ read from @socket which should be used before starting to read new data. - @@ -1607,7 +1524,6 @@ read from @socket which should be used before starting to read new data. - @@ -1626,7 +1542,6 @@ read from @socket which should be used before starting to read new data. - @@ -1642,7 +1557,6 @@ read from @socket which should be used before starting to read new data. - @@ -1658,7 +1572,6 @@ read from @socket which should be used before starting to read new data. - @@ -1677,7 +1590,6 @@ read from @socket which should be used before starting to read new data. - @@ -1693,7 +1605,6 @@ read from @socket which should be used before starting to read new data. - @@ -1712,7 +1623,6 @@ read from @socket which should be used before starting to read new data. - @@ -1950,15 +1860,12 @@ read from @socket which should be used before starting to read new data. Provides methods for creating and parsing request, response and data messages. - the message type - - @@ -1970,7 +1877,6 @@ read from @socket which should be used before starting to read new data. - @@ -1982,7 +1888,6 @@ read from @socket which should be used before starting to read new data. - @@ -2010,7 +1915,6 @@ read from @socket which should be used before starting to read new data. Add a header with key @field and @value to @msg. This function takes a copy of @value. - a #GstRTSPResult. @@ -2033,7 +1937,6 @@ of @value. Add a header with key @header and @value to @msg. This function takes a copy of @value. - a #GstRTSPResult. @@ -2056,7 +1959,6 @@ of @value. Append the currently configured headers in @msg to the #GString @str suitable for transmission. - #GST_RTSP_OK. @@ -2075,7 +1977,6 @@ for transmission. Allocate a new copy of @msg and store the result in @copy. The value in @copy should be release with gst_rtsp_message_free function. - a #GstRTSPResult @@ -2093,7 +1994,6 @@ for transmission. Dump the contents of @msg to stdout. - #GST_RTSP_OK. @@ -2107,7 +2007,6 @@ for transmission. Free the memory used by @msg. - a #GstRTSPResult. @@ -2126,7 +2025,6 @@ unchanged. If the message body was set as a #GstBuffer before this will cause the data to be copied and stored in the message. The #GstBuffer will no longer be kept in the message. - #GST_RTSP_OK. @@ -2155,7 +2053,6 @@ unchanged. If body data was set from raw memory instead of a #GstBuffer this function will always return %NULL. The caller can check if there is a body buffer by calling gst_rtsp_message_has_body_buffer(). - #GST_RTSP_OK. @@ -2174,7 +2071,6 @@ calling gst_rtsp_message_has_body_buffer(). Get the @indx header value with key @field from @msg. The result in @value stays valid as long as it remains present in @msg. - #GST_RTSP_OK when @field was found, #GST_RTSP_ENOTIMPL if the key was not found. @@ -2202,7 +2098,6 @@ was not found. Get the @index header value with key @header from @msg. The result in @value stays valid as long as it remains present in @msg. - #GST_RTSP_OK when @field was found, #GST_RTSP_ENOTIMPL if the key was not found. @@ -2229,7 +2124,6 @@ was not found. Get the message type of @msg. - the message type. @@ -2243,7 +2137,6 @@ was not found. Checks if @msg has a body and the body is stored as #GstBuffer. - %TRUE if @msg has a body and it's stored as #GstBuffer, %FALSE otherwise. @@ -2259,7 +2152,6 @@ otherwise. Initialize @msg. This function is mostly used when @msg is allocated on the stack. The reverse operation of this is gst_rtsp_message_unset(). - a #GstRTSPResult. @@ -2273,7 +2165,6 @@ stack. The reverse operation of this is gst_rtsp_message_unset(). Initialize a new data #GstRTSPMessage for @channel. - a #GstRTSPResult. @@ -2292,7 +2183,6 @@ stack. The reverse operation of this is gst_rtsp_message_unset(). Initialize @msg as a request message with @method and @uri. To clear @msg again, use gst_rtsp_message_unset(). - a #GstRTSPResult. @@ -2319,7 +2209,6 @@ When @reason is %NULL, the default reason for @code will be used. When @request is not %NULL, the relevant headers will be copied to the new response message. - a #GstRTSPResult. @@ -2345,7 +2234,6 @@ response message. Parses the credentials given in a WWW-Authenticate or Authorization header. - %NULL-terminated array of GstRTSPAuthCredential or %NULL. @@ -2366,7 +2254,6 @@ response message. Parse the data message @msg and store the channel in @channel. - a #GstRTSPResult. @@ -2388,7 +2275,6 @@ response message. value. @uri remains valid for as long as @msg is valid and unchanged. - a #GstRTSPResult. @@ -2418,7 +2304,6 @@ value. value. @reason remains valid for as long as @msg is valid and unchanged. - a #GstRTSPResult. @@ -2445,7 +2330,6 @@ value. Remove the @indx header with key @field from @msg. If @indx equals -1, all headers will be removed. - a #GstRTSPResult. @@ -2468,7 +2352,6 @@ headers will be removed. Remove the @index header with key @header from @msg. If @index equals -1, all matching headers will be removed. - a #GstRTSPResult @@ -2491,7 +2374,6 @@ all matching headers will be removed. Set the body of @msg to a copy of @data. Any existing body or body buffer will be replaced by the new body. - #GST_RTSP_OK. @@ -2516,7 +2398,6 @@ will be replaced by the new body. Set the body of @msg to @buffer. Any existing body or body buffer will be replaced by the new body. - #GST_RTSP_OK. @@ -2535,7 +2416,6 @@ will be replaced by the new body. Take the body of @msg and store it in @data and @size. After this method, the body and size of @msg will be set to %NULL and 0 respectively. - #GST_RTSP_OK. @@ -2564,7 +2444,6 @@ the body and size of @msg will be set to %NULL and 0 respectively. If body data was set from raw memory instead of a #GstBuffer this function will always return %NULL. The caller can check if there is a body buffer by calling gst_rtsp_message_has_body_buffer(). - #GST_RTSP_OK. @@ -2583,7 +2462,6 @@ calling gst_rtsp_message_has_body_buffer(). Set the body of @msg to @data and @size. This method takes ownership of @data. Any existing body or body buffer will be replaced by the new body. - #GST_RTSP_OK. @@ -2608,7 +2486,6 @@ calling gst_rtsp_message_has_body_buffer(). Set the body of @msg to @buffer. This method takes ownership of @buffer. Any existing body or body buffer will be replaced by the new body. - #GST_RTSP_OK. @@ -2627,7 +2504,6 @@ Any existing body or body buffer will be replaced by the new body. Add a header with key @field and @value to @msg. This function takes ownership of @value. - a #GstRTSPResult. @@ -2650,7 +2526,6 @@ ownership of @value. Add a header with key @header and @value to @msg. This function takes ownership of @value, but not of @header. - a #GstRTSPResult. @@ -2675,7 +2550,6 @@ ownership of @value, but not of @header. #GstRTSPMessage again. This function is mostly used in combination with gst_rtsp_message_init_request(), gst_rtsp_message_init_response() and gst_rtsp_message_init_data() on stack allocated #GstRTSPMessage structures. - #GST_RTSP_OK. @@ -2734,7 +2608,6 @@ gst_rtsp_message_init_data() on stack allocated #GstRTSPMessage structures. Convert @method to a string. - a string representation of @method. @@ -2788,7 +2661,6 @@ gst_rtsp_message_init_data() on stack allocated #GstRTSPMessage structures. Provides helper functions to deal with time ranges. - minimum value of the range @@ -2801,7 +2673,6 @@ gst_rtsp_message_init_data() on stack allocated #GstRTSPMessage structures.Converts the range in-place between different types of units. Ranges containing the special value #GST_RTSP_TIME_NOW can not be converted as these are only valid for #GST_RTSP_RANGE_NPT. - %TRUE if the range could be converted @@ -2819,7 +2690,6 @@ converted as these are only valid for #GST_RTSP_RANGE_NPT. Free the memory allocated by @range. - @@ -2838,7 +2708,6 @@ A value of %GST_CLOCK_TIME_NONE will be used to signal #GST_RTSP_TIME_NOW and #GST_RTSP_TIME_END for @min and @max respectively. UTC times will be converted to nanoseconds since 1900. - %TRUE on success. @@ -2860,7 +2729,6 @@ UTC times will be converted to nanoseconds since 1900. Parse @rangestr to a #GstRTSPTimeRange. - #GST_RTSP_OK on success. @@ -2878,7 +2746,6 @@ UTC times will be converted to nanoseconds since 1900. Convert @range into a string representation. - The string representation of @range. g_free() after usage. @@ -3084,7 +2951,6 @@ UTC times will be converted to nanoseconds since 1900. A time indication. - the time of the time @@ -3097,7 +2963,6 @@ UTC times will be converted to nanoseconds since 1900. Extra fields for a time indication. - frames and subframes when type in GstRTSPTime is GST_RTSP_TIME_FRAMES @@ -3118,7 +2983,6 @@ UTC times will be converted to nanoseconds since 1900. A time range. - the time units used @@ -3172,7 +3036,6 @@ UTC times will be converted to nanoseconds since 1900. Provides helper functions to deal with RTSP transport strings. - the transport mode @@ -3245,7 +3108,6 @@ UTC times will be converted to nanoseconds since 1900. Convert @transport into a string that can be used to signal the transport in an RTSP SETUP response. - a string describing the RTSP transport or %NULL when the transport is invalid. @@ -3260,7 +3122,6 @@ is invalid. Free the memory used by @transport. - #GST_RTSP_OK. @@ -3275,7 +3136,6 @@ is invalid. Get the media type of @transport. This media type is typically used to generate #GstCaps events. - #GST_RTSP_OK. @@ -3293,7 +3153,6 @@ used to generate #GstCaps events. Initialize @transport so that it can be used. - #GST_RTSP_OK. @@ -3313,7 +3172,6 @@ selected one. @manager will contain an element name or %NULL when no manager is needed/available for @trans. - #GST_RTSP_OK. @@ -3339,7 +3197,6 @@ used to generate #GstCaps events. This functions only deals with the GstRTSPTransMode and only returns the mime type for #GST_RTSP_PROFILE_AVP. Use gst_rtsp_transport_get_media_type() instead. - #GST_RTSP_OK. @@ -3358,7 +3215,6 @@ used to generate #GstCaps events. Allocate a new initialized #GstRTSPTransport. Use gst_rtsp_transport_free() after usage. - a #GstRTSPResult. @@ -3372,7 +3228,6 @@ after usage. Parse the RTSP transport string @str into @transport. - a #GstRTSPResult. @@ -3391,7 +3246,6 @@ after usage. Provides helper functions to handle RTSP urls. - the transports allowed @@ -3426,7 +3280,6 @@ after usage. Make a copy of @url. - a copy of @url. Free with gst_rtsp_url_free () after usage. @@ -3450,7 +3303,6 @@ unescaped to NUL, as that would prematurely terminate the string. Also note that since paths usually start with a slash, the first component will usually be the empty string. - %NULL-terminated array of URL components. Free with g_strfreev() when no longer needed. @@ -3467,7 +3319,6 @@ g_strfreev() when no longer needed. Free the memory used by @url. - @@ -3480,7 +3331,6 @@ g_strfreev() when no longer needed. Get the port number of @url. - #GST_RTSP_OK. @@ -3498,7 +3348,6 @@ g_strfreev() when no longer needed. Get a newly allocated string describing the request URI for @url. - a string with the request URI. g_free() after usage. @@ -3513,7 +3362,6 @@ g_strfreev() when no longer needed. Get a newly allocated string describing the request URI for @url combined with the control path for @control_path - a string with the request URI combined with the control path. g_free() after usage. @@ -3532,7 +3380,6 @@ g_free() after usage. Set the port number in @url to @port. - #GST_RTSP_OK. @@ -3551,7 +3398,6 @@ g_free() after usage. Parse the RTSP @urlstr into a newly allocated #GstRTSPUrl. Free after usage with gst_rtsp_url_free(). - a #GstRTSPResult. @@ -3584,7 +3430,6 @@ with gst_rtsp_url_free(). Convert @version to a string. - a string representation of @version. @@ -3600,10 +3445,8 @@ with gst_rtsp_url_free(). Opaque RTSP watch object that can be used for asynchronous RTSP operations. - Adds a #GstRTSPWatch to a context so that it will be executed within that context. - the ID (greater than 0) for the watch within the GMainContext. @@ -3622,7 +3465,6 @@ operations. Get the maximum amount of bytes and messages that will be queued in @watch. See gst_rtsp_watch_set_send_backlog(). - @@ -3644,7 +3486,6 @@ See gst_rtsp_watch_set_send_backlog(). Reset @watch, this is usually called after gst_rtsp_connection_do_tunnel() when the file descriptors of the connection might have changed. - @@ -3662,7 +3503,6 @@ immediately, it will be queued for transmission in @watch. The contents of @watch becomes writable. In case the @message is queued, the ID returned in @id will be non-zero and used as the ID argument in the message_sent callback. - #GST_RTSP_OK on success. @@ -3690,7 +3530,6 @@ immediately, they will be queued for transmission in @watch. The contents of @id will be non-zero and used as the ID argument in the message_sent callback once the last message is sent. The callback will only be called once for the last message. - #GST_RTSP_OK on success. @@ -3720,7 +3559,6 @@ once for the last message. When @flushing is %TRUE, abort a call to gst_rtsp_watch_wait_backlog() and make sure gst_rtsp_watch_write_data() returns immediately with #GST_RTSP_EINTR. And empty the queue. - @@ -3741,7 +3579,6 @@ When the maximum amounts are exceeded, gst_rtsp_watch_write_data() and gst_rtsp_watch_send_message() will return #GST_RTSP_ENOMEM. A value of 0 for @bytes or @messages means no limits. - @@ -3763,7 +3600,6 @@ A value of 0 for @bytes or @messages means no limits. Decreases the reference count of @watch by one. If the resulting reference count is zero the watch and associated memory will be destroyed. - @@ -3785,7 +3621,6 @@ after the timeout expired. The typically use of this function is when gst_rtsp_watch_write_data returns %GST_RTSP_ENOMEM. The caller then calls this function to wait for free space in the backlog queue and try again. - %GST_RTSP_OK when if there is room in queue. %GST_RTSP_ETIMEOUT when @timeout was reached. @@ -3815,7 +3650,6 @@ after the timeout expired. The typically use of this function is when gst_rtsp_watch_write_data returns %GST_RTSP_ENOMEM. The caller then calls this function to wait for free space in the backlog queue and try again. - %GST_RTSP_OK when if there is room in queue. %GST_RTSP_ETIMEOUT when @timeout was reached. @@ -3847,7 +3681,6 @@ This function will take ownership of @data and g_free() it after use. If the amount of queued data exceeds the limits set with gst_rtsp_watch_set_send_backlog(), this function will return #GST_RTSP_ENOMEM. - #GST_RTSP_OK on success. #GST_RTSP_ENOMEM when the backlog limits are reached. #GST_RTSP_EINTR when @watch was flushing. @@ -3882,7 +3715,6 @@ The new watch is usually created so that it can be attached to a maincontext with gst_rtsp_watch_attach(). @conn must exist for the entire lifetime of the watch. - a #GstRTSPWatch that can be used for asynchronous RTSP communication. Free with gst_rtsp_watch_unref () after usage. @@ -3910,10 +3742,8 @@ communication. Free with gst_rtsp_watch_unref () after usage. Callback functions from a #GstRTSPWatch. - - @@ -3932,7 +3762,6 @@ communication. Free with gst_rtsp_watch_unref () after usage. - @@ -3951,7 +3780,6 @@ communication. Free with gst_rtsp_watch_unref () after usage. - @@ -3967,7 +3795,6 @@ communication. Free with gst_rtsp_watch_unref () after usage. - @@ -3986,7 +3813,6 @@ communication. Free with gst_rtsp_watch_unref () after usage. - @@ -4002,7 +3828,6 @@ communication. Free with gst_rtsp_watch_unref () after usage. - @@ -4018,7 +3843,6 @@ communication. Free with gst_rtsp_watch_unref () after usage. - @@ -4043,7 +3867,6 @@ communication. Free with gst_rtsp_watch_unref () after usage. - @@ -4059,7 +3882,6 @@ communication. Free with gst_rtsp_watch_unref () after usage. - @@ -4088,7 +3910,6 @@ communication. Free with gst_rtsp_watch_unref () after usage. Macro that checks the return value of @stmt and jumps to @label when it does not equal #GST_RTSP_OK. - a statement @@ -4100,39 +3921,33 @@ not equal #GST_RTSP_OK. The default RTSP port to connect to. - - - - - - @@ -4144,7 +3959,6 @@ not equal #GST_RTSP_OK. Free a %NULL-terminated array of credentials returned from gst_rtsp_message_parse_auth_credentials(). - @@ -4158,7 +3972,6 @@ gst_rtsp_message_parse_auth_credentials(). Accept a new connection on @socket and create a new #GstRTSPConnection for handling communication on new socket. - #GST_RTSP_OK when @conn contains a valid connection. @@ -4184,7 +3997,6 @@ The connection will not yet attempt to connect to @url, use gst_rtsp_connection_connect(). A copy of @url will be made. - #GST_RTSP_OK when @conn contains a valid connection. @@ -4204,7 +4016,6 @@ A copy of @url will be made. Create a new #GstRTSPConnection for handling communication on the existing socket @socket. The @initial_buffer contains zero terminated data already read from @socket which should be used before starting to read new data. - #GST_RTSP_OK when @conn contains a valid connection. @@ -4234,7 +4045,6 @@ read from @socket which should be used before starting to read new data. Convert @header to a #GstRTSPHeaderField. - a #GstRTSPHeaderField for @header or #GST_RTSP_HDR_INVALID if the header field is unknown. @@ -4249,7 +4059,6 @@ header field is unknown. Convert @method to a #GstRTSPMethod. - a #GstRTSPMethod for @method or #GST_RTSP_INVALID if the method is unknown. @@ -4267,7 +4076,6 @@ method is unknown. the username and password. See RFC2069 for details. Currently only supported algorithm "md5". - Authentication response or %NULL if unsupported @@ -4311,7 +4119,6 @@ This function is useful when the passwords are not stored in clear text, but instead in the same format as the .htdigest file. Currently only supported algorithm "md5". - Authentication response or %NULL if unsupported @@ -4341,7 +4148,6 @@ Currently only supported algorithm "md5". Check whether @field may appear multiple times in a message. - %TRUE if multiple headers are allowed. @@ -4355,7 +4161,6 @@ Currently only supported algorithm "md5". Convert @field to a string. - a string representation of @field. @@ -4369,7 +4174,6 @@ Currently only supported algorithm "md5". Create a new initialized #GstRTSPMessage. Free with gst_rtsp_message_free(). - a #GstRTSPResult. @@ -4384,7 +4188,6 @@ Currently only supported algorithm "md5". Create a new data #GstRTSPMessage with @channel and store the result message in @msg. Free with gst_rtsp_message_free(). - a #GstRTSPResult. @@ -4403,7 +4206,6 @@ result message in @msg. Free with gst_rtsp_message_free(). Create a new #GstRTSPMessage with @method and @uri and store the result request message in @msg. Free with gst_rtsp_message_free(). - a #GstRTSPResult. @@ -4431,7 +4233,6 @@ When @reason is %NULL, the default reason for @code will be used. When @request is not %NULL, the relevant headers will be copied to the new response message. - a #GstRTSPResult. @@ -4457,7 +4258,6 @@ response message. Convert @method to a string. - a string representation of @method. @@ -4471,7 +4271,6 @@ response message. Convert @options to a string. - a new string of @options. g_free() after usage. @@ -4486,7 +4285,6 @@ response message. Convert the comma separated list @options to a #GstRTSPMethod bitwise or of methods. This functions is the reverse of gst_rtsp_options_as_text(). - a #GstRTSPMethod @@ -4502,7 +4300,6 @@ of methods. This functions is the reverse of gst_rtsp_options_as_text(). Converts the range in-place between different types of units. Ranges containing the special value #GST_RTSP_TIME_NOW can not be converted as these are only valid for #GST_RTSP_RANGE_NPT. - %TRUE if the range could be converted @@ -4520,7 +4317,6 @@ converted as these are only valid for #GST_RTSP_RANGE_NPT. Free the memory allocated by @range. - @@ -4539,7 +4335,6 @@ A value of %GST_CLOCK_TIME_NONE will be used to signal #GST_RTSP_TIME_NOW and #GST_RTSP_TIME_END for @min and @max respectively. UTC times will be converted to nanoseconds since 1900. - %TRUE on success. @@ -4561,7 +4356,6 @@ UTC times will be converted to nanoseconds since 1900. Parse @rangestr to a #GstRTSPTimeRange. - #GST_RTSP_OK on success. @@ -4579,7 +4373,6 @@ UTC times will be converted to nanoseconds since 1900. Convert @range into a string representation. - The string representation of @range. g_free() after usage. @@ -4593,7 +4386,6 @@ UTC times will be converted to nanoseconds since 1900. Convert @code to a string. - a string representation of @code. @@ -4607,7 +4399,6 @@ UTC times will be converted to nanoseconds since 1900. Convert @result in a human readable string. - a newly allocated string. g_free() after usage. @@ -4627,7 +4418,6 @@ selected one. @manager will contain an element name or %NULL when no manager is needed/available for @trans. - #GST_RTSP_OK. @@ -4653,7 +4443,6 @@ used to generate #GstCaps events. This functions only deals with the GstRTSPTransMode and only returns the mime type for #GST_RTSP_PROFILE_AVP. Use gst_rtsp_transport_get_media_type() instead. - #GST_RTSP_OK. @@ -4672,7 +4461,6 @@ used to generate #GstCaps events. Allocate a new initialized #GstRTSPTransport. Use gst_rtsp_transport_free() after usage. - a #GstRTSPResult. @@ -4686,7 +4474,6 @@ after usage. Parse the RTSP transport string @str into @transport. - a #GstRTSPResult. @@ -4705,7 +4492,6 @@ after usage. Parse the RTSP @urlstr into a newly allocated #GstRTSPUrl. Free after usage with gst_rtsp_url_free(). - a #GstRTSPResult. @@ -4723,7 +4509,6 @@ with gst_rtsp_url_free(). Convert @version to a string. - a string representation of @version. @@ -4743,7 +4528,6 @@ The new watch is usually created so that it can be attached to a maincontext with gst_rtsp_watch_attach(). @conn must exist for the entire lifetime of the watch. - a #GstRTSPWatch that can be used for asynchronous RTSP communication. Free with gst_rtsp_watch_unref () after usage. diff --git a/gir-files/GstRtspServer-1.0.gir b/gir-files/GstRtspServer-1.0.gir index 228621c2c..55d94d2bb 100644 --- a/gir-files/GstRtspServer-1.0.gir +++ b/gir-files/GstRtspServer-1.0.gir @@ -10,273 +10,234 @@ and/or use gtk-doc annotations. --> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -284,7 +245,6 @@ and/or use gtk-doc annotations. --> An address - the #GstRTSPAddressPool owner of this address @@ -310,7 +270,6 @@ and/or use gtk-doc annotations. --> Make a copy of @addr. - a copy of @addr. @@ -325,7 +284,6 @@ and/or use gtk-doc annotations. --> Free @addr and releasing it back into the pool when owned by a pool. - @@ -339,7 +297,6 @@ pool. Flags used to control allocation of addresses - no flags @@ -361,10 +318,8 @@ pool. An address pool, all member are private - Make a new #GstRTSPAddressPool. - a new #GstRTSPAddressPool @@ -374,7 +329,6 @@ pool. Take an address and ports from @pool. @flags can be used to control the allocation. @n_ports consecutive ports will be allocated of which the first one can be found in @port. - a #GstRTSPAddress that should be freed with gst_rtsp_address_free after use or %NULL when no address could be @@ -407,7 +361,6 @@ When @ttl is 0, @min_address and @max_address should be unicast addresses. to all available IPv4 or IPv6 addresses. When @ttl > 0, @min_address and @max_address should be multicast addresses. - %TRUE if the addresses could be added. @@ -442,7 +395,6 @@ When @ttl > 0, @min_address and @max_address should be multicast addresses. Clear all addresses in @pool. There should be no outstanding allocations. - @@ -455,7 +407,6 @@ allocations. Dump the free and allocated addresses to stdout. - @@ -468,7 +419,6 @@ allocations. Used to know if the pool includes any unicast addresses. - %TRUE if the pool includes any unicast addresses, %FALSE otherwise @@ -487,7 +437,6 @@ ports will be allocated of which the first one can be found in If @ttl is 0, @address should be a unicast address. If @ttl > 0, @address should be a valid multicast address. - #GST_RTSP_ADDRESS_POOL_OK if an address was reserved. The address is returned in @address and should be freed with gst_rtsp_address_free @@ -536,7 +485,6 @@ after use. Opaque Address pool class. - @@ -546,12 +494,9 @@ after use. - - - + Result codes from RTSP address pool functions. - no error @@ -570,10 +515,8 @@ after use. The authentication structure. - Create a new #GstRTSPAuth instance. - a new #GstRTSPAuth @@ -581,7 +524,6 @@ after use. Check if @check is allowed in the current context. - FALSE if check failed. @@ -595,7 +537,6 @@ after use. Construct a Basic authorisation token from @user and @pass. - the base64 encoding of the string @user:@pass. g_free() after usage. @@ -613,7 +554,6 @@ g_free() after usage. - @@ -633,7 +573,6 @@ g_free() after usage. - @@ -647,7 +586,6 @@ g_free() after usage. - @@ -664,7 +602,6 @@ g_free() after usage. - @@ -680,7 +617,6 @@ g_free() after usage. Add a basic token for the default authentication algorithm that enables the client with privileges listed in @token. - @@ -702,7 +638,6 @@ enables the client with privileges listed in @token. Add a digest @user and @pass for the default authentication algorithm that enables the client with privileges listed in @token. - @@ -728,7 +663,6 @@ enables the client with privileges listed in @token. Get the default token for @auth. This token will be used for unauthenticated users. - the #GstRTSPToken of @auth. gst_rtsp_token_unref() after usage. @@ -742,7 +676,6 @@ usage. - the @realm of @auth @@ -755,7 +688,6 @@ usage. Gets the supported authentication methods of @auth. - The supported authentication methods @@ -769,7 +701,6 @@ usage. Get the #GTlsAuthenticationMode. - the #GTlsAuthenticationMode. @@ -783,7 +714,6 @@ usage. Get the #GTlsCertificate used for negotiating TLS @auth. - the #GTlsCertificate of @auth. g_object_unref() after usage. @@ -798,7 +728,6 @@ usage. Get the #GTlsDatabase used for verifying client certificate. - the #GTlsDatabase of @auth. g_object_unref() after usage. @@ -818,7 +747,6 @@ listed in @token for the users it describes. The format of the file is expected to match the format described by <https://en.wikipedia.org/wiki/Digest_access_authentication#The_.htdigest_file>, as output by the `htdigest` command. - %TRUE if the file was successfully parsed, %FALSE otherwise. @@ -839,7 +767,6 @@ as output by the `htdigest` command. Removes @basic authentication token. - @@ -856,7 +783,6 @@ as output by the `htdigest` command. Removes a digest user. - @@ -874,7 +800,6 @@ as output by the `htdigest` command. Set the default #GstRTSPToken to @token in @auth. The default token will be used for unauthenticated users. - @@ -891,7 +816,6 @@ be used for unauthenticated users. Set the @realm of @auth - @@ -906,7 +830,6 @@ be used for unauthenticated users. Sets the supported authentication @methods for @auth. - @@ -925,7 +848,6 @@ be used for unauthenticated users. The #GTlsAuthenticationMode to set on the underlying GTlsServerConnection. When set to another value than %G_TLS_AUTHENTICATION_NONE, #GstRTSPAuth::accept-certificate signal will be emitted and must be handled. - @@ -943,7 +865,6 @@ When set to another value than %G_TLS_AUTHENTICATION_NONE, Set the TLS certificate for the auth. Client connections will only be accepted when TLS is negotiated. - @@ -962,7 +883,6 @@ be accepted when TLS is negotiated. Sets the certificate database that is used to verify peer certificates. If set to %NULL (the default), then peer certificate validation will always set the %G_TLS_CERTIFICATE_UNKNOWN_CA error. - @@ -1016,13 +936,11 @@ no one else overrides it. The authentication class. - - @@ -1038,7 +956,6 @@ no one else overrides it. - @@ -1057,7 +974,6 @@ no one else overrides it. - @@ -1073,7 +989,6 @@ no one else overrides it. - @@ -1099,22 +1014,17 @@ no one else overrides it. - - - + The client object represents the connection and its state with a client. - Create a new #GstRTSPClient instance. - a new #GstRTSPClient - @@ -1143,7 +1053,6 @@ no one else overrides it. - @@ -1157,7 +1066,6 @@ no one else overrides it. - @@ -1171,7 +1079,6 @@ no one else overrides it. - @@ -1188,7 +1095,6 @@ no one else overrides it. - @@ -1199,7 +1105,6 @@ no one else overrides it. - @@ -1219,7 +1124,6 @@ no one else overrides it. - @@ -1236,7 +1140,6 @@ no one else overrides it. - @@ -1250,7 +1153,6 @@ no one else overrides it. - @@ -1264,7 +1166,6 @@ no one else overrides it. - @@ -1278,7 +1179,6 @@ no one else overrides it. - @@ -1292,7 +1192,6 @@ no one else overrides it. - @@ -1312,7 +1211,6 @@ no one else overrides it. - @@ -1326,7 +1224,6 @@ no one else overrides it. - @@ -1340,7 +1237,6 @@ no one else overrides it. - @@ -1354,7 +1250,6 @@ no one else overrides it. - @@ -1368,7 +1263,6 @@ no one else overrides it. - @@ -1382,7 +1276,6 @@ no one else overrides it. - @@ -1396,7 +1289,6 @@ no one else overrides it. - @@ -1410,7 +1302,6 @@ no one else overrides it. - @@ -1424,7 +1315,6 @@ no one else overrides it. - @@ -1438,7 +1328,6 @@ no one else overrides it. - @@ -1452,7 +1341,6 @@ no one else overrides it. - @@ -1466,7 +1354,6 @@ no one else overrides it. - @@ -1480,7 +1367,6 @@ no one else overrides it. - @@ -1494,7 +1380,6 @@ no one else overrides it. - @@ -1508,7 +1393,6 @@ no one else overrides it. - @@ -1522,7 +1406,6 @@ no one else overrides it. - @@ -1536,7 +1419,6 @@ no one else overrides it. - @@ -1550,7 +1432,6 @@ no one else overrides it. - @@ -1564,7 +1445,6 @@ no one else overrides it. - @@ -1581,7 +1461,6 @@ no one else overrides it. - @@ -1595,7 +1474,6 @@ no one else overrides it. - @@ -1609,7 +1487,6 @@ no one else overrides it. - @@ -1623,7 +1500,6 @@ no one else overrides it. - @@ -1646,7 +1522,6 @@ used). This function should be called when the client properties and urls are fully configured and the client is ready to start. - the ID (greater than 0) for the source within the GMainContext. @@ -1664,7 +1539,6 @@ configured and the client is ready to start. Close the connection of @client and remove all media it was managing. - @@ -1677,7 +1551,6 @@ configured and the client is ready to start. Get the #GstRTSPAuth used as the authentication manager of @client. - the #GstRTSPAuth of @client. g_object_unref() after usage. @@ -1692,7 +1565,6 @@ g_object_unref() after usage. Get the #GstRTSPConnection of @client. - the #GstRTSPConnection of @client. The connection object returned remains valid until the client is freed. @@ -1707,7 +1579,6 @@ The connection object returned remains valid until the client is freed. Get the Content-Length limit of @client. - the Content-Length limit. @@ -1721,7 +1592,6 @@ The connection object returned remains valid until the client is freed. Get the #GstRTSPMountPoints object that @client uses to manage its sessions. - a #GstRTSPMountPoints, unref after usage. @@ -1735,7 +1605,6 @@ The connection object returned remains valid until the client is freed. Get the #GstRTSPSessionPool object that @client uses to manage its sessions. - a #GstRTSPSessionPool, unref after usage. @@ -1753,7 +1622,6 @@ gst_rtsp_client_set_send_func() when doing RTSP over TCP: the send function must call gst_rtsp_stream_transport_message_sent () on the appropriate transport when data has been received for streaming to continue. - the #GstRTSPStreamTransport associated with @channel. @@ -1769,7 +1637,6 @@ to continue. Get the #GstRTSPThreadPool used as the thread pool of @client. - the #GstRTSPThreadPool of @client. g_object_unref() after usage. @@ -1784,7 +1651,6 @@ usage. Let the client handle @message. - a #GstRTSPResult. @@ -1803,7 +1669,6 @@ usage. Send a message message to the remote end. @message must be a #GST_RTSP_MESSAGE_REQUEST or a #GST_RTSP_MESSAGE_RESPONSE. - @@ -1838,7 +1703,6 @@ will also be added with an additional ref to the result #GList of this function.. When @func is %NULL, #GST_RTSP_FILTER_REF will be assumed for each session. - a #GList with all sessions for which @func returned #GST_RTSP_FILTER_REF. After usage, each @@ -1864,7 +1728,6 @@ element in the #GList should be unreffed before the list is freed. configure @auth to be used as the authentication manager of @client. - @@ -1882,7 +1745,6 @@ element in the #GList should be unreffed before the list is freed. Set the #GstRTSPConnection of @client. This function takes ownership of @conn. - %TRUE on success. @@ -1903,7 +1765,6 @@ element in the #GList should be unreffed before the list is freed. Define an appropriate request size limit and reject requests exceeding the limit with response status 413 Request Entity Too Large - @@ -1922,7 +1783,6 @@ limit with response status 413 Request Entity Too Large Set @mounts as the mount points for @client which it will use to map urls to media streams. These mount points are usually inherited from the server that created the client but can be overriden later. - @@ -1947,7 +1807,6 @@ was configured with gst_rtsp_client_attach() was called. It is only allowed to set either a `send_func` or a `send_messages_func` but not both at the same time. - @@ -1980,7 +1839,6 @@ was configured with gst_rtsp_client_attach() was called. It is only allowed to set either a `send_func` or a `send_messages_func` but not both at the same time. - @@ -2007,7 +1865,6 @@ but not both at the same time. Set @pool as the sessionpool for @client which it will use to find or allocate sessions. the sessionpool is usually inherited from the server that created the client but can be overridden later. - @@ -2024,7 +1881,6 @@ that created the client but can be overridden later. configure @pool to be used as the thread pool of @client. - @@ -2366,13 +2222,11 @@ that created the client but can be overridden later. The client class structure. - - @@ -2388,7 +2242,6 @@ that created the client but can be overridden later. - @@ -2410,7 +2263,6 @@ that created the client but can be overridden later. - @@ -2429,7 +2281,6 @@ that created the client but can be overridden later. - @@ -2445,7 +2296,6 @@ that created the client but can be overridden later. - @@ -2461,7 +2311,6 @@ that created the client but can be overridden later. - @@ -2477,7 +2326,6 @@ that created the client but can be overridden later. - @@ -2508,7 +2356,6 @@ that created the client but can be overridden later. - @@ -2524,7 +2371,6 @@ that created the client but can be overridden later. - @@ -2537,7 +2383,6 @@ that created the client but can be overridden later. - @@ -2553,7 +2398,6 @@ that created the client but can be overridden later. - @@ -2569,7 +2413,6 @@ that created the client but can be overridden later. - @@ -2585,7 +2428,6 @@ that created the client but can be overridden later. - @@ -2601,7 +2443,6 @@ that created the client but can be overridden later. - @@ -2617,7 +2458,6 @@ that created the client but can be overridden later. - @@ -2633,7 +2473,6 @@ that created the client but can be overridden later. - @@ -2649,7 +2488,6 @@ that created the client but can be overridden later. - @@ -2665,7 +2503,6 @@ that created the client but can be overridden later. - @@ -2681,7 +2518,6 @@ that created the client but can be overridden later. - @@ -2697,7 +2533,6 @@ that created the client but can be overridden later. - @@ -2716,7 +2551,6 @@ that created the client but can be overridden later. - @@ -2735,7 +2569,6 @@ that created the client but can be overridden later. - @@ -2757,7 +2590,6 @@ that created the client but can be overridden later. - @@ -2773,7 +2605,6 @@ that created the client but can be overridden later. - @@ -2789,7 +2620,6 @@ that created the client but can be overridden later. - @@ -2808,7 +2638,6 @@ that created the client but can be overridden later. - @@ -2824,7 +2653,6 @@ that created the client but can be overridden later. - @@ -2840,7 +2668,6 @@ that created the client but can be overridden later. - @@ -2856,7 +2683,6 @@ that created the client but can be overridden later. - @@ -2872,7 +2698,6 @@ that created the client but can be overridden later. - @@ -2888,7 +2713,6 @@ that created the client but can be overridden later. - @@ -2904,7 +2728,6 @@ that created the client but can be overridden later. - @@ -2920,7 +2743,6 @@ that created the client but can be overridden later. - @@ -2936,7 +2758,6 @@ that created the client but can be overridden later. - @@ -2952,7 +2773,6 @@ that created the client but can be overridden later. - @@ -2972,13 +2792,10 @@ that created the client but can be overridden later. - - - + This callback is called when @client wants to send @message. When @close is %TRUE, the connection should be closed when the message has been sent. - %TRUE on success. @@ -3005,7 +2822,6 @@ that created the client but can be overridden later. This callback is called when @client wants to send @messages. When @close is %TRUE, the connection should be closed when the message has been sent. - %TRUE on success. @@ -3045,7 +2861,6 @@ A return value of #GST_RTSP_FILTER_KEEP will leave @sess untouched in A value of #GST_RTSP_FILTER_REF will add @sess to the result #GList of gst_rtsp_client_session_filter(). - a #GstRTSPFilterResult. @@ -3067,7 +2882,6 @@ gst_rtsp_client_session_filter(). Information passed around containing the context of a request. - the server @@ -3136,7 +2950,6 @@ gst_rtsp_client_session_filter(). Pops @ctx off the context stack (verifying that @ctx is on the top of the stack). - @@ -3150,7 +2963,6 @@ is on the top of the stack). Pushes @ctx onto the context stack. The current context can then be received using gst_rtsp_context_get_current(). - @@ -3164,7 +2976,6 @@ context can then be received using gst_rtsp_context_get_current(). Get the current #GstRTSPContext. This object is retrieved from the current thread that is handling the request for a client. - a #GstRTSPContext @@ -3173,7 +2984,6 @@ current thread that is handling the request for a client. Possible return values for gst_rtsp_session_pool_filter(). - Remove session @@ -3187,7 +2997,6 @@ current thread that is handling the request for a client. Function registered with gst_rtsp_stream_transport_set_keepalive() and called when the stream is active. - @@ -3203,7 +3012,6 @@ when the stream is active. #GstRTSPStream objects that can produce data. This object is usually created from a #GstRTSPMediaFactory. - Create a new #GstRTSPMedia instance. @element is the bin element that provides the different streams. The #GstRTSPMedia object contains the @@ -3211,7 +3019,6 @@ element to produce RTP data for one or more related (audio/video/..) streams. Ownership is taken of @element. - a new #GstRTSPMedia object. @@ -3224,7 +3031,6 @@ Ownership is taken of @element. - @@ -3241,7 +3047,6 @@ Ownership is taken of @element. - @@ -3252,7 +3057,6 @@ Ownership is taken of @element. - @@ -3267,7 +3071,6 @@ Ownership is taken of @element. Configure an SDP on @media for receiving streams - TRUE on success. @@ -3284,7 +3087,6 @@ Ownership is taken of @element. - @@ -3298,7 +3100,6 @@ Ownership is taken of @element. - @@ -3318,7 +3119,6 @@ gst_rtsp_media_take_pipeline(). It will preroll the pipeline and collect vital information about the streams such as the duration. - %TRUE on success. @@ -3336,7 +3136,6 @@ such as the duration. - @@ -3347,7 +3146,6 @@ such as the duration. - @@ -3361,7 +3159,6 @@ such as the duration. - @@ -3375,7 +3172,6 @@ such as the duration. - @@ -3389,7 +3185,6 @@ such as the duration. - @@ -3405,7 +3200,6 @@ such as the duration. Add @media specific info to @sdp. @info is used to configure the connection information in the SDP. - TRUE on success. @@ -3431,7 +3225,6 @@ GST_STATE_NULL but all streams are kept. @media can be prepared again with gst_rtsp_media_unsuspend() @media must be prepared with gst_rtsp_media_prepare(); - %TRUE on success. @@ -3444,7 +3237,6 @@ with gst_rtsp_media_unsuspend() - @@ -3461,7 +3253,6 @@ with gst_rtsp_media_unsuspend() Unprepare @media. After this call, the media should be prepared again before it can be used again. If the media is set to be non-reusable, a new instance must be created. - %TRUE on success. @@ -3474,7 +3265,6 @@ must be created. - @@ -3487,7 +3277,6 @@ must be created. Unsuspend @media if it was in a suspended state. This method does nothing when the media was not in the suspended state. - %TRUE on success. @@ -3508,7 +3297,6 @@ the list of dynamic elements. Find all depayloader elements, they should be named depay\%d in the element of @media, and create #GstRTSPStreams for them. - @@ -3522,7 +3310,6 @@ element of @media, and create #GstRTSPStreams for them. Add a receiver and sender parts to the pipeline based on the transport from SETUP. - %TRUE if the media pipeline has been sucessfully updated. @@ -3543,7 +3330,6 @@ SETUP. Create a new stream in @media that provides RTP data on @pad. @pad should be a pad of an element inside @media->element. - a new #GstRTSPStream that remains valid for as long as @media exists. @@ -3566,7 +3352,6 @@ as @media exists. Find a stream in @media with @control as the control uri. - the #GstRTSPStream with control uri @control or %NULL when a stream with that control did @@ -3586,7 +3371,6 @@ not exist. Get the #GstRTSPAddressPool used as the address pool of @media. - the #GstRTSPAddressPool of @media. g_object_unref() after usage. @@ -3603,7 +3387,6 @@ g_object_unref() after usage. Get the base_time that is used by the pipeline in @media. @media must be prepared before this method returns a valid base_time. - the base_time used by @media. @@ -3617,7 +3400,6 @@ g_object_unref() after usage. Get the kernel UDP buffer size. - the kernel UDP buffer size. @@ -3633,7 +3415,6 @@ g_object_unref() after usage. Get the clock that is used by the pipeline in @media. @media must be prepared before this method returns a valid clock object. - the #GstClock used by @media. unref after usage. @@ -3646,7 +3427,6 @@ g_object_unref() after usage. - Whether retransmission requests will be sent @@ -3659,7 +3439,6 @@ g_object_unref() after usage. Get the configured DSCP QoS of attached media. - the DSCP QoS value of attached streams or -1 if disabled. @@ -3673,7 +3452,6 @@ g_object_unref() after usage. Get the element that was used when constructing @media. - a #GstElement. Unref after usage. @@ -3687,7 +3465,6 @@ g_object_unref() after usage. Get the latency that is used for receiving media. - latency in milliseconds @@ -3701,7 +3478,6 @@ g_object_unref() after usage. Get the the maximum time-to-live value of outgoing multicast packets. - the maximum time-to-live value of outgoing multicast packets. @@ -3715,7 +3491,6 @@ g_object_unref() after usage. Get the multicast interface used for @media. - the multicast interface for @media. g_free() after usage. @@ -3730,7 +3505,6 @@ g_free() after usage. Get the permissions object from @media. - a #GstRTSPPermissions object, unref after usage. @@ -3744,7 +3518,6 @@ g_free() after usage. Get the allowed profiles of @media. - a #GstRTSPProfile @@ -3758,7 +3531,6 @@ g_free() after usage. Get the allowed protocols of @media. - a #GstRTSPLowerTrans @@ -3772,7 +3544,6 @@ g_free() after usage. Gets if and how the media clock should be published according to RFC7273. - The GstRTSPPublishClockMode @@ -3787,7 +3558,6 @@ g_free() after usage. Get the current range as a string. @media must be prepared with gst_rtsp_media_prepare (). - The range as a string, g_free() after usage. @@ -3808,7 +3578,6 @@ gst_rtsp_media_prepare (). - whether @media will follow the Rate-Control=no behaviour as specified in the ONVIF replay spec. @@ -3822,7 +3591,6 @@ in the ONVIF replay spec. Get the rate and applied_rate of the current segment. - %FALSE if looking up the rate and applied rate failed. Otherwise %TRUE is returned and @rate and @applied_rate are set to the rate and @@ -3846,7 +3614,6 @@ applied_rate of the current segment. Get the amount of time to store retransmission data. - the amount of time to store retransmission data. @@ -3861,7 +3628,6 @@ applied_rate of the current segment. Get the status of @media. When @media is busy preparing, this function waits until @media is prepared or in error. - the status of @media. @@ -3875,7 +3641,6 @@ until @media is prepared or in error. Retrieve the stream with index @idx from @media. - the #GstRTSPStream at index @idx or %NULL when a stream with that index did not exist. @@ -3894,7 +3659,6 @@ until @media is prepared or in error. Get how @media will be suspended. - #GstRTSPSuspendMode. @@ -3909,7 +3673,6 @@ until @media is prepared or in error. Get the #GstNetTimeProvider for the clock used by @media. The time provider will listen on @address and @port for client time requests. - the #GstNetTimeProvider of @media. @@ -3931,7 +3694,6 @@ will listen on @address and @port for client time requests. Check if the pipeline for @media can be used for PLAY or RECORD methods. - The transport mode. @@ -3945,7 +3707,6 @@ will listen on @address and @port for client time requests. Configure an SDP on @media for receiving streams - TRUE on success. @@ -3963,7 +3724,6 @@ will listen on @address and @port for client time requests. See gst_rtsp_stream_is_complete(), gst_rtsp_stream_is_sender(). - whether @media has at least one complete sender stream. @@ -3976,7 +3736,6 @@ will listen on @address and @port for client time requests. Check if multicast sockets are configured to be bound to multicast addresses. - %TRUE if multicast sockets are configured to be bound to multicast addresses. @@ -3991,7 +3750,6 @@ will listen on @address and @port for client time requests. Check if the pipeline for @media will send an EOS down the pipeline before unpreparing. - %TRUE if the media will send EOS before unpreparing. @@ -4004,7 +3762,6 @@ unpreparing. - %TRUE if @media is receive-only, %FALSE otherwise. @@ -4017,7 +3774,6 @@ unpreparing. Check if the pipeline for @media can be reused after an unprepare. - %TRUE if the media can be reused @@ -4031,7 +3787,6 @@ unpreparing. Check if the pipeline for @media can be shared between multiple clients. - %TRUE if the media can be shared between clients. @@ -4046,7 +3801,6 @@ unpreparing. Check if the pipeline for @media will be stopped when a client disconnects without sending TEARDOWN. - %TRUE if the media will be stopped when a client disconnects without sending TEARDOWN. @@ -4063,7 +3817,6 @@ without sending TEARDOWN. Check if @media can provide a #GstNetTimeProvider for its pipeline clock. Use gst_rtsp_media_get_time_provider() to get the network clock. - %TRUE if @media can provide a #GstNetTimeProvider. @@ -4085,7 +3838,6 @@ such as DESCRIBE, SETUP, ANNOUNCE, TEARDOWN, PLAY, PAUSE. As best practice take the lock as soon as the function get hold of a shared media object. Release the lock right before the function returns. - @@ -4098,7 +3850,6 @@ media object. Release the lock right before the function returns. Get the number of streams in this media. - The number of streams. @@ -4117,7 +3868,6 @@ gst_rtsp_media_take_pipeline(). It will preroll the pipeline and collect vital information about the streams such as the duration. - %TRUE on success. @@ -4137,7 +3887,6 @@ such as the duration. Seek the pipeline of @media to @range. @media must be prepared with gst_rtsp_media_prepare(). - %TRUE on success. @@ -4156,7 +3905,6 @@ gst_rtsp_media_prepare(). Seek the pipeline of @media to @range with the given @flags. @media must be prepared with gst_rtsp_media_prepare(). - %TRUE on success. @@ -4182,7 +3930,6 @@ and @trickmode_interval. @media must be prepared with gst_rtsp_media_prepare(). In order to perform the seek operation, the pipeline must contain all needed transport parts (transport sinks). - %TRUE on success. @@ -4213,7 +3960,6 @@ needed transport parts (transport sinks). Check if the pipeline for @media seek and up to what point in time, it can seek. - -1 if the stream is not seekable, 0 if seekable only to the beginning and > 0 to indicate the longest duration between any two random access points. @@ -4229,7 +3975,6 @@ and > 0 to indicate the longest duration between any two random access points configure @pool to be used as the address pool of @media. - @@ -4247,7 +3992,6 @@ and > 0 to indicate the longest duration between any two random access points Decide whether the multicast socket should be bound to a multicast address or INADDR_ANY. - @@ -4264,7 +4008,6 @@ INADDR_ANY. Set the kernel UDP buffer size. - @@ -4281,7 +4024,6 @@ INADDR_ANY. Configure the clock used for the media. - @@ -4298,7 +4040,6 @@ INADDR_ANY. Set whether retransmission requests will be sent - @@ -4313,7 +4054,6 @@ INADDR_ANY. Configure the dscp qos of attached streams to @dscp_qos. - @@ -4331,7 +4071,6 @@ INADDR_ANY. Set or unset if an EOS event will be sent to the pipeline for @media before it is unprepared. - @@ -4348,7 +4087,6 @@ it is unprepared. Configure the latency used for receiving media. - @@ -4365,7 +4103,6 @@ it is unprepared. Set the maximum time-to-live value of outgoing multicast packets. - %TRUE if the requested ttl has been set successfully. @@ -4383,7 +4120,6 @@ it is unprepared. configure @multicast_iface to be used for @media. - @@ -4400,7 +4136,6 @@ it is unprepared. Set @permissions on @media. - @@ -4417,7 +4152,6 @@ it is unprepared. Set the state of the pipeline managed by @media to @state - @@ -4434,7 +4168,6 @@ it is unprepared. Configure the allowed lower transport for @media. - @@ -4451,7 +4184,6 @@ it is unprepared. Configure the allowed lower transport for @media. - @@ -4468,7 +4200,6 @@ it is unprepared. Sets if and how the media clock should be published according to RFC7273. - @@ -4486,7 +4217,6 @@ it is unprepared. Define whether @media will follow the Rate-Control=no behaviour as specified in the ONVIF replay spec. - @@ -4501,7 +4231,6 @@ in the ONVIF replay spec. Set the amount of time to store retransmission packets. - @@ -4519,7 +4248,6 @@ in the ONVIF replay spec. Set or unset if the pipeline for @media can be reused after the pipeline has been unprepared. - @@ -4538,7 +4266,6 @@ been unprepared. Set or unset if the pipeline for @media can be shared will multiple clients. When @shared is %TRUE, client requests for this media will share the media pipeline. - @@ -4557,7 +4284,6 @@ pipeline. Set the state of @media to @state and for the transports in @transports. @media must be prepared with gst_rtsp_media_prepare(); - %TRUE on success. @@ -4583,7 +4309,6 @@ a #GPtrArray of #GstRTSPStreamTransport pointers Set or unset if the pipeline for @media should be stopped when a client disconnects without sending TEARDOWN. - @@ -4603,7 +4328,6 @@ client disconnects without sending TEARDOWN. after a PAUSE request has been performed. Media must be unprepared when setting the suspend mode. - @@ -4620,7 +4344,6 @@ Media must be unprepared when setting the suspend mode. Sets if the media pipeline can work in PLAY or RECORD mode - @@ -4638,7 +4361,6 @@ Media must be unprepared when setting the suspend mode. Add @media specific info to @sdp. @info is used to configure the connection information in the SDP. - TRUE on success. @@ -4664,7 +4386,6 @@ GST_STATE_NULL but all streams are kept. @media can be prepared again with gst_rtsp_media_unsuspend() @media must be prepared with gst_rtsp_media_prepare(); - %TRUE on success. @@ -4679,7 +4400,6 @@ with gst_rtsp_media_unsuspend() Set @pipeline as the #GstPipeline for @media. Ownership is taken of @pipeline. - @@ -4696,7 +4416,6 @@ taken of @pipeline. Unlock the media. - @@ -4711,7 +4430,6 @@ taken of @pipeline. Unprepare @media. After this call, the media should be prepared again before it can be used again. If the media is set to be non-reusable, a new instance must be created. - %TRUE on success. @@ -4726,7 +4444,6 @@ must be created. Unsuspend @media if it was in a suspended state. This method does nothing when the media was not in the suspended state. - %TRUE on success. @@ -4740,7 +4457,6 @@ when the media was not in the suspended state. Set @media to provide a #GstNetTimeProvider. - @@ -4867,13 +4583,11 @@ when the media was not in the suspended state. The RTSP media class - - @@ -4889,7 +4603,6 @@ when the media was not in the suspended state. - %TRUE on success. @@ -4909,7 +4622,6 @@ when the media was not in the suspended state. - %TRUE on success. @@ -4924,7 +4636,6 @@ when the media was not in the suspended state. - %TRUE on success. @@ -4939,7 +4650,6 @@ when the media was not in the suspended state. - %TRUE on success. @@ -4954,7 +4664,6 @@ when the media was not in the suspended state. - @@ -4973,7 +4682,6 @@ when the media was not in the suspended state. - @@ -4989,7 +4697,6 @@ when the media was not in the suspended state. - @@ -5005,7 +4712,6 @@ when the media was not in the suspended state. - @@ -5018,7 +4724,6 @@ when the media was not in the suspended state. - @@ -5034,7 +4739,6 @@ when the media was not in the suspended state. - TRUE on success. @@ -5057,7 +4761,6 @@ when the media was not in the suspended state. - @@ -5073,7 +4776,6 @@ when the media was not in the suspended state. - @@ -5089,7 +4791,6 @@ when the media was not in the suspended state. - @@ -5102,7 +4803,6 @@ when the media was not in the suspended state. - @@ -5115,7 +4815,6 @@ when the media was not in the suspended state. - @@ -5131,7 +4830,6 @@ when the media was not in the suspended state. - @@ -5147,7 +4845,6 @@ when the media was not in the suspended state. - TRUE on success. @@ -5173,17 +4870,14 @@ when the media was not in the suspended state. The definition and logic for constructing the pipeline for a media. The media can contain multiple streams like audio and video. - Create a new #GstRTSPMediaFactory instance. - a new #GstRTSPMediaFactory object. - @@ -5206,7 +4900,6 @@ with gst_rtsp_media_create_stream (). After the media is constructed, it can be configured and then prepared with gst_rtsp_media_prepare (). - a new #GstRTSPMedia if the media could be prepared. @@ -5229,7 +4922,6 @@ the elements to use for streaming the media. The bin should contain payloaders pay\%d for each stream. The default implementation of this function returns the bin created from the launch parameter. - a new #GstElement. @@ -5246,7 +4938,6 @@ launch parameter. - @@ -5260,7 +4951,6 @@ launch parameter. - @@ -5274,7 +4964,6 @@ launch parameter. - @@ -5288,7 +4977,6 @@ launch parameter. - @@ -5305,7 +4993,6 @@ launch parameter. A convenience method to add @role with @fieldname and additional arguments to the permissions of @factory. If @factory had no permissions, new permissions will be created and the role will be added to it. - @@ -5332,7 +5019,6 @@ will be created and the role will be added to it. A convenience wrapper around gst_rtsp_permissions_add_role_from_structure(). If @factory had no permissions, new permissions will be created and the role will be added to it. - @@ -5355,7 +5041,6 @@ with gst_rtsp_media_create_stream (). After the media is constructed, it can be configured and then prepared with gst_rtsp_media_prepare (). - a new #GstRTSPMedia if the media could be prepared. @@ -5378,7 +5063,6 @@ the elements to use for streaming the media. The bin should contain payloaders pay\%d for each stream. The default implementation of this function returns the bin created from the launch parameter. - a new #GstElement. @@ -5396,7 +5080,6 @@ launch parameter. Get the #GstRTSPAddressPool used as the address pool of @factory. - the #GstRTSPAddressPool of @factory. g_object_unref() after usage. @@ -5411,7 +5094,6 @@ usage. Get the kernel UDP buffer size. - the kernel UDP buffer size. @@ -5426,7 +5108,6 @@ usage. Returns the clock that is going to be used by the pipelines of all medias created from this factory. - The GstClock @@ -5439,7 +5120,6 @@ of all medias created from this factory. - Whether retransmission requests will be sent for receiving media @@ -5452,7 +5132,6 @@ of all medias created from this factory. Get the configured media DSCP QoS. - the media DSCP QoS value or -1 if disabled. @@ -5466,7 +5145,6 @@ of all medias created from this factory. Get the latency that is used for receiving media - latency in milliseconds @@ -5481,7 +5159,6 @@ of all medias created from this factory. Get the gst_parse_launch() pipeline description that will be used in the default prepare vmethod. - the configured launch description. g_free() after usage. @@ -5496,7 +5173,6 @@ usage. Get the the maximum time-to-live value of outgoing multicast packets. - the maximum time-to-live value of outgoing multicast packets. @@ -5511,7 +5187,6 @@ usage. Return the GType of the GstRTSPMedia subclass this factory will create. - @@ -5524,7 +5199,6 @@ factory will create. Get the multicast interface used for @factory. - the multicast interface for @factory. g_free() after usage. @@ -5539,7 +5213,6 @@ usage. Get the permissions object from @factory. - a #GstRTSPPermissions object, unref after usage. @@ -5553,7 +5226,6 @@ usage. Get the allowed profiles of @factory. - a #GstRTSPProfile @@ -5567,7 +5239,6 @@ usage. Get the allowed protocols of @factory. - a #GstRTSPLowerTrans @@ -5581,7 +5252,6 @@ usage. Gets if and how the media clock should be published according to RFC7273. - The GstRTSPPublishClockMode @@ -5595,7 +5265,6 @@ usage. Get the time that is stored for retransmission purposes - a #GstClockTime @@ -5609,7 +5278,6 @@ usage. Get how media created from this factory will be suspended. - a #GstRTSPSuspendMode. @@ -5624,7 +5292,6 @@ usage. Get if media created from this factory can be used for PLAY or RECORD methods. - The transport mode. @@ -5638,7 +5305,6 @@ methods. Check if multicast sockets are configured to be bound to multicast addresses. - %TRUE if multicast sockets are configured to be bound to multicast addresses. @@ -5653,7 +5319,6 @@ methods. Get if media created from this factory will have an EOS event sent to the pipeline before shutdown. - %TRUE if the media will receive EOS before shutdown. @@ -5667,7 +5332,6 @@ pipeline before shutdown. Get if media created from this factory can be shared between clients. - %TRUE if the media will be shared between clients. @@ -5680,7 +5344,6 @@ pipeline before shutdown. - @@ -5692,7 +5355,6 @@ pipeline before shutdown. configure @pool to be used as the address pool of @factory. - @@ -5710,7 +5372,6 @@ pipeline before shutdown. Decide whether the multicast socket should be bound to a multicast address or INADDR_ANY. - @@ -5727,7 +5388,6 @@ INADDR_ANY. Set the kernel UDP buffer size. - @@ -5745,7 +5405,6 @@ INADDR_ANY. Configures a specific clock to be used by the pipelines of all medias created from this factory. - @@ -5763,7 +5422,6 @@ of all medias created from this factory. Set whether retransmission requests will be sent for receiving media - @@ -5778,7 +5436,6 @@ receiving media Configure the media dscp qos to @dscp_qos. - @@ -5796,7 +5453,6 @@ receiving media Configure if media created from this factory will have an EOS sent to the pipeline before shutdown. - @@ -5813,7 +5469,6 @@ pipeline before shutdown. Configure the latency used for receiving media - @@ -5838,7 +5493,6 @@ which can be accomplished by enclosing the description with brackets '(' The description should return a pipeline with payloaders named pay0, pay1, etc.. Each of the payloaders will result in a stream. - @@ -5855,7 +5509,6 @@ etc.. Each of the payloaders will result in a stream. Set the maximum time-to-live value of outgoing multicast packets. - %TRUE if the requested ttl has been set successfully. @@ -5875,7 +5528,6 @@ etc.. Each of the payloaders will result in a stream. Configure the GType of the GstRTSPMedia subclass to create (by default, overridden construct vmethods may of course do something different) - @@ -5892,7 +5544,6 @@ may of course do something different) configure @multicast_iface to be used for @factory. - @@ -5909,7 +5560,6 @@ may of course do something different) Set @permissions on @factory. - @@ -5926,7 +5576,6 @@ may of course do something different) Configure the allowed profiles for @factory. - @@ -5943,7 +5592,6 @@ may of course do something different) Configure the allowed lower transport for @factory. - @@ -5960,7 +5608,6 @@ may of course do something different) Sets if and how the media clock should be published according to RFC7273. - @@ -5977,7 +5624,6 @@ may of course do something different) Configure the time to store for possible retransmission - @@ -5994,7 +5640,6 @@ may of course do something different) Configure if media created from this factory can be shared between clients. - @@ -6012,7 +5657,6 @@ may of course do something different) Configure if media created from this factory should be stopped when a client disconnects without sending TEARDOWN. - @@ -6029,7 +5673,6 @@ when a client disconnects without sending TEARDOWN. Configure how media created from this factory will be suspended. - @@ -6046,7 +5689,6 @@ when a client disconnects without sending TEARDOWN. Configure if this factory creates media for PLAY or RECORD modes. - @@ -6137,13 +5779,11 @@ when a client disconnects without sending TEARDOWN. The #GstRTSPMediaFactory class structure. - - @@ -6159,7 +5799,6 @@ when a client disconnects without sending TEARDOWN. - a new #GstElement. @@ -6178,7 +5817,6 @@ when a client disconnects without sending TEARDOWN. - a new #GstRTSPMedia if the media could be prepared. @@ -6197,7 +5835,6 @@ when a client disconnects without sending TEARDOWN. - @@ -6213,7 +5850,6 @@ when a client disconnects without sending TEARDOWN. - @@ -6229,7 +5865,6 @@ when a client disconnects without sending TEARDOWN. - @@ -6245,7 +5880,6 @@ when a client disconnects without sending TEARDOWN. - @@ -6265,15 +5899,11 @@ when a client disconnects without sending TEARDOWN. - - - + A media factory that creates a pipeline to play any uri. - Create a new #GstRTSPMediaFactoryURI instance. - a new #GstRTSPMediaFactoryURI object. @@ -6281,7 +5911,6 @@ when a client disconnects without sending TEARDOWN. Get the URI that will provide media for this factory. - the configured URI. g_free() after usage. @@ -6295,7 +5924,6 @@ when a client disconnects without sending TEARDOWN. Set the URI of the resource that will be streamed by this factory. - @@ -6330,7 +5958,6 @@ when a client disconnects without sending TEARDOWN. The #GstRTSPMediaFactoryURI class structure. - @@ -6340,15 +5967,10 @@ when a client disconnects without sending TEARDOWN. - - - - - - + + The state of the media pipeline. - media pipeline not prerolled @@ -6372,7 +5994,6 @@ when a client disconnects without sending TEARDOWN. Function registered with gst_rtsp_stream_transport_set_message_sent() and called when a message has been sent on the transport. - @@ -6386,7 +6007,6 @@ and called when a message has been sent on the transport. Function registered with gst_rtsp_stream_transport_set_message_sent_full() and called when a message has been sent on the transport. - @@ -6402,10 +6022,8 @@ and called when a message has been sent on the transport. Creates a #GstRTSPMediaFactory object for a given url. - Make a new mount points object. - a new #GstRTSPMountPoints @@ -6413,7 +6031,6 @@ and called when a message has been sent on the transport. Make a path string from @url. - a path string for @url, g_free() after usage. @@ -6436,7 +6053,6 @@ and called when a message has been sent on the transport. Ownership is taken of the reference on @factory so that @factory should not be used after calling this function. - @@ -6457,7 +6073,6 @@ used after calling this function. Make a path string from @url. - a path string for @url, g_free() after usage. @@ -6478,7 +6093,6 @@ used after calling this function. If @matched is %NULL, @path will match the factory exactly otherwise the amount of characters that matched is returned in @matched. - the #GstRTSPMediaFactory for @path. g_object_unref() after usage. @@ -6501,7 +6115,6 @@ g_object_unref() after usage. Remove the #GstRTSPMediaFactory associated with @path in @mounts. - @@ -6530,13 +6143,11 @@ g_object_unref() after usage. The class for the media mounts object. - - a path string for @url, g_free() after usage. @@ -6559,14 +6170,10 @@ g_object_unref() after usage. - - - + - Create a new #GstRTSPOnvifClient instance. - a new #GstRTSPOnvifClient @@ -6582,7 +6189,6 @@ g_object_unref() after usage. - @@ -6593,7 +6199,6 @@ g_object_unref() after usage. - Find the ONVIF backchannel depayloader element. It should be named 'depay_backchannel', be placed in a bin called 'onvif-backchannel' @@ -6601,7 +6206,6 @@ and return all supported RTP caps on a caps query. Complete RTP caps with at least the payload type, clock-rate and encoding-name are required. A new #GstRTSPStream is created for the backchannel if found. - %TRUE if a backchannel stream could be found and created @@ -6616,7 +6220,6 @@ A new #GstRTSPStream is created for the backchannel if found. Get the configured/supported bandwidth of the ONVIF backchannel pipeline in bits per second. - the configured/supported backchannel bandwidth. @@ -6631,7 +6234,6 @@ bits per second. Set the configured/supported bandwidth of the ONVIF backchannel pipeline in bits per second. - @@ -6659,7 +6261,6 @@ bits per second. - @@ -6670,10 +6271,8 @@ bits per second. - Create a new #GstRTSPOnvifMediaFactory - A new #GstRTSPOnvifMediaFactory @@ -6681,7 +6280,6 @@ bits per second. Checks whether the client request requires backchannel. - %TRUE if the client request requires backchannel. @@ -6698,7 +6296,6 @@ bits per second. Returns %TRUE if an ONVIF backchannel is supported by the media factory. - %TRUE if an ONVIF backchannel is supported by the media factory. @@ -6713,7 +6310,6 @@ bits per second. Get the configured/supported bandwidth of the ONVIF backchannel pipeline in bits per second. - the configured/supported backchannel bandwidth. @@ -6728,7 +6324,6 @@ bits per second. Get the gst_parse_launch() pipeline description that will be used in the default prepare vmethod for generating the ONVIF backchannel pipeline. - the configured backchannel launch description. g_free() after usage. @@ -6743,7 +6338,6 @@ usage. Returns %TRUE if an ONVIF backchannel is supported by the media factory. - %TRUE if an ONVIF backchannel is supported by the media factory. @@ -6756,7 +6350,6 @@ usage. - %TRUE if ONVIF replay is supported by the media factory. @@ -6770,7 +6363,6 @@ usage. Set the configured/supported bandwidth of the ONVIF backchannel pipeline in bits per second. - @@ -6802,7 +6394,6 @@ Note: The pipeline part passed here must end in sinks that are not waiting until pre-rolling before reaching the PAUSED state, i.e. setting async=false on #GstBaseSink. Otherwise the whole media will not be able to prepare. - @@ -6819,7 +6410,6 @@ prepare. Set to %TRUE if ONVIF replay is supported by the media factory. - @@ -6845,13 +6435,11 @@ prepare. - - %TRUE if an ONVIF backchannel is supported by the media factory. @@ -6870,17 +6458,11 @@ prepare. - - - - - - + + - Create a new #GstRTSPOnvifServer instance. - a new #GstRTSPOnvifServer @@ -6896,7 +6478,6 @@ prepare. - @@ -6909,13 +6490,11 @@ prepare. The opaque permissions structure. It is used to define the permissions of objects in different roles. - Create a new empty Authorization permissions. - a new empty authorization permissions. @@ -6923,7 +6502,6 @@ of objects in different roles. Add a new @permission for @role to @permissions with the access in @allowed. - @@ -6949,7 +6527,6 @@ of objects in different roles. Add a new @role to @permissions with the given variables. The fields are the same layout as gst_structure_new(). - @@ -6975,7 +6552,6 @@ are the same layout as gst_structure_new(). Add a new @role to @permissions without any permissions. You can add permissions for the role with gst_rtsp_permissions_add_permission_for_role(). - @@ -6998,7 +6574,6 @@ given a role named `tester`, which should be granted a permission named ``` gst_structure_new ("tester", "permission1", G_TYPE_BOOLEAN, TRUE, NULL); ``` - @@ -7014,7 +6589,6 @@ gst_structure_new ("tester", "permission1", G_TYPE_BOOLEAN, TRUE, NULL); Add a new @role to @permissions with the given variables. Structure fields are set according to the varargs in a manner similar to gst_structure_new(). - @@ -7039,7 +6613,6 @@ are set according to the varargs in a manner similar to gst_structure_new(). Get all permissions for @role in @permissions. - the structure with permissions for @role. It remains valid for as long as @permissions is valid. @@ -7058,7 +6631,6 @@ remains valid for as long as @permissions is valid. Check if @role in @permissions is given permission for @permission. - %TRUE if @role is allowed @permission. @@ -7080,7 +6652,6 @@ remains valid for as long as @permissions is valid. Remove all permissions for @role in @permissions. - @@ -7111,7 +6682,6 @@ remains valid for as long as @permissions is valid. Function registered with gst_rtsp_stream_transport_set_callbacks() and called when @buffer must be sent on @channel. - %TRUE on success @@ -7134,7 +6704,6 @@ called when @buffer must be sent on @channel. Function registered with gst_rtsp_stream_transport_set_callbacks() and called when @buffer_list must be sent on @channel. - %TRUE on success @@ -7157,10 +6726,8 @@ called when @buffer_list must be sent on @channel. This object listens on a port, creates and manages the clients connected to it. - Create a new #GstRTSPServer instance. - a new #GstRTSPServer @@ -7169,7 +6736,6 @@ it. A default #GSocketSourceFunc that creates a new #GstRTSPClient to accept and handle a new connection on @socket or @server. - TRUE if the source could be connected, FALSE if an error occurred. @@ -7190,7 +6756,6 @@ new connection on @socket or @server. - @@ -7204,7 +6769,6 @@ new connection on @socket or @server. - @@ -7227,7 +6791,6 @@ if @context is not the default main context as returned by g_main_context_default() (or %NULL), g_source_remove() cannot be used to destroy the source. In that case it is recommended to use gst_rtsp_server_create_source() and attach it to @context manually. - the ID (greater than 0) for the source within the GMainContext. @@ -7258,7 +6821,6 @@ will also be added with an additional ref to the result #GList of this function.. When @func is %NULL, #GST_RTSP_FILTER_REF will be assumed for each client. - a #GList with all clients for which @func returned #GST_RTSP_FILTER_REF. After usage, each @@ -7285,7 +6847,6 @@ element in the #GList should be unreffed before the list is freed. Create a #GSocket for @server. The socket will listen on the configured service. - the #GSocket for @server or %NULL when an error occurred. @@ -7312,7 +6873,6 @@ unless cancellation happened at the same time as a condition change). You can check for this in the callback using g_cancellable_is_cancelled(). This takes a reference on @server until @source is destroyed. - the #GSource for @server or %NULL when an error occurred. Free with g_source_unref () @@ -7331,7 +6891,6 @@ occurred. Free with g_source_unref () Get the address on which the server will accept connections. - the server address. g_free() after usage. @@ -7345,7 +6904,6 @@ occurred. Free with g_source_unref () Get the #GstRTSPAuth used as the authentication manager of @server. - the #GstRTSPAuth of @server. g_object_unref() after usage. @@ -7360,7 +6918,6 @@ usage. The maximum amount of queued requests for the server. - the server backlog. @@ -7374,7 +6931,6 @@ usage. Get the port number where the server was bound to. - the port number @@ -7388,7 +6944,6 @@ usage. Get the Content-Length limit of @server. - the Content-Length limit. @@ -7402,7 +6957,6 @@ usage. Get the #GstRTSPMountPoints used as the mount points of @server. - the #GstRTSPMountPoints of @server. g_object_unref() after usage. @@ -7417,7 +6971,6 @@ usage. Get the service on which the server will accept connections. - the service. use g_free() after usage. @@ -7431,7 +6984,6 @@ usage. Get the #GstRTSPSessionPool used as the session pool of @server. - the #GstRTSPSessionPool used for sessions. g_object_unref() after usage. @@ -7446,7 +6998,6 @@ usage. Get the #GstRTSPThreadPool used as the thread pool of @server. - the #GstRTSPThreadPool of @server. g_object_unref() after usage. @@ -7463,7 +7014,6 @@ usage. Configure @server to accept connections on the given address. This function must be called before the server is bound. - @@ -7480,7 +7030,6 @@ This function must be called before the server is bound. configure @auth to be used as the authentication manager of @server. - @@ -7500,7 +7049,6 @@ This function must be called before the server is bound. server. This function must be called before the server is bound. - @@ -7518,7 +7066,6 @@ This function must be called before the server is bound. Define an appropriate request size limit and reject requests exceeding the limit. - @@ -7535,7 +7082,6 @@ Configure @server to use the specified Content-Length limit. configure @mounts to be used as the mount points of @server. - @@ -7560,7 +7106,6 @@ port. The actual used port can be retrieved with gst_rtsp_server_get_bound_port(). This function must be called before the server is bound. - @@ -7577,7 +7122,6 @@ This function must be called before the server is bound. configure @pool to be used as the session pool of @server. - @@ -7594,7 +7138,6 @@ This function must be called before the server is bound. configure @pool to be used as the thread pool of @server. - @@ -7614,7 +7157,6 @@ This function must be called before the server is bound. is used when transferring a socket from an HTTP server which should be used as an RTSP over HTTP tunnel. The @initial_buffer contains any remaining data that the HTTP server read from the socket while parsing the HTTP header. - TRUE if all was ok, FALSE if an error occurred. @@ -7687,13 +7229,11 @@ that the HTTP server read from the socket while parsing the HTTP header. The RTSP server class structure - - @@ -7706,7 +7246,6 @@ that the HTTP server read from the socket while parsing the HTTP header. - @@ -7738,7 +7277,6 @@ A return value of #GST_RTSP_FILTER_KEEP will leave @client untouched in A value of #GST_RTSP_FILTER_REF will add @client to the result #GList of gst_rtsp_server_client_filter(). - a #GstRTSPFilterResult. @@ -7758,17 +7296,13 @@ gst_rtsp_server_client_filter(). - - - + Session information kept by the server for a specific client. One client session, identified with a session id, can handle multiple medias identified with the url of a media. - Create a new #GstRTSPSession instance with @sessionid. - a new #GstRTSPSession @@ -7783,7 +7317,6 @@ identified with the url of a media. Allow @session to expire. This method must be called an equal amount of time as gst_rtsp_session_prevent_expire(). - @@ -7809,7 +7342,6 @@ will also be added with an additional ref to the result #GList of this function.. When @func is %NULL, #GST_RTSP_FILTER_REF will be assumed for all media. - a GList with all media for which @func returned #GST_RTSP_FILTER_REF. After usage, each @@ -7835,7 +7367,6 @@ element in the #GList should be unreffed before the list is freed. Get the string that can be placed in the Session header field. - the Session header of @session. g_free() after usage. @@ -7851,7 +7382,6 @@ g_free() after usage. Get the session media for @path. @matched will contain the number of matched characters of @path. - the configuration for @path in @sess. @@ -7873,7 +7403,6 @@ characters of @path. Get the sessionid of @session. - the sessionid of @session. The value remains valid as long as @session is alive. @@ -7888,7 +7417,6 @@ The value remains valid as long as @session is alive. Get the timeout value of @session. - the timeout of @session in seconds. @@ -7903,7 +7431,6 @@ The value remains valid as long as @session is alive. Check if @session timeout out. Use gst_rtsp_session_is_expired_usec() instead. - %TRUE if @session timed out @@ -7921,7 +7448,6 @@ The value remains valid as long as @session is alive. Check if @session timeout out. - %TRUE if @session timed out @@ -7942,7 +7468,6 @@ The value remains valid as long as @session is alive. media from the session with gst_rtsp_session_get_media(). Ownership is taken from @media. - a new @GstRTSPSessionMedia object. @@ -7965,7 +7490,6 @@ Ownership is taken from @media. Get the amount of milliseconds till the session will expire. Use gst_rtsp_session_next_timeout_usec() instead. - the amount of milliseconds since the session will time out. @@ -7983,7 +7507,6 @@ Ownership is taken from @media. Get the amount of milliseconds till the session will expire. - the amount of milliseconds since the session will time out. @@ -8001,7 +7524,6 @@ Ownership is taken from @media. Prevent @session from expiring. - @@ -8014,7 +7536,6 @@ Ownership is taken from @media. Release the managed @media in @sess, freeing the memory allocated by it. - %TRUE if there are more media session left in @sess. @@ -8033,7 +7554,6 @@ Ownership is taken from @media. Configure @session for a timeout of @timeout seconds. The session will be cleaned up when there is no activity for @timeout seconds. - @@ -8050,7 +7570,6 @@ cleaned up when there is no activity for @timeout seconds. Update the last_access time of the session to the current time. - @@ -8086,7 +7605,6 @@ cleaned up when there is no activity for @timeout seconds. - @@ -8108,7 +7626,6 @@ A return value of #GST_RTSP_FILTER_KEEP will leave @media untouched in A value of GST_RTSP_FILTER_REF will add @media to the result #GList of gst_rtsp_session_filter(). - a #GstRTSPFilterResult. @@ -8130,13 +7647,11 @@ gst_rtsp_session_filter(). State of a client session regarding a specific media identified by path. - Create a new #GstRTSPSessionMedia that manages the streams in @media for @path. @media should be prepared. Ownership is taken of @media. - a new #GstRTSPSessionMedia. @@ -8155,7 +7670,6 @@ Ownership is taken of @media. Fill @range with the next available min and max channels for interleaved transport. - %TRUE on success. @@ -8173,7 +7687,6 @@ interleaved transport. Get the base_time of the #GstRTSPMedia in @media - the base_time of the media. @@ -8187,7 +7700,6 @@ interleaved transport. Get the #GstRTSPMedia that was used when constructing @media - the #GstRTSPMedia of @media. Remains valid as long as @media is valid. @@ -8203,7 +7715,6 @@ Remains valid as long as @media is valid. Retrieve the RTP-Info header string for all streams in @media with configured transports. - The RTP-Info as a string or %NULL when no RTP-Info could be generated, g_free() after usage. @@ -8218,7 +7729,6 @@ with configured transports. Get the current RTSP state of @media. - the current RTSP state of @media. @@ -8232,7 +7742,6 @@ with configured transports. Get a previously created #GstRTSPStreamTransport for the stream at @idx. - a #GstRTSPStreamTransport that is valid until the session of @media is unreffed. @@ -8251,7 +7760,6 @@ valid until the session of @media is unreffed. Get a list of all available #GstRTSPStreamTransport in this session. - a list of #GstRTSPStreamTransport, g_ptr_array_unref () after usage. @@ -8269,7 +7777,6 @@ list of #GstRTSPStreamTransport, g_ptr_array_unref () after usage. Check if the path of @media matches @path. It @path matches, the amount of matched characters is returned in @matched. - %TRUE when @path matches the path of @media. @@ -8291,7 +7798,6 @@ matched characters is returned in @matched. Set the RTSP state of @media to @state. - @@ -8308,7 +7814,6 @@ matched characters is returned in @matched. Tell the media object @media to change to @state. - %TRUE on success. @@ -8326,7 +7831,6 @@ matched characters is returned in @matched. Configure the transport for @stream to @tr in @media. - the new or updated #GstRTSPStreamTransport for @stream. @@ -8359,7 +7863,6 @@ matched characters is returned in @matched. - @@ -8369,16 +7872,12 @@ matched characters is returned in @matched. - - - + An object that keeps track of the active sessions. This object is usually attached to a #GstRTSPServer object to manage the sessions in that server. - Create a new #GstRTSPSessionPool instance. - A new #GstRTSPSessionPool. g_object_unref() after usage. @@ -8386,7 +7885,6 @@ usage. - @@ -8400,7 +7898,6 @@ usage. - @@ -8411,7 +7908,6 @@ usage. - @@ -8427,7 +7923,6 @@ usage. Inspect all the sessions in @pool and remove the sessions that are inactive for more than their timeout. - the amount of sessions that got removed. @@ -8441,7 +7936,6 @@ for more than their timeout. Create a new #GstRTSPSession object in @pool. - a new #GstRTSPSession. @@ -8456,7 +7950,6 @@ for more than their timeout. Create a #GSource that will be dispatched when the session should be cleaned up. - a #GSource @@ -8483,7 +7976,6 @@ will also be added with an additional ref to the result GList of this function.. When @func is %NULL, #GST_RTSP_FILTER_REF will be assumed for all sessions. - a GList with all sessions for which @func returned #GST_RTSP_FILTER_REF. After usage, each @@ -8510,7 +8002,6 @@ element in the GList should be unreffed before the list is freed. Find the session with @sessionid in @pool. The access time of the session will be updated with gst_rtsp_session_touch(). - the #GstRTSPSession with @sessionid or %NULL when the session did not exist. g_object_unref() after usage. @@ -8530,7 +8021,6 @@ or %NULL when the session did not exist. g_object_unref() after usage. Get the maximum allowed number of sessions in @pool. 0 means an unlimited amount of sessions. - the maximum allowed number of sessions. @@ -8544,7 +8034,6 @@ amount of sessions. Get the amount of active sessions in @pool. - the amount of active sessions in @pool. @@ -8558,7 +8047,6 @@ amount of sessions. Remove @sess from @pool, releasing the ref that the pool has on @sess. - %TRUE if the session was found and removed. @@ -8577,7 +8065,6 @@ amount of sessions. Configure the maximum allowed number of sessions in @pool to @max. A value of 0 means an unlimited amount of sessions. - @@ -8618,13 +8105,11 @@ A value of 0 means an unlimited amount of sessions. - - @@ -8637,7 +8122,6 @@ A value of 0 means an unlimited amount of sessions. - @@ -8653,7 +8137,6 @@ A value of 0 means an unlimited amount of sessions. - @@ -8685,7 +8168,6 @@ A return value of #GST_RTSP_FILTER_KEEP will leave @session untouched in A value of GST_RTSP_FILTER_REF will add @session to the result #GList of gst_rtsp_session_pool_filter(). - a #GstRTSPFilterResult. @@ -8710,7 +8192,6 @@ gst_rtsp_session_pool_filter(). The function will be called when the pool must be cleaned up because one or more sessions timed out. - %FALSE if the source should be removed. @@ -8726,20 +8207,14 @@ more sessions timed out. - - - - - - + + The definition of a media stream. - Create a new media stream with index @idx that handles RTP data on @pad and has a payloader element @payloader if @pad is a source pad or a depayloader element @payloader if @pad is a sink pad. - a new #GstRTSPStream @@ -8763,7 +8238,6 @@ or a depayloader element @payloader if @pad is a sink pad. Add multicast client address to stream. At this point, the sockets that will stream RTP and RTCP data to @destination are supposed to be allocated. - %TRUE if @destination can be addedd and handled by @stream. @@ -8799,7 +8273,6 @@ same transport twice will not add it a second time. @stream must be joined to a bin. @trans must contain a valid #GstRTSPTransport. - %TRUE if @trans was added @@ -8817,7 +8290,6 @@ same transport twice will not add it a second time. Allocates RTP and RTCP ports. - %TRUE if the RTP and RTCP sockets have been succeccully allocated. @@ -8844,7 +8316,6 @@ same transport twice will not add it a second time. Add a receiver and sender part to the pipeline based on the transport from SETUP. - %TRUE if the stream has been sucessfully updated. @@ -8862,7 +8333,6 @@ SETUP. Get the #GstRTSPAddressPool used as the address pool of @stream. - the #GstRTSPAddressPool of @stream. g_object_unref() after usage. @@ -8877,7 +8347,6 @@ g_object_unref() after usage. Get the size of the UDP transmission buffer (in bytes) - the size of the UDP TX buffer @@ -8891,7 +8360,6 @@ g_object_unref() after usage. Retrieve the current caps of @stream. - the #GstCaps of @stream. use gst_caps_unref() after usage. @@ -8906,7 +8374,6 @@ use gst_caps_unref() after usage. Get the control string to identify this stream. - the control string. g_free() after usage. @@ -8919,7 +8386,6 @@ use gst_caps_unref() after usage. - @@ -8931,7 +8397,6 @@ use gst_caps_unref() after usage. Get the configured DSCP QoS in of the outgoing sockets. - the DSCP QoS value of the outgoing sockets, or -1 if disbled. @@ -8945,7 +8410,6 @@ use gst_caps_unref() after usage. Get the stream index. - the stream index. @@ -8959,7 +8423,6 @@ use gst_caps_unref() after usage. Get the previous joined bin with gst_rtsp_stream_join_bin() or NULL. - the joined bin or NULL. @@ -8973,7 +8436,6 @@ use gst_caps_unref() after usage. Get the the maximum time-to-live value of outgoing multicast packets. - the maximum time-to-live value of outgoing multicast packets. @@ -8987,7 +8449,6 @@ use gst_caps_unref() after usage. Get the configured MTU in the payloader of @stream. - the MTU of the payloader. @@ -9003,7 +8464,6 @@ use gst_caps_unref() after usage. Get the multicast address of @stream for @family. The original #GstRTSPAddress is cached and copy is returned, so freeing the return value won't release the address from the pool. - the #GstRTSPAddress of @stream or %NULL when no address could be allocated. gst_rtsp_address_free() @@ -9023,7 +8483,6 @@ after usage. Get all multicast client addresses that RTP data will be sent to - A comma separated list of host:port pairs with destinations @@ -9037,7 +8496,6 @@ after usage. Get the multicast interface used for @stream. - the multicast interface for @stream. g_free() after usage. @@ -9052,7 +8510,6 @@ g_free() after usage. Get the allowed profiles of @stream. - a #GstRTSPProfile @@ -9066,7 +8523,6 @@ g_free() after usage. Get the allowed protocols of @stream. - a #GstRTSPLowerTrans @@ -9080,7 +8536,6 @@ g_free() after usage. Get the stream payload type. - the stream payload type. @@ -9094,7 +8549,6 @@ g_free() after usage. Gets if and how the stream clock should be published according to RFC7273. - The GstRTSPPublishClockMode @@ -9107,7 +8561,6 @@ g_free() after usage. - whether @stream will follow the Rate-Control=no behaviour as specified in the ONVIF replay spec. @@ -9121,7 +8574,6 @@ in the ONVIF replay spec. Retrieve the current rate and/or applied_rate. - %TRUE if rate and/or applied_rate could be determined. @@ -9143,7 +8595,6 @@ in the ONVIF replay spec. Get the payload-type used for retransmission of this stream - The retransmission PT. @@ -9157,7 +8608,6 @@ in the ONVIF replay spec. Get the amount of time to store retransmission data. - the amount of time to store retransmission data. @@ -9171,7 +8621,6 @@ in the ONVIF replay spec. Get the multicast RTCP socket from @stream for a @family. - the multicast RTCP socket or %NULL if no socket could be allocated for @family. Unref after usage @@ -9192,7 +8641,6 @@ socket could be allocated for @family. Unref after usage Get the RTCP socket from @stream for a @family. @stream must be joined to a bin. - the RTCP socket or %NULL if no socket could be allocated for @family. Unref after usage @@ -9211,7 +8659,6 @@ socket could be allocated for @family. Unref after usage Get the multicast RTP socket from @stream for a @family. - the multicast RTP socket or %NULL if no @@ -9233,7 +8680,6 @@ socket could be allocated for @family. Unref after usage Get the RTP socket from @stream for a @family. @stream must be joined to a bin. - the RTP socket or %NULL if no socket could be allocated for @family. Unref after usage @@ -9253,7 +8699,6 @@ socket could be allocated for @family. Unref after usage Retrieve the current rtptime, seq and running-time. This is used to construct a RTPInfo reply header. - %TRUE when rtptime, seq and running-time could be determined. @@ -9283,7 +8728,6 @@ construct a RTPInfo reply header. Get the RTP session of this stream. - The RTP session of this stream. Unref after usage. @@ -9298,7 +8742,6 @@ construct a RTPInfo reply header. Fill @server_port with the port pair used by the server. This function can only be called when @stream has been joined. - @@ -9319,7 +8762,6 @@ only be called when @stream has been joined. Get the sinkpad associated with @stream. - the sinkpad. Unref after usage. @@ -9333,7 +8775,6 @@ only be called when @stream has been joined. Get the srcpad associated with @stream. - the srcpad. Unref after usage. @@ -9347,7 +8788,6 @@ only be called when @stream has been joined. Get the SRTP encoder for this stream. - The SRTP encoder for this stream. Unref after usage. @@ -9362,7 +8802,6 @@ only be called when @stream has been joined. Get the SSRC used by the RTP session of this stream. This function can only be called when @stream has been joined. - @@ -9378,7 +8817,6 @@ be called when @stream has been joined. - @@ -9389,7 +8827,6 @@ be called when @stream has been joined. - the amount of redundancy applied when creating ULPFEC protection packets. @@ -9402,7 +8839,6 @@ protection packets. - the payload type used for ULPFEC protection packets @@ -9415,7 +8851,6 @@ protection packets. Parse and handle a KeyMgmt header. - @@ -9432,7 +8867,6 @@ protection packets. Check if @stream has the control string @control. - %TRUE is @stream has @control as the control string @@ -9450,7 +8884,6 @@ protection packets. Check if multicast sockets are configured to be bound to multicast addresses. - %TRUE if multicast sockets are configured to be bound to multicast addresses. @@ -9464,7 +8897,6 @@ protection packets. Check if @stream is blocking on a #GstBuffer. - %TRUE if @stream is blocking @@ -9478,7 +8910,6 @@ protection packets. See gst_rtsp_stream_set_client_side() - TRUE if this #GstRTSPStream is client-side. @@ -9494,7 +8925,6 @@ protection packets. Checks whether the stream is complete, contains the receiver and the sender parts. As the stream contains sink(s) element(s), it's possible to perform seek operations on it. - %TRUE if the stream contains at least one sink element. @@ -9508,7 +8938,6 @@ seek operations on it. Checks whether the stream is a receiver. - %TRUE if the stream is a receiver and %FALSE otherwise. @@ -9522,7 +8951,6 @@ seek operations on it. Checks whether the stream is a sender. - %TRUE if the stream is a sender and %FALSE otherwise. @@ -9536,7 +8964,6 @@ seek operations on it. Check if @transport can be handled by stream - %TRUE if @transport can be handled by @stream. @@ -9557,7 +8984,6 @@ seek operations on it. @stream will link to @rtpbin, which must be inside @bin. The elements added to @bin will be set to the state given in @state. - %TRUE on success. @@ -9583,7 +9009,6 @@ added to @bin will be set to the state given in @state. Remove the elements of @stream from @bin. - %TRUE on success. @@ -9606,7 +9031,6 @@ added to @bin will be set to the state given in @state. Query the position of the stream in %GST_FORMAT_TIME. This only considers the RTP parts of the pipeline and not the RTCP parts. - %TRUE if the position could be queried @@ -9625,7 +9049,6 @@ the RTP parts of the pipeline and not the RTCP parts. Query the stop of the stream in %GST_FORMAT_TIME. This only considers the RTP parts of the pipeline and not the RTCP parts. - %TRUE if the stop could be queried @@ -9646,7 +9069,6 @@ the RTP parts of the pipeline and not the RTCP parts. message has been received from a client using the TCP transport. This function takes ownership of @buffer. - a GstFlowReturn. @@ -9667,7 +9089,6 @@ This function takes ownership of @buffer. message has been received from a client using the TCP transport. This function takes ownership of @buffer. - a GstFlowReturn. @@ -9690,7 +9111,6 @@ not be sent to the values configured in @trans. @stream must be joined to a bin. @trans must contain a valid #GstRTSPTransport. - %TRUE if @trans was removed @@ -9708,7 +9128,6 @@ not be sent to the values configured in @trans. Creating a rtxreceive bin - a #GstElement. @@ -9726,7 +9145,6 @@ not be sent to the values configured in @trans. Creating a rtxsend bin - a #GstElement. @@ -9744,7 +9162,6 @@ not be sent to the values configured in @trans. Creating a rtpulpfecdec element - a #GstElement. @@ -9763,7 +9180,6 @@ not be sent to the values configured in @trans. Creating a rtpulpfecenc element - a #GstElement. @@ -9781,7 +9197,6 @@ not be sent to the values configured in @trans. Reserve @address and @port as the address and port of @stream. The original #GstRTSPAddress is cached and copy is returned, so freeing the return value won't release the address from the pool. - the #GstRTSPAddress of @stream or %NULL when the address could not be reserved. gst_rtsp_address_free() after @@ -9813,7 +9228,6 @@ usage. Checks whether the individual @stream is seekable. - %TRUE if @stream is seekable, else %FALSE. @@ -9827,7 +9241,6 @@ usage. configure @pool to be used as the address pool of @stream. - @@ -9845,7 +9258,6 @@ usage. Decide whether the multicast socket should be bound to a multicast address or INADDR_ANY. - @@ -9862,7 +9274,6 @@ INADDR_ANY. Blocks or unblocks the dataflow on @stream. - %TRUE on success @@ -9881,7 +9292,6 @@ INADDR_ANY. Set the size of the UDP transmission buffer (in bytes) Needs to be set before the stream is joined to a bin. - @@ -9902,7 +9312,6 @@ streams to an RTSP server via RECORD. This has the practical effect of changing which UDP port numbers are used when setting up the local side of the stream sending to be either the 'server' or 'client' pair of a configured UDP transport. - @@ -9920,7 +9329,6 @@ an RTSP connection. Set the control string in @stream. - @@ -9937,7 +9345,6 @@ an RTSP connection. Configure the dscp qos of the outgoing sockets to @dscp_qos. - @@ -9954,7 +9361,6 @@ an RTSP connection. Set the maximum time-to-live value of outgoing multicast packets. - %TRUE if the requested ttl has been set successfully. @@ -9972,7 +9378,6 @@ an RTSP connection. Configure the mtu in the payloader of @stream to @mtu. - @@ -9989,7 +9394,6 @@ an RTSP connection. configure @multicast_iface to be used for @stream. - @@ -10006,7 +9410,6 @@ an RTSP connection. Configure the allowed profiles for @stream. - @@ -10023,7 +9426,6 @@ an RTSP connection. Configure the allowed lower transport for @stream. - @@ -10040,7 +9442,6 @@ an RTSP connection. Configure a pt map between @pt and @caps. - @@ -10061,7 +9462,6 @@ an RTSP connection. Sets if and how the stream clock should be published according to RFC7273. - @@ -10079,7 +9479,6 @@ an RTSP connection. Define whether @stream will follow the Rate-Control=no behaviour as specified in the ONVIF replay spec. - @@ -10094,7 +9493,6 @@ in the ONVIF replay spec. Set the payload type (pt) for retransmission of this stream. - @@ -10111,7 +9509,6 @@ in the ONVIF replay spec. Set the amount of time to store retransmission packets. - @@ -10127,7 +9524,6 @@ in the ONVIF replay spec. - @@ -10143,7 +9539,6 @@ in the ONVIF replay spec. Sets the amount of redundancy to apply when creating ULPFEC protection packets. - @@ -10158,7 +9553,6 @@ protection packets. Set the payload type to be used for ULPFEC protection packets - @@ -10186,7 +9580,6 @@ will also be added with an additional ref to the result #GList of this function.. When @func is %NULL, #GST_RTSP_FILTER_REF will be assumed for each transport. - a #GList with all transports for which @func returned #GST_RTSP_FILTER_REF. After usage, each @@ -10211,7 +9604,6 @@ element in the #GList should be unreffed before the list is freed. - @@ -10226,7 +9618,6 @@ element in the #GList should be unreffed before the list is freed. for @ssrc did not exist, it will be added. If information for @ssrc existed, it will be replaced. If @crypto is %NULL, it will be removed from @stream. - %TRUE if @crypto could be updated @@ -10248,7 +9639,6 @@ be removed from @stream. Check if the requested multicast ttl value is allowed. - TRUE if the requested ttl value is allowed. @@ -10316,7 +9706,6 @@ be removed from @stream. - @@ -10326,16 +9715,12 @@ be removed from @stream. - - - + A Transport description for a stream - Create a new #GstRTSPStreamTransport that can be used to manage @stream with transport @tr. - a new #GstRTSPStreamTransport @@ -10353,7 +9738,6 @@ be removed from @stream. Get the RTP-Info string for @trans and @start_time. - the RTPInfo string for @trans and @start_time or %NULL when the RTP-Info could not be @@ -10373,7 +9757,6 @@ determined. g_free() after usage. Get the #GstRTSPStream used when constructing @trans. - the stream used when constructing @trans. @@ -10387,7 +9770,6 @@ determined. g_free() after usage. Get the transport configured in @trans. - the transport configured in @trans. It remains valid for as long as @trans is valid. @@ -10402,7 +9784,6 @@ valid for as long as @trans is valid. Get the url configured in @trans. - the url configured in @trans. It remains valid for as long as @trans is valid. @@ -10417,7 +9798,6 @@ It remains valid for as long as @trans is valid. Check if @trans is timed out. - %TRUE if @trans timed out. @@ -10431,7 +9811,6 @@ It remains valid for as long as @trans is valid. Signal the installed keep_alive callback for @trans. - @@ -10444,7 +9823,6 @@ It remains valid for as long as @trans is valid. Signal the installed message_sent / message_sent_full callback for @trans. - @@ -10457,7 +9835,6 @@ It remains valid for as long as @trans is valid. Receive @buffer on @channel @trans. - a #GstFlowReturn. Returns GST_FLOW_NOT_LINKED when @channel is not configured in the transport of @trans. @@ -10480,7 +9857,6 @@ It remains valid for as long as @trans is valid. Send @buffer to the installed RTCP callback for @trans. - %TRUE on success @@ -10498,7 +9874,6 @@ It remains valid for as long as @trans is valid. Send @buffer_list to the installed RTCP callback for @trans. - %TRUE on success @@ -10516,7 +9891,6 @@ It remains valid for as long as @trans is valid. Send @buffer to the installed RTP callback for @trans. - %TRUE on success @@ -10534,7 +9908,6 @@ It remains valid for as long as @trans is valid. Send @buffer_list to the installed RTP callback for @trans. - %TRUE on success @@ -10552,7 +9925,6 @@ It remains valid for as long as @trans is valid. Activate or deactivate datatransfer configured in @trans. - %TRUE when the state was changed. @@ -10571,7 +9943,6 @@ It remains valid for as long as @trans is valid. Install callbacks that will be called when data for a stream should be sent to a client. This is usually used when sending RTP/RTCP over TCP. - @@ -10601,7 +9972,6 @@ to a client. This is usually used when sending RTP/RTCP over TCP. Install callbacks that will be called when RTCP packets are received from the receiver of @trans. - @@ -10627,7 +9997,6 @@ receiver of @trans. Install callbacks that will be called when data for a stream should be sent to a client. This is usually used when sending RTP/RTCP over TCP. - @@ -10656,7 +10025,6 @@ to a client. This is usually used when sending RTP/RTCP over TCP. Install a callback that will be called when a message has been sent on @trans. - @@ -10681,7 +10049,6 @@ to a client. This is usually used when sending RTP/RTCP over TCP. Install a callback that will be called when a message has been sent on @trans. - @@ -10706,7 +10073,6 @@ to a client. This is usually used when sending RTP/RTCP over TCP. Set the timed out state of @trans to @timedout - @@ -10724,7 +10090,6 @@ to a client. This is usually used when sending RTP/RTCP over TCP. Set @tr as the client transport. This function takes ownership of the passed @tr. - @@ -10741,7 +10106,6 @@ passed @tr. Set @url as the client url. - @@ -10770,7 +10134,6 @@ passed @tr. - @@ -10792,7 +10155,6 @@ A return value of #GST_RTSP_FILTER_KEEP will leave @trans untouched in A value of #GST_RTSP_FILTER_REF will add @trans to the result #GList of gst_rtsp_stream_transport_filter(). - a #GstRTSPFilterResult. @@ -10812,9 +10174,7 @@ gst_rtsp_stream_transport_filter(). - - - + The suspend mode of the media pipeline. A media pipeline is suspended right after creating the SDP and when the client performs a PAUSED request. @@ -10830,7 +10190,6 @@ after creating the SDP and when the client performs a PAUSED request. Structure holding info about a mainloop running in a thread - parent #GstMiniObject @@ -10849,7 +10208,6 @@ after creating the SDP and when the client performs a PAUSED request. Create a new thread object that can run a mainloop. - a #GstRTSPThread. @@ -10863,7 +10221,6 @@ after creating the SDP and when the client performs a PAUSED request. Reuse the mainloop of @thread - %TRUE if the mainloop could be reused @@ -10878,7 +10235,6 @@ after creating the SDP and when the client performs a PAUSED request. Stop and unref @thread. When no threads are using the mainloop, the thread will be stopped and the final ref to @thread will be released. - @@ -10892,10 +10248,8 @@ will be stopped and the final ref to @thread will be released. The thread pool structure. - Create a new #GstRTSPThreadPool instance. - a new #GstRTSPThreadPool @@ -10905,13 +10259,11 @@ will be stopped and the final ref to @thread will be released. Wait for all tasks to be stopped and free all allocated resources. This is mainly used in test suites to ensure proper cleanup of internal data structures. - - @@ -10929,7 +10281,6 @@ structures. Get a new #GstRTSPThread for @type and @ctx. - a new #GstRTSPThread, gst_rtsp_thread_stop() after usage @@ -10951,7 +10302,6 @@ gst_rtsp_thread_stop() after usage - @@ -10965,7 +10315,6 @@ gst_rtsp_thread_stop() after usage - @@ -10981,7 +10330,6 @@ gst_rtsp_thread_stop() after usage Get the maximum number of threads used for client connections. See gst_rtsp_thread_pool_set_max_threads(). - the maximum number of threads. @@ -10995,7 +10343,6 @@ See gst_rtsp_thread_pool_set_max_threads(). Get a new #GstRTSPThread for @type and @ctx. - a new #GstRTSPThread, gst_rtsp_thread_stop() after usage @@ -11020,7 +10367,6 @@ gst_rtsp_thread_stop() after usage Set the maximum threads used by the pool to handle client requests. A value of 0 will use the pool mainloop, a value of -1 will use an unlimited number of threads. - @@ -11052,7 +10398,6 @@ unlimited number of threads. Class for managing threads. - @@ -11062,7 +10407,6 @@ unlimited number of threads. - a new #GstRTSPThread, gst_rtsp_thread_stop() after usage @@ -11086,7 +10430,6 @@ gst_rtsp_thread_stop() after usage - @@ -11105,7 +10448,6 @@ gst_rtsp_thread_stop() after usage - @@ -11121,7 +10463,6 @@ gst_rtsp_thread_stop() after usage - @@ -11141,12 +10482,9 @@ gst_rtsp_thread_stop() after usage - - - + Different thread types - a thread to handle the client communication @@ -11157,14 +10495,12 @@ gst_rtsp_thread_stop() after usage An opaque object used for checking authorisations. It is generated after successful authentication. - Create a new Authorization token with the given fieldnames and values. Arguments are given similar to gst_structure_new(). - a new authorization token. @@ -11182,7 +10518,6 @@ Arguments are given similar to gst_structure_new(). Create a new empty Authorization token. - a new empty authorization token. @@ -11191,7 +10526,6 @@ Arguments are given similar to gst_structure_new(). Create a new Authorization token with the given fieldnames and values. Arguments are given similar to gst_structure_new_valist(). - a new authorization token. @@ -11209,7 +10543,6 @@ Arguments are given similar to gst_structure_new_valist(). Get the string value of @field in @token. - the string value of @field in @token or %NULL when @field is not defined in @token. The string @@ -11229,7 +10562,6 @@ becomes invalid when you free @token. Access the structure of the token. - The structure of the token. The structure is still owned by the token, which means that you should not free it and that the @@ -11247,7 +10579,6 @@ MT safe. Check if @token has a boolean @field and if it is set to %TRUE. - %TRUE if @token has a boolean field named @field set to %TRUE. @@ -11265,7 +10596,6 @@ MT safe. Sets a boolean value on @token. - @@ -11286,7 +10616,6 @@ MT safe. Sets a string value on @token. - @@ -11307,7 +10636,6 @@ MT safe. Get a writable version of the structure. - The structure of the token. The structure is still owned by the token, which means that you should not free it and that the @@ -11335,7 +10663,6 @@ MT safe. - @@ -11344,52 +10671,44 @@ MT safe. Used with gst_rtsp_address_pool_add_range() to bind to all IPv4 addresses - Used with gst_rtsp_address_pool_add_range() to bind to all IPv6 addresses - - - - - - - @@ -11397,386 +10716,329 @@ IPv6 addresses Check a new connection - Check if access is allowed to a factory. When access is not allowed an 404 Not Found is sent in the response. - Check if media can be constructed from a media factory A response should be sent on error. - Check if the client can specify TTL, destination and port pair in multicast. No response is sent when the check returns %FALSE. - Check the URL and methods - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -11785,290 +11047,248 @@ port pair in multicast. No response is sent when the check returns G_TYPE_BOOLEAN, %TRUE if the media can be accessed, %FALSE will return a 404 Not Found error when trying to access the media. - G_TYPE_BOOLEAN, %TRUE if the media can be constructed, %FALSE will return a 404 Not Found error when trying to access the media. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -12080,17 +11300,14 @@ return a 404 Not Found error when trying to access the media. The default #GstRTSPAuth object uses this string in the token to find the role of the media factory. It will then retrieve the #GstRTSPPermissions of the media factory and retrieve the role with the same name. - G_TYPE_BOOLEAN, %TRUE if the client can specify TTL, destination and port pair in multicast. - - @@ -12481,21 +11698,18 @@ Last reviewed on 2013-07-15 (1.0.0) Get the current #GstRTSPContext. This object is retrieved from the current thread that is handling the request for a client. - a #GstRTSPContext - Get parameters (not implemented yet) - a #GstRTSPResult @@ -12513,7 +11727,6 @@ current thread that is handling the request for a client. Set parameters (not implemented yet) - a #GstRTSPResult @@ -12532,7 +11745,6 @@ current thread that is handling the request for a client. Add @media specific info to @sdp. @info is used to configure the connection information in the SDP. - TRUE on success. @@ -12554,7 +11766,6 @@ information in the SDP. Add info from @stream to @sdp. - TRUE on success. @@ -12576,7 +11787,6 @@ information in the SDP. Creates a #GstSDPMedia from the parameters and stores it in @sdp. - %TRUE on success diff --git a/gir-files/GstSdp-1.0.gir b/gir-files/GstSdp-1.0.gir index e5b0d5491..92b7fc954 100644 --- a/gir-files/GstSdp-1.0.gir +++ b/gir-files/GstSdp-1.0.gir @@ -9,7 +9,6 @@ and/or use gtk-doc annotations. --> The different cache types - The envelope key MUST NOT be cached @@ -21,12 +20,9 @@ and/or use gtk-doc annotations. --> to be used for the specific CSB. - - - + The encryption algorithm used to encrypt the Encr data field - no encryption @@ -40,12 +36,9 @@ and/or use gtk-doc annotations. --> AES-GCM using a 128-bit key (Since: 1.16) - - - + The key validity type - No specific usage rule @@ -58,7 +51,6 @@ and/or use gtk-doc annotations. --> The type of key. - a TEK Generation Key @@ -68,7 +60,6 @@ and/or use gtk-doc annotations. --> Specifies the authentication algorithm used - no authentication @@ -78,7 +69,6 @@ and/or use gtk-doc annotations. --> The Security policy Map item for SRTP - The security policy applied for the stream with @ssrc @@ -95,14 +85,12 @@ and/or use gtk-doc annotations. --> Specifies the method of uniquely mapping Crypto Sessions to the security protocol sessions. - SRTP Structure holding the information of the MIKEY message - @@ -144,7 +132,6 @@ protocol sessions. Make a new MIKEY message. - a new #GstMIKEYMessage on success @@ -152,7 +139,6 @@ protocol sessions. Make a new #GstMIKEYMessage from @bytes. - a new #GstMIKEYMessage @@ -173,7 +159,6 @@ protocol sessions. - Security Policy Payload - Key Data Transport Payload - Key Data Sub-Payload - a #GstMIKEYMessage, or %NULL if there is no srtp information in the caps. @@ -189,7 +174,6 @@ or %NULL if there is no srtp information in the caps. Parse @size bytes from @data into a #GstMIKEYMessage. @info contains the parameters to decrypt and verify the data. - a #GstMIKEYMessage on success or %NULL when parsing failed and @error will be set. @@ -214,7 +198,6 @@ parameters to decrypt and verify the data. Add a Crypto policy for SRTP to @msg. - %TRUE on success @@ -240,7 +223,6 @@ parameters to decrypt and verify the data. Add a new payload to @msg. - %TRUE on success @@ -258,7 +240,6 @@ parameters to decrypt and verify the data. Add a new PKE payload to @msg with the given parameters. - %TRUE on success @@ -286,7 +267,6 @@ parameters to decrypt and verify the data. Add a new RAND payload to @msg with the given parameters. - %TRUE on success @@ -310,7 +290,6 @@ parameters to decrypt and verify the data. Add a new RAND payload to @msg with @len random bytes. - %TRUE on success @@ -328,7 +307,6 @@ parameters to decrypt and verify the data. Add a new T payload to @msg with the given parameters. - %TRUE on success @@ -353,7 +331,6 @@ parameters to decrypt and verify the data. Add a new T payload to @msg that contains the current time in NTP-UTC format. - %TRUE on success @@ -366,7 +343,6 @@ in NTP-UTC format. - a #gchar, base64-encoded data @@ -380,7 +356,6 @@ in NTP-UTC format. Find the @nth occurrence of the payload with @type in @msg. - the @nth #GstMIKEYPayload of @type. @@ -402,7 +377,6 @@ in NTP-UTC format. Get the policy information of @msg at @idx. - a #GstMIKEYMapSRTP @@ -420,7 +394,6 @@ in NTP-UTC format. Get the number of crypto sessions in @msg. - the number of crypto sessions @@ -434,7 +407,6 @@ in NTP-UTC format. Get the number of payloads in @msg. - the number of payloads in @msg @@ -448,7 +420,6 @@ in NTP-UTC format. Get the #GstMIKEYPayload at @idx in @msg - the #GstMIKEYPayload at @idx. The payload remains valid for as long as it is part of @msg. @@ -469,7 +440,6 @@ remains valid for as long as it is part of @msg. Insert a Crypto Session map for SRTP in @msg at @idx When @idx is -1, the policy will be appended. - %TRUE on success @@ -492,7 +462,6 @@ When @idx is -1, the policy will be appended. Insert the @payload at index @idx in @msg. If @idx is -1, the payload will be appended to @msg. - %TRUE on success @@ -514,7 +483,6 @@ will be appended to @msg. Remove the SRTP policy at @idx. - %TRUE on success @@ -532,7 +500,6 @@ will be appended to @msg. Remove the payload in @msg at @idx - %TRUE on success @@ -550,7 +517,6 @@ will be appended to @msg. Replace a Crypto Session map for SRTP in @msg at @idx with @map. - %TRUE on success @@ -572,7 +538,6 @@ will be appended to @msg. Replace the payload at @idx in @msg with @payload. - %TRUE on success @@ -594,7 +559,6 @@ will be appended to @msg. Set the information in @msg. - %TRUE on success @@ -632,7 +596,6 @@ will be appended to @msg. Convert @msg to a #GBytes. - a new #GBytes for @msg. @@ -649,7 +612,6 @@ will be appended to @msg. - %TRUE on success @@ -668,14 +630,12 @@ will be appended to @msg. The PRF function that has been/will be used for key derivation - MIKEY-1 PRF function Hold the common fields for all payloads - @@ -689,7 +649,6 @@ will be appended to @msg. Make a new #GstMIKEYPayload with @type. - a new #GstMIKEYPayload or %NULL on failure. @@ -703,7 +662,6 @@ will be appended to @msg. Add a new sub payload to @payload. - %TRUE on success. @@ -722,7 +680,6 @@ will be appended to @msg. Get the number of sub payloads of @payload. @payload should be of type %GST_MIKEY_PT_KEMAC. - the number of sub payloads in @payload @@ -737,7 +694,6 @@ will be appended to @msg. Get the sub payload of @payload at @idx. @payload should be of type %GST_MIKEY_PT_KEMAC. - the #GstMIKEYPayload at @idx. @@ -755,7 +711,6 @@ will be appended to @msg. Remove the sub payload at @idx in @payload. - %TRUE on success. @@ -774,7 +729,6 @@ will be appended to @msg. Set the KEMAC parameters. @payload should point to a %GST_MIKEY_PT_KEMAC payload. - %TRUE on success @@ -796,7 +750,6 @@ payload. Set the key validity period in the %GST_MIKEY_PT_KEY_DATA @payload. - %TRUE on success @@ -831,7 +784,6 @@ payload. Set @key_len bytes of @key_data of type @key_type as the key for the %GST_MIKEY_PT_KEY_DATA @payload. - %TRUE on success @@ -860,7 +812,6 @@ payload. Set the salt key data. If @salt_len is 0 and @salt_data is %NULL, the salt data will be removed. - %TRUE on success @@ -884,7 +835,6 @@ salt data will be removed. Set the SPI/MKI validity in the %GST_MIKEY_PT_KEY_DATA @payload. - %TRUE on success @@ -909,7 +859,6 @@ salt data will be removed. Set the PKE values in @payload. @payload must be of type %GST_MIKEY_PT_PKE. - %TRUE on success @@ -937,7 +886,6 @@ salt data will be removed. Set the random values in a %GST_MIKEY_PT_RAND @payload. - %TRUE on success @@ -962,7 +910,6 @@ salt data will be removed. Add a new parameter to the %GST_MIKEY_PT_SP @payload with @type, @len and @val. - %TRUE on success @@ -991,7 +938,6 @@ and @val. Get the number of security policy parameters in a %GST_MIKEY_PT_SP @payload. - the number of parameters in @payload @@ -1006,7 +952,6 @@ and @val. Get the Security Policy parameter in a %GST_MIKEY_PT_SP @payload at @idx. - the #GstMIKEYPayloadSPParam at @idx in @payload @@ -1025,7 +970,6 @@ at @idx. Remove the Security Policy parameters from a %GST_MIKEY_PT_SP @payload at @idx. - %TRUE on success @@ -1043,7 +987,6 @@ at @idx. Set the Security Policy parameters for @payload. - %TRUE on success @@ -1065,7 +1008,6 @@ at @idx. Set the timestamp in a %GST_MIKEY_PT_T @payload. - %TRUE on success @@ -1090,7 +1032,6 @@ at @idx. A structure holding the KEMAC payload - the common #GstMIKEYPayload @@ -1113,7 +1054,6 @@ at @idx. The Key data payload contains key material. It should be added as sub payload to the KEMAC. - the payload header @@ -1160,7 +1100,6 @@ payload to the KEMAC. used in the public-key transport to protect the data in the Key data transport payload. The encryption algorithm used is implicit from the certificate/public key used. - the common #GstMIKEYPayload @@ -1180,7 +1119,6 @@ the certificate/public key used. The RAND payload consists of a (pseudo-)random bit-string - the payload header @@ -1197,7 +1135,6 @@ the certificate/public key used. The Security Policy payload defines a set of policies that apply to a specific security protocol - the payload header @@ -1219,7 +1156,6 @@ specific security protocol A Type/Length/Value field for security parameters - specifies the type of the parameter @@ -1235,7 +1171,6 @@ specific security protocol The timestamp payload carries the timestamp information - the payload header @@ -1251,7 +1186,6 @@ specific security protocol Different MIKEY Payload types. - Last payload @@ -1300,14 +1234,12 @@ specific security protocol Specifies the security protocol - SRTP This policy specifies the parameters for SRTP and SRTCP - Encryption algorithm @@ -1353,7 +1285,6 @@ specific security protocol Specifies the timestamp type. - an NTP time in UTC timezone @@ -1366,7 +1297,6 @@ specific security protocol Different MIKEY data types. - Invalid type @@ -1394,12 +1324,10 @@ specific security protocol The supported MIKEY version 1. - The contents of the SDP "a=" field which contains a key/value pair. - the attribute key @@ -1410,7 +1338,6 @@ specific security protocol Clear the attribute. - @GST_SDP_OK. @@ -1424,7 +1351,6 @@ specific security protocol Set the attribute with @key and @value. - @GST_SDP_OK. @@ -1448,7 +1374,6 @@ specific security protocol The contents of the SDP "b=" field which specifies the proposed bandwidth to be used by the session or media. - the bandwidth modifier type @@ -1459,7 +1384,6 @@ be used by the session or media. Reset the bandwidth information in @bw. - a #GstSDPResult. @@ -1473,7 +1397,6 @@ be used by the session or media. Set bandwidth information in @bw. - a #GstSDPResult. @@ -1496,7 +1419,6 @@ be used by the session or media. The contents of the SDP "c=" field which contains connection data. - the type of network. "IN" is defined to have the meaning "Internet". @@ -1520,7 +1442,6 @@ be used by the session or media. Clear the connection. - @GST_SDP_OK. @@ -1534,7 +1455,6 @@ be used by the session or media. Set the connection with the given parameters. - @GST_SDP_OK. @@ -1571,7 +1491,6 @@ be used by the session or media. The contents of the SDP "k=" field which is used to convey encryption keys. - the encryption type @@ -1583,7 +1502,6 @@ keys. The contents of the SDP "m=" field with all related fields. - the media type @@ -1634,7 +1552,6 @@ keys. Add the attribute with @key and @value to @media. - #GST_SDP_OK. @@ -1656,7 +1573,6 @@ keys. Add the bandwidth information with @bwtype and @bandwidth to @media. - #GST_SDP_OK. @@ -1678,7 +1594,6 @@ keys. Add the given connection parameters to @media. - a #GstSDPResult. @@ -1713,7 +1628,6 @@ keys. Add the format information to @media. - #GST_SDP_OK. @@ -1731,7 +1645,6 @@ keys. Convert the contents of @media to a text string. - A dynamically allocated string representing the media. @@ -1745,7 +1658,6 @@ keys. Get the number of attribute fields in @media. - the number of attributes in @media. @@ -1759,7 +1671,6 @@ keys. Mapping of attributes of #GstSDPMedia to #GstCaps - a #GstSDPResult. @@ -1777,7 +1688,6 @@ keys. Get the number of bandwidth fields in @media. - the number of bandwidths in @media. @@ -1791,7 +1701,6 @@ keys. Get the number of connection fields in @media. - the number of connections in @media. @@ -1806,7 +1715,6 @@ keys. Allocate a new copy of @media and store the result in @copy. The value in @copy should be release with gst_sdp_media_free function. - a #GstSDPResult @@ -1824,7 +1732,6 @@ keys. Get the number of formats in @media. - the number of formats in @media. @@ -1840,7 +1747,6 @@ keys. Free all resources allocated by @media. @media should not be used anymore after this function. This function should be used when @media was dynamically allocated with gst_sdp_media_new(). - a #GstSDPResult. @@ -1854,7 +1760,6 @@ allocated with gst_sdp_media_new(). Get the attribute at position @idx in @media. - the #GstSDPAttribute at position @idx. @@ -1872,7 +1777,6 @@ allocated with gst_sdp_media_new(). Get the first attribute value for @key in @media. - the first attribute value for @key. @@ -1890,7 +1794,6 @@ allocated with gst_sdp_media_new(). Get the @nth attribute value for @key in @media. - the @nth attribute value. @@ -1912,7 +1815,6 @@ allocated with gst_sdp_media_new(). Get the bandwidth at position @idx in @media. - the #GstSDPBandwidth at position @idx. @@ -1938,7 +1840,6 @@ a=framesize:(payload) (width)-(height) a=fmtp:(payload) (param)[=(value)];... Note that the extmap attribute is set only by gst_sdp_media_attributes_to_caps(). - a #GstCaps, or %NULL if an error happened @@ -1956,7 +1857,6 @@ Note that the extmap attribute is set only by gst_sdp_media_attributes_to_caps() Get the connection at position @idx in @media. - the #GstSDPConnection at position @idx. @@ -1974,7 +1874,6 @@ Note that the extmap attribute is set only by gst_sdp_media_attributes_to_caps() Get the format information at position @idx in @media. - the format at position @idx. @@ -1992,7 +1891,6 @@ Note that the extmap attribute is set only by gst_sdp_media_attributes_to_caps() Get the information of @media - the information of @media. @@ -2006,7 +1904,6 @@ Note that the extmap attribute is set only by gst_sdp_media_attributes_to_caps() Get the encryption information from @media. - a #GstSDPKey. @@ -2020,7 +1917,6 @@ Note that the extmap attribute is set only by gst_sdp_media_attributes_to_caps() Get the media description of @media. - the media description. @@ -2034,7 +1930,6 @@ Note that the extmap attribute is set only by gst_sdp_media_attributes_to_caps() Get the number of ports for @media. - the number of ports for @media. @@ -2048,7 +1943,6 @@ Note that the extmap attribute is set only by gst_sdp_media_attributes_to_caps() Get the port number for @media. - the port number of @media. @@ -2062,7 +1956,6 @@ Note that the extmap attribute is set only by gst_sdp_media_attributes_to_caps() Get the transport protocol of @media - the transport protocol of @media. @@ -2081,7 +1974,6 @@ allocated on the stack. gst_sdp_media_uninit() undoes this operation. When this function is invoked on newly allocated data (with malloc or on the stack), its contents should be set to 0 before calling this function. - a #GstSDPResult. @@ -2096,7 +1988,6 @@ stack), its contents should be set to 0 before calling this function. Insert the attribute to @media at @idx. When @idx is -1, the attribute is appended. - #GST_SDP_OK. @@ -2119,7 +2010,6 @@ the attribute is appended. Insert the bandwidth information to @media at @idx. When @idx is -1, the bandwidth is appended. - #GST_SDP_OK. @@ -2142,7 +2032,6 @@ the bandwidth is appended. Insert the connection information to @media at @idx. When @idx is -1, the connection is appended. - #GST_SDP_OK. @@ -2165,7 +2054,6 @@ the connection is appended. Insert the format information to @media at @idx. When @idx is -1, the format is appended. - #GST_SDP_OK. @@ -2188,7 +2076,6 @@ the format is appended. Creates a new #GstMIKEYMessage after parsing the key-mgmt attribute from a #GstSDPMedia. - a #GstSDPResult. @@ -2206,7 +2093,6 @@ from a #GstSDPMedia. Remove the attribute in @media at @idx. - #GST_SDP_OK. @@ -2224,7 +2110,6 @@ from a #GstSDPMedia. Remove the bandwidth information in @media at @idx. - #GST_SDP_OK. @@ -2242,7 +2127,6 @@ from a #GstSDPMedia. Remove the connection information in @media at @idx. - #GST_SDP_OK. @@ -2260,7 +2144,6 @@ from a #GstSDPMedia. Remove the format information in @media at @idx. - #GST_SDP_OK. @@ -2278,7 +2161,6 @@ from a #GstSDPMedia. Replace the attribute in @media at @idx with @attr. - #GST_SDP_OK. @@ -2300,7 +2182,6 @@ from a #GstSDPMedia. Replace the bandwidth information in @media at @idx with @bw. - #GST_SDP_OK. @@ -2322,7 +2203,6 @@ from a #GstSDPMedia. Replace the connection information in @media at @idx with @conn. - #GST_SDP_OK. @@ -2344,7 +2224,6 @@ from a #GstSDPMedia. Replace the format information in @media at @idx with @format. - #GST_SDP_OK. @@ -2366,7 +2245,6 @@ from a #GstSDPMedia. Set the media information of @media to @information. - #GST_SDP_OK. @@ -2384,7 +2262,6 @@ from a #GstSDPMedia. Adds the encryption information to @media. - a #GstSDPResult. @@ -2406,7 +2283,6 @@ from a #GstSDPMedia. Set the media description of @media to @med. - #GST_SDP_OK. @@ -2424,7 +2300,6 @@ from a #GstSDPMedia. Set the port information in @media. - #GST_SDP_OK. @@ -2446,7 +2321,6 @@ from a #GstSDPMedia. Set the media transport protocol of @media to @proto. - #GST_SDP_OK. @@ -2466,7 +2340,6 @@ from a #GstSDPMedia. Free all resources allocated in @media. @media should not be used anymore after this function. This function should be used when @media was allocated on the stack and initialized with gst_sdp_media_init(). - a #GstSDPResult. @@ -2480,7 +2353,6 @@ stack and initialized with gst_sdp_media_init(). Allocate a new GstSDPMedia and store the result in @media. - a #GstSDPResult. @@ -2504,7 +2376,6 @@ a=fmtp:(payload) (param)[=(value)];... a=rtcp-fb:(payload) (param1) [param2]... a=extmap:(id)[/direction] (extensionname) (extensionattributes) - a #GstSDPResult. @@ -2524,7 +2395,6 @@ a=extmap:(id)[/direction] (extensionname) (extensionattributes) The GstSDPMessage helper functions makes it easy to parse and create SDP messages. - the protocol version @@ -2597,7 +2467,6 @@ messages. Add the attribute with @key and @value to @msg. - @GST_SDP_OK. @@ -2619,7 +2488,6 @@ messages. Add the specified bandwidth information to @msg. - a #GstSDPResult. @@ -2641,7 +2509,6 @@ messages. Add @email to the list of emails in @msg. - a #GstSDPResult. @@ -2661,7 +2528,6 @@ messages. Adds @media to the array of medias in @msg. This function takes ownership of the contents of @media so that @media will have to be reinitialized with gst_sdp_media_init() before it can be used again. - a #GstSDPResult. @@ -2679,7 +2545,6 @@ gst_sdp_media_init() before it can be used again. Add @phone to the list of phones in @msg. - a #GstSDPResult. @@ -2697,7 +2562,6 @@ gst_sdp_media_init() before it can be used again. Add time information @start and @stop to @msg. - a #GstSDPResult. @@ -2725,7 +2589,6 @@ gst_sdp_media_init() before it can be used again. Add time zone information to @msg. - a #GstSDPResult. @@ -2747,7 +2610,6 @@ gst_sdp_media_init() before it can be used again. Convert the contents of @msg to a text string. - A dynamically allocated string representing the SDP description. @@ -2761,7 +2623,6 @@ gst_sdp_media_init() before it can be used again. Get the number of attributes in @msg. - the number of attributes in @msg. @@ -2775,7 +2636,6 @@ gst_sdp_media_init() before it can be used again. Mapping of attributes of #GstSDPMessage to #GstCaps - a #GstSDPResult. @@ -2793,7 +2653,6 @@ gst_sdp_media_init() before it can be used again. Get the number of bandwidth information in @msg. - the number of bandwidth information in @msg. @@ -2808,7 +2667,6 @@ gst_sdp_media_init() before it can be used again. Allocate a new copy of @msg and store the result in @copy. The value in @copy should be release with gst_sdp_message_free function. - a #GstSDPResult @@ -2826,7 +2684,6 @@ gst_sdp_media_init() before it can be used again. Dump the parsed contents of @msg to stdout. - a #GstSDPResult. @@ -2840,7 +2697,6 @@ gst_sdp_media_init() before it can be used again. Get the number of emails in @msg. - the number of emails in @msg. @@ -2856,7 +2712,6 @@ gst_sdp_media_init() before it can be used again. Free all resources allocated by @msg. @msg should not be used anymore after this function. This function should be used when @msg was dynamically allocated with gst_sdp_message_new(). - a #GstSDPResult. @@ -2870,7 +2725,6 @@ allocated with gst_sdp_message_new(). Get the attribute at position @idx in @msg. - the #GstSDPAttribute at position @idx. @@ -2888,7 +2742,6 @@ allocated with gst_sdp_message_new(). Get the first attribute with key @key in @msg. - the attribute value of the first attribute with @key. @@ -2906,7 +2759,6 @@ allocated with gst_sdp_message_new(). Get the @nth attribute with key @key in @msg. - the attribute value of the @nth attribute with @key. @@ -2928,7 +2780,6 @@ allocated with gst_sdp_message_new(). Get the bandwidth at index @idx from @msg. - a #GstSDPBandwidth. @@ -2946,7 +2797,6 @@ allocated with gst_sdp_message_new(). Get the connection of @msg. - a #GstSDPConnection. The result remains valid as long as @msg is valid. @@ -2960,7 +2810,6 @@ allocated with gst_sdp_message_new(). Get the email with number @idx from @msg. - the email at position @idx. @@ -2978,7 +2827,6 @@ allocated with gst_sdp_message_new(). Get the information in @msg. - a #GstSDPResult. @@ -2992,7 +2840,6 @@ allocated with gst_sdp_message_new(). Get the encryption information from @msg. - a #GstSDPKey. @@ -3006,7 +2853,6 @@ allocated with gst_sdp_message_new(). Get the media description at index @idx in @msg. - a #GstSDPMedia. @@ -3024,7 +2870,6 @@ allocated with gst_sdp_message_new(). Get the origin of @msg. - a #GstSDPOrigin. The result remains valid as long as @msg is valid. @@ -3038,7 +2883,6 @@ allocated with gst_sdp_message_new(). Get the phone with number @idx from @msg. - the phone at position @idx. @@ -3056,7 +2900,6 @@ allocated with gst_sdp_message_new(). Get the session name in @msg. - a #GstSDPResult. @@ -3070,7 +2913,6 @@ allocated with gst_sdp_message_new(). Get time information with index @idx from @msg. - a #GstSDPTime. @@ -3088,7 +2930,6 @@ allocated with gst_sdp_message_new(). Get the URI in @msg. - a #GstSDPResult. @@ -3102,7 +2943,6 @@ allocated with gst_sdp_message_new(). Get the version in @msg. - a #GstSDPResult. @@ -3116,7 +2956,6 @@ allocated with gst_sdp_message_new(). Get time zone information with index @idx from @msg. - a #GstSDPZone. @@ -3139,7 +2978,6 @@ allocated on the stack. gst_sdp_message_uninit() undoes this operation. When this function is invoked on newly allocated data (with malloc or on the stack), its contents should be set to 0 before calling this function. - a #GstSDPResult. @@ -3155,7 +2993,6 @@ stack), its contents should be set to 0 before calling this function. Insert attribute into the array of attributes in @msg at index @idx. When -1 is given as @idx, the attribute is inserted at the end. - a #GstSDPResult. @@ -3179,7 +3016,6 @@ When -1 is given as @idx, the attribute is inserted at the end. Insert bandwidth parameters into the array of bandwidths in @msg at index @idx. When -1 is given as @idx, the bandwidth is inserted at the end. - a #GstSDPResult. @@ -3202,7 +3038,6 @@ When -1 is given as @idx, the bandwidth is inserted at the end. Insert @email into the array of emails in @msg at index @idx. When -1 is given as @idx, the email is inserted at the end. - a #GstSDPResult. @@ -3225,7 +3060,6 @@ When -1 is given as @idx, the email is inserted at the end. Insert @phone into the array of phone numbers in @msg at index @idx. When -1 is given as @idx, the phone is inserted at the end. - a #GstSDPResult. @@ -3249,7 +3083,6 @@ When -1 is given as @idx, the phone is inserted at the end. Insert time parameters into the array of times in @msg at index @idx. When -1 is given as @idx, the times are inserted at the end. - a #GstSDPResult. @@ -3273,7 +3106,6 @@ When -1 is given as @idx, the times are inserted at the end. Insert zone parameters into the array of zones in @msg at index @idx. When -1 is given as @idx, the zone is inserted at the end. - a #GstSDPResult. @@ -3295,7 +3127,6 @@ When -1 is given as @idx, the zone is inserted at the end. Get the number of media descriptions in @msg. - the number of media descriptions in @msg. @@ -3310,7 +3141,6 @@ When -1 is given as @idx, the zone is inserted at the end. Creates a new #GstMIKEYMessage after parsing the key-mgmt attribute from a #GstSDPMessage. - a #GstSDPResult. @@ -3328,7 +3158,6 @@ from a #GstSDPMessage. Get the number of phones in @msg. - the number of phones in @msg. @@ -3342,7 +3171,6 @@ from a #GstSDPMessage. Remove the attribute in @msg at index @idx. - a #GstSDPResult. @@ -3360,7 +3188,6 @@ from a #GstSDPMessage. Remove the bandwidth information in @msg at index @idx. - a #GstSDPResult. @@ -3378,7 +3205,6 @@ from a #GstSDPMessage. Remove the email in @msg at index @idx. - a #GstSDPResult. @@ -3396,7 +3222,6 @@ from a #GstSDPMessage. Remove the phone number in @msg at index @idx. - a #GstSDPResult. @@ -3414,7 +3239,6 @@ from a #GstSDPMessage. Remove the time information in @msg at index @idx. - a #GstSDPResult. @@ -3432,7 +3256,6 @@ from a #GstSDPMessage. Remove the zone information in @msg at index @idx. - a #GstSDPResult. @@ -3450,7 +3273,6 @@ from a #GstSDPMessage. Replace the attribute in @msg at index @idx with @attr. - a #GstSDPResult. @@ -3472,7 +3294,6 @@ from a #GstSDPMessage. Replace the bandwidth information in @msg at index @idx with @bw. - a #GstSDPResult. @@ -3494,7 +3315,6 @@ from a #GstSDPMessage. Replace the email in @msg at index @idx with @email. - a #GstSDPResult. @@ -3516,7 +3336,6 @@ from a #GstSDPMessage. Replace the phone number in @msg at index @idx with @phone. - a #GstSDPResult. @@ -3538,7 +3357,6 @@ from a #GstSDPMessage. Replace the time information in @msg at index @idx with @t. - a #GstSDPResult. @@ -3560,7 +3378,6 @@ from a #GstSDPMessage. Replace the zone information in @msg at index @idx with @zone. - a #GstSDPResult. @@ -3582,7 +3399,6 @@ from a #GstSDPMessage. Configure the SDP connection in @msg with the given parameters. - a #GstSDPResult. @@ -3617,7 +3433,6 @@ from a #GstSDPMessage. Set the information in @msg. - a #GstSDPResult. @@ -3635,7 +3450,6 @@ from a #GstSDPMessage. Adds the encryption information to @msg. - a #GstSDPResult. @@ -3657,7 +3471,6 @@ from a #GstSDPMessage. Configure the SDP origin in @msg with the given parameters. - #GST_SDP_OK. @@ -3695,7 +3508,6 @@ from a #GstSDPMessage. Set the session name in @msg. - a #GstSDPResult. @@ -3713,7 +3525,6 @@ from a #GstSDPMessage. Set the URI in @msg. - a #GstSDPResult. @@ -3731,7 +3542,6 @@ from a #GstSDPMessage. Set the version in @msg. - a #GstSDPResult. @@ -3749,7 +3559,6 @@ from a #GstSDPMessage. Get the number of time information entries in @msg. - the number of time information entries in @msg. @@ -3765,7 +3574,6 @@ from a #GstSDPMessage. Free all resources allocated in @msg. @msg should not be used anymore after this function. This function should be used when @msg was allocated on the stack and initialized with gst_sdp_message_init(). - a #GstSDPResult. @@ -3779,7 +3587,6 @@ stack and initialized with gst_sdp_message_init(). Get the number of time zone information entries in @msg. - the number of time zone information entries in @msg. @@ -3797,7 +3604,6 @@ stack and initialized with gst_sdp_message_init(). \@scheme:///[#type=value *[&type=value]] Where each value is url encoded. - a uri for @msg. @@ -3815,7 +3621,6 @@ stack and initialized with gst_sdp_message_init(). Allocate a new GstSDPMessage and store the result in @msg. - a #GstSDPResult. @@ -3829,7 +3634,6 @@ stack and initialized with gst_sdp_message_init(). Parse @text and create a new SDPMessage from these. - a #GstSDPResult. @@ -3848,7 +3652,6 @@ stack and initialized with gst_sdp_message_init(). Parse the contents of @size bytes pointed to by @data and store the result in @msg. - #GST_SDP_OK on success. @@ -3880,7 +3683,6 @@ The uri should be of the form: where value is url encoded. This looslely resembles http://tools.ietf.org/html/draft-fujikawa-sdp-url-01 - #GST_SDP_OK on success. @@ -3901,7 +3703,6 @@ The uri should be of the form: The contents of the SDP "o=" field which gives the originator of the session (their username and the address of the user's host) plus a session id and session version number. - the user's login on the originating host, or it is "-" if the originating host does not support the concept of user ids. @@ -3934,7 +3735,6 @@ session version number. Return values for the SDP functions. - A successful return value @@ -3945,7 +3745,6 @@ session version number. The contents of the SDP "t=" field which specify the start and stop times for a conference session. - start time for the conference. The value is the decimal representation of Network Time Protocol (NTP) time values in seconds @@ -3964,7 +3763,6 @@ a conference session. Reset the time information in @t. - a #GstSDPResult. @@ -3978,7 +3776,6 @@ a conference session. Set time information @start, @stop and @repeat in @t. - a #GstSDPResult. @@ -4009,7 +3806,6 @@ a conference session. The contents of the SDP "z=" field which allows the sender to specify a list of time zone adjustments and offsets from the base time. - the NTP time that a time zone adjustment happens @@ -4020,7 +3816,6 @@ time. Reset the zone information in @zone. - a #GstSDPResult. @@ -4034,7 +3829,6 @@ time. Set zone information in @zone. - a #GstSDPResult. @@ -4057,43 +3851,35 @@ time. The Application-Specific Maximum bandwidth modifier. - The Conference Total bandwidth modifier. - The extension prefix bandwidth modifier. - RTCP bandwidth allocated to data receivers (RFC 3556). - RTCP bandwidth allocated to active data senders (RFC 3556). - Transport Independent Application Specific Maximum bandwidth (RFC 3890). - - - @@ -4105,7 +3891,6 @@ messages. Check if the given @addr is a multicast address. - TRUE when @addr is multicast. @@ -4127,7 +3912,6 @@ messages. Makes key management data - a #gchar key-mgmt data, @@ -4145,7 +3929,6 @@ messages. Allocate a new GstSDPMedia and store the result in @media. - a #GstSDPResult. @@ -4169,7 +3952,6 @@ a=fmtp:(payload) (param)[=(value)];... a=rtcp-fb:(payload) (param1) [param2]... a=extmap:(id)[/direction] (extensionname) (extensionattributes) - a #GstSDPResult. @@ -4191,7 +3973,6 @@ a=extmap:(id)[/direction] (extensionname) (extensionattributes) \@scheme:///[#type=value *[&type=value]] Where each value is url encoded. - a uri for @msg. @@ -4209,7 +3990,6 @@ a=extmap:(id)[/direction] (extensionname) (extensionattributes) Allocate a new GstSDPMessage and store the result in @msg. - a #GstSDPResult. @@ -4223,7 +4003,6 @@ a=extmap:(id)[/direction] (extensionname) (extensionattributes) Parse @text and create a new SDPMessage from these. - a #GstSDPResult. @@ -4242,7 +4021,6 @@ a=extmap:(id)[/direction] (extensionname) (extensionattributes) Parse the contents of @size bytes pointed to by @data and store the result in @msg. - #GST_SDP_OK on success. @@ -4274,7 +4052,6 @@ The uri should be of the form: where value is url encoded. This looslely resembles http://tools.ietf.org/html/draft-fujikawa-sdp-url-01 - #GST_SDP_OK on success. diff --git a/gir-files/GstTag-1.0.gir b/gir-files/GstTag-1.0.gir index 188061061..bd027ab08 100644 --- a/gir-files/GstTag-1.0.gir +++ b/gir-files/GstTag-1.0.gir @@ -9,35 +9,30 @@ and/or use gtk-doc annotations. --> - - - - - @@ -45,12 +40,10 @@ and/or use gtk-doc annotations. --> AcoustID Fingerprint (Chromaprint) - AcoustID Identifier - @@ -60,17 +53,14 @@ The allowed values are: "normal" "soft" "hard" - Digital zoom ratio used when capturing an image. (double) - Exposure compensation using when capturing an image in EV. (double) - @@ -80,7 +70,6 @@ The allowed values are: "auto-exposure" "manual-exposure" "auto-bracket" - @@ -96,7 +85,6 @@ The allowed values are: "action" - biased towards fast shutter speed "portrait" - closeup, leaving background out of focus "landscape" - landscape photos, background in focus - @@ -104,7 +92,6 @@ The allowed values are: Note that if this tag isn't present, it should not be assumed that the flash did not fire. It should be treated as unknown. - @@ -114,17 +101,14 @@ The allowed values are: "auto" "always" "never" - Focal length used when capturing an image, in mm. (double) - 35 mm equivalent focal length used when capturing an image, in mm. (double) - @@ -132,7 +116,6 @@ The allowed values are: The value stored is the denominator of the focal ratio (f-number). For example, if this tag value is 2, the focal ratio is f/2. - @@ -144,12 +127,10 @@ The allowed values are: "high-gain-up" "low-gain-down" "high-gain-down" - ISO speed used when capturing an image. (integer) - @@ -164,7 +145,6 @@ The allowed values are: "pattern" "partial" "other" - @@ -174,7 +154,6 @@ The allowed values are: "normal" "low-saturation" "high-saturation" - @@ -185,7 +164,6 @@ The allowed values are: "landscape" "portrait" "night-scene" - @@ -195,12 +173,10 @@ The allowed values are: "normal" "soft" "hard" - Shutter speed used when capturing an image, in seconds. (fraction) - @@ -212,7 +188,6 @@ Allowed values are: "transparent-scanner" "reflex-scanner" "other" - @@ -227,53 +202,43 @@ The allowed values are: "fluorescent" "fluorescent h" (newer daylight-calibrated fluorescents) "flash" - CDDB disc id in its short form (e.g. 'aa063d0f') - CDDB disc id including all details - Musicbrainz disc id (e.g. 'ahg7JUcfR3vCYBphSDIogOOWrr0-') - Musicbrainz disc id details - Annodex CMML clip element tag - Annodex CMML head element tag - Annodex CMML stream element tag - - - @@ -282,17 +247,14 @@ The allowed values are: ID3V2 header size considered minimum input for some functions such as gst_tag_list_from_id3v2_tag() and gst_tag_get_id3v2_tag_size() for example. - Media (image/video) intended horizontal pixel density in ppi. (double) - Media (image/video) intended vertical pixel density in ppi. (double) - @@ -303,67 +265,55 @@ represented with "b" and "#". Minor is represented as "m" (e.g. "Dbm"). Off key is represented with an "o" only. This notation might be extended in the future to support non-minor/major keys. - MusicBrainz album artist ID - MusicBrainz album ID - MusicBrainz artist ID - MusicBrainz Release Group ID - MusicBrainz Release Track ID - MusicBrainz track ID - MusicBrainz track TRM ID - - - - - @@ -399,9 +349,7 @@ Subclasses have to do four things: for the identify function to decide whether the stream has a supported tag or not. A class parsing ID3v1 tags, for example, would set min_end_size to 128 bytes. - - @@ -421,7 +369,6 @@ Subclasses have to do four things: - @@ -438,7 +385,6 @@ Subclasses have to do four things: - @@ -476,7 +422,6 @@ Subclasses have to do four things: The #GstTagDemuxClass structure. See documentation at beginning of section for details about what subclasses need to override and do. - the parent class. @@ -495,7 +440,6 @@ Subclasses should set this in their class_init function. - @@ -517,7 +461,6 @@ Subclasses should set this in their class_init function. - @@ -542,7 +485,6 @@ Subclasses should set this in their class_init function. - @@ -565,9 +507,7 @@ Subclasses should set this in their class_init function. - - - + Result values from the parse_tag virtual function. @@ -724,10 +664,8 @@ Subclasses have to do the following things: GST_TAG_MUX_CLASS(mux_klass)->render_start_tag and/or GST_TAG_MUX_CLASS(mux_klass)->render_end_tag vfuncs and set up a render function. - - @@ -741,7 +679,6 @@ Subclasses have to do the following things: - @@ -770,14 +707,12 @@ Subclasses have to do the following things: The #GstTagMuxClass structure. Subclasses need to override at least one of the two render vfuncs. - the parent class. - @@ -793,7 +728,6 @@ of the two render vfuncs. - @@ -813,9 +747,7 @@ of the two render vfuncs. - - - + This interface is implemented by elements that are able to do XMP serialization. Examples for such elements are #jifmux and #qtmux. @@ -823,12 +755,10 @@ such elements are #jifmux and #qtmux. Applications can use this interface to configure which XMP schemas should be used when serializing tags into XMP. Schemas are represented by their names, a full list of the supported schemas can be obtained from gst_tag_xmp_list_schemas(). By default, all schemas are used. - Adds all available XMP schemas to the configuration. Meaning that all will be used. - @@ -841,7 +771,6 @@ all will be used. Adds @schema to the list schemas - @@ -858,7 +787,6 @@ all will be used. Checks if @schema is going to be used - %TRUE if it is going to be used @@ -877,7 +805,6 @@ all will be used. Removes all schemas from the list of schemas to use. Meaning that no XMP will be generated. - @@ -891,7 +818,6 @@ XMP will be generated. Removes a schema from the list of schemas to use. Nothing is done if the schema wasn't in the list - @@ -907,7 +833,6 @@ the schema wasn't in the list - @@ -925,7 +850,6 @@ the schema wasn't in the list - @@ -972,7 +896,6 @@ This is useful in situations where it's not clear whether a given string is a language code (which should be put into a #GST_TAG_LANGUAGE_CODE tag) or a free-form language name descriptor (which should be put into a #GST_TAG_LANGUAGE_NAME tag instead). - TRUE if the two- or three-letter language code in @lang_code is a valid ISO-639 language code. @@ -994,7 +917,6 @@ variables (whose names are specified in the NULL-terminated string array @env_vars) containing a list of character encodings to try/use. If none are specified, the current locale will be tried. If that also doesn't work, WINDOWS-1252/ISO-8859-1 is assumed (which will almost always succeed). - a newly-allocated string in UTF-8 encoding, or NULL @@ -1021,7 +943,6 @@ WINDOWS-1252/ISO-8859-1 is assumed (which will almost always succeed). Looks up the GStreamer tag for a ID3v2 tag. - The corresponding GStreamer tag or NULL if none exists. @@ -1036,7 +957,6 @@ WINDOWS-1252/ISO-8859-1 is assumed (which will almost always succeed). Looks up the GStreamer tag for an ID3v2 user tag (e.g. description in TXXX frame or owner in UFID frame). - The corresponding GStreamer tag or NULL if none exists. @@ -1054,7 +974,6 @@ TXXX frame or owner in UFID frame). Looks up the GStreamer tag for a vorbiscomment tag. - The corresponding GStreamer tag or NULL if none exists. @@ -1069,7 +988,6 @@ TXXX frame or owner in UFID frame). Determines size of an ID3v2 tag on buffer containing at least ID3v2 header, i.e. at least #GST_TAG_ID3V2_HEADER_SIZE (10) bytes; - Size of tag, or 0 if header is invalid or too small. @@ -1083,7 +1001,6 @@ i.e. at least #GST_TAG_ID3V2_HEADER_SIZE (10) bytes; Convenience macro wrapping gst_tag_get_language_code_iso_639_1(). - ISO-639 language code (e.g. "deu" or "ger" or "de") @@ -1096,7 +1013,6 @@ language code or two-letter ISO-639-1 language code (both are accepted for convenience). Language codes are case-sensitive and expected to be lower case. - two-letter ISO-639-1 language code string that maps to @lang_code, or NULL if no mapping is known. The returned string must not be @@ -1120,7 +1036,6 @@ The "bibliographic" code is derived from the English name of the language "terminological" codes are preferred. Language codes are case-sensitive and expected to be lower case. - three-letter ISO-639-2 language code string that maps to @lang_code, or NULL if no mapping is known. The returned string must not be @@ -1144,7 +1059,6 @@ The "terminological" code is derived from the local name of the language "terminological" codes are preferred over the "bibliographic" ones. Language codes are case-sensitive and expected to be lower case. - three-letter ISO-639-2 language code string that maps to @lang_code, or NULL if no mapping is known. The returned string must not be @@ -1163,7 +1077,6 @@ Language codes are case-sensitive and expected to be lower case. codes). This is useful for UIs to build a list of available languages for tagging purposes (e.g. to tag an audio track appropriately in a video or audio editor). - NULL-terminated string array with two-letter language codes. Free with g_strfreev() when no longer needed. @@ -1179,7 +1092,6 @@ according to the current locale (if the library was built against the iso-codes package, otherwise the English name will be returned). Language codes are case-sensitive and expected to be lower case. - language name in UTF-8 format, or NULL if @language_code could not be mapped to a language name. The returned string must not be @@ -1197,7 +1109,6 @@ Language codes are case-sensitive and expected to be lower case. Get the description of a license, which is a translated description of the license's main features. - the description of the license, or NULL if the license is unknown or a description is not available. @@ -1214,7 +1125,6 @@ of the license's main features. Get the flags of a license, which describe most of the features of a license in their most general form. - the flags of the license, or 0 if the license is unknown @@ -1235,7 +1145,6 @@ for which no code exists and which is thus represented as "scotland". Known jurisdictions: ar, at, au, be, bg, br, ca, ch, cl, cn, co, de, dk, es, fi, fr, hr, hu, il, in, it, jp, kr, mk, mt, mx, my, nl, pe, pl, pt, scotland, se, si, tw, uk, us, za. - the jurisdiction code of the license, or NULL if the license is unknown or is not specific to a particular jurisdiction. @@ -1252,7 +1161,6 @@ pt, scotland, se, si, tw, uk, us, za. Get the nick name of a license, which is a short (untranslated) string such as e.g. "CC BY-NC-ND 2.0 UK". - the nick name of the license, or NULL if the license is unknown @@ -1268,7 +1176,6 @@ such as e.g. "CC BY-NC-ND 2.0 UK". Get the title of a license, which is a short translated description of the license's features (generally not very pretty though). - the title of the license, or NULL if the license is unknown or no title is available. @@ -1284,7 +1191,6 @@ of the license's features (generally not very pretty though). Get the version of a license. - the version of the license, or NULL if the license is not known or has no version @@ -1303,7 +1209,6 @@ of the license's features (generally not very pretty though). useful for UIs to build a list of available licenses for tagging purposes (e.g. to tag an audio track appropriately in a video or audio editor, or an image in a camera application). - NULL-terminated array of license strings. Free with g_strfreev() when no longer needed. @@ -1315,7 +1220,6 @@ an image in a camera application). Gets the number of ID3v1 genres that can be identified. Winamp genres are included. - the number of ID3v1 genres that can be identified @@ -1323,7 +1227,6 @@ included. Gets the ID3v1 genre name for a given ID. - the genre or NULL if no genre is associated with that ID. @@ -1358,7 +1261,6 @@ the special tag name. This function will do various checks and typefind the encoded image data (we can't trust the declared mime type). - a newly-allocated image sample for use in tag lists, or NULL @@ -1386,7 +1288,6 @@ data (we can't trust the declared mime type). Adds an image from an ID3 APIC frame (or similar, such as used in FLAC) to the given tag list. Also see gst_tag_image_data_to_image_sample() for more information on image tags in GStreamer. - %TRUE if the image was processed, otherwise %FALSE @@ -1418,7 +1319,6 @@ more information on image tags in GStreamer. on a taglist. The base_offset is used to subtract from the offset in the tag entries and be able to get the offset relative to the buffer start - The parsed taglist @@ -1440,7 +1340,6 @@ start Parses the exif tags starting with a tiff header structure. - The taglist @@ -1455,7 +1354,6 @@ start Creates a new tag list that contains the information parsed out of a ID3 tag. - A new #GstTagList with all tags that could be extracted from the given vorbiscomment buffer or NULL on error. @@ -1471,7 +1369,6 @@ ID3 tag. Creates a new tag list that contains the information parsed out of a vorbiscomment packet. - A new #GstTagList with all tags that could be extracted from the given vorbiscomment buffer or NULL on error. @@ -1508,7 +1405,6 @@ vorbiscomment packet. Creates a new tag list that contains the information parsed out of a vorbiscomment packet. - A new #GstTagList with all tags that could be extracted from the given vorbiscomment buffer or NULL on error. @@ -1538,7 +1434,6 @@ vorbiscomment packet. Parse a xmp packet into a taglist. - new taglist or %NULL, free the list when done @@ -1553,7 +1448,6 @@ vorbiscomment packet. Parses the data containing an ID3v1 tag and returns a #GstTagList from the parsed data. - A new tag list or NULL if the data was not an ID3v1 tag. @@ -1570,7 +1464,6 @@ parsed data. Formats the tags in taglist on exif format. The resulting buffer contains the tags IFD and is followed by the data pointed by the tag entries. - A GstBuffer containing the tag entries followed by the tag data @@ -1593,7 +1486,6 @@ the tags IFD and is followed by the data pointed by the tag entries. Formats the tags in taglist into exif structure, a tiff header is put in the beginning of the buffer. - A GstBuffer containing the data @@ -1607,7 +1499,6 @@ is put in the beginning of the buffer. Creates a new vorbiscomment buffer from a tag list. - A new #GstBuffer containing a vorbiscomment buffer with all tags that could be converted from the given tag list. @@ -1638,7 +1529,6 @@ is put in the beginning of the buffer. Formats a taglist as a xmp packet using only the selected schemas. An empty list (%NULL) means that all schemas should be used - new buffer or %NULL, unref the buffer when done @@ -1669,7 +1559,6 @@ If successful, @key, @lang and/or @value will be set to newly allocated strings that you need to free with g_free() when done. @key and @lang may also be set to NULL by this function if there is no key or no language code in the extended comment string. - TRUE if the string could be parsed, otherwise FALSE @@ -1703,14 +1592,12 @@ code in the extended comment string. Registers additional musicbrainz-specific tags with the GStreamer tag system. Plugins and applications that use these tags should call this function before using them. Can be called multiple times. - Looks up the ID3v2 tag for a GStreamer tag. - The corresponding ID3v2 tag or NULL if none exists. @@ -1725,7 +1612,6 @@ function before using them. Can be called multiple times. Creates a new tag list that contains the information parsed out of a vorbiscomment packet. - A #GList of newly-allocated key=value strings. Free with g_list_foreach (list, (GFunc) g_free, NULL) @@ -1747,7 +1633,6 @@ vorbiscomment packet. Looks up the vorbiscomment tag for a GStreamer tag. - The corresponding vorbiscomment tag or NULL if none exists. @@ -1761,7 +1646,6 @@ vorbiscomment packet. Gets the list of supported schemas in the xmp lib - a %NULL terminated array of strings with the schema names @@ -1777,7 +1661,6 @@ given taglist @list. Unknown vorbiscomment tags will be added to the tag list in form of a #GST_TAG_EXTENDED_COMMENT. - diff --git a/gir-files/GstVideo-1.0.gir b/gir-files/GstVideo-1.0.gir index fefeb3a03..c74c7165a 100644 --- a/gir-files/GstVideo-1.0.gir +++ b/gir-files/GstVideo-1.0.gir @@ -9,7 +9,6 @@ and/or use gtk-doc annotations. --> - @@ -18,7 +17,6 @@ option, gst_buffer_pool_config_set_video_alignment() can be called. When this option is enabled on the bufferpool, #GST_BUFFER_POOL_OPTION_VIDEO_META should also be enabled. - @@ -27,13 +25,11 @@ meta on buffers from the pool. When this option is enabled on the bufferpool, @GST_BUFFER_POOL_OPTION_VIDEO_META should also be enabled. - An option that can be activated on bufferpool to request video metadata on buffers from the pool. - @@ -50,48 +46,39 @@ Top and bottom fields are expected to alternate in this mode. The frame rate in the caps still signals the frame rate, so the notional field rate will be twice the frame rate from the caps (see @GST_VIDEO_INFO_FIELD_RATE_N). - - - - - - - - - @@ -103,10 +90,8 @@ balance operation on video frames they process. For example, modifying the brightness, contrast, hue or saturation. Example elements are 'xvimagesink' and 'colorbalance' - Get the #GstColorBalanceType of this implementation. - A the #GstColorBalanceType. @@ -125,7 +110,6 @@ and max_value. See Also: The #GstColorBalanceChannel.min_value and #GstColorBalanceChannel.max_value members of the #GstColorBalanceChannel object. - The current value of the channel. @@ -143,7 +127,6 @@ See Also: The #GstColorBalanceChannel.min_value and Retrieve a list of the available channels. - A GList containing pointers to #GstColorBalanceChannel @@ -167,7 +150,6 @@ be between min_value and max_value. See Also: The #GstColorBalanceChannel.min_value and #GstColorBalanceChannel.max_value members of the #GstColorBalanceChannel object. - @@ -191,7 +173,6 @@ See Also: The #GstColorBalanceChannel.min_value and interface. It fires the #GstColorBalance::value-changed signal on the instance, and the #GstColorBalanceChannel::value-changed signal on the channel object. - @@ -212,7 +193,6 @@ channel object. Get the #GstColorBalanceType of this implementation. - A the #GstColorBalanceType. @@ -231,7 +211,6 @@ and max_value. See Also: The #GstColorBalanceChannel.min_value and #GstColorBalanceChannel.max_value members of the #GstColorBalanceChannel object. - The current value of the channel. @@ -249,7 +228,6 @@ See Also: The #GstColorBalanceChannel.min_value and Retrieve a list of the available channels. - A GList containing pointers to #GstColorBalanceChannel @@ -273,7 +251,6 @@ be between min_value and max_value. See Also: The #GstColorBalanceChannel.min_value and #GstColorBalanceChannel.max_value members of the #GstColorBalanceChannel object. - @@ -297,7 +274,6 @@ See Also: The #GstColorBalanceChannel.min_value and interface. It fires the #GstColorBalance::value-changed signal on the instance, and the #GstColorBalanceChannel::value-changed signal on the channel object. - @@ -337,9 +313,7 @@ channel object. The #GstColorBalanceChannel object represents a parameter for modifying the color balance implemented by an element providing the #GstColorBalance interface. For example, Hue or Saturation. - - @@ -387,14 +361,12 @@ for modifying the color balance implemented by an element providing the Color-balance channel class. - the parent class - @@ -416,14 +388,12 @@ for modifying the color balance implemented by an element providing the Color-balance interface. - the parent interface - A GList containing pointers to #GstColorBalanceChannel @@ -443,7 +413,6 @@ for modifying the color balance implemented by an element providing the - @@ -465,7 +434,6 @@ for modifying the color balance implemented by an element providing the - The current value of the channel. @@ -484,7 +452,6 @@ for modifying the color balance implemented by an element providing the - A the #GstColorBalanceType. @@ -499,7 +466,6 @@ for modifying the color balance implemented by an element providing the - @@ -540,168 +506,144 @@ preferred. - - - - - - - - - - - - - - - - - - - - - - - - @@ -709,33 +651,27 @@ preferred. This metadata stays relevant as long as video colorspace is unchanged. - This metadata stays relevant as long as video orientation is unchanged. - This metadata stays relevant as long as video size is unchanged. - This metadata is relevant for video streams. - - - @@ -762,11 +698,9 @@ The main parts of the API are: The GstNavigation message functions provide functions for creating and parsing custom bus messages for signaling GstNavigation changes. - Inspect a #GstEvent and return the #GstNavigationEventType of the event, or #GST_NAVIGATION_EVENT_INVALID if the event is not a #GstNavigation event. - @@ -780,7 +714,6 @@ custom bus messages for signaling GstNavigation changes. Inspect a #GstNavigation command event and retrieve the enum value of the associated command. - TRUE if the navigation command could be extracted, otherwise FALSE. @@ -798,7 +731,6 @@ associated command. - @@ -819,7 +751,6 @@ associated command. 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. - TRUE if the button number and both coordinates could be extracted, otherwise FALSE. @@ -850,7 +781,6 @@ gst_navigation_event_get_type() to retrieve the #GstNavigationEventType. Inspect a #GstNavigation mouse movement event and extract the coordinates of the event. - TRUE if both coordinates could be extracted, otherwise FALSE. @@ -875,7 +805,6 @@ of the event. Inspect a #GstNavigation mouse scroll event and extract the coordinates of the event. - TRUE if all coordinates could be extracted, otherwise FALSE. @@ -910,7 +839,6 @@ of the event. Check a bus message to see if it is a #GstNavigation event, and return the #GstNavigationMessageType identifying the type of the message if so. - The type of the #GstMessage, or #GST_NAVIGATION_MESSAGE_INVALID if the message is not a #GstNavigation @@ -929,7 +857,6 @@ notification. #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. @@ -952,7 +879,6 @@ multiangle video has changed. Creates a new #GstNavigation message with type #GST_NAVIGATION_MESSAGE_COMMANDS_CHANGED - The new #GstMessage. @@ -967,7 +893,6 @@ multiangle video has changed. Creates a new #GstNavigation message with type #GST_NAVIGATION_MESSAGE_EVENT. - The new #GstMessage. @@ -986,7 +911,6 @@ multiangle video has changed. Creates a new #GstNavigation message with type #GST_NAVIGATION_MESSAGE_MOUSE_OVER. - The new #GstMessage. @@ -1006,7 +930,6 @@ multiangle video has changed. 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. @@ -1032,7 +955,6 @@ and extract the @cur_angle and @n_angles parameters. Parse a #GstNavigation message of type #GST_NAVIGATION_MESSAGE_EVENT and extract contained #GstEvent. The caller must unref the @event when done with it. - %TRUE if the message could be successfully parsed. %FALSE if not. @@ -1053,7 +975,6 @@ with it. 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. @@ -1073,7 +994,6 @@ active, it indicates that the mouse is over a clickable area. Inspect a #GstQuery and return the #GstNavigationQueryType associated with it if it is a #GstNavigation query. - The #GstNavigationQueryType of the query, or #GST_NAVIGATION_QUERY_INVALID @@ -1090,7 +1010,6 @@ it if it is a #GstNavigation query. 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. @@ -1099,7 +1018,6 @@ greater than one in a multiangle video. Create a new #GstNavigation commands query. When executed, it will query the pipeline for the set of currently available commands. - The new query. @@ -1109,7 +1027,6 @@ query the pipeline for the set of currently available commands. 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. @@ -1133,7 +1050,6 @@ angles into the #guint pointed to by the @n_angles variable. Parse the number of commands in the #GstNavigation commands @query. - %TRUE if the query could be successfully parsed. %FALSE if not. @@ -1153,7 +1069,6 @@ angles into the #guint pointed to by the @n_angles variable. 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. @@ -1175,7 +1090,6 @@ set to #GST_NAVIGATION_COMMAND_INVALID. Set the #GstNavigation angles query result field in @query. - @@ -1197,7 +1111,6 @@ set to #GST_NAVIGATION_COMMAND_INVALID. Set the #GstNavigation command query result fields in @query. The number of commands passed must be equal to @n_commands. - @@ -1219,7 +1132,6 @@ of commands passed must be equal to @n_commands. Set the #GstNavigation command query result fields in @query. The number of commands passed must be equal to @n_commands. - @@ -1242,7 +1154,6 @@ of commands passed must be equal to @n_commands. - @@ -1257,7 +1168,6 @@ of commands passed must be equal to @n_commands. Sends the indicated command to the navigation interface. - @@ -1273,7 +1183,6 @@ of commands passed must be equal to @n_commands. - @@ -1287,7 +1196,6 @@ of commands passed must be equal to @n_commands. - @@ -1313,7 +1221,6 @@ by XKeysymToString. 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. - @@ -1347,7 +1254,6 @@ for mouse-move events. 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. - @@ -1490,14 +1396,12 @@ the event. (Since: 1.18) Navigation interface. - the parent interface - @@ -1551,77 +1455,66 @@ by any element in the pipeline (Since: 1.6) - - - - - - - - - - - @@ -1629,7 +1522,6 @@ by any element in the pipeline (Since: 1.6) Returns the #GstVideoAncillaryDID16 of the ancillary data. - a #GstVideoAncillary @@ -1638,7 +1530,6 @@ by any element in the pipeline (Since: 1.6) Check if GST_VIDEO_BUFFER_FLAG_BOTTOM_FIELD is set on @buf (Since: 1.18). - a #GstBuffer @@ -1647,7 +1538,6 @@ by any element in the pipeline (Since: 1.6) Check if GST_VIDEO_BUFFER_FLAG_TOP_FIELD is set on @buf (Since: 1.18). - a #GstBuffer @@ -1655,14 +1545,12 @@ by any element in the pipeline (Since: 1.6) - - @@ -1670,7 +1558,6 @@ by any element in the pipeline (Since: 1.6) Generic caps string for video, for use in pad templates. - string format that describes the pixel layout, as string @@ -1680,7 +1567,6 @@ by any element in the pipeline (Since: 1.6) Generic caps string for video, for use in pad templates. - Requires caps features as a string, e.g. @@ -1694,7 +1580,6 @@ by any element in the pipeline (Since: 1.6) The entire set of flags for the @frame - a #GstVideoCodecFrame @@ -1703,7 +1588,6 @@ by any element in the pipeline (Since: 1.6) Checks whether the given @flag is set - a #GstVideoCodecFrame @@ -1715,7 +1599,6 @@ by any element in the pipeline (Since: 1.6) This macro sets the given bits - a #GstVideoCodecFrame @@ -1727,7 +1610,6 @@ by any element in the pipeline (Since: 1.6) This macro usets the given bits. - a #GstVideoCodecFrame @@ -1739,7 +1621,6 @@ by any element in the pipeline (Since: 1.6) Tests if the buffer should only be decoded but not sent downstream. - a #GstVideoCodecFrame @@ -1749,7 +1630,6 @@ by any element in the pipeline (Since: 1.6) Tests if the frame must be encoded as a keyframe. Applies only to frames provided to encoders. Decoders can safely ignore this field. - a #GstVideoCodecFrame @@ -1762,7 +1642,6 @@ resulting encoded buffer for the given frame. Applies only to frames provided to encoders. Decoders can safely ignore this field. - a #GstVideoCodecFrame @@ -1773,7 +1652,6 @@ ignore this field. Tests if the frame is a synchronization point (like a keyframe). Decoder implementations can use this to detect keyframes. - a #GstVideoCodecFrame @@ -1787,7 +1665,6 @@ Decoder implementation can use this if they have frames that are not meant to be displayed. Encoder implementation can safely ignore this field. - a #GstVideoCodecFrame @@ -1795,14 +1672,12 @@ Encoder implementation can safely ignore this field. - - @@ -1815,7 +1690,6 @@ Encoder implementations should set this accordingly. Decoder implementing parsing features should set this when they detect such a synchronization point. - a #GstVideoCodecFrame @@ -1823,158 +1697,127 @@ detect such a synchronization point. - - - - - - - - - - - - - - - - - - - - #GstVideoAlphaMode, the alpha mode to use. Default is #GST_VIDEO_ALPHA_MODE_COPY. - #G_TYPE_DOUBLE, the alpha color value to use. Default to 1.0 - #G_TYPE_UINT, the border color to use if #GST_VIDEO_CONVERTER_OPT_FILL_BORDER is set to %TRUE. The color is in ARGB format. Default 0xff000000 - #GstVideoChromaMode, set the chroma resample mode subsampled formats. Default is #GST_VIDEO_CHROMA_MODE_FULL. - #GstVideoChromaMethod, The resampler method to use for chroma resampling. Other options for the resampler can be used, see the #GstVideoResampler. Default is #GST_VIDEO_RESAMPLER_METHOD_LINEAR - #G_TYPE_INT, height in the destination frame, default destination height - #G_TYPE_INT, width in the destination frame, default destination width - #G_TYPE_INT, x position in the destination frame, default 0 - #G_TYPE_INT, y position in the destination frame, default 0 - #GstVideoDitherMethod, The dither method to use when changing bit depth. Default is #GST_VIDEO_DITHER_BAYER. - #G_TYPE_UINT, The quantization amount to dither to. Components will be quantized to multiples of this value. Default is 1 - @@ -1982,83 +1825,69 @@ Default is 1 destination image, render a border with #GST_VIDEO_CONVERTER_OPT_BORDER_ARGB. Otherwise the unusded pixels in the destination are untouched. Default %TRUE. - #GstVideoGammaMode, set the gamma mode. Default is #GST_VIDEO_GAMMA_MODE_NONE. - #GstVideoMatrixMode, set the color matrix conversion mode for converting between Y'PbPr and non-linear RGB (R'G'B'). Default is #GST_VIDEO_MATRIX_MODE_FULL. - #GstVideoPrimariesMode, set the primaries conversion mode. Default is #GST_VIDEO_PRIMARIES_MODE_NONE. - #GstVideoResamplerMethod, The resampler method to use for resampling. Other options for the resampler can be used, see the #GstVideoResampler. Default is #GST_VIDEO_RESAMPLER_METHOD_CUBIC - #G_TYPE_UINT, The number of taps for the resampler. Default is 0: let the resampler choose a good value. - #G_TYPE_INT, source height to convert, default source height - #G_TYPE_INT, source width to convert, default source width - #G_TYPE_INT, source x position to start conversion, default 0 - #G_TYPE_INT, source y position to start conversion, default 0 - #G_TYPE_UINT, maximum number of threads to use. Default 1, 0 for the number of cores. - - - - @@ -2073,7 +1902,6 @@ post an error message and the application will be requested to stop further media processing. Otherwise, it is considered a "glitch" and only a warning is logged. In either case, @ret is set to the proper value to return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). - the base video decoder element that generates the error @@ -2101,7 +1929,6 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). - @@ -2109,7 +1936,6 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). Gives the segment of the element. - base decoder instance @@ -2118,12 +1944,10 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). Default maximum number of errors tolerated before signaling error. - Gives the segment of the element. - base decoder instance @@ -2132,12 +1956,10 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). The name of the templates for the sink pad. - Gives the pointer to the sink #GstPad object of the element. - a #GstVideoDecoder @@ -2146,12 +1968,10 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). The name of the templates for the source pad. - Gives the pointer to the source #GstPad object of the element. - a #GstVideoDecoder @@ -2160,7 +1980,6 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). Obtain a lock to protect the decoder function from concurrent access. - video decoder instance @@ -2169,7 +1988,6 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). Release the lock that protects the decoder function from concurrent access. - video decoder instance @@ -2177,49 +1995,42 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). - - - - - - - @@ -2227,7 +2038,6 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). Gives the segment of the element. - base parse instance @@ -2236,7 +2046,6 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). Gives the segment of the element. - base parse instance @@ -2245,12 +2054,10 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). The name of the templates for the sink pad. - Gives the pointer to the sink #GstPad object of the element. - a #GstVideoEncoder @@ -2259,12 +2066,10 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). The name of the templates for the source pad. - Gives the pointer to the source #GstPad object of the element. - a #GstVideoEncoder @@ -2273,7 +2078,6 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). Obtain a lock to protect the encoder function from concurrent access. - video encoder instance @@ -2282,7 +2086,6 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). Release the lock that protects the encoder function from concurrent access. - video encoder instance @@ -2290,28 +2093,24 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). - - - - @@ -2333,18 +2132,15 @@ Formats are sorted by decreasing "quality", using these criteria by priority: - prefer YUV formats over RGB ones - prefer I420 over YV12 - format name - - - @@ -2355,7 +2151,6 @@ Formats are sorted by decreasing "quality", using these criteria by priority: - @@ -2364,35 +2159,30 @@ Formats are sorted by decreasing "quality", using these criteria by priority: - - - - - @@ -2401,56 +2191,48 @@ Formats are sorted by decreasing "quality", using these criteria by priority: - - - - - - - - @@ -2464,7 +2246,6 @@ components are packed into one plane. Examples: RGB/RGBx/RGBA: 1 plane, 3/3/4 components; I420: 3 planes, 3 components; NV21/NV12: 2 planes, 3 components. - a #GstVideoFormatInfo @@ -2472,7 +2253,6 @@ I420: 3 planes, 3 components; NV21/NV12: 2 planes, 3 components. - @@ -2485,7 +2265,6 @@ I420: 3 planes, 3 components; NV21/NV12: 2 planes, 3 components. Plane number where the given component can be found. A plane may contain data for multiple components. - a #GstVideoFormatInfo @@ -2496,7 +2275,6 @@ contain data for multiple components. - @@ -2513,7 +2291,6 @@ Examples: for 24-bit RGB, the pixel stride would be 3 bytes, while it would be 4 bytes for RGBx or ARGB, and 8 bytes for ARGB64 or AYUV64. For planar formats such as I420 the pixel stride is usually 1. For YUY2 it would be 2 bytes. - a #GstVideoFormatInfo @@ -2524,7 +2301,6 @@ YUY2 it would be 2 bytes. - @@ -2535,7 +2311,6 @@ YUY2 it would be 2 bytes. - @@ -2546,7 +2321,6 @@ YUY2 it would be 2 bytes. - @@ -2559,7 +2333,6 @@ YUY2 it would be 2 bytes. of a row to the first pixel component in the next row. This might include some row padding (memory not actually used for anything, to make sure the beginning of the next row is aligned in a particular way). - a #GstVideoFormatInfo @@ -2573,28 +2346,24 @@ beginning of the next row is aligned in a particular way). - - - - @@ -2603,11 +2372,9 @@ beginning of the next row is aligned in a particular way). - - @@ -2616,7 +2383,6 @@ beginning of the next row is aligned in a particular way). - @@ -2625,7 +2391,6 @@ beginning of the next row is aligned in a particular way). - @@ -2634,7 +2399,6 @@ beginning of the next row is aligned in a particular way). - @@ -2643,7 +2407,6 @@ beginning of the next row is aligned in a particular way). - @@ -2652,7 +2415,6 @@ beginning of the next row is aligned in a particular way). - @@ -2661,7 +2423,6 @@ beginning of the next row is aligned in a particular way). - @@ -2670,7 +2431,6 @@ beginning of the next row is aligned in a particular way). - @@ -2679,7 +2439,6 @@ beginning of the next row is aligned in a particular way). - @@ -2688,14 +2447,12 @@ beginning of the next row is aligned in a particular way). - - @@ -2704,77 +2461,66 @@ beginning of the next row is aligned in a particular way). - - - - - - - - - - - @@ -2783,7 +2529,6 @@ beginning of the next row is aligned in a particular way). - @@ -2792,7 +2537,6 @@ beginning of the next row is aligned in a particular way). - @@ -2801,35 +2545,30 @@ beginning of the next row is aligned in a particular way). - - - - - @@ -2840,7 +2579,6 @@ beginning of the next row is aligned in a particular way). - @@ -2849,7 +2587,6 @@ beginning of the next row is aligned in a particular way). - @@ -2858,7 +2595,6 @@ beginning of the next row is aligned in a particular way). - @@ -2867,7 +2603,6 @@ beginning of the next row is aligned in a particular way). - @@ -2876,7 +2611,6 @@ beginning of the next row is aligned in a particular way). - @@ -2885,7 +2619,6 @@ beginning of the next row is aligned in a particular way). - @@ -2894,7 +2627,6 @@ beginning of the next row is aligned in a particular way). - @@ -2903,7 +2635,6 @@ beginning of the next row is aligned in a particular way). - @@ -2914,35 +2645,30 @@ beginning of the next row is aligned in a particular way). The height of a field. It's the height of the full frame unless split-field (alternate) interlacing is in use. - - - - - @@ -2951,7 +2677,6 @@ beginning of the next row is aligned in a particular way). - @@ -2960,7 +2685,6 @@ beginning of the next row is aligned in a particular way). - @@ -2969,119 +2693,102 @@ beginning of the next row is aligned in a particular way). - - - - - - - - - - - - - - - - - @@ -3096,7 +2803,6 @@ The size passed as third argument is the size of the pixel data and should not contain any extra metadata padding. It is not valid to use this macro with a TILED format. - @@ -3107,7 +2813,6 @@ It is not valid to use this macro with a TILED format. - @@ -3116,7 +2821,6 @@ It is not valid to use this macro with a TILED format. - @@ -3125,106 +2829,90 @@ It is not valid to use this macro with a TILED format. - - - - - - - - - - - - - - - - @@ -3246,7 +2934,6 @@ Robidoux Sharp 0.2620 0.3690 Robidoux Soft 0.6796 0.1602 - @@ -3255,44 +2942,37 @@ parameter controls the Keys alpha value. Values between 0.0 and 2.0 are accepted. 1/3 is the default. See #GST_VIDEO_RESAMPLER_OPT_CUBIC_B for some more common values - G_TYPE_DOUBLE, specifies the size of filter envelope for @GST_VIDEO_RESAMPLER_METHOD_LANCZOS. values are clamped between 1.0 and 5.0. 2.0 is the default. - G_TYPE_INT, limits the maximum number of taps to use. 16 is the default. - G_TYPE_DOUBLE, specifies sharpening of the filter for @GST_VIDEO_RESAMPLER_METHOD_LANCZOS. values are clamped between 0.0 and 1.0. 0.0 is the default. - G_TYPE_DOUBLE, specifies sharpness of the filter for @GST_VIDEO_RESAMPLER_METHOD_LANCZOS. values are clamped between 0.5 and 1.5. 1.0 is the default. - #GstVideoDitherMethod, The dither method to use for propagating quatization errors. - - @@ -3300,7 +2980,6 @@ quatization errors. Cast @obj to a #GstVideoSink without runtime type check. - a #GstVideoSink or derived object @@ -3308,21 +2987,18 @@ quatization errors. - - - @@ -3330,7 +3006,6 @@ quatization errors. Get the sink #GstPad of @obj. - a #GstVideoSink @@ -3338,18 +3013,15 @@ quatization errors. - - - @@ -3359,7 +3031,6 @@ quatization errors. use this macro to create new tile modes. - the mode number to create @@ -3371,7 +3042,6 @@ quatization errors. Encode the number of tile in X and Y into the stride. - number of tiles in X @@ -3383,7 +3053,6 @@ quatization errors. Check if @mode is an indexed tile type - a tile mode @@ -3392,7 +3061,6 @@ quatization errors. Get the tile mode type of @mode - the tile mode @@ -3400,16 +3068,13 @@ quatization errors. - - Extract the number of tiles in X from the stride value. - plane stride @@ -3417,12 +3082,10 @@ quatization errors. - Extract the number of tiles in Y from the stride value. - plane stride @@ -3430,7 +3093,6 @@ quatization errors. - @@ -3448,7 +3110,6 @@ and Active Format Description in Complete list of AFD codes https://en.wikipedia.org/wiki/Active_Format_Description#Complete_list_of_AFD_codes and SMPTE ST2016-1 - parent #GstMeta @@ -3466,7 +3127,6 @@ and SMPTE ST2016-1 - @@ -3576,7 +3236,6 @@ of the active image. - @@ -3600,7 +3259,6 @@ are assumed to have an origin at (0.5, 0.5, 0.5) in a left-handed coordinate system with the x-axis moving horizontally (positive values to the right), the y-axis moving vertically (positive values up the screen) and the z-axis perpendicular to the screen (positive values into the screen). - parent #GstMeta @@ -3614,7 +3272,6 @@ perpendicular to the screen (positive values into the screen). Apply a transformation using the given 4x4 transformation matrix. Performs the multiplication, meta->matrix X matrix. - @@ -3632,7 +3289,6 @@ Performs the multiplication, meta->matrix X matrix. - @@ -3648,9 +3304,7 @@ VideoAggregator will do colorspace conversion. Zorder for each input stream can be configured on the #GstVideoAggregatorPad. - - @@ -3664,7 +3318,6 @@ Zorder for each input stream can be configured on the - @@ -3678,7 +3331,6 @@ Zorder for each input stream can be configured on the - @@ -3698,7 +3350,6 @@ Zorder for each input stream can be configured on the - @@ -3729,13 +3380,11 @@ srcpad caps. - - @@ -3751,7 +3400,6 @@ srcpad caps. - @@ -3767,7 +3415,6 @@ srcpad caps. - @@ -3783,7 +3430,6 @@ srcpad caps. - @@ -3813,9 +3459,7 @@ srcpad caps. An implementation of GstPad that can be used with #GstVideoAggregator. See #GstVideoAggregator for more details. - - @@ -3834,7 +3478,6 @@ See #GstVideoAggregator for more details. Requests the pad to check and update the converter before the next usage to update for any changes that have happened. - @@ -3861,13 +3504,11 @@ update for any changes that have happened. - - @@ -3890,13 +3531,9 @@ update for any changes that have happened. - - - + - - @@ -3913,7 +3550,6 @@ update for any changes that have happened. - @@ -3933,7 +3569,6 @@ update for any changes that have happened. - @@ -3952,7 +3587,6 @@ or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the agg The return value is only valid until #GstVideoAggregatorClass::aggregate_frames or #GstVideoAggregatorPadClass::prepare_frame returns. - The currently queued buffer @@ -3973,7 +3607,6 @@ or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the agg The return value is only valid until #GstVideoAggregatorClass::aggregate_frames or #GstVideoAggregatorPadClass::prepare_frame returns. - The currently prepared video frame @@ -3991,7 +3624,6 @@ for the current output frame. This must only be called from the #GstVideoAggregatorClass::aggregate_frames virtual method, or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the aggregator pads. - %TRUE if the pad has currently a buffer queued @@ -4005,7 +3637,6 @@ or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the agg Allows selecting that this pad requires an output format with alpha - @@ -4046,13 +3677,11 @@ or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the agg - - @@ -4065,7 +3694,6 @@ or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the agg - @@ -4087,7 +3715,6 @@ or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the agg - @@ -4110,17 +3737,12 @@ or from the #GstVideoAggregatorPadClass::prepare_frame virtual method of the agg - - - - - - + + Extra alignment parameters for the memory of video buffers. This structure is usually used to configure the bufferpool if it supports the #GST_BUFFER_POOL_OPTION_VIDEO_ALIGNMENT. - extra pixels on the top @@ -4145,7 +3767,6 @@ structure is usually used to configure the bufferpool if it supports the Set @align to its default values with no padding and no alignment. - @@ -4180,7 +3801,6 @@ structure is usually used to configure the bufferpool if it supports the Note that the contents of the data are always stored as 8bit data (i.e. do not contain the parity check bits). - The Data Identifier @@ -4258,7 +3878,6 @@ For more details, see: https://www.atsc.org/wp-content/uploads/2015/03/a_53-Part-4-2009.pdf and SMPTE ST2016-1 - parent #GstMeta @@ -4286,7 +3905,6 @@ and SMPTE ST2016-1 - @@ -4337,7 +3955,6 @@ They can conflict with other extended buffer flags. GST_VIDEO_BUFFER_FLAG_ONEFIELD (Since: 1.16). Use GST_VIDEO_BUFFER_IS_TOP_FIELD() to check for this flag. - The video frame has the bottom field only. This is the same as GST_VIDEO_BUFFER_FLAG_ONEFIELD @@ -4353,11 +3970,9 @@ They can conflict with other extended buffer flags. - Create a new bufferpool that can allocate video frames. This bufferpool supports all the video bufferpool options. - a new #GstBufferPool to allocate video frames @@ -4371,17 +3986,13 @@ supports all the video bufferpool options. - - - - + Extra buffer metadata providing Closed Caption. - parent #GstMeta @@ -4401,7 +4012,6 @@ supports all the video bufferpool options. - @@ -4444,7 +4054,6 @@ supports all the video bufferpool options. Parses fixed Closed Caption #GstCaps and returns the corresponding caption type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN. - #GstVideoCaptionType. @@ -4458,7 +4067,6 @@ type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN. Creates new caps corresponding to @type. - new #GstCaps @@ -4507,10 +4115,8 @@ type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN. - Perform resampling of @width chroma pixels in @lines. - @@ -4531,7 +4137,6 @@ type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN. Free @resample - @@ -4545,7 +4150,6 @@ type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN. The resampler must be fed @n_lines at a time. The first line should be at @offset. - @@ -4568,7 +4172,6 @@ at @offset. Create a new resampler object for the given parameters. When @h_factor or @v_factor is > 0, upsampling will be used, otherwise subsampling is performed. - a new #GstVideoChromaResample that should be freed with gst_video_chroma_resample_free() after usage. @@ -4635,7 +4238,6 @@ performed. A #GstVideoCodecFrame represents a video frame both in raw and encoded form. - @@ -4702,9 +4304,7 @@ encoded form. - - @@ -4724,7 +4324,6 @@ encoded form. Gets private data set on the frame by the subclass via gst_video_codec_frame_set_user_data() previously. - The previously set user_data @@ -4738,7 +4337,6 @@ gst_video_codec_frame_set_user_data() previously. Increases the refcount of the given frame by one. - @buf @@ -4756,7 +4354,6 @@ the frame is freed. Allows to attach private data by the subclass to frames. If a @user_data was previously set, then the previous set @notify will be called before the @user_data is replaced. - @@ -4778,7 +4375,6 @@ before the @user_data is replaced. Decreases the refcount of the frame. If the refcount reaches 0, the frame will be freed. - @@ -4792,7 +4388,6 @@ will be freed. Flags for #GstVideoCodecFrame - is the frame only meant to be decoded @@ -4816,7 +4411,6 @@ respective @set_format vmethods. Decoders and encoders can set the downstream state, by using the @gst_video_decoder_set_output_state() or @gst_video_encoder_set_output_state() methods. - @@ -4845,7 +4439,6 @@ Decoders and encoders can set the downstream state, by using the Increases the refcount of the given state by one. - @buf @@ -4860,7 +4453,6 @@ Decoders and encoders can set the downstream state, by using the Decreases the refcount of the state. If the refcount reaches 0, the state will be freed. - @@ -4904,7 +4496,6 @@ The matrix coefficients (MatrixCoefficients) value is defined by "ISO/IEC 23001-8 Section 7.3 Table 4" and "ITU-T H.273 Table 4". "H.264 Table E-5" and "H.265 Table E.5" share the identical values. - the matched #GstVideoColorMatrix @@ -4941,7 +4532,6 @@ and the other way around: G' = Y' - Cb*2*(1-Kb)*Kb/(1-Kr-Kb) - Cr*2*(1-Kr)*Kr/(1-Kr-Kb) B' = Y' + Cb*2*(1-Kb) ]| - TRUE if @matrix was a YUV color format and @Kr and @Kb contain valid values. @@ -4967,7 +4557,6 @@ and the other way around: (MatrixCoefficients) value defined by "ISO/IEC 23001-8 Section 7.3 Table 4" and "ITU-T H.273 Table 4". "H.264 Table E-5" and "H.265 Table E.5" share the identical values. - The value of ISO/IEC 23001-8 matrix coefficients. @@ -5036,7 +4625,6 @@ phosphors). Since: 1.16 The colour primaries (ColourPrimaries) value is defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". "H.264 Table E-3" and "H.265 Table E.3" share the identical values. - the matched #GstVideoColorPrimaries @@ -5050,7 +4638,6 @@ defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". Get information about the chromaticity coordinates of @primaries. - a #GstVideoColorPrimariesInfo for @primaries. @@ -5067,7 +4654,6 @@ defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". value defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". "H.264 Table E-3" and "H.265 Table E.3" share the identical values. - The value of ISO/IEC 23001-8 colour primaries. @@ -5084,7 +4670,6 @@ and "ITU-T H.273 Table 2". Structure describing the chromaticity coordinates of an RGB system. These values can be used to construct a matrix to transform RGB to and from the XYZ colorspace. - a #GstVideoColorPrimaries @@ -5143,7 +4728,6 @@ range [0.0 .. 1.0]. The reverse operation (c[i] * scale[i]) + offset[i] can be used to convert the component values in range [0.0 .. 1.0] back to their representation in @info and @range. - @@ -5173,7 +4757,6 @@ the component values in range [0.0 .. 1.0] back to their representation in Structure describing the color info. - the color range. This is the valid range for the samples. It is used to convert the samples to Y'PbPr values. @@ -5195,7 +4778,6 @@ the component values in range [0.0 .. 1.0] back to their representation in Parse the colorimetry string and update @cinfo with the parsed values. - %TRUE if @color points to valid colorimetry info. @@ -5213,7 +4795,6 @@ values. Compare the 2 colorimetry sets for equality - %TRUE if @cinfo and @other are equal. @@ -5232,7 +4813,6 @@ values. Check if the colorimetry information in @info matches that of the string @color. - %TRUE if @color conveys the same colorimetry info as the color information in @info. @@ -5251,7 +4831,6 @@ information in @info. Make a string representation of @cinfo. - a string representation of @cinfo or %NULL if all the entries of @cinfo are unknown values. @@ -5267,7 +4846,6 @@ or %NULL if all the entries of @cinfo are unknown values. Content light level information specified in CEA-861.3, Appendix A. - the maximum content light level (abbreviated to MaxCLL) in candelas per square meter (cd/m^2 and nit) @@ -5285,7 +4863,6 @@ or %NULL if all the entries of @cinfo are unknown values. Parse @caps and update @linfo - %TRUE if @linfo was successfully set to @caps @@ -5303,7 +4880,6 @@ or %NULL if all the entries of @cinfo are unknown values. Parse @caps and update @linfo - if @caps has #GstVideoContentLightLevel and could be parsed @@ -5322,7 +4898,6 @@ or %NULL if all the entries of @cinfo are unknown values. Parse the value of content-light-level caps field and update @minfo with the parsed values. - %TRUE if @linfo points to valid #GstVideoContentLightLevel. @@ -5340,7 +4915,6 @@ with the parsed values. Initialize @linfo - @@ -5353,7 +4927,6 @@ with the parsed values. Convert @linfo to its string representation. - a string representation of @linfo. @@ -5367,7 +4940,6 @@ with the parsed values. - @@ -5384,10 +4956,8 @@ with the parsed values. - Convert the pixels of @src into @dest using @convert. - @@ -5408,7 +4978,6 @@ with the parsed values. Free @convert - @@ -5421,7 +4990,6 @@ with the parsed values. Get the current configuration of @convert. - a #GstStructure that remains valid for as long as @convert is valid or until gst_video_converter_set_config() is called. @@ -5443,7 +5011,6 @@ then be retrieved and refined with gst_video_converter_get_config(). Look at the `GST_VIDEO_CONVERTER_OPT_*` fields to check valid configuration option and values. - %TRUE when @config could be set. @@ -5462,7 +5029,6 @@ option and values. Create a new converter object to convert between @in_info and @out_info with @config. - a #GstVideoConverter or %NULL if conversion is not possible. @@ -5485,7 +5051,6 @@ with @config. Extra buffer metadata describing image cropping. - parent #GstMeta @@ -5507,7 +5072,6 @@ with @config. - @@ -5617,9 +5181,7 @@ The bare minimum that a functional subclass needs to implement is: * Accept data in @handle_frame and provide decoded results to @gst_video_decoder_finish_frame, or call @gst_video_decoder_drop_frame. - - @@ -5630,7 +5192,6 @@ The bare minimum that a functional subclass needs to implement is: - @@ -5644,7 +5205,6 @@ The bare minimum that a functional subclass needs to implement is: - @@ -5655,7 +5215,6 @@ The bare minimum that a functional subclass needs to implement is: - @@ -5666,7 +5225,6 @@ The bare minimum that a functional subclass needs to implement is: - @@ -5677,7 +5235,6 @@ The bare minimum that a functional subclass needs to implement is: - @@ -5691,7 +5248,6 @@ The bare minimum that a functional subclass needs to implement is: - @@ -5708,7 +5264,6 @@ The bare minimum that a functional subclass needs to implement is: Negotiate with downstream elements to currently configured #GstVideoCodecState. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails. - %TRUE if the negotiation succeeded, else %FALSE. @@ -5721,7 +5276,6 @@ negotiate fails. - @@ -5732,7 +5286,6 @@ negotiate fails. - @@ -5752,7 +5305,6 @@ negotiate fails. - @@ -5766,7 +5318,6 @@ negotiate fails. - @@ -5780,7 +5331,6 @@ negotiate fails. - @@ -5794,7 +5344,6 @@ negotiate fails. - @@ -5808,7 +5357,6 @@ negotiate fails. - @@ -5822,7 +5370,6 @@ negotiate fails. - @@ -5836,7 +5383,6 @@ negotiate fails. - @@ -5850,7 +5396,6 @@ negotiate fails. - @@ -5861,7 +5406,6 @@ negotiate fails. - @@ -5872,7 +5416,6 @@ negotiate fails. - @@ -5890,7 +5433,6 @@ negotiate fails. Removes next @n_bytes of input data and adds it to currently parsed frame. - @@ -5911,7 +5453,6 @@ current #GstVideoCodecState. You should use gst_video_decoder_allocate_output_frame() instead of this function, if possible at all. - allocated buffer, or NULL if no buffer could be allocated (e.g. when downstream is flushing or shutting down) @@ -5931,7 +5472,6 @@ state and set src pad caps. The buffer allocated here is owned by the frame and you should only keep references to the frame, not the buffer. - %GST_FLOW_OK if an output buffer could be allocated @@ -5950,7 +5490,6 @@ keep references to the frame, not the buffer. Same as #gst_video_decoder_allocate_output_frame except it allows passing #GstBufferPoolAcquireParams to the sub call gst_buffer_pool_acquire_buffer. - %GST_FLOW_OK if an output buffer could be allocated @@ -5974,7 +5513,6 @@ keep references to the frame, not the buffer. Similar to gst_video_decoder_finish_frame(), but drops @frame in any case and posts a QoS message with the frame's details on the bus. In any case, the frame is considered finished and released. - a #GstFlowReturn, usually GST_FLOW_OK. @@ -5999,7 +5537,6 @@ In any case, the frame is considered finished and released. After calling this function the output buffer of the frame is to be considered read-only. This function will also change the metadata of the buffer. - a #GstFlowReturn resulting from sending data downstream @@ -6020,7 +5557,6 @@ of the buffer. used by the base class and its @params. Unref the @allocator after use it. - @@ -6042,7 +5578,6 @@ used - the instance of the #GstBufferPool used by the decoder; free it after use it @@ -6056,7 +5591,6 @@ by the decoder; free it after use it - currently configured byte to time conversion setting @@ -6070,7 +5604,6 @@ by the decoder; free it after use it Get a pending unfinished #GstVideoCodecFrame - pending unfinished #GstVideoCodecFrame identified by @frame_number. @@ -6088,7 +5621,6 @@ by the decoder; free it after use it Get all pending unfinished #GstVideoCodecFrame - pending unfinished #GstVideoCodecFrame. @@ -6105,7 +5637,6 @@ by the decoder; free it after use it Query the configured decoder latency. Results will be returned via @min_latency and @max_latency. - @@ -6131,7 +5662,6 @@ by the decoder; free it after use it allow it to decode and arrive in time (as determined by QoS events). In particular, a negative result means decoding in time is no longer possible and should therefore occur as soon/skippy as possible. - max decoding time. @@ -6148,7 +5678,6 @@ and should therefore occur as soon/skippy as possible. - currently configured decoder tolerated error count. @@ -6162,7 +5691,6 @@ and should therefore occur as soon/skippy as possible. Queries decoder required format handling. - %TRUE if required format handling is enabled. @@ -6176,7 +5704,6 @@ and should therefore occur as soon/skippy as possible. Get the oldest pending unfinished #GstVideoCodecFrame - oldest pending unfinished #GstVideoCodecFrame. @@ -6190,7 +5717,6 @@ and should therefore occur as soon/skippy as possible. Get the #GstVideoCodecState currently describing the output stream. - #GstVideoCodecState describing format of video data. @@ -6205,7 +5731,6 @@ and should therefore occur as soon/skippy as possible. Queries whether input data is considered packetized or not by the base class. - TRUE if input data is considered packetized. @@ -6220,7 +5745,6 @@ base class. Returns the number of bytes previously added to the current frame by calling gst_video_decoder_add_to_frame(). - The number of bytes pending for the current frame @@ -6233,7 +5757,6 @@ by calling gst_video_decoder_add_to_frame(). - The current QoS proportion. @@ -6249,7 +5772,6 @@ by calling gst_video_decoder_add_to_frame(). Gathers all data collected for currently parsed frame, gathers corresponding metadata and passes it along for further processing, i.e. @handle_frame. - a #GstFlowReturn @@ -6270,7 +5792,6 @@ Note that this is provided for convenience, and the subclass is not required to use this and can still do tag handling on its own. MT safe. - @@ -6294,7 +5815,6 @@ MT safe. Negotiate with downstream elements to currently configured #GstVideoCodecState. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails. - %TRUE if the negotiation succeeded, else %FALSE. @@ -6310,7 +5830,6 @@ negotiate fails. Returns caps that express @caps (or sink template caps if @caps == NULL) restricted to resolution/format/... combinations supported by downstream elements. - a #GstCaps owned by caller @@ -6334,7 +5853,6 @@ elements. Similar to gst_video_decoder_drop_frame(), but simply releases @frame without any processing other than removing it from list of pending frames, after which it is considered finished and released. - @@ -6351,7 +5869,6 @@ after which it is considered finished and released. Allows baseclass to perform byte to time estimated conversion. - @@ -6369,7 +5886,6 @@ after which it is considered finished and released. Same as #gst_video_decoder_set_output_state() but also allows you to also set the interlacing mode. - the newly configured output state. @@ -6405,7 +5921,6 @@ the interlacing mode. Lets #GstVideoDecoder sub-classes tell the baseclass what the decoder latency is. Will also post a LATENCY message on the bus so the pipeline can reconfigure its global latency. - @@ -6431,7 +5946,6 @@ warned about, but more than tolerated will lead to fatal error. You can set GST_VIDEO_DECODER_MAX_ERRORS. The '-1' option was added in 1.4 - @@ -6453,7 +5967,6 @@ never be handed any data before it has been configured. Otherwise, it might be handed data without having been configured and is then expected being able to do so either by default or based on the input data. - @@ -6483,7 +5996,6 @@ pixel-aspect-ratio or framerate) it can do so on the returned #GstVideoCodecStat The new output state will only take effect (set on pads and buffers) starting from the next call to #gst_video_decoder_finish_frame(). - the newly configured output state. @@ -6514,7 +6026,6 @@ from the next call to #gst_video_decoder_finish_frame(). Allows baseclass to consider input data as packetized or not. If the input is packetized, then the @parse method will not be called. - @@ -6536,7 +6047,6 @@ to use the default pad query handler to reply to accept-caps queries. By setting this to true it is possible to further customize the default handler with %GST_PAD_SET_ACCEPT_INTERSECT and %GST_PAD_SET_ACCEPT_TEMPLATE - @@ -6595,13 +6105,11 @@ using the metrics reported by those events. needed. At minimum @handle_frame needs to be overridden, and @set_format and likely as well. If non-packetized input is supported or expected, @parse needs to be overridden as well. - - @@ -6614,7 +6122,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6627,7 +6134,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6640,7 +6146,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6653,7 +6158,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6675,7 +6179,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6691,7 +6194,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6707,7 +6209,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6720,7 +6221,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6736,7 +6236,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6752,7 +6251,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6768,7 +6266,6 @@ and likely as well. If non-packetized input is supported or expected, - %TRUE if the negotiation succeeded, else %FALSE. @@ -6783,7 +6280,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6799,7 +6295,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6815,7 +6310,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6828,7 +6322,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6844,7 +6337,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6860,7 +6352,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6876,7 +6367,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6889,7 +6379,6 @@ and likely as well. If non-packetized input is supported or expected, - @@ -6912,20 +6401,16 @@ and likely as well. If non-packetized input is supported or expected, - - - + The interface allows unified access to control flipping and rotation operations of video-sources or operators. - #GstVideoDirectionInterface interface. - parent interface type. @@ -6934,10 +6419,8 @@ operations of video-sources or operators. GstVideoDither provides implementations of several dithering algorithms that can be applied to lines of video pixels to quantize and dither them. - Free @dither - @@ -6952,7 +6435,6 @@ that can be applied to lines of video pixels to quantize and dither them. Dither @width pixels starting from offset @x in @line using @dither. @y is the line number of @line in the output image. - @@ -6987,7 +6469,6 @@ Each component will be quantized to a multiple of @quantizer. Better performance is achieved when @quantizer is a power of 2. @width is the width of the lines that this ditherer will handle. - a new #GstVideoDither @@ -7105,10 +6586,8 @@ performance of the downstream elements. If enabled, subclasses can use gst_video_encoder_get_max_encode_time() to check if input frames are already late and drop them right away to give a chance to the pipeline to catch up. - - @@ -7119,7 +6598,6 @@ pipeline to catch up. - @@ -7133,7 +6611,6 @@ pipeline to catch up. - @@ -7144,7 +6621,6 @@ pipeline to catch up. - @@ -7155,7 +6631,6 @@ pipeline to catch up. - @@ -7169,7 +6644,6 @@ pipeline to catch up. - @@ -7186,7 +6660,6 @@ pipeline to catch up. Negotiate with downstream elements to currently configured #GstVideoCodecState. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails. - %TRUE if the negotiation succeeded, else %FALSE. @@ -7199,7 +6672,6 @@ negotiate fails. - @@ -7210,7 +6682,6 @@ negotiate fails. - @@ -7224,7 +6695,6 @@ negotiate fails. - @@ -7238,7 +6708,6 @@ negotiate fails. - @@ -7252,7 +6721,6 @@ negotiate fails. - @@ -7266,7 +6734,6 @@ negotiate fails. - @@ -7280,7 +6747,6 @@ negotiate fails. - @@ -7294,7 +6760,6 @@ negotiate fails. - @@ -7308,7 +6773,6 @@ negotiate fails. - @@ -7322,7 +6786,6 @@ negotiate fails. - @@ -7333,7 +6796,6 @@ negotiate fails. - @@ -7344,7 +6806,6 @@ negotiate fails. - @@ -7363,7 +6824,6 @@ negotiate fails. Helper function that allocates a buffer to hold an encoded video frame for @encoder's current #GstVideoCodecState. - allocated buffer @@ -7386,7 +6846,6 @@ state and set src pad caps. The buffer allocated here is owned by the frame and you should only keep references to the frame, not the buffer. - %GST_FLOW_OK if an output buffer could be allocated @@ -7416,7 +6875,6 @@ In any case, the frame is considered finished and released. After calling this function the output buffer of the frame is to be considered read-only. This function will also change the metadata of the buffer. - a #GstFlowReturn resulting from sending data downstream @@ -7442,7 +6900,6 @@ to tell the encoder that the frame has been fully encoded. This function will change the metadata of @frame and frame->output_buffer will be pushed downstream. - a #GstFlowReturn resulting from pushing the buffer downstream. @@ -7463,7 +6920,6 @@ will be pushed downstream. used by the base class and its @params. Unref the @allocator after use it. - @@ -7486,7 +6942,6 @@ used Get a pending unfinished #GstVideoCodecFrame - pending unfinished #GstVideoCodecFrame identified by @frame_number. @@ -7504,7 +6959,6 @@ used Get all pending unfinished #GstVideoCodecFrame - pending unfinished #GstVideoCodecFrame. @@ -7521,7 +6975,6 @@ used Query the configured encoding latency. Results will be returned via @min_latency and @max_latency. - @@ -7550,7 +7003,6 @@ and should therefore occur as soon/skippy as possible. If no QoS events have been received from downstream, or if #GstVideoEncoder:qos is disabled this function returns #G_MAXINT64. - max decoding time. @@ -7569,7 +7021,6 @@ If no QoS events have been received from downstream, or if Returns the minimum force-keyunit interval, see gst_video_encoder_set_min_force_key_unit_interval() for more details. - the minimum force-keyunit interval @@ -7583,7 +7034,6 @@ for more details. Get the oldest unfinished pending #GstVideoCodecFrame - oldest unfinished pending #GstVideoCodecFrame @@ -7597,7 +7047,6 @@ for more details. Get the current #GstVideoCodecState - #GstVideoCodecState describing format of video data. @@ -7612,7 +7061,6 @@ for more details. Checks if @encoder is currently configured to handle Quality-of-Service events from downstream. - %TRUE if the encoder is configured to perform Quality-of-Service. @@ -7633,7 +7081,6 @@ Note that this is provided for convenience, and the subclass is not required to use this and can still do tag handling on its own. MT safe. - @@ -7657,7 +7104,6 @@ MT safe. Negotiate with downstream elements to currently configured #GstVideoCodecState. Unmark GST_PAD_FLAG_NEED_RECONFIGURE in any case. But mark it again if negotiate fails. - %TRUE if the negotiation succeeded, else %FALSE. @@ -7673,7 +7119,6 @@ negotiate fails. Returns caps that express @caps (or sink template caps if @caps == NULL) restricted to resolution/format/... combinations supported by downstream elements (e.g. muxers). - a #GstCaps owned by caller @@ -7695,7 +7140,6 @@ elements (e.g. muxers). Set the codec headers to be sent downstream whenever requested. - @@ -7714,7 +7158,6 @@ elements (e.g. muxers). Informs baseclass of encoding latency. - @@ -7737,7 +7180,6 @@ elements (e.g. muxers). Sets the minimum interval for requesting keyframes based on force-keyunit events. Setting this to 0 will allow to handle every event, setting this to %GST_CLOCK_TIME_NONE causes force-keyunit events to be ignored. - @@ -7757,7 +7199,6 @@ events. Setting this to 0 will allow to handle every event, setting this to For streams with reordered frames this can be used to ensure that there is enough time to accommodate first DTS, which may be less than first PTS - @@ -7791,7 +7232,6 @@ pixel-aspect-ratio or framerate) it can do so on the returned #GstVideoCodecStat The new output state will only take effect (set on pads and buffers) starting from the next call to #gst_video_encoder_finish_frame(). - the newly configured output state. @@ -7813,7 +7253,6 @@ from the next call to #gst_video_encoder_finish_frame(). Configures @encoder to handle Quality-of-Service events from downstream. - @@ -7867,13 +7306,11 @@ gst_video_encoder_set_min_force_key_unit_interval() for more details. Subclasses can override any of the available virtual methods or not, as needed. At minimum @handle_frame needs to be overridden, and @set_format and @get_caps are likely needed as well. - - @@ -7886,7 +7323,6 @@ and @get_caps are likely needed as well. - @@ -7899,7 +7335,6 @@ and @get_caps are likely needed as well. - @@ -7912,7 +7347,6 @@ and @get_caps are likely needed as well. - @@ -7925,7 +7359,6 @@ and @get_caps are likely needed as well. - @@ -7941,7 +7374,6 @@ and @get_caps are likely needed as well. - @@ -7957,7 +7389,6 @@ and @get_caps are likely needed as well. - @@ -7973,7 +7404,6 @@ and @get_caps are likely needed as well. - @@ -7986,7 +7416,6 @@ and @get_caps are likely needed as well. - @@ -8002,7 +7431,6 @@ and @get_caps are likely needed as well. - @@ -8018,7 +7446,6 @@ and @get_caps are likely needed as well. - @@ -8034,7 +7461,6 @@ and @get_caps are likely needed as well. - @@ -8050,7 +7476,6 @@ and @get_caps are likely needed as well. - %TRUE if the negotiation succeeded, else %FALSE. @@ -8065,7 +7490,6 @@ and @get_caps are likely needed as well. - @@ -8081,7 +7505,6 @@ and @get_caps are likely needed as well. - @@ -8097,7 +7520,6 @@ and @get_caps are likely needed as well. - @@ -8110,7 +7532,6 @@ and @get_caps are likely needed as well. - @@ -8126,7 +7547,6 @@ and @get_caps are likely needed as well. - @@ -8142,7 +7562,6 @@ and @get_caps are likely needed as well. - @@ -8165,9 +7584,7 @@ and @get_caps are likely needed as well. - - - + Field order of interlaced content. This is only valid for interlace-mode=interleaved and not interlace-mode=mixed. In the case of @@ -8185,7 +7602,6 @@ buffer flags. Convert @order to a #GstVideoFieldOrder - the #GstVideoFieldOrder of @order or #GST_VIDEO_FIELD_ORDER_UNKNOWN when @order is not a valid @@ -8201,7 +7617,6 @@ buffer flags. Convert @order to its string representation. - @order as a string or NULL if @order in invalid. @@ -8219,9 +7634,7 @@ buffer flags. The videofilter will by default enable QoS on the parent GstBaseTransform to implement frame dropping. - - @@ -8244,7 +7657,6 @@ to implement frame dropping. - @@ -8261,7 +7673,6 @@ to implement frame dropping. - @@ -8294,14 +7705,12 @@ to implement frame dropping. The video filter class structure. - the parent class structure - @@ -8326,7 +7735,6 @@ to implement frame dropping. - @@ -8345,7 +7753,6 @@ to implement frame dropping. - @@ -8688,7 +8095,6 @@ for details about the layout and packing of these formats in memory. Converts a FOURCC value into the corresponding #GstVideoFormat. If the FOURCC cannot be represented by #GstVideoFormat, #GST_VIDEO_FORMAT_UNKNOWN is returned. - the #GstVideoFormat describing the FOURCC value @@ -8702,7 +8108,6 @@ If the FOURCC cannot be represented by #GstVideoFormat, Find the #GstVideoFormat for the given parameters. - a #GstVideoFormat or GST_VIDEO_FORMAT_UNKNOWN when the parameters to not specify a known format. @@ -8742,7 +8147,6 @@ not specify a known format. Convert the @format string to its #GstVideoFormat. - the #GstVideoFormat for @format or GST_VIDEO_FORMAT_UNKNOWN when the string is not a known format. @@ -8757,7 +8161,6 @@ string is not a known format. Get the #GstVideoFormatInfo for @format - The #GstVideoFormatInfo for @format. @@ -8772,7 +8175,6 @@ string is not a known format. Get the default palette of @format. This the palette used in the pack function for paletted formats. - the default palette of @format or %NULL when @format does not have a palette. @@ -8793,7 +8195,6 @@ function for paletted formats. Converts a #GstVideoFormat value into the corresponding FOURCC. Only a few YUV formats have corresponding FOURCC values. If @format has no corresponding FOURCC value, 0 is returned. - the FOURCC corresponding to @format @@ -8808,7 +8209,6 @@ no corresponding FOURCC value, 0 is returned. Returns a string containing a descriptive name for the #GstVideoFormat if there is one, or NULL otherwise. - the name corresponding to @format @@ -8862,7 +8262,6 @@ the #GstVideoFormat if there is one, or NULL otherwise. Information for a video format. - #GstVideoFormat @@ -8982,7 +8381,6 @@ the #GstVideoFormat if there is one, or NULL otherwise. Fill @components with the number of all the components packed in plane @p for the format @info. A value of -1 in @components indicates that no more components are packed in the plane. - @@ -9019,7 +8417,6 @@ Because this function does not have a x coordinate, it is not possible to pack pixels starting from an unaligned position. For tiled images this means that packing should start from a tile coordinate. For subsampled formats this means that a complete pixel needs to be packed. - @@ -9076,7 +8473,6 @@ the same as the pixel stride for plane 0 for the above formats. For subsampled formats, the components will be duplicated in the destination array. Reconstruction of the missing components can be performed in a separate step after unpacking. - @@ -9117,7 +8513,6 @@ separate step after unpacking. A video frame obtained from gst_video_frame_map() - the #GstVideoInfo @@ -9161,7 +8556,6 @@ separate step after unpacking. Note: Since: 1.18, @dest dimensions are allowed to be smaller than @src dimensions. - TRUE if the contents could be copied. @@ -9182,7 +8576,6 @@ smaller than @src dimensions. Note: Since: 1.18, @dest dimensions are allowed to be smaller than @src dimensions. - TRUE if the contents could be copied. @@ -9246,7 +8639,6 @@ each buffer). This function will just fill the #GstVideoFrame structure with the right values and if you use the accessor macros everything will just work and you can access the data easily. It also maps the underlying memory chunks for you. - %TRUE on success. @@ -9279,7 +8671,6 @@ will return %FALSE when there is no GstVideoMeta with that id. All video planes of @buffer will be mapped and the pointers will be set in @frame->data. - %TRUE on success. @@ -9309,7 +8700,6 @@ All video planes of @buffer will be mapped and the pointers will be set in Unmap the memory previously mapped with gst_video_frame_map. - @@ -9353,7 +8743,6 @@ All video planes of @buffer will be mapped and the pointers will be set in is the same as GST_VIDEO_FRAME_FLAG_TFF | GST_VIDEO_FRAME_FLAG_ONEFIELD (Since: 1.16). - The video frame has the bottom field only. This is the same as GST_VIDEO_FRAME_FLAG_ONEFIELD @@ -9374,7 +8763,6 @@ All video planes of @buffer will be mapped and the pointers will be set in The orientation of the GL texture. - Top line first in memory, left row first @@ -9390,7 +8778,6 @@ All video planes of @buffer will be mapped and the pointers will be set in The GL texture type. - Luminance texture, GL_LUMINANCE @@ -9414,7 +8801,6 @@ All video planes of @buffer will be mapped and the pointers will be set in - @@ -9432,7 +8818,6 @@ All video planes of @buffer will be mapped and the pointers will be set in ID. The caller of gst_video_gl_texture_upload_meta_upload() must have OpenGL set up and call this from a thread where it is valid to upload something to an OpenGL texture. - parent #GstMeta @@ -9468,7 +8853,6 @@ to upload something to an OpenGL texture. Uploads the buffer which owns the meta to a specific texture ID. - %TRUE if uploading succeeded, %FALSE otherwise. @@ -9485,7 +8869,6 @@ to upload something to an OpenGL texture. - @@ -9507,7 +8890,6 @@ to store the specific video info when mapping a video frame with gst_video_frame_map(). Use the provided macros to access the info in this structure. - the format info of the video @@ -9573,9 +8955,7 @@ Use the provided macros to access the info in this structure. - - @@ -9595,7 +8975,6 @@ Use the provided macros to access the info in this structure. Allocate a new #GstVideoInfo that is also initialized with gst_video_info_init(). - a new #GstVideoInfo. free with gst_video_info_free(). @@ -9607,7 +8986,6 @@ stride alignment in @align is respected. Extra padding will be added to the right side when stride alignment padding is required and @align will be updated with the new padding values. - %FALSE if alignment could not be applied, e.g. because the size of a frame can't be represented as a 32 bit integer (Since: 1.12) @@ -9631,7 +9009,6 @@ paddings. In case of GST_VIDEO_INTERLACE_MODE_ALTERNATE info, the returned sizes are the ones used to hold a single field, not the full frame. - %FALSE if alignment could not be applied, e.g. because the size of a frame can't be represented as a 32 bit integer @@ -9657,7 +9034,6 @@ ones used to hold a single field, not the full frame. GST_FORMAT_BYTES, GST_FORMAT_TIME, and GST_FORMAT_DEFAULT. For raw video, GST_FORMAT_DEFAULT corresponds to video frames. This function can be used to handle pad queries of the type GST_QUERY_CONVERT. - TRUE if the conversion was successful. @@ -9687,7 +9063,6 @@ function can be used to handle pad queries of the type GST_QUERY_CONVERT. Copy a GstVideoInfo structure. - a new #GstVideoInfo. free with gst_video_info_free. @@ -9702,7 +9077,6 @@ function can be used to handle pad queries of the type GST_QUERY_CONVERT. Free a GstVideoInfo structure previously allocated with gst_video_info_new() or gst_video_info_copy(). - @@ -9715,7 +9089,6 @@ or gst_video_info_copy(). Parse @caps and update @info. - TRUE if @caps could be parsed @@ -9733,7 +9106,6 @@ or gst_video_info_copy(). Initialize @info with default values. - @@ -9746,7 +9118,6 @@ or gst_video_info_copy(). Compares two #GstVideoInfo and returns whether they are equal or not - %TRUE if @info and @other are equal, else %FALSE. @@ -9768,7 +9139,6 @@ or gst_video_info_copy(). Note: This initializes @info first, no values are preserved. This function does not set the offsets correctly for interlaced vertically subsampled formats. - %FALSE if the returned video info is invalid, e.g. because the size of a frame can't be represented as a 32 bit integer (Since: 1.12) @@ -9796,7 +9166,6 @@ subsampled formats. Same as #gst_video_info_set_format but also allowing to set the interlaced mode. - %FALSE if the returned video info is invalid, e.g. because the size of a frame can't be represented as a 32 bit integer. @@ -9827,7 +9196,6 @@ mode. Convert the values of @info into a #GstCaps. - a new #GstCaps containing the info of @info. @@ -9872,7 +9240,6 @@ mode of the stream. Convert @mode to a #GstVideoInterlaceMode - the #GstVideoInterlaceMode of @mode or #GST_VIDEO_INTERLACE_MODE_PROGRESSIVE when @mode is not a valid @@ -9888,7 +9255,6 @@ mode of the stream. Convert @mode to its string representation. - @mode as a string or NULL if @mode in invalid. @@ -9904,7 +9270,6 @@ mode of the stream. Mastering display color volume information defined by SMPTE ST 2086 (a.k.a static HDR metadata). - the xy coordinates of primaries in the CIE 1931 color space. the index 0 contains red, 1 is for green and 2 is for blue. @@ -9935,7 +9300,6 @@ mode of the stream. Set string representation of @minfo to @caps - %TRUE if @minfo was successfully set to @caps @@ -9953,7 +9317,6 @@ mode of the stream. Parse @caps and update @minfo - %TRUE if @caps has #GstVideoMasteringDisplayInfo and could be parsed @@ -9971,7 +9334,6 @@ mode of the stream. Initialize @minfo - @@ -9984,7 +9346,6 @@ mode of the stream. Checks equality between @minfo and @other. - %TRUE if @minfo and @other are equal. @@ -10002,7 +9363,6 @@ mode of the stream. Convert @minfo to its string representation - a string representation of @minfo @@ -10016,7 +9376,6 @@ mode of the stream. Extract #GstVideoMasteringDisplayInfo from @mastering - %TRUE if @minfo was filled with @mastering @@ -10036,7 +9395,6 @@ mode of the stream. Used to represent display_primaries and white_point of #GstVideoMasteringDisplayInfo struct. See #GstVideoMasteringDisplayInfo - the x coordinate of CIE 1931 color space in unit of 0.00002. @@ -10080,7 +9438,6 @@ fields: - padding-right (uint): extra pixels on the right side The padding fields have the same semantic as #GstVideoMeta.alignment and so represent the paddings requested on produced video buffers. - parent #GstMeta @@ -10129,7 +9486,6 @@ and so represent the paddings requested on produced video buffers. - @@ -10157,7 +9513,6 @@ and so represent the paddings requested on produced video buffers. - @@ -10187,7 +9542,6 @@ divided by stride). It is not valid to call this function with a meta associated to a TILED video format. - %TRUE if @meta's alignment is valid and @plane_height has been updated, %FALSE otherwise @@ -10209,7 +9563,6 @@ updated, %FALSE otherwise Compute the size, in bytes, of each video plane described in @meta including any padding and alignment constraint defined in @meta->alignment. - %TRUE if @meta's alignment is valid and @plane_size has been updated, %FALSE otherwise @@ -10231,7 +9584,6 @@ updated, %FALSE otherwise Map the video plane with index @plane in @meta and return a pointer to the first byte of the plane and the stride of the plane. - TRUE if the map operation was successful. @@ -10267,7 +9619,6 @@ first byte of the plane and the stride of the plane. Set the alignment of @meta to @alignment. This function checks that the paddings defined in @alignment are compatible with the strides defined in @meta and will fail to update if they are not. - %TRUE if @alignment's meta has been updated, %FALSE if not @@ -10285,7 +9636,6 @@ defined in @meta and will fail to update if they are not. Unmap a previously mapped plane with gst_video_meta_map(). - TRUE if the memory was successfully unmapped. @@ -10306,7 +9656,6 @@ defined in @meta and will fail to update if they are not. - @@ -10315,7 +9664,6 @@ defined in @meta and will fail to update if they are not. Extra data passed to a video transform #GstMetaTransformFunction such as: "gst-video-scale". - the input #GstVideoInfo @@ -10326,7 +9674,6 @@ defined in @meta and will fail to update if they are not. Get the #GQuark for the "gst-video-scale" metadata transform operation. - a #GQuark @@ -10496,7 +9843,6 @@ provided as separate #GstMemory framebuffers attached to each and #GstVideoMeta(s) - The #GstVideoMultiviewMode value @@ -10513,7 +9859,6 @@ or #GST_VIDEO_MULTIVIEW_MODE_NONE - The caps string representation of the mode, or NULL if invalid. @@ -10532,10 +9877,8 @@ for insertion into a caps structure The interface allows unified access to control flipping and autocenter operation of video-sources or operators. - Get the horizontal centering offset from the given object. - %TRUE in case the element supports centering @@ -10553,7 +9896,6 @@ operation of video-sources or operators. Get the horizontal flipping state (%TRUE for flipped) from the given object. - %TRUE in case the element supports flipping @@ -10571,7 +9913,6 @@ operation of video-sources or operators. Get the vertical centering offset from the given object. - %TRUE in case the element supports centering @@ -10589,7 +9930,6 @@ operation of video-sources or operators. Get the vertical flipping state (%TRUE for flipped) from the given object. - %TRUE in case the element supports flipping @@ -10607,7 +9947,6 @@ operation of video-sources or operators. Set the horizontal centering offset for the given object. - %TRUE in case the element supports centering @@ -10625,7 +9964,6 @@ operation of video-sources or operators. Set the horizontal flipping state (%TRUE for flipped) for the given object. - %TRUE in case the element supports flipping @@ -10643,7 +9981,6 @@ operation of video-sources or operators. Set the vertical centering offset for the given object. - %TRUE in case the element supports centering @@ -10661,7 +9998,6 @@ operation of video-sources or operators. Set the vertical flipping state (%TRUE for flipped) for the given object. - %TRUE in case the element supports flipping @@ -10679,7 +10015,6 @@ operation of video-sources or operators. Get the horizontal centering offset from the given object. - %TRUE in case the element supports centering @@ -10697,7 +10032,6 @@ operation of video-sources or operators. Get the horizontal flipping state (%TRUE for flipped) from the given object. - %TRUE in case the element supports flipping @@ -10715,7 +10049,6 @@ operation of video-sources or operators. Get the vertical centering offset from the given object. - %TRUE in case the element supports centering @@ -10733,7 +10066,6 @@ operation of video-sources or operators. Get the vertical flipping state (%TRUE for flipped) from the given object. - %TRUE in case the element supports flipping @@ -10751,7 +10083,6 @@ operation of video-sources or operators. Set the horizontal centering offset for the given object. - %TRUE in case the element supports centering @@ -10769,7 +10100,6 @@ operation of video-sources or operators. Set the horizontal flipping state (%TRUE for flipped) for the given object. - %TRUE in case the element supports flipping @@ -10787,7 +10117,6 @@ operation of video-sources or operators. Set the vertical centering offset for the given object. - %TRUE in case the element supports centering @@ -10805,7 +10134,6 @@ operation of video-sources or operators. Set the vertical flipping state (%TRUE for flipped) for the given object. - %TRUE in case the element supports flipping @@ -10824,14 +10152,12 @@ operation of video-sources or operators. #GstVideoOrientationInterface interface. - parent interface type. - %TRUE in case the element supports flipping @@ -10850,7 +10176,6 @@ operation of video-sources or operators. - %TRUE in case the element supports flipping @@ -10869,7 +10194,6 @@ operation of video-sources or operators. - %TRUE in case the element supports centering @@ -10888,7 +10212,6 @@ operation of video-sources or operators. - %TRUE in case the element supports centering @@ -10907,7 +10230,6 @@ operation of video-sources or operators. - %TRUE in case the element supports flipping @@ -10926,7 +10248,6 @@ operation of video-sources or operators. - %TRUE in case the element supports flipping @@ -10945,7 +10266,6 @@ operation of video-sources or operators. - %TRUE in case the element supports centering @@ -10964,7 +10284,6 @@ operation of video-sources or operators. - %TRUE in case the element supports centering @@ -11274,13 +10593,11 @@ int main(int argc, char *argv[]) return ret; } ]| - This helper shall be used by classes implementing the #GstVideoOverlay interface that want the render rectangle to be controllable using properties. This helper will install "render-rectangle" property into the class. - @@ -11300,7 +10617,6 @@ class. interface that want the render rectangle to be controllable using properties. This helper will parse and set the render rectangle calling gst_video_overlay_set_render_rectangle(). - %TRUE if the @property_id matches the GstVideoOverlay property @@ -11327,7 +10643,6 @@ gst_video_overlay_set_render_rectangle(). Tell an overlay that it has been exposed. This will redraw the current frame in the drawable even if the pipeline is PAUSED. - @@ -11344,7 +10659,6 @@ events are forwarded 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 #GstVideoOverlay. - @@ -11360,7 +10674,6 @@ from the #GstVideoOverlay. - @@ -11387,7 +10700,6 @@ from the #GstVideoOverlay. should use this method to tell to an overlay to display video output to a specific window (e.g. an XWindow on X11). Passing 0 as the @handle will tell the overlay to stop using that window and create an internal one. - @@ -11405,7 +10717,6 @@ tell the overlay to stop using that window and create an internal one. Tell an overlay that it has been exposed. This will redraw the current frame in the drawable even if the pipeline is PAUSED. - @@ -11420,7 +10731,6 @@ in the drawable even if the pipeline is PAUSED. This will post a "have-window-handle" element message on the bus. This function should only be used by video overlay plugin developers. - @@ -11441,7 +10751,6 @@ events are forwarded 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 #GstVideoOverlay. - @@ -11463,7 +10772,6 @@ gst_video_overlay_set_window_handle() before a plugin creates its own window. This function should only be used by video overlay plugin developers. - @@ -11485,7 +10793,6 @@ 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. @@ -11518,7 +10825,6 @@ do not support subwindows. should use this method to tell to an overlay to display video output to a specific window (e.g. an XWindow on X11). Passing 0 as the @handle will tell the overlay to stop using that window and create an internal one. - @@ -11557,11 +10863,9 @@ have been put into a #GstVideoOverlayComposition object anyway) - for raw video the overlay can just use the blending function to blend the data on top of the video, and for surface buffers it can just attach them to the buffer and let the sink render the overlays. - Creates a new video overlay composition object to hold one or more overlay rectangles. - a new #GstVideoOverlayComposition. Unref with gst_video_overlay_composition_unref() when no longer needed. @@ -11578,7 +10882,6 @@ overlay rectangles. Adds an overlay rectangle to an existing overlay composition object. This must be done right after creating the overlay composition. - @@ -11601,7 +10904,6 @@ mapped appropriately. Since @video_buf data is read and will be modified, it ought be mapped with flag GST_MAP_READWRITE. - @@ -11623,7 +10925,6 @@ to modify the composition and contained rectangles (e.g. add additional rectangles or change the render co-ordinates or render dimension). The actual overlay pixel data buffers contained in the rectangles are not copied. - a new #GstVideoOverlayComposition equivalent to @comp. @@ -11638,7 +10939,6 @@ copied. Returns the @n-th #GstVideoOverlayRectangle contained in @comp. - the @n-th rectangle, or NULL if @n is out of bounds. Will not return a new reference, the caller will need to @@ -11662,7 +10962,6 @@ copied. monotonically increasing and unique for overlay compositions and rectangles (meaning there will never be a rectangle with the same sequence number as a composition). - the sequence number of @comp @@ -11680,7 +10979,6 @@ a composition). new writable copy of @comp and unref @comp itself. All the contained rectangles will also be copied, but the actual overlay pixel data buffers contained in the rectangles are not copied. - a writable #GstVideoOverlayComposition equivalent to @comp. @@ -11695,7 +10993,6 @@ contained in the rectangles are not copied. Returns the number of #GstVideoOverlayRectangle<!-- -->s contained in @comp. - the number of rectangles @@ -11710,7 +11007,6 @@ contained in the rectangles are not copied. Extra buffer metadata describing image overlay data. - parent #GstMeta @@ -11720,7 +11016,6 @@ contained in the rectangles are not copied. - @@ -11740,14 +11035,12 @@ contained in the rectangles are not copied. #GstVideoOverlay interface - parent interface type. - @@ -11761,7 +11054,6 @@ contained in the rectangles are not copied. - @@ -11779,7 +11071,6 @@ contained in the rectangles are not copied. - @@ -11804,7 +11095,6 @@ contained in the rectangles are not copied. - @@ -11824,7 +11114,6 @@ contained in the rectangles are not copied. An opaque video overlay rectangle object. A rectangle contains a single overlay rectangle which can be added to a composition. - Creates a new video overlay rectangle with ARGB or AYUV pixel data. The layout in case of ARGB of the components in memory is B-G-R-A @@ -11837,7 +11126,6 @@ component value. Unless specified in the flags, the RGB values are non-premultiplied. This is the format that is used by most hardware, and also many rendering libraries such as Cairo, for example. The pixel data buffer must have #GstVideoMeta set. - a new #GstVideoOverlayRectangle. Unref with gst_video_overlay_rectangle_unref() when no longer needed. @@ -11877,7 +11165,6 @@ The pixel data buffer must have #GstVideoMeta set. (e.g. to change the render co-ordinates or render dimension). The actual overlay pixel data buffers contained in the rectangle are not copied. - a new #GstVideoOverlayRectangle equivalent to @rectangle. @@ -11896,7 +11183,6 @@ This is useful if the caller can handle both premultiplied alpha and non premultiplied alpha, for example. By knowing whether the rectangle uses premultiplied or not, it can request the pixel data in the format it is stored in, to avoid unnecessary conversion. - the #GstVideoOverlayFormatFlags associated with the rectangle. @@ -11910,7 +11196,6 @@ it is stored in, to avoid unnecessary conversion. Retrieves the global-alpha value associated with a #GstVideoOverlayRectangle. - the global-alpha value associated with the rectangle. @@ -11923,7 +11208,6 @@ it is stored in, to avoid unnecessary conversion. - a #GstBuffer holding the ARGB pixel data with width and height of the render dimensions as per @@ -11948,7 +11232,6 @@ it is stored in, to avoid unnecessary conversion. - a #GstBuffer holding the AYUV pixel data with width and height of the render dimensions as per @@ -11973,7 +11256,6 @@ it is stored in, to avoid unnecessary conversion. - a #GstBuffer holding the pixel data with format as originally provided and specified in video meta with @@ -12003,7 +11285,6 @@ it is stored in, to avoid unnecessary conversion. do the scaling itself when handling the overlaying. The rectangle will need to be scaled to the render dimensions, which can be retrieved using gst_video_overlay_rectangle_get_render_rectangle(). - a #GstBuffer holding the ARGB pixel data with #GstVideoMeta set. This function does not return a reference, the caller @@ -12030,7 +11311,6 @@ gst_video_overlay_rectangle_get_render_rectangle(). do the scaling itself when handling the overlaying. The rectangle will need to be scaled to the render dimensions, which can be retrieved using gst_video_overlay_rectangle_get_render_rectangle(). - a #GstBuffer holding the AYUV pixel data with #GstVideoMeta set. This function does not return a reference, the caller @@ -12057,7 +11337,6 @@ gst_video_overlay_rectangle_get_render_rectangle(). do the scaling itself when handling the overlaying. The rectangle will need to be scaled to the render dimensions, which can be retrieved using gst_video_overlay_rectangle_get_render_rectangle(). - a #GstBuffer holding the pixel data with #GstVideoMeta set. This function does not return a reference, the caller @@ -12082,7 +11361,6 @@ gst_video_overlay_rectangle_get_render_rectangle(). Retrieves the render position and render dimension of the overlay rectangle on the video. - TRUE if valid render dimensions were retrieved. @@ -12125,7 +11403,6 @@ pixel-data returned by gst_video_overlay_rectangle_get_pixels_*() won't be different for different global-alpha values. In this case a renderer could also use the GstBuffer pointers as a hint for changed pixel-data. - the sequence number of @rectangle @@ -12146,7 +11423,6 @@ values: 0 <= global_alpha <= 1; 1 to deactivate. make the rectangles inside a #GstVideoOverlayComposition writable using gst_video_overlay_composition_make_writable() or gst_video_overlay_composition_copy(). - @@ -12171,7 +11447,6 @@ details of any overlays to match the operation that changed the size. make the rectangles inside a #GstVideoOverlayComposition writable using gst_video_overlay_composition_make_writable() or gst_video_overlay_composition_copy(). - @@ -12232,7 +11507,6 @@ gst_video_overlay_composition_copy(). Helper structure representing a rectangular area. - X coordinate of rectangle's top-left point @@ -12252,7 +11526,6 @@ gst_video_overlay_composition_copy(). Extra buffer metadata describing an image region of interest - parent #GstMeta @@ -12302,7 +11575,6 @@ For example, a structure named "roi/x264enc" could be used to give the QP offsets this encoder should use when encoding the region described in @meta. Multiple parameters can be defined for the same meta so different encoders can be supported by cross platform applications). - @@ -12322,7 +11594,6 @@ can be supported by cross platform applications). or %NULL if there is none. See also: gst_video_region_of_interest_meta_add_param() - a #GstStructure @@ -12339,7 +11610,6 @@ See also: gst_video_region_of_interest_meta_add_param() - @@ -12348,7 +11618,6 @@ See also: gst_video_region_of_interest_meta_add_param() #GstVideoResampler is a structure which holds the information required to perform various kinds of resampling filtering. - the input size @@ -12388,7 +11657,6 @@ required to perform various kinds of resampling filtering. Clear a previously initialized #GstVideoResampler @resampler. - @@ -12400,7 +11668,6 @@ required to perform various kinds of resampling filtering. - @@ -12469,7 +11736,6 @@ required to perform various kinds of resampling filtering. #GstVideoScaler is a utility object for rescaling and resampling video frames using various interpolation / sampling methods. - Scale a rectangle of pixels in @src with @src_stride to @dest with @dest_stride using the horizontal scaler @hscaler and the vertical @@ -12479,7 +11745,6 @@ One or both of @hscale and @vscale can be NULL to only perform scaling in one dimension or do a copy without scaling. @x and @y are the coordinates in the destination image to process. - @@ -12532,7 +11797,6 @@ one dimension or do a copy without scaling. Combine a scaler for Y and UV into one scaler for the packed @format. - a new horizontal videoscaler for @format. @@ -12558,7 +11822,6 @@ one dimension or do a copy without scaling. Free a previously allocated #GstVideoScaler @scale. - @@ -12575,7 +11838,6 @@ one dimension or do a copy without scaling. Note that for interlaced content, @in_offset needs to be incremented with 2 to get the next input line. - an array of @n_tap gdouble values with filter coefficients. @@ -12601,7 +11863,6 @@ Note that for interlaced content, @in_offset needs to be incremented with Get the maximum number of taps for @scale. - the maximum number of taps @@ -12616,7 +11877,6 @@ Note that for interlaced content, @in_offset needs to be incremented with Horizontally scale the pixels in @src to @dest, starting from @dest_offset for @width samples. - @@ -12651,7 +11911,6 @@ for @width samples. Vertically combine @width pixels in the lines in @src_lines to @dest. @dest is the location of the target line at @dest_offset and @srcs are the input lines for @dest_offset. - @@ -12689,7 +11948,6 @@ be scaled to @out_size destination lines/pixels. @n_taps specifies the amount of pixels to use from the source for one output pixel. If n_taps is 0, this function chooses a good value automatically based on the @method and @in_size/@out_size. - a #GstVideoScaler @@ -12737,12 +11995,10 @@ on the @method and @in_size/@out_size. GstVideoSink will configure the default base sink to drop frames that arrive later than 20ms as this is considered the default threshold for observing out-of-sync frames. - Takes @src rectangle and position it at the center of @dst rectangle with or without @scaling. It handles clipping if the @src rectangle is bigger than the @dst one and @scaling is set to FALSE. - @@ -12766,7 +12022,6 @@ the @dst one and @scaling is set to FALSE. - @@ -12807,14 +12062,12 @@ frames will only be rendered in PLAYING state. The video sink class structure. Derived classes should override the @show_frame virtual function. - the parent class structure - @@ -12834,9 +12087,7 @@ frames will only be rendered in PLAYING state. - - - + Enum value describing the available tiling modes. @@ -12869,7 +12120,6 @@ A representation of a SMPTE time code. @minutes and @seconds must be positive and less than 60. @frames must be less than or equal to @config.fps_n / @config.fps_d These values are *NOT* automatically normalized. - the corresponding #GstVideoTimeCodeConfig @@ -12897,7 +12147,6 @@ These values are *NOT* automatically normalized. @field_count is 0 for progressive, 1 or 2 for interlaced. @latest_daiy_jam reference is stolen from caller. - a new #GstVideoTimeCode with the given values. The values are not checked for being in a valid range. To see if your @@ -12944,7 +12193,6 @@ timecode actually has valid content, use gst_video_time_code_is_valid(). - a new empty, invalid #GstVideoTimeCode @@ -12957,7 +12205,6 @@ midnight, and timecode is set to the given time. This might return a completely invalid timecode, use gst_video_time_code_new_from_date_time_full() to ensure that you would get %NULL instead in that case. - the #GstVideoTimeCode representation of @dt. @@ -12988,7 +12235,6 @@ that you would get %NULL instead in that case. The resulting config->latest_daily_jam is set to midnight, and timecode is set to the given time. - the #GstVideoTimeCode representation of @dt, or %NULL if no valid timecode could be created. @@ -13018,7 +12264,6 @@ midnight, and timecode is set to the given time. - a new #GstVideoTimeCode from the given string or %NULL if the string could not be passed. @@ -13034,7 +12279,6 @@ midnight, and timecode is set to the given time. Adds or subtracts @frames amount of frames to @tc. tc needs to contain valid data, as verified by gst_video_time_code_is_valid(). - @@ -13057,7 +12301,6 @@ adding ("00:00:00;00", "00:01:00:00") will return "00:01:00;02" because of drop-frame oddities. However, adding ("00:09:00;02", "00:01:00:00") will return "00:10:00;00" because this time we can have an exact minute. - A new #GstVideoTimeCode with @tc_inter added or %NULL if the interval can't be added. @@ -13081,7 +12324,6 @@ be dropped. These are then corrected to the next reasonable timecode. Initializes @tc with empty/zero/NULL values and frees any memory it might currently use. - @@ -13096,7 +12338,6 @@ it might currently use. Compares @tc1 and @tc2. If both have latest daily jam information, it is taken into account. Otherwise, it is assumed that the daily jam of both @tc1 and @tc2 was at the same time. Both time codes must be valid. - 1 if @tc1 is after @tc2, -1 if @tc1 is before @tc2, 0 otherwise. @@ -13113,7 +12354,6 @@ taken into account. Otherwise, it is assumed that the daily jam of both - a new #GstVideoTimeCode with the same values as @tc. @@ -13126,7 +12366,6 @@ taken into account. Otherwise, it is assumed that the daily jam of both - how many frames have passed since the daily jam of @tc. @@ -13140,7 +12379,6 @@ taken into account. Otherwise, it is assumed that the daily jam of both Frees @tc. - @@ -13153,7 +12391,6 @@ taken into account. Otherwise, it is assumed that the daily jam of both Adds one frame to @tc. - @@ -13171,7 +12408,6 @@ taken into account. Otherwise, it is assumed that the daily jam of both Initializes @tc with the given values. The values are not checked for being in a valid range. To see if your timecode actually has valid content, use gst_video_time_code_is_valid(). - @@ -13224,7 +12460,6 @@ set to the given time. Will assert on invalid parameters, use gst_video_time_code_init_from_date_time_full() for being able to handle invalid parameters. - @@ -13258,7 +12493,6 @@ for being able to handle invalid parameters. The resulting config->latest_daily_jam is set to midnight, and timecode is set to the given time. - %TRUE if @tc could be correctly initialized to a valid timecode @@ -13291,7 +12525,6 @@ midnight, and timecode is set to the given time. - whether @tc is a valid timecode (supported frame rate, hours/minutes/seconds/frames not overflowing) @@ -13305,7 +12538,6 @@ hours/minutes/seconds/frames not overflowing) - how many nsec have passed since the daily jam of @tc. @@ -13319,7 +12551,6 @@ hours/minutes/seconds/frames not overflowing) The @tc.config->latest_daily_jam is required to be non-NULL. - the #GDateTime representation of @tc or %NULL if @tc has no daily jam. @@ -13333,7 +12564,6 @@ hours/minutes/seconds/frames not overflowing) - the SMPTE ST 2059-1:2015 string representation of @tc. That will take the form hh:mm:ss:ff. The last separator (between seconds and frames) @@ -13360,7 +12590,6 @@ interlaced field 2 frame), and integer frame rates e.g. 25/1, 30/1, 50/1, 60/1. The configuration of the time code. - Numerator of the frame rate @@ -13394,7 +12623,6 @@ For drop frame, only 30000/1001 and 60000/1001 frame rates are supported. A representation of a difference between two #GstVideoTimeCode instances. Will not necessarily correspond to a real timecode (e.g. 00:00:10;00) - the hours field of #GstVideoTimeCodeInterval @@ -13412,7 +12640,6 @@ Will not necessarily correspond to a real timecode (e.g. 00:00:10;00) - a new #GstVideoTimeCodeInterval with the given values. @@ -13438,7 +12665,6 @@ Will not necessarily correspond to a real timecode (e.g. 00:00:10;00) @tc_inter_str must only have ":" as separators. - a new #GstVideoTimeCodeInterval from the given string or %NULL if the string could not be passed. @@ -13453,7 +12679,6 @@ Will not necessarily correspond to a real timecode (e.g. 00:00:10;00) Initializes @tc with empty/zero/NULL values. - @@ -13465,7 +12690,6 @@ Will not necessarily correspond to a real timecode (e.g. 00:00:10;00) - a new #GstVideoTimeCodeInterval with the same values as @tc. @@ -13479,7 +12703,6 @@ Will not necessarily correspond to a real timecode (e.g. 00:00:10;00) Frees @tc. - @@ -13492,7 +12715,6 @@ Will not necessarily correspond to a real timecode (e.g. 00:00:10;00) Initializes @tc with the given values. - @@ -13525,7 +12747,6 @@ Will not necessarily correspond to a real timecode (e.g. 00:00:10;00) Each frame is assumed to have its own timecode, i.e. they are not automatically incremented/interpolated. - parent #GstMeta @@ -13535,7 +12756,6 @@ automatically incremented/interpolated. - @@ -13616,7 +12836,6 @@ The transfer characteristics (TransferCharacteristics) value is defined by "ISO/IEC 23001-8 Section 7.2 Table 3" and "ITU-T H.273 Table 3". "H.264 Table E-4" and "H.265 Table E.4" share the identical values. - the matched #GstVideoTransferFunction @@ -13634,7 +12853,6 @@ and "ITU-T H.273 Table 3". identical. In these cases, when doing conversion, we should consider them as equivalent. Also, BT2020_12 is the same as the aforementioned three for less than 12 bits per pixel. - TRUE if @from_func and @to_func can be considered equivalent. @@ -13663,7 +12881,6 @@ less than 12 bits per pixel. (TransferCharacteristics) value defined by "ISO/IEC 23001-8 Section 7.2 Table 3" and "ITU-T H.273 Table 3". "H.264 Table E-4" and "H.265 Table E.4" share the identical values. - The value of ISO/IEC 23001-8 transfer characteristics. @@ -13679,10 +12896,8 @@ and "ITU-T H.273 Table 3". An encoder for writing ancillary data to the Vertical Blanking Interval lines of component signals. - Create a new #GstVideoVBIEncoder for the specified @format and @pixel_width. - The new #GstVideoVBIEncoder or %NULL if the @format and/or @pixel_width is not supported. @@ -13704,7 +12919,6 @@ is not supported. Note that the contents of the data are always read as 8bit data (i.e. do not contain the parity check bits). - %TRUE if enough space was left in the current line, %FALSE otherwise. @@ -13742,7 +12956,6 @@ the parity check bits). - @@ -13754,7 +12967,6 @@ the parity check bits). Frees the @encoder. - @@ -13766,7 +12978,6 @@ the parity check bits). - @@ -13783,10 +12994,8 @@ the parity check bits). A parser for detecting and extracting @GstVideoAncillary data from Vertical Blanking Interval lines of component signals. - Create a new #GstVideoVBIParser for the specified @format and @pixel_width. - The new #GstVideoVBIParser or %NULL if the @format and/or @pixel_width is not supported. @@ -13806,7 +13015,6 @@ is not supported. Provide a new line of data to the @parser. Call gst_video_vbi_parser_get_ancillary() to get the Ancillary data that might be present on that line. - @@ -13824,7 +13032,6 @@ to get the Ancillary data that might be present on that line. - @@ -13836,7 +13043,6 @@ to get the Ancillary data that might be present on that line. Frees the @parser. - @@ -13849,7 +13055,6 @@ to get the Ancillary data that might be present on that line. Parse the line provided previously by gst_video_vbi_parser_add_line(). - %GST_VIDEO_VBI_PARSER_RESULT_OK if ancillary data was found and @anc was filled. %GST_VIDEO_VBI_PARSER_RESULT_DONE if there wasn't any @@ -13883,7 +13088,6 @@ data. Attaches #GstVideoAFDMeta metadata to @buffer with the given parameters. - the #GstVideoAFDMeta on @buffer. @@ -13910,7 +13114,6 @@ parameters. Attaches GstVideoAffineTransformationMeta metadata to @buffer with the given parameters. - the #GstVideoAffineTransformationMeta on @buffer. @@ -13925,7 +13128,6 @@ the given parameters. Attaches #GstVideoBarMeta metadata to @buffer with the given parameters. - the #GstVideoBarMeta on @buffer. @@ -13966,7 +13168,6 @@ https://www.atsc.org/wp-content/uploads/2015/03/a_53-Part-4-2009.pdf Attaches #GstVideoCaptionMeta metadata to @buffer with the given parameters. - the #GstVideoCaptionMeta on @buffer. @@ -13993,7 +13194,6 @@ parameters. - @@ -14002,7 +13202,6 @@ parameters. Attaches GstVideoGLTextureUploadMeta metadata to @buffer with the given parameters. - the #GstVideoGLTextureUploadMeta on @buffer. @@ -14048,7 +13247,6 @@ default offsets and strides for @format and @width x @height. This function calculates the default offsets and strides and then calls gst_buffer_add_video_meta_full() with them. - the #GstVideoMeta on @buffer. @@ -14078,7 +13276,6 @@ gst_buffer_add_video_meta_full() with them. Attaches GstVideoMeta metadata to @buffer with the given parameters. - the #GstVideoMeta on @buffer. @@ -14126,7 +13323,6 @@ gst_buffer_add_video_meta_full() with them. Sets an overlay composition on a buffer. The buffer will obtain its own reference to the composition, meaning this function does not take ownership of @comp. - a #GstVideoOverlayCompositionMeta @@ -14145,7 +13341,6 @@ of @comp. Attaches #GstVideoRegionOfInterestMeta metadata to @buffer with the given parameters. - the #GstVideoRegionOfInterestMeta on @buffer. @@ -14180,7 +13375,6 @@ parameters. Attaches #GstVideoRegionOfInterestMeta metadata to @buffer with the given parameters. - the #GstVideoRegionOfInterestMeta on @buffer. @@ -14215,7 +13409,6 @@ parameters. Attaches #GstVideoTimeCodeMeta metadata to @buffer with the given parameters. - the #GstVideoTimeCodeMeta on @buffer, or (since 1.16) %NULL if the timecode was invalid. @@ -14235,7 +13428,6 @@ parameters. Attaches #GstVideoTimeCodeMeta metadata to @buffer with the given parameters. - the #GstVideoTimeCodeMeta on @buffer, or (since 1.16) %NULL if the timecode was invalid. @@ -14288,7 +13480,6 @@ parameters. Gets the #GstVideoAFDMeta that might be present on @b. Note: there may be two #GstVideoAFDMeta structs for interlaced video. - A #GstBuffer @@ -14296,7 +13487,6 @@ Note: there may be two #GstVideoAFDMeta structs for interlaced video. - @@ -14304,7 +13494,6 @@ Note: there may be two #GstVideoAFDMeta structs for interlaced video. Gets the #GstVideoBarMeta that might be present on @b. - A #GstBuffer @@ -14313,7 +13502,6 @@ Note: there may be two #GstVideoAFDMeta structs for interlaced video. Gets the #GstVideoCaptionMeta that might be present on @b. - A #GstBuffer @@ -14321,14 +13509,12 @@ Note: there may be two #GstVideoAFDMeta structs for interlaced video. - - @@ -14339,7 +13525,6 @@ Note: there may be two #GstVideoAFDMeta structs for interlaced video. Buffers can contain multiple #GstVideoMeta metadata items when dealing with multiview buffers. - the #GstVideoMeta with lowest id (usually 0) or %NULL when there is no such metadata on @buffer. @@ -14357,7 +13542,6 @@ is no such metadata on @buffer. Buffers can contain multiple #GstVideoMeta metadata items when dealing with multiview buffers. - the #GstVideoMeta with @id or %NULL when there is no such metadata on @buffer. @@ -14375,21 +13559,18 @@ on @buffer. - - - @@ -14400,7 +13581,6 @@ on @buffer. Buffers can contain multiple #GstVideoRegionOfInterestMeta metadata items if multiple regions of interests are marked on a frame. - the #GstVideoRegionOfInterestMeta with @id or %NULL when there is no such metadata on @buffer. @@ -14418,7 +13598,6 @@ no such metadata on @buffer. - @@ -14427,7 +13606,6 @@ no such metadata on @buffer. Get the video alignment from the bufferpool configuration @config in in @align - %TRUE if @config could be parsed correctly. @@ -14446,7 +13624,6 @@ in @align Set the video alignment in @align to the bufferpool configuration @config - @@ -14462,7 +13639,6 @@ in @align - @@ -14495,7 +13671,6 @@ to automatically add #GstVideoMeta to the buffers. Convenience function to check if the given message is a "prepare-window-handle" message from a #GstVideoOverlay. - whether @msg is a "prepare-window-handle" message @@ -14510,7 +13685,6 @@ to automatically add #GstVideoMeta to the buffers. Inspect a #GstEvent and return the #GstNavigationEventType of the event, or #GST_NAVIGATION_EVENT_INVALID if the event is not a #GstNavigation event. - @@ -14524,7 +13698,6 @@ to automatically add #GstVideoMeta to the buffers. Inspect a #GstNavigation command event and retrieve the enum value of the associated command. - TRUE if the navigation command could be extracted, otherwise FALSE. @@ -14542,7 +13715,6 @@ associated command. - @@ -14563,7 +13735,6 @@ associated command. 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. - TRUE if the button number and both coordinates could be extracted, otherwise FALSE. @@ -14594,7 +13765,6 @@ gst_navigation_event_get_type() to retrieve the #GstNavigationEventType. Inspect a #GstNavigation mouse movement event and extract the coordinates of the event. - TRUE if both coordinates could be extracted, otherwise FALSE. @@ -14619,7 +13789,6 @@ of the event. Inspect a #GstNavigation mouse scroll event and extract the coordinates of the event. - TRUE if all coordinates could be extracted, otherwise FALSE. @@ -14654,7 +13823,6 @@ of the event. Check a bus message to see if it is a #GstNavigation event, and return the #GstNavigationMessageType identifying the type of the message if so. - The type of the #GstMessage, or #GST_NAVIGATION_MESSAGE_INVALID if the message is not a #GstNavigation @@ -14673,7 +13841,6 @@ notification. #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. @@ -14696,7 +13863,6 @@ multiangle video has changed. Creates a new #GstNavigation message with type #GST_NAVIGATION_MESSAGE_COMMANDS_CHANGED - The new #GstMessage. @@ -14711,7 +13877,6 @@ multiangle video has changed. Creates a new #GstNavigation message with type #GST_NAVIGATION_MESSAGE_EVENT. - The new #GstMessage. @@ -14730,7 +13895,6 @@ multiangle video has changed. Creates a new #GstNavigation message with type #GST_NAVIGATION_MESSAGE_MOUSE_OVER. - The new #GstMessage. @@ -14750,7 +13914,6 @@ multiangle video has changed. 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. @@ -14776,7 +13939,6 @@ and extract the @cur_angle and @n_angles parameters. Parse a #GstNavigation message of type #GST_NAVIGATION_MESSAGE_EVENT and extract contained #GstEvent. The caller must unref the @event when done with it. - %TRUE if the message could be successfully parsed. %FALSE if not. @@ -14797,7 +13959,6 @@ with it. 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. @@ -14817,7 +13978,6 @@ active, it indicates that the mouse is over a clickable area. Inspect a #GstQuery and return the #GstNavigationQueryType associated with it if it is a #GstNavigation query. - The #GstNavigationQueryType of the query, or #GST_NAVIGATION_QUERY_INVALID @@ -14834,7 +13994,6 @@ it if it is a #GstNavigation query. 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. @@ -14843,7 +14002,6 @@ greater than one in a multiangle video. Create a new #GstNavigation commands query. When executed, it will query the pipeline for the set of currently available commands. - The new query. @@ -14853,7 +14011,6 @@ query the pipeline for the set of currently available commands. 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. @@ -14877,7 +14034,6 @@ angles into the #guint pointed to by the @n_angles variable. Parse the number of commands in the #GstNavigation commands @query. - %TRUE if the query could be successfully parsed. %FALSE if not. @@ -14897,7 +14053,6 @@ angles into the #guint pointed to by the @n_angles variable. 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. @@ -14919,7 +14074,6 @@ set to #GST_NAVIGATION_COMMAND_INVALID. Set the #GstNavigation angles query result field in @query. - @@ -14941,7 +14095,6 @@ set to #GST_NAVIGATION_COMMAND_INVALID. Set the #GstNavigation command query result fields in @query. The number of commands passed must be equal to @n_commands. - @@ -14964,44 +14117,37 @@ of commands passed must be equal to @n_commands. - - - - - - Lets you blend the @src image into the @dest image - @@ -15034,7 +14180,6 @@ of commands passed must be equal to @n_commands. helper function which is used to scale subtitle overlays, and may be deprecated in the near future. Use #GstVideoScaler to scale video buffers instead. - @@ -15071,7 +14216,6 @@ instead. Given the Pixel Aspect Ratio and size of an input video frame, and the pixel aspect ratio of the intended display device, calculates the actual display ratio the video will be rendered with. - A boolean indicating success and a calculated Display Ratio in the dar_n and dar_d parameters. @@ -15114,13 +14258,11 @@ The return value is FALSE in the case of integer overflow or other error. - - @@ -15128,7 +14270,6 @@ The return value is FALSE in the case of integer overflow or other error. Parses fixed Closed Caption #GstCaps and returns the corresponding caption type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN. - #GstVideoCaptionType. @@ -15142,7 +14283,6 @@ type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN. Creates new caps corresponding to @type. - new #GstCaps @@ -15156,7 +14296,6 @@ type, or %GST_VIDEO_CAPTION_TYPE_UNKNOWN. Convert @s to a #GstVideoChromaSite - a #GstVideoChromaSite or %GST_VIDEO_CHROMA_SITE_UNKNOWN when @s does not contain a valid chroma description. @@ -15171,7 +14310,6 @@ not contain a valid chroma description. Perform resampling of @width chroma pixels in @lines. - @@ -15194,7 +14332,6 @@ not contain a valid chroma description. Create a new resampler object for the given parameters. When @h_factor or @v_factor is > 0, upsampling will be used, otherwise subsampling is performed. - a new #GstVideoChromaResample that should be freed with gst_video_chroma_resample_free() after usage. @@ -15229,7 +14366,6 @@ performed. Converts @site to its string representation. - a string describing @site. @@ -15247,7 +14383,6 @@ The matrix coefficients (MatrixCoefficients) value is defined by "ISO/IEC 23001-8 Section 7.3 Table 4" and "ITU-T H.273 Table 4". "H.264 Table E-5" and "H.265 Table E.5" share the identical values. - the matched #GstVideoColorMatrix @@ -15284,7 +14419,6 @@ and the other way around: G' = Y' - Cb*2*(1-Kb)*Kb/(1-Kr-Kb) - Cr*2*(1-Kr)*Kr/(1-Kr-Kb) B' = Y' + Cb*2*(1-Kb) ]| - TRUE if @matrix was a YUV color format and @Kr and @Kb contain valid values. @@ -15310,7 +14444,6 @@ and the other way around: (MatrixCoefficients) value defined by "ISO/IEC 23001-8 Section 7.3 Table 4" and "ITU-T H.273 Table 4". "H.264 Table E-5" and "H.265 Table E.5" share the identical values. - The value of ISO/IEC 23001-8 matrix coefficients. @@ -15327,7 +14460,6 @@ and "ITU-T H.273 Table 4". The colour primaries (ColourPrimaries) value is defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". "H.264 Table E-3" and "H.265 Table E.3" share the identical values. - the matched #GstVideoColorPrimaries @@ -15341,7 +14473,6 @@ defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". Get information about the chromaticity coordinates of @primaries. - a #GstVideoColorPrimariesInfo for @primaries. @@ -15358,7 +14489,6 @@ defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". value defined by "ISO/IEC 23001-8 Section 7.1 Table 2" and "ITU-T H.273 Table 2". "H.264 Table E-3" and "H.265 Table E.3" share the identical values. - The value of ISO/IEC 23001-8 colour primaries. @@ -15378,7 +14508,6 @@ range [0.0 .. 1.0]. The reverse operation (c[i] * scale[i]) + offset[i] can be used to convert the component values in range [0.0 .. 1.0] back to their representation in @info and @range. - @@ -15418,7 +14547,6 @@ L is in general performed with a power function like: Depending on @func, different formulas might be applied. Some formulas encode a linear segment in the lower range. - the gamma decoded value of @val @@ -15446,7 +14574,6 @@ For a linear value L in the range [0..1], conversion to the non-linear Depending on @func, different formulas might be applied. Some formulas encode a linear segment in the lower range. - the gamma encoded value of @val @@ -15468,7 +14595,6 @@ encode a linear segment in the lower range. The output caps can be any raw video formats or any image formats (jpeg, png, ...). The width, height and pixel-aspect-ratio can also be specified in the output caps. - The converted #GstSample, or %NULL if an error happened (in which case @err will point to the #GError). @@ -15503,7 +14629,6 @@ this will always be the global default main context. @destroy_notify will be called after the callback was called and @user_data is not needed anymore. - @@ -15537,7 +14662,6 @@ anymore. Create a new converter object to convert between @in_info and @out_info with @config. - a #GstVideoConverter or %NULL if conversion is not possible. @@ -15558,13 +14682,11 @@ with @config. - - @@ -15577,7 +14699,6 @@ Each component will be quantized to a multiple of @quantizer. Better performance is achieved when @quantizer is a power of 2. @width is the width of the lines that this ditherer will handle. - a new #GstVideoDither @@ -15608,7 +14729,6 @@ performance is achieved when @quantizer is a power of 2. Checks if an event is a force key unit event. Returns true for both upstream and downstream force key unit events. - %TRUE if the event is a valid force key unit event @@ -15629,7 +14749,6 @@ handled. To parse an event created by gst_video_event_new_downstream_force_key_unit() use gst_video_event_parse_downstream_force_key_unit(). - The new GstEvent @@ -15664,7 +14783,6 @@ the event ends a still frame sequence. To parse an event created by gst_video_event_new_still_frame() use gst_video_event_parse_still_frame(). - The new GstEvent @@ -15686,7 +14804,6 @@ new key unit as soon as possible. To parse an event created by gst_video_event_new_downstream_force_key_unit() use gst_video_event_parse_downstream_force_key_unit(). - The new GstEvent @@ -15712,7 +14829,6 @@ key unit event. See gst_video_event_new_downstream_force_key_unit() for a full description of the downstream force key unit event. @running_time will be adjusted for any pad offsets of pads it was passing through. - %TRUE if the event is a valid downstream force key unit event. @@ -15753,7 +14869,6 @@ in_still variable order to just check whether the event is a valid still-frame event. Create a still frame event using gst_video_event_new_still_frame() - %TRUE if the event is a valid still-frame event. %FALSE if not @@ -15778,7 +14893,6 @@ upstream force key unit event. Create an upstream force key unit event using gst_video_event_new_upstream_force_key_unit() @running_time will be adjusted for any pad offsets of pads it was passing through. - %TRUE if the event is a valid upstream force-key-unit event. %FALSE if not @@ -15804,7 +14918,6 @@ Create an upstream force key unit event using gst_video_event_new_upstream_forc Convert @order to a #GstVideoFieldOrder - the #GstVideoFieldOrder of @order or #GST_VIDEO_FIELD_ORDER_UNKNOWN when @order is not a valid @@ -15820,7 +14933,6 @@ Create an upstream force key unit event using gst_video_event_new_upstream_forc Convert @order to its string representation. - @order as a string or NULL if @order in invalid. @@ -15836,7 +14948,6 @@ Create an upstream force key unit event using gst_video_event_new_upstream_forc Converts a FOURCC value into the corresponding #GstVideoFormat. If the FOURCC cannot be represented by #GstVideoFormat, #GST_VIDEO_FORMAT_UNKNOWN is returned. - the #GstVideoFormat describing the FOURCC value @@ -15850,7 +14961,6 @@ If the FOURCC cannot be represented by #GstVideoFormat, Find the #GstVideoFormat for the given parameters. - a #GstVideoFormat or GST_VIDEO_FORMAT_UNKNOWN when the parameters to not specify a known format. @@ -15890,7 +15000,6 @@ not specify a known format. Convert the @format string to its #GstVideoFormat. - the #GstVideoFormat for @format or GST_VIDEO_FORMAT_UNKNOWN when the string is not a known format. @@ -15905,7 +15014,6 @@ string is not a known format. Get the #GstVideoFormatInfo for @format - The #GstVideoFormatInfo for @format. @@ -15920,7 +15028,6 @@ string is not a known format. Get the default palette of @format. This the palette used in the pack function for paletted formats. - the default palette of @format or %NULL when @format does not have a palette. @@ -15941,7 +15048,6 @@ function for paletted formats. Converts a #GstVideoFormat value into the corresponding FOURCC. Only a few YUV formats have corresponding FOURCC values. If @format has no corresponding FOURCC value, 0 is returned. - the FOURCC corresponding to @format @@ -15956,7 +15062,6 @@ no corresponding FOURCC value, 0 is returned. Returns a string containing a descriptive name for the #GstVideoFormat if there is one, or NULL otherwise. - the name corresponding to @format @@ -15970,7 +15075,6 @@ the #GstVideoFormat if there is one, or NULL otherwise. Return all the raw video formats supported by GStreamer. - an array of #GstVideoFormat @@ -15985,13 +15089,11 @@ the #GstVideoFormat if there is one, or NULL otherwise. - - @@ -16005,7 +15107,6 @@ It will calculate an arbitrary framerate if no close match was found, and return %FALSE. It returns %FALSE if a duration of 0 is passed. - %TRUE if a close "standard" framerate was recognised, and %FALSE otherwise. @@ -16028,7 +15129,6 @@ recognised, and %FALSE otherwise. Convert @mode to a #GstVideoInterlaceMode - the #GstVideoInterlaceMode of @mode or #GST_VIDEO_INTERLACE_MODE_PROGRESSIVE when @mode is not a valid @@ -16044,7 +15144,6 @@ recognised, and %FALSE otherwise. Convert @mode to its string representation. - @mode as a string or NULL if @mode in invalid. @@ -16060,7 +15159,6 @@ recognised, and %FALSE otherwise. Return a generic raw video caps for formats defined in @formats. If @formats is %NULL returns a caps for all the supported raw video formats, see gst_video_formats_raw(). - a video @GstCaps @@ -16083,7 +15181,6 @@ see gst_video_formats_raw(). @features. If @formats is %NULL returns a caps for all the supported video formats, see gst_video_formats_raw(). - a video @GstCaps @@ -16107,7 +15204,6 @@ see gst_video_formats_raw(). Extract #GstVideoMasteringDisplayInfo from @mastering - %TRUE if @minfo was filled with @mastering @@ -16124,27 +15220,23 @@ see gst_video_formats_raw(). - - Get the #GQuark for the "gst-video-scale" metadata transform operation. - a #GQuark - A const #GValue containing a list of stereo video modes @@ -16155,7 +15247,6 @@ caps negotiations. Currently this is top-bottom and row-interleaved. - A const #GValue containing a list of stereo video modes @@ -16167,7 +15258,6 @@ view for use in caps negotiation. Currently this is just - A const #GValue containing a list of stereo video modes @@ -16179,7 +15269,6 @@ and column-interleaved. - A const #GValue containing a list of mono video modes @@ -16189,7 +15278,6 @@ modes (mono/left/right) for use in caps negotiations. - A const #GValue containing a list of 'unpacked' stereo video modes @@ -16200,7 +15288,6 @@ for use in caps negotiations. - A boolean indicating whether the #GST_VIDEO_MULTIVIEW_FLAGS_HALF_ASPECT flag should be set. @@ -16235,7 +15322,6 @@ overall display aspect ratio. - The #GstVideoMultiviewMode value @@ -16252,7 +15338,6 @@ or #GST_VIDEO_MULTIVIEW_MODE_NONE - The caps string representation of the mode, or NULL if invalid. @@ -16271,7 +15356,6 @@ for insertion into a caps structure Utility function that transforms the width/height/PAR and multiview mode and flags of a #GstVideoInfo into the requested mode. - @@ -16291,13 +15375,11 @@ the requested mode. - - @@ -16307,7 +15389,6 @@ the requested mode. interface that want the render rectangle to be controllable using properties. This helper will install "render-rectangle" property into the class. - @@ -16327,7 +15408,6 @@ class. interface that want the render rectangle to be controllable using properties. This helper will parse and set the render rectangle calling gst_video_overlay_set_render_rectangle(). - %TRUE if the @property_id matches the GstVideoOverlay property @@ -16352,13 +15432,11 @@ gst_video_overlay_set_render_rectangle(). - - @@ -16370,7 +15448,6 @@ be scaled to @out_size destination lines/pixels. @n_taps specifies the amount of pixels to use from the source for one output pixel. If n_taps is 0, this function chooses a good value automatically based on the @method and @in_size/@out_size. - a #GstVideoScaler @@ -16407,7 +15484,6 @@ on the @method and @in_size/@out_size. image of @x_tiles by @y_tiles. Use this method when @mode is of type %GST_VIDEO_TILE_TYPE_INDEXED. - the index of the tile at @x and @y in the tiled image of @x_tiles by @y_tiles. @@ -16437,13 +15513,11 @@ Use this method when @mode is of type %GST_VIDEO_TILE_TYPE_INDEXED. - - @@ -16454,7 +15528,6 @@ The transfer characteristics (TransferCharacteristics) value is defined by "ISO/IEC 23001-8 Section 7.2 Table 3" and "ITU-T H.273 Table 3". "H.264 Table E-4" and "H.265 Table E.4" share the identical values. - the matched #GstVideoTransferFunction @@ -16472,7 +15545,6 @@ and "ITU-T H.273 Table 3". identical. In these cases, when doing conversion, we should consider them as equivalent. Also, BT2020_12 is the same as the aforementioned three for less than 12 bits per pixel. - TRUE if @from_func and @to_func can be considered equivalent. @@ -16501,7 +15573,6 @@ less than 12 bits per pixel. (TransferCharacteristics) value defined by "ISO/IEC 23001-8 Section 7.2 Table 3" and "ITU-T H.273 Table 3". "H.264 Table E-4" and "H.265 Table E.4" share the identical values. - The value of ISO/IEC 23001-8 transfer characteristics. diff --git a/gir-files/GstWebRTC-1.0.gir b/gir-files/GstWebRTC-1.0.gir index 1af7222de..c96518339 100644 --- a/gir-files/GstWebRTC-1.0.gir +++ b/gir-files/GstWebRTC-1.0.gir @@ -9,224 +9,192 @@ and/or use gtk-doc annotations. --> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -263,9 +231,7 @@ for more information. - - @@ -279,7 +245,6 @@ for more information. - @@ -344,7 +309,6 @@ for more information. - @@ -372,10 +336,8 @@ for more information. - Close the @channel. - @@ -388,7 +350,6 @@ for more information. Send @data as a data message over @channel. - @@ -405,7 +366,6 @@ for more information. Send @str as a string message over @channel. - @@ -422,7 +382,6 @@ for more information. Close the @channel. - @@ -435,7 +394,6 @@ for more information. Signal that the data channel reached a low buffered amount. Should only be used by subclasses. - @@ -448,7 +406,6 @@ for more information. Signal that the data channel was closed. Should only be used by subclasses. - @@ -461,7 +418,6 @@ for more information. Signal that the data channel had an error. Should only be used by subclasses. - @@ -478,7 +434,6 @@ for more information. Signal that the data channel received a data message. Should only be used by subclasses. - @@ -495,7 +450,6 @@ for more information. Signal that the data channel received a string message. Should only be used by subclasses. - @@ -512,7 +466,6 @@ for more information. Signal that the data channel was opened. Should only be used by subclasses. - @@ -525,7 +478,6 @@ for more information. Send @data as a data message over @channel. - @@ -542,7 +494,6 @@ for more information. Send @str as a string message over @channel. - @@ -712,13 +663,11 @@ for more information. - - @@ -736,7 +685,6 @@ for more information. - @@ -754,7 +702,6 @@ for more information. - @@ -851,9 +798,7 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcdatachannelstate> - - @@ -864,7 +809,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcdatachannelstate> - @@ -878,7 +822,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcdatachannelstate> - @@ -892,7 +835,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcdatachannelstate> - @@ -912,7 +854,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcdatachannelstate> - @@ -974,13 +915,11 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcdatachannelstate> - - @@ -1044,15 +983,12 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcprioritytype> - - - @@ -1066,7 +1002,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcprioritytype> - @@ -1095,7 +1030,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcprioritytype> - @@ -1106,15 +1040,12 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcprioritytype> - - - @@ -1128,7 +1059,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcprioritytype> - @@ -1162,7 +1092,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcprioritytype> - @@ -1173,7 +1102,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcprioritytype> - Direction of the transceiver. @@ -1221,7 +1149,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcprioritytype> - @@ -1278,7 +1205,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcsctptransportstate> rollback - the string representation of @type or "unknown" when @type is not recognized. @@ -1294,7 +1220,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcsctptransportstate> See <https://www.w3.org/TR/webrtc/#rtcsessiondescription-class> - the #GstWebRTCSDPType of the description @@ -1304,7 +1229,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcsctptransportstate> - a new #GstWebRTCSessionDescription from @type and @sdp @@ -1322,7 +1246,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcsctptransportstate> - a new copy of @src @@ -1336,7 +1259,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcsctptransportstate> Free @desc and all associated resources - @@ -1435,7 +1357,6 @@ See <http://w3c.github.io/webrtc-pc/#dom-rtcsctptransportstate> <https://www.w3.org/TR/webrtc/#rtcrtptransceiver-interface> - the string representation of @type or "unknown" when @type is not recognized.