/usr/share/gir-1.0/GrlPls-0.3.gir is in libgrilo-0.3-dev 0.3.2-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 | <?xml version="1.0"?>
<!-- This file was automatically generated from C sources - DO NOT EDIT!
To affect the contents of this file, edit the original C definitions,
and/or use gtk-doc annotations. -->
<repository version="1.2"
xmlns="http://www.gtk.org/introspection/core/1.0"
xmlns:c="http://www.gtk.org/introspection/c/1.0"
xmlns:glib="http://www.gtk.org/introspection/glib/1.0">
<include name="GObject" version="2.0"/>
<include name="Gio" version="2.0"/>
<include name="Grl" version="0.3"/>
<namespace name="GrlPls"
version="0.3"
shared-library="libgrlpls-0.3.so.0,libgrilo-0.3.so.0"
c:identifier-prefixes="GrlPls"
c:symbol-prefixes="grl_pls">
<callback name="FilterFunc" c:type="GrlPlsFilterFunc">
<doc xml:space="preserve">Callback type to filter, or modify #GrlMedia created
when parsing a playlist using one of grl_pls_browse(),
grl_pls_browse_sync() or grl_pls_browse_by_spec().
The callback is responsible for unreffing @media when returning %NULL or
another #GrlMedia.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">%NULL to not add this entry to the results,
or a new #GrlMedia populated with metadata of your choice.</doc>
<type name="Grl.Media" c:type="GrlMedia*"/>
</return-value>
<parameters>
<parameter name="source" transfer-ownership="none">
<doc xml:space="preserve">the #GrlSource the browse call came from</doc>
<type name="Grl.Source" c:type="GrlSource*"/>
</parameter>
<parameter name="media" transfer-ownership="full">
<doc xml:space="preserve">a #GrlMedia to operate on</doc>
<type name="Grl.Media" c:type="GrlMedia*"/>
</parameter>
<parameter name="user_data"
transfer-ownership="none"
nullable="1"
allow-none="1"
closure="2">
<doc xml:space="preserve">user data passed to the browse call</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</callback>
<function name="browse" c:identifier="grl_pls_browse" version="0.2.0">
<doc xml:space="preserve">Browse into a playlist. The playlist entries are
returned via the @callback function as GrlMedia objects.
This function imitates the API and way of working of
#grl_source_browse.
The @playlist provided could be of any GrlMedia class,
as long as its URI points to a valid playlist file.
This function is asynchronous.
See #grl_source_browse() function for additional information
and sample code.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">the operation identifier</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
<parameter name="source" transfer-ownership="none">
<doc xml:space="preserve">a source</doc>
<type name="Grl.Source" c:type="GrlSource*"/>
</parameter>
<parameter name="playlist" transfer-ownership="none">
<doc xml:space="preserve">a playlist</doc>
<type name="Grl.Media" c:type="GrlMedia*"/>
</parameter>
<parameter name="keys" transfer-ownership="none">
<doc xml:space="preserve">the #GList of
#GrlKeyID<!-- -->s to request</doc>
<type name="GLib.List" c:type="const GList*">
<type name="Grl.KeyID"/>
</type>
</parameter>
<parameter name="options" transfer-ownership="none">
<doc xml:space="preserve">options wanted for that operation</doc>
<type name="Grl.OperationOptions" c:type="GrlOperationOptions*"/>
</parameter>
<parameter name="filter_func"
transfer-ownership="none"
nullable="1"
allow-none="1"
scope="async">
<doc xml:space="preserve">A filter function, or %NULL</doc>
<type name="FilterFunc" c:type="GrlPlsFilterFunc"/>
</parameter>
<parameter name="callback"
transfer-ownership="none"
scope="notified"
closure="6">
<doc xml:space="preserve">the user defined callback</doc>
<type name="Grl.SourceResultCb" c:type="GrlSourceResultCb"/>
</parameter>
<parameter name="user_data"
transfer-ownership="none"
nullable="1"
allow-none="1">
<doc xml:space="preserve">the user data to pass in the callback</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</function>
<function name="browse_by_spec"
c:identifier="grl_pls_browse_by_spec"
version="0.2.0">
<doc xml:space="preserve">Browse into a playlist. The playlist entries are
returned via the bs->callback function as GrlMedia objects.
This function is more suitable to be called from plugins, which by
design get the GrlSourceBrowseSpec already filled in.
The bs->playlist provided could be of any GrlMedia class,
as long as its URI points to a valid playlist file.
This function is asynchronous.
See #grl_pls_browse() and #grl_source_browse() function for additional
information and sample code.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="source" transfer-ownership="none">
<doc xml:space="preserve">a source</doc>
<type name="Grl.Source" c:type="GrlSource*"/>
</parameter>
<parameter name="filter_func"
transfer-ownership="none"
nullable="1"
allow-none="1"
scope="async">
<doc xml:space="preserve">A filter function, or %NULL</doc>
<type name="FilterFunc" c:type="GrlPlsFilterFunc"/>
</parameter>
<parameter name="bs" transfer-ownership="none">
<doc xml:space="preserve">a GrlSourceBrowseSpec structure with details of the browsing operation</doc>
<type name="Grl.SourceBrowseSpec" c:type="GrlSourceBrowseSpec*"/>
</parameter>
</parameters>
</function>
<function name="browse_sync"
c:identifier="grl_pls_browse_sync"
version="0.2.0"
throws="1">
<doc xml:space="preserve">Browse into a playlist. The playlist entries are
returned via the @callback function as GrlMedia objects.
This function imitates the API and way of working of
#grl_source_browse_sync.
The filter function @filter_func will be used for plugins
or applications to be able to refuse particular entries from
being listed.
If a %NULL filter function is passed, the media will be added
with only the metadata coming from the playlist included.
This function is synchronous.
See #grl_source_browse_sync() function for additional information
and sample code.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a #GList with #GrlMedia
elements. After use g_object_unref() every element and g_list_free() the
list.</doc>
<type name="GLib.List" c:type="GList*">
<type name="Grl.Media"/>
</type>
</return-value>
<parameters>
<parameter name="source" transfer-ownership="none">
<doc xml:space="preserve">a source</doc>
<type name="Grl.Source" c:type="GrlSource*"/>
</parameter>
<parameter name="playlist" transfer-ownership="none">
<doc xml:space="preserve">a playlist</doc>
<type name="Grl.Media" c:type="GrlMedia*"/>
</parameter>
<parameter name="keys" transfer-ownership="none">
<doc xml:space="preserve">the #GList of
#GrlKeyID<!-- -->s to request</doc>
<type name="GLib.List" c:type="const GList*">
<type name="Grl.KeyID"/>
</type>
</parameter>
<parameter name="options" transfer-ownership="none">
<doc xml:space="preserve">options wanted for that operation</doc>
<type name="Grl.OperationOptions" c:type="GrlOperationOptions*"/>
</parameter>
<parameter name="filter_func"
transfer-ownership="none"
nullable="1"
allow-none="1"
scope="async">
<doc xml:space="preserve">A filter function, or %NULL</doc>
<type name="FilterFunc" c:type="GrlPlsFilterFunc"/>
</parameter>
</parameters>
</function>
<function name="file_to_media"
c:identifier="grl_pls_file_to_media"
version="0.2.0">
<doc xml:space="preserve">This function will update (if @content is non-%NULL) or create a
GrlMedia and populate it with information from @info.
If @info is %NULL, a call to g_file_query_info() will be made.
This function is useful for plugins that browse the local filesystem
and want to easily create GrlMedia from filesystem information.</doc>
<return-value transfer-ownership="full">
<doc xml:space="preserve">a new #GrlMedia.</doc>
<type name="Grl.Media" c:type="GrlMedia*"/>
</return-value>
<parameters>
<parameter name="content" transfer-ownership="none">
<doc xml:space="preserve">an existing #GrlMedia for the file, or %NULL</doc>
<type name="Grl.Media" c:type="GrlMedia*"/>
</parameter>
<parameter name="file" transfer-ownership="none">
<doc xml:space="preserve">a #GFile pointing to the file or directory in question</doc>
<type name="Gio.File" c:type="GFile*"/>
</parameter>
<parameter name="info" transfer-ownership="none">
<doc xml:space="preserve">an existing #GFileInfo, or %NULL</doc>
<type name="Gio.FileInfo" c:type="GFileInfo*"/>
</parameter>
<parameter name="handle_pls" transfer-ownership="none">
<doc xml:space="preserve">Whether playlists should be handled as containers</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
<parameter name="options" transfer-ownership="none">
<doc xml:space="preserve">a #GrlOperationOptions representing the options to apply
to this operation.</doc>
<type name="Grl.OperationOptions" c:type="GrlOperationOptions*"/>
</parameter>
</parameters>
</function>
<function name="get_file_attributes"
c:identifier="grl_pls_get_file_attributes"
version="0.2.0">
<doc xml:space="preserve">Returns the list of attributes to pass to
g_file_query_info() to make it possible to
populate a GrlMedia using grl_pls_file_to_media().
Do not free the result of this function.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">a string containing the
list of attributes.</doc>
<type name="utf8" c:type="const char*"/>
</return-value>
</function>
<function name="media_is_playlist"
c:identifier="grl_pls_media_is_playlist"
version="0.2.0">
<doc xml:space="preserve">Check if a file identified by GrlMedia object is a playlist or not.
This function does blocking I/O.</doc>
<return-value transfer-ownership="none">
<doc xml:space="preserve">%TRUE if a GrlMedia is recognized as a playlist.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<parameter name="media" transfer-ownership="none">
<doc xml:space="preserve">GrlMedia</doc>
<type name="Grl.Media" c:type="GrlMedia*"/>
</parameter>
</parameters>
</function>
</namespace>
</repository>
|