← Back to branch summary

~mfisch/brasero/update-to-3.8.0

« back to all changes in this revision

Viewing changes to docs/reference/libbrasero-burn/xml/brasero-track-data-cfg.xml

  • Committer: Bazaar Package Importer
  • Author(s): Andreas Moog
  • Date: 2009-07-28 01:12:27 UTC
  • mto: (1.4.1 experimental)
  • mto: This revision was merged to the branch mainline in revision 46.
  • Revision ID: james.westby@ubuntu.com-20090728011227-tiva9yorc5d1r5hs
Tags: upstream-2.27.5
Import upstream version 2.27.5

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/libbrasero-burn/xml/brasero-track-data-cfg.xml
1
 
<refentry id="libbrasero-burn-BraseroTrackDataCfg">
2
 
<refmeta>
3
 
<refentrytitle role="top_of_page" id="libbrasero-burn-BraseroTrackDataCfg.top_of_page">BraseroTrackDataCfg</refentrytitle>
4
 
<manvolnum>3</manvolnum>
5
 
<refmiscinfo>LIBBRASERO-BURN Library</refmiscinfo>
6
 
</refmeta>
7
 
 
8
 
<refnamediv>
9
 
<refname>BraseroTrackDataCfg</refname>
10
 
<refpurpose></refpurpose>
11
 
</refnamediv>
12
 
 
13
 
<refsynopsisdiv id="libbrasero-burn-BraseroTrackDataCfg.synopsis" role="synopsis">
14
 
<title role="synopsis.title">Synopsis</title>
15
 
 
16
 
<synopsis>
17
 
#define             <link linkend="BRASERO-DND-TARGET-DATA-TRACK-REFERENCE-LIST--CAPS">BRASERO_DND_TARGET_DATA_TRACK_REFERENCE_LIST</link>
18
 
enum                <link linkend="BraseroTrackDataCfgColumn">BraseroTrackDataCfgColumn</link>;
19
 
                    <link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link>;
20
 
<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> * <link linkend="brasero-track-data-cfg-new">brasero_track_data_cfg_new</link>        (void);
21
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-track-data-cfg-add">brasero_track_data_cfg_add</link>          (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
22
 
                                                         const <link linkend="gchar">gchar</link> *uri,
23
 
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *parent);
24
 
<link linkend="GtkTreePath">GtkTreePath</link> *       <link linkend="brasero-track-data-cfg-add-empty-directory">brasero_track_data_cfg_add_empty_directory</link>
25
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
26
 
                                                         const <link linkend="gchar">gchar</link> *name,
27
 
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *parent);
28
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-track-data-cfg-remove">brasero_track_data_cfg_remove</link>       (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
29
 
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *treepath);
30
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-track-data-cfg-rename">brasero_track_data_cfg_rename</link>       (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
31
 
                                                         const <link linkend="gchar">gchar</link> *newname,
32
 
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *treepath);
33
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-track-data-cfg-reset">brasero_track_data_cfg_reset</link>        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);
34
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-track-data-cfg-load-medium">brasero_track_data_cfg_load_medium</link>  (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
35
 
                                                         <link linkend="BraseroMedium">BraseroMedium</link> *medium,
36
 
                                                         <link linkend="GError">GError</link> **error);
37
 
<link linkend="void">void</link>                <link linkend="brasero-track-data-cfg-unload-current-medium">brasero_track_data_cfg_unload_current_medium</link>
38
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);
39
 
<link linkend="BraseroMedium">BraseroMedium</link> *     <link linkend="brasero-track-data-cfg-get-current-medium">brasero_track_data_cfg_get_current_medium</link>
40
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);
41
 
<link linkend="GSList">GSList</link> *            <link linkend="brasero-track-data-cfg-get-available-media">brasero_track_data_cfg_get_available_media</link>
42
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);
43
 
<link linkend="void">void</link>                <link linkend="brasero-track-data-cfg-dont-filter-uri">brasero_track_data_cfg_dont_filter_uri</link>
44
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
45
 
                                                         const <link linkend="gchar">gchar</link> *uri);
46
 
<link linkend="GSList">GSList</link> *            <link linkend="brasero-track-data-cfg-get-restored-list">brasero_track_data_cfg_get_restored_list</link>
47
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);
48
 
<link linkend="void">void</link>                <link linkend="brasero-track-data-cfg-restore">brasero_track_data_cfg_restore</link>      (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
49
 
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *treepath);
50
 
<link linkend="GtkTreeModel">GtkTreeModel</link> *      <link linkend="brasero-track-data-cfg-get-filtered-model">brasero_track_data_cfg_get_filtered_model</link>
51
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);
52
 
<link linkend="BraseroBurnResult">BraseroBurnResult</link>   <link linkend="brasero-track-data-cfg-span">brasero_track_data_cfg_span</link>         (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
53
 
                                                         <link linkend="goffset">goffset</link> sectors,
54
 
                                                         <link linkend="BraseroTrackData">BraseroTrackData</link> *new_track);
55
 
<link linkend="BraseroBurnResult">BraseroBurnResult</link>   <link linkend="brasero-track-data-cfg-span-again">brasero_track_data_cfg_span_again</link>   (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);
56
 
<link linkend="BraseroBurnResult">BraseroBurnResult</link>   <link linkend="brasero-track-data-cfg-span-possible">brasero_track_data_cfg_span_possible</link>
57
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
58
 
                                                         <link linkend="goffset">goffset</link> sectors);
59
 
<link linkend="void">void</link>                <link linkend="brasero-track-data-cfg-span-stop">brasero_track_data_cfg_span_stop</link>    (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);
60
 
<link linkend="GIcon">GIcon</link> *             <link linkend="brasero-track-data-cfg-get-icon">brasero_track_data_cfg_get_icon</link>     (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);
61
 
<link linkend="gchar">gchar</link> *             <link linkend="brasero-track-data-cfg-get-icon-path">brasero_track_data_cfg_get_icon_path</link>
62
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);
63
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-track-data-cfg-set-icon">brasero_track_data_cfg_set_icon</link>     (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
64
 
                                                         const <link linkend="gchar">gchar</link> *icon_path,
65
 
                                                         <link linkend="GError">GError</link> **error);
66
 
</synopsis>
67
 
</refsynopsisdiv>
68
 
 
69
 
 
70
 
 
71
 
 
72
 
 
73
 
 
74
 
 
75
 
 
76
 
 
77
 
<refsect1 id="libbrasero-burn-BraseroTrackDataCfg.description" role="desc">
78
 
<title role="desc.title">Description</title>
79
 
<para>
80
 
</para>
81
 
</refsect1>
82
 
 
83
 
<refsect1 id="libbrasero-burn-BraseroTrackDataCfg.details" role="details">
84
 
<title role="details.title">Details</title>
85
 
<refsect2 id="BRASERO-DND-TARGET-DATA-TRACK-REFERENCE-LIST--CAPS" role="macro">
86
 
<title>BRASERO_DND_TARGET_DATA_TRACK_REFERENCE_LIST</title>
87
 
<indexterm zone="BRASERO-DND-TARGET-DATA-TRACK-REFERENCE-LIST--CAPS"><primary sortas="BRASERO_DND_TARGET_DATA_TRACK_REFERENCE_LIST">BRASERO_DND_TARGET_DATA_TRACK_REFERENCE_LIST</primary></indexterm><programlisting>#define BRASERO_DND_TARGET_DATA_TRACK_REFERENCE_LIST      "GTK_TREE_MODEL_ROW"
88
 
</programlisting>
89
 
<para>
90
 
</para></refsect2>
91
 
<refsect2 id="BraseroTrackDataCfgColumn" role="enum">
92
 
<title>enum BraseroTrackDataCfgColumn</title>
93
 
<indexterm zone="BraseroTrackDataCfgColumn"><primary sortas="BraseroTrackDataCfgColumn">BraseroTrackDataCfgColumn</primary></indexterm><programlisting>typedef enum {
94
 
        BRASERO_DATA_TREE_MODEL_NAME            = 0,
95
 
        BRASERO_DATA_TREE_MODEL_URI,
96
 
        BRASERO_DATA_TREE_MODEL_MIME_DESC,
97
 
        BRASERO_DATA_TREE_MODEL_MIME_ICON,
98
 
        BRASERO_DATA_TREE_MODEL_SIZE,
99
 
        BRASERO_DATA_TREE_MODEL_SHOW_PERCENT,
100
 
        BRASERO_DATA_TREE_MODEL_PERCENT,
101
 
        BRASERO_DATA_TREE_MODEL_STYLE,
102
 
        BRASERO_DATA_TREE_MODEL_COLOR,
103
 
        BRASERO_DATA_TREE_MODEL_EDITABLE,
104
 
        BRASERO_DATA_TREE_MODEL_IS_FILE,
105
 
        BRASERO_DATA_TREE_MODEL_IS_LOADING,
106
 
        BRASERO_DATA_TREE_MODEL_IS_IMPORTED,
107
 
        BRASERO_DATA_TREE_MODEL_COL_NUM
108
 
} BraseroTrackDataCfgColumn;
109
 
</programlisting>
110
 
<para>
111
 
</para></refsect2>
112
 
<refsect2 id="BraseroTrackDataCfg" role="struct">
113
 
<title>BraseroTrackDataCfg</title>
114
 
<indexterm zone="BraseroTrackDataCfg"><primary sortas="BraseroTrackDataCfg">BraseroTrackDataCfg</primary></indexterm><programlisting>typedef struct {
115
 
        BraseroTrackData parent_instance;
116
 
} BraseroTrackDataCfg;
117
 
</programlisting>
118
 
<para>
119
 
</para></refsect2>
120
 
<refsect2 id="brasero-track-data-cfg-new" role="function">
121
 
<title>brasero_track_data_cfg_new ()</title>
122
 
<indexterm zone="brasero-track-data-cfg-new"><primary sortas="brasero_track_data_cfg_new">brasero_track_data_cfg_new</primary></indexterm><programlisting><link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> * brasero_track_data_cfg_new        (void);</programlisting>
123
 
<para>
124
 
Creates a new <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>.</para>
125
 
<para>
126
 
</para><variablelist role="params">
127
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>.
128
 
</simpara></listitem></varlistentry>
129
 
</variablelist></refsect2>
130
 
<refsect2 id="brasero-track-data-cfg-add" role="function">
131
 
<title>brasero_track_data_cfg_add ()</title>
132
 
<indexterm zone="brasero-track-data-cfg-add"><primary sortas="brasero_track_data_cfg_add">brasero_track_data_cfg_add</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_track_data_cfg_add          (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
133
 
                                                         const <link linkend="gchar">gchar</link> *uri,
134
 
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *parent);</programlisting>
135
 
<para>
136
 
Add a new file (with <parameter>uri</parameter> as URI) under a directory (<parameter>parent</parameter>).
137
 
If <parameter>parent</parameter> is NULL, the file is added to the root.
138
 
Also if <parameter>uri</parameter> is the path of a directory, this directory will be explored
139
 
and all its children added to the tree.</para>
140
 
<para>
141
 
</para><variablelist role="params">
142
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
143
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
144
 
</simpara></listitem></varlistentry>
145
 
<varlistentry><term><parameter>uri</parameter>&#160;:</term>
146
 
<listitem><simpara> a <link linkend="gchar"><type>gchar</type></link>
147
 
</simpara></listitem></varlistentry>
148
 
<varlistentry><term><parameter>parent</parameter>&#160;:</term>
149
 
<listitem><simpara> a <link linkend="GtkTreePath"><type>GtkTreePath</type></link> or NULL
150
 
</simpara></listitem></varlistentry>
151
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the operation was successful, FALSE otherwise
152
 
</simpara></listitem></varlistentry>
153
 
</variablelist></refsect2>
154
 
<refsect2 id="brasero-track-data-cfg-add-empty-directory" role="function">
155
 
<title>brasero_track_data_cfg_add_empty_directory ()</title>
156
 
<indexterm zone="brasero-track-data-cfg-add-empty-directory"><primary sortas="brasero_track_data_cfg_add_empty_directory">brasero_track_data_cfg_add_empty_directory</primary></indexterm><programlisting><link linkend="GtkTreePath">GtkTreePath</link> *       brasero_track_data_cfg_add_empty_directory
157
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
158
 
                                                         const <link linkend="gchar">gchar</link> *name,
159
 
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *parent);</programlisting>
160
 
<para>
161
 
Add a new empty directory (with <parameter>name</parameter> as name) under another directory (<parameter>parent</parameter>).
162
 
If <parameter>parent</parameter> is NULL, the file is added to the root.</para>
163
 
<para>
164
 
</para><variablelist role="params">
165
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
166
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
167
 
</simpara></listitem></varlistentry>
168
 
<varlistentry><term><parameter>name</parameter>&#160;:</term>
169
 
<listitem><simpara> a <link linkend="gchar"><type>gchar</type></link>
170
 
</simpara></listitem></varlistentry>
171
 
<varlistentry><term><parameter>parent</parameter>&#160;:</term>
172
 
<listitem><simpara> a <link linkend="GtkTreePath"><type>GtkTreePath</type></link> or NULL
173
 
</simpara></listitem></varlistentry>
174
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="GtkTreePath"><type>GtkTreePath</type></link> which should be destroyed when not needed; NULL if the operation was not successful.
175
 
</simpara></listitem></varlistentry>
176
 
</variablelist></refsect2>
177
 
<refsect2 id="brasero-track-data-cfg-remove" role="function">
178
 
<title>brasero_track_data_cfg_remove ()</title>
179
 
<indexterm zone="brasero-track-data-cfg-remove"><primary sortas="brasero_track_data_cfg_remove">brasero_track_data_cfg_remove</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_track_data_cfg_remove       (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
180
 
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *treepath);</programlisting>
181
 
<para>
182
 
Removes a file or a directory (as well as its children) from the tree.
183
 
NOTE: some files cannot be removed like files from an imported session.</para>
184
 
<para>
185
 
</para><variablelist role="params">
186
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
187
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
188
 
</simpara></listitem></varlistentry>
189
 
<varlistentry><term><parameter>treepath</parameter>&#160;:</term>
190
 
<listitem><simpara> a <link linkend="GtkTreePath"><type>GtkTreePath</type></link>
191
 
</simpara></listitem></varlistentry>
192
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the operation was successful, FALSE otherwise
193
 
</simpara></listitem></varlistentry>
194
 
</variablelist></refsect2>
195
 
<refsect2 id="brasero-track-data-cfg-rename" role="function">
196
 
<title>brasero_track_data_cfg_rename ()</title>
197
 
<indexterm zone="brasero-track-data-cfg-rename"><primary sortas="brasero_track_data_cfg_rename">brasero_track_data_cfg_rename</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_track_data_cfg_rename       (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
198
 
                                                         const <link linkend="gchar">gchar</link> *newname,
199
 
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *treepath);</programlisting>
200
 
<para>
201
 
Renames the file in the tree pointed by <parameter>treepath</parameter>.</para>
202
 
<para>
203
 
</para><variablelist role="params">
204
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
205
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
206
 
</simpara></listitem></varlistentry>
207
 
<varlistentry><term><parameter>newname</parameter>&#160;:</term>
208
 
<listitem><simpara> a <link linkend="gchar"><type>gchar</type></link>
209
 
</simpara></listitem></varlistentry>
210
 
<varlistentry><term><parameter>treepath</parameter>&#160;:</term>
211
 
<listitem><simpara> a <link linkend="GtkTreePath"><type>GtkTreePath</type></link>
212
 
</simpara></listitem></varlistentry>
213
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the operation was successful, FALSE otherwise
214
 
</simpara></listitem></varlistentry>
215
 
</variablelist></refsect2>
216
 
<refsect2 id="brasero-track-data-cfg-reset" role="function">
217
 
<title>brasero_track_data_cfg_reset ()</title>
218
 
<indexterm zone="brasero-track-data-cfg-reset"><primary sortas="brasero_track_data_cfg_reset">brasero_track_data_cfg_reset</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_track_data_cfg_reset        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);</programlisting>
219
 
<para>
220
 
Completely empties <parameter>track</parameter> and unloads any currently loaded session</para>
221
 
<para>
222
 
</para><variablelist role="params">
223
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
224
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
225
 
</simpara></listitem></varlistentry>
226
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the operation was successful, FALSE otherwise
227
 
</simpara></listitem></varlistentry>
228
 
</variablelist></refsect2>
229
 
<refsect2 id="brasero-track-data-cfg-load-medium" role="function">
230
 
<title>brasero_track_data_cfg_load_medium ()</title>
231
 
<indexterm zone="brasero-track-data-cfg-load-medium"><primary sortas="brasero_track_data_cfg_load_medium">brasero_track_data_cfg_load_medium</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_track_data_cfg_load_medium  (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
232
 
                                                         <link linkend="BraseroMedium">BraseroMedium</link> *medium,
233
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
234
 
<para>
235
 
Tries to load the contents of the last session of <parameter>medium</parameter> so all its files will be included in the tree
236
 
to perform a merge between files from the session and new added files.
237
 
Errors are stored in <parameter>error</parameter>.</para>
238
 
<para>
239
 
</para><variablelist role="params">
240
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
241
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
242
 
</simpara></listitem></varlistentry>
243
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
244
 
<listitem><simpara> a <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
245
 
</simpara></listitem></varlistentry>
246
 
<varlistentry><term><parameter>error</parameter>&#160;:</term>
247
 
<listitem><simpara> a <link linkend="GError"><type>GError</type></link>
248
 
</simpara></listitem></varlistentry>
249
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the operation was successful, FALSE otherwise
250
 
</simpara></listitem></varlistentry>
251
 
</variablelist></refsect2>
252
 
<refsect2 id="brasero-track-data-cfg-unload-current-medium" role="function">
253
 
<title>brasero_track_data_cfg_unload_current_medium ()</title>
254
 
<indexterm zone="brasero-track-data-cfg-unload-current-medium"><primary sortas="brasero_track_data_cfg_unload_current_medium">brasero_track_data_cfg_unload_current_medium</primary></indexterm><programlisting><link linkend="void">void</link>                brasero_track_data_cfg_unload_current_medium
255
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);</programlisting>
256
 
<para>
257
 
Unload the contents of the last session of the currently loaded medium.
258
 
See <link linkend="brasero-track-data-cfg-load-medium"><function>brasero_track_data_cfg_load_medium()</function></link>.</para>
259
 
<para>
260
 
</para><variablelist role="params">
261
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
262
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
263
 
</simpara></listitem></varlistentry>
264
 
</variablelist></refsect2>
265
 
<refsect2 id="brasero-track-data-cfg-get-current-medium" role="function">
266
 
<title>brasero_track_data_cfg_get_current_medium ()</title>
267
 
<indexterm zone="brasero-track-data-cfg-get-current-medium"><primary sortas="brasero_track_data_cfg_get_current_medium">brasero_track_data_cfg_get_current_medium</primary></indexterm><programlisting><link linkend="BraseroMedium">BraseroMedium</link> *     brasero_track_data_cfg_get_current_medium
268
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);</programlisting>
269
 
<para>
270
 
Gets the currently loaded medium.</para>
271
 
<para>
272
 
</para><variablelist role="params">
273
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
274
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
275
 
</simpara></listitem></varlistentry>
276
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="BraseroMedium"><type>BraseroMedium</type></link>. NULL if no medium are currently loaded.
277
 
Do not unref when the <link linkend="BraseroMedium"><type>BraseroMedium</type></link> is not needed anymore.
278
 
</simpara></listitem></varlistentry>
279
 
</variablelist></refsect2>
280
 
<refsect2 id="brasero-track-data-cfg-get-available-media" role="function">
281
 
<title>brasero_track_data_cfg_get_available_media ()</title>
282
 
<indexterm zone="brasero-track-data-cfg-get-available-media"><primary sortas="brasero_track_data_cfg_get_available_media">brasero_track_data_cfg_get_available_media</primary></indexterm><programlisting><link linkend="GSList">GSList</link> *            brasero_track_data_cfg_get_available_media
283
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);</programlisting>
284
 
<para>
285
 
Gets a list of all the media that can be appended with new data and which have a session that can be loaded.</para>
286
 
<para>
287
 
</para><variablelist role="params">
288
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
289
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
290
 
</simpara></listitem></varlistentry>
291
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="GSList"><type>GSList</type></link> of <link linkend="BraseroMedium"><type>BraseroMedium</type></link>. Free the list and unref its contents when the list is not needed anymore.
292
 
</simpara></listitem></varlistentry>
293
 
</variablelist></refsect2>
294
 
<refsect2 id="brasero-track-data-cfg-dont-filter-uri" role="function">
295
 
<title>brasero_track_data_cfg_dont_filter_uri ()</title>
296
 
<indexterm zone="brasero-track-data-cfg-dont-filter-uri"><primary sortas="brasero_track_data_cfg_dont_filter_uri">brasero_track_data_cfg_dont_filter_uri</primary></indexterm><programlisting><link linkend="void">void</link>                brasero_track_data_cfg_dont_filter_uri
297
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
298
 
                                                         const <link linkend="gchar">gchar</link> *uri);</programlisting>
299
 
<para>
300
 
Prevents <parameter>uri</parameter> to be filtered while automatic exploration
301
 
of added directories is performed.</para>
302
 
<para>
303
 
</para><variablelist role="params">
304
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
305
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
306
 
</simpara></listitem></varlistentry>
307
 
<varlistentry><term><parameter>uri</parameter>&#160;:</term>
308
 
<listitem><simpara> a <link linkend="gchar"><type>gchar</type></link>
309
 
</simpara></listitem></varlistentry>
310
 
</variablelist></refsect2>
311
 
<refsect2 id="brasero-track-data-cfg-get-restored-list" role="function">
312
 
<title>brasero_track_data_cfg_get_restored_list ()</title>
313
 
<indexterm zone="brasero-track-data-cfg-get-restored-list"><primary sortas="brasero_track_data_cfg_get_restored_list">brasero_track_data_cfg_get_restored_list</primary></indexterm><programlisting><link linkend="GSList">GSList</link> *            brasero_track_data_cfg_get_restored_list
314
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);</programlisting>
315
 
<para>
316
 
Gets a list of URIs (as <link linkend="gchar"><type>gchar</type></link> *) that were restored with <link linkend="brasero-track-data-cfg-restore"><function>brasero_track_data_cfg_restore()</function></link>.</para>
317
 
<para>
318
 
</para><variablelist role="params">
319
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
320
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
321
 
</simpara></listitem></varlistentry>
322
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="GSList"><type>GSList</type></link>; free the list and its contents when not needed anymore.
323
 
</simpara></listitem></varlistentry>
324
 
</variablelist></refsect2>
325
 
<refsect2 id="brasero-track-data-cfg-restore" role="function">
326
 
<title>brasero_track_data_cfg_restore ()</title>
327
 
<indexterm zone="brasero-track-data-cfg-restore"><primary sortas="brasero_track_data_cfg_restore">brasero_track_data_cfg_restore</primary></indexterm><programlisting><link linkend="void">void</link>                brasero_track_data_cfg_restore      (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
328
 
                                                         <link linkend="GtkTreePath">GtkTreePath</link> *treepath);</programlisting>
329
 
<para>
330
 
Removes a file from the filtered file list (see <link linkend="brasero-track-data-cfg-get-filtered-model"><function>brasero_track_data_cfg_get_filtered_model()</function></link>)
331
 
and re-adds it wherever it should be in the tree.
332
 
<parameter>treepath</parameter> is a <link linkend="GtkTreePath"><type>GtkTreePath</type></link> associated with the <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link> which holds the
333
 
filtered files not the main tree.</para>
334
 
<para>
335
 
</para><variablelist role="params">
336
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
337
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
338
 
</simpara></listitem></varlistentry>
339
 
<varlistentry><term><parameter>treepath</parameter>&#160;:</term>
340
 
<listitem><simpara> a <link linkend="GtkTreePath"><type>GtkTreePath</type></link>
341
 
</simpara></listitem></varlistentry>
342
 
</variablelist></refsect2>
343
 
<refsect2 id="brasero-track-data-cfg-get-filtered-model" role="function">
344
 
<title>brasero_track_data_cfg_get_filtered_model ()</title>
345
 
<indexterm zone="brasero-track-data-cfg-get-filtered-model"><primary sortas="brasero_track_data_cfg_get_filtered_model">brasero_track_data_cfg_get_filtered_model</primary></indexterm><programlisting><link linkend="GtkTreeModel">GtkTreeModel</link> *      brasero_track_data_cfg_get_filtered_model
346
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);</programlisting>
347
 
<para>
348
 
Gets a GtkTreeModel which contains all the files that were
349
 
automatically filtered while added directories were explored.</para>
350
 
<para>
351
 
</para><variablelist role="params">
352
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
353
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
354
 
</simpara></listitem></varlistentry>
355
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="GtkTreeModel"><type>GtkTreeModel</type></link>. Unref when not needed.
356
 
</simpara></listitem></varlistentry>
357
 
</variablelist></refsect2>
358
 
<refsect2 id="brasero-track-data-cfg-span" role="function">
359
 
<title>brasero_track_data_cfg_span ()</title>
360
 
<indexterm zone="brasero-track-data-cfg-span"><primary sortas="brasero_track_data_cfg_span">brasero_track_data_cfg_span</primary></indexterm><programlisting><link linkend="BraseroBurnResult">BraseroBurnResult</link>   brasero_track_data_cfg_span         (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
361
 
                                                         <link linkend="goffset">goffset</link> sectors,
362
 
                                                         <link linkend="BraseroTrackData">BraseroTrackData</link> *new_track);</programlisting>
363
 
<para>
364
 
Creates a new <link linkend="BraseroTrackData"><type>BraseroTrackData</type></link> (stored in <parameter>new_track</parameter>) from the files contained in <parameter>track</parameter>. The sum of their sizes
365
 
does not exceed <parameter>sectors</parameter>. This allows to burn a tree on multiple discs. This function can be
366
 
called repeatedly; in this case if some files were left out after the previous calls, the newly created BraseroTrackData
367
 
is created with all or part of the remaining files.</para>
368
 
<para>
369
 
</para><variablelist role="params">
370
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
371
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
372
 
</simpara></listitem></varlistentry>
373
 
<varlistentry><term><parameter>sectors</parameter>&#160;:</term>
374
 
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link>
375
 
</simpara></listitem></varlistentry>
376
 
<varlistentry><term><parameter>new_track</parameter>&#160;:</term>
377
 
<listitem><simpara> a <link linkend="BraseroTrackData"><type>BraseroTrackData</type></link>
378
 
</simpara></listitem></varlistentry>
379
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="BraseroBurnResult"><type>BraseroBurnResult</type></link>. BRASERO_BURN_OK if there is not anymore data.
380
 
BRASERO_BURN_RETRY if the operation was successful and a new <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link> was created.
381
 
BRASERO_BURN_ERR otherwise.
382
 
</simpara></listitem></varlistentry>
383
 
</variablelist></refsect2>
384
 
<refsect2 id="brasero-track-data-cfg-span-again" role="function">
385
 
<title>brasero_track_data_cfg_span_again ()</title>
386
 
<indexterm zone="brasero-track-data-cfg-span-again"><primary sortas="brasero_track_data_cfg_span_again">brasero_track_data_cfg_span_again</primary></indexterm><programlisting><link linkend="BraseroBurnResult">BraseroBurnResult</link>   brasero_track_data_cfg_span_again   (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);</programlisting>
387
 
<para>
388
 
Checks whether some files were not included during calls to <link linkend="brasero-track-data-cfg-span"><function>brasero_track_data_cfg_span()</function></link>.</para>
389
 
<para>
390
 
</para><variablelist role="params">
391
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
392
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
393
 
</simpara></listitem></varlistentry>
394
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="BraseroBurnResult"><type>BraseroBurnResult</type></link>. BRASERO_BURN_OK if there is not anymore data.
395
 
BRASERO_BURN_RETRY if the operation was successful and a new <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link> was created.
396
 
BRASERO_BURN_ERR otherwise.
397
 
</simpara></listitem></varlistentry>
398
 
</variablelist></refsect2>
399
 
<refsect2 id="brasero-track-data-cfg-span-possible" role="function">
400
 
<title>brasero_track_data_cfg_span_possible ()</title>
401
 
<indexterm zone="brasero-track-data-cfg-span-possible"><primary sortas="brasero_track_data_cfg_span_possible">brasero_track_data_cfg_span_possible</primary></indexterm><programlisting><link linkend="BraseroBurnResult">BraseroBurnResult</link>   brasero_track_data_cfg_span_possible
402
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
403
 
                                                         <link linkend="goffset">goffset</link> sectors);</programlisting>
404
 
<para>
405
 
Checks if a new <link linkend="BraseroTrackData"><type>BraseroTrackData</type></link> can be created from the files remaining in the tree 
406
 
after calls to <link linkend="brasero-track-data-cfg-span"><function>brasero_track_data_cfg_span()</function></link>.</para>
407
 
<para>
408
 
</para><variablelist role="params">
409
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
410
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
411
 
</simpara></listitem></varlistentry>
412
 
<varlistentry><term><parameter>sectors</parameter>&#160;:</term>
413
 
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link>
414
 
</simpara></listitem></varlistentry>
415
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="BraseroBurnResult"><type>BraseroBurnResult</type></link>. BRASERO_BURN_OK if there is not anymore data.
416
 
BRASERO_BURN_RETRY if the operation was successful and a new <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link> was created.
417
 
BRASERO_BURN_ERR otherwise.
418
 
</simpara></listitem></varlistentry>
419
 
</variablelist></refsect2>
420
 
<refsect2 id="brasero-track-data-cfg-span-stop" role="function">
421
 
<title>brasero_track_data_cfg_span_stop ()</title>
422
 
<indexterm zone="brasero-track-data-cfg-span-stop"><primary sortas="brasero_track_data_cfg_span_stop">brasero_track_data_cfg_span_stop</primary></indexterm><programlisting><link linkend="void">void</link>                brasero_track_data_cfg_span_stop    (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);</programlisting>
423
 
<para>
424
 
Resets the list of files that were included after calls to <link linkend="brasero-track-data-cfg-span"><function>brasero_track_data_cfg_span()</function></link>.</para>
425
 
<para>
426
 
</para><variablelist role="params">
427
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
428
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
429
 
</simpara></listitem></varlistentry>
430
 
</variablelist></refsect2>
431
 
<refsect2 id="brasero-track-data-cfg-get-icon" role="function">
432
 
<title>brasero_track_data_cfg_get_icon ()</title>
433
 
<indexterm zone="brasero-track-data-cfg-get-icon"><primary sortas="brasero_track_data_cfg_get_icon">brasero_track_data_cfg_get_icon</primary></indexterm><programlisting><link linkend="GIcon">GIcon</link> *             brasero_track_data_cfg_get_icon     (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);</programlisting>
434
 
<para>
435
 
Returns the currently selected icon.</para>
436
 
<para>
437
 
</para><variablelist role="params">
438
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
439
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
440
 
</simpara></listitem></varlistentry>
441
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="GIcon"><type>GIcon</type></link> or NULL.
442
 
</simpara></listitem></varlistentry>
443
 
</variablelist></refsect2>
444
 
<refsect2 id="brasero-track-data-cfg-get-icon-path" role="function">
445
 
<title>brasero_track_data_cfg_get_icon_path ()</title>
446
 
<indexterm zone="brasero-track-data-cfg-get-icon-path"><primary sortas="brasero_track_data_cfg_get_icon_path">brasero_track_data_cfg_get_icon_path</primary></indexterm><programlisting><link linkend="gchar">gchar</link> *             brasero_track_data_cfg_get_icon_path
447
 
                                                        (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track);</programlisting>
448
 
<para>
449
 
Returns a path pointing to the currently selected icon file.</para>
450
 
<para>
451
 
</para><variablelist role="params">
452
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
453
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
454
 
</simpara></listitem></varlistentry>
455
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gchar"><type>gchar</type></link> or NULL.
456
 
</simpara></listitem></varlistentry>
457
 
</variablelist></refsect2>
458
 
<refsect2 id="brasero-track-data-cfg-set-icon" role="function">
459
 
<title>brasero_track_data_cfg_set_icon ()</title>
460
 
<indexterm zone="brasero-track-data-cfg-set-icon"><primary sortas="brasero_track_data_cfg_set_icon">brasero_track_data_cfg_set_icon</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_track_data_cfg_set_icon     (<link linkend="BraseroTrackDataCfg">BraseroTrackDataCfg</link> *track,
461
 
                                                         const <link linkend="gchar">gchar</link> *icon_path,
462
 
                                                         <link linkend="GError">GError</link> **error);</programlisting>
463
 
<para>
464
 
Sets the current icon.</para>
465
 
<para>
466
 
</para><variablelist role="params">
467
 
<varlistentry><term><parameter>track</parameter>&#160;:</term>
468
 
<listitem><simpara> a <link linkend="BraseroTrackDataCfg"><type>BraseroTrackDataCfg</type></link>
469
 
</simpara></listitem></varlistentry>
470
 
<varlistentry><term><parameter>icon_path</parameter>&#160;:</term>
471
 
<listitem><simpara> a <link linkend="gchar"><type>gchar</type></link>
472
 
</simpara></listitem></varlistentry>
473
 
<varlistentry><term><parameter>error</parameter>&#160;:</term>
474
 
<listitem><simpara> a <link linkend="GError"><type>GError</type></link>
475
 
</simpara></listitem></varlistentry>
476
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the operation was successful, FALSE otherwise
477
 
</simpara></listitem></varlistentry>
478
 
</variablelist></refsect2>
479
 
 
480
 
</refsect1>
481
 
 
482
 
 
483
 
 
484
 
 
485
 
</refentry>