← Back to branch summary

~mfisch/brasero/update-to-3.8.0

« back to all changes in this revision

Viewing changes to docs/reference/libbrasero-media/xml/brasero-medium.xml

  • Committer: Bazaar Package Importer
  • Author(s): Robert Ancell
  • Date: 2009-09-08 09:33:41 UTC
  • mfrom: (1.1.29 upstream)
  • Revision ID: james.westby@ubuntu.com-20090908093341-jh02q5ba0q8jyu9l
Tags: 2.27.92-0ubuntu1
https://launchpad.net/bugs/425998
https://launchpad.net/bugs/354995
* New upstream release (LP: #425998)
  - Some improvements when handling DVD-RW sequential
  - #593829 - Brasero gets stuck in a loop at "Getting size" while burning another session on a multi-session disk
  - #578466 - Unable to overburn
  - #593314 - Brasero is failing to burn from sftp
  - #593492 - Compilation must be ordered by file name
  - #587122 - Copying DVD - "Error while reading video DVD (no error)"
  - #592026 - brasero crashes when eject a medium
  - #592025 - brasero crashes on detecting src images on a NFS path when preparing burning an image
  - #591880 - Image checksumming causes internal error (LP: #354995)
  - #591397 - Brasero Main window pops up after exiting from Image Burning window.
  - Translation updates
  - lots of small fixes and improvements

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/libbrasero-media/xml/brasero-medium.xml
 
1
<refentry id="libbrasero-media-BraseroMedium">
 
2
<refmeta>
 
3
<refentrytitle role="top_of_page" id="libbrasero-media-BraseroMedium.top_of_page">BraseroMedium</refentrytitle>
 
4
<manvolnum>3</manvolnum>
 
5
<refmiscinfo>LIBBRASERO-MEDIA Library</refmiscinfo>
 
6
</refmeta>
 
7
 
 
8
<refnamediv>
 
9
<refname>BraseroMedium</refname>
 
10
<refpurpose></refpurpose>
 
11
</refnamediv>
 
12
 
 
13
<refsynopsisdiv id="libbrasero-media-BraseroMedium.synopsis" role="synopsis">
 
14
<title role="synopsis.title">Synopsis</title>
 
15
 
 
16
<synopsis>
 
17
                    <link linkend="BraseroMedium">BraseroMedium</link>;
 
18
<link linkend="BraseroMedia">BraseroMedia</link>        <link linkend="brasero-medium-get-status">brasero_medium_get_status</link>           (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
 
19
<link linkend="guint64">guint64</link>             <link linkend="brasero-medium-get-max-write-speed">brasero_medium_get_max_write_speed</link>  (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
 
20
<link linkend="guint64">guint64</link> *           <link linkend="brasero-medium-get-write-speeds">brasero_medium_get_write_speeds</link>     (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
 
21
<link linkend="void">void</link>                <link linkend="brasero-medium-get-free-space">brasero_medium_get_free_space</link>       (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
 
22
                                                         <link linkend="goffset">goffset</link> *bytes,
 
23
                                                         <link linkend="goffset">goffset</link> *blocks);
 
24
<link linkend="void">void</link>                <link linkend="brasero-medium-get-capacity">brasero_medium_get_capacity</link>         (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
 
25
                                                         <link linkend="goffset">goffset</link> *bytes,
 
26
                                                         <link linkend="goffset">goffset</link> *blocks);
 
27
<link linkend="void">void</link>                <link linkend="brasero-medium-get-data-size">brasero_medium_get_data_size</link>        (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
 
28
                                                         <link linkend="goffset">goffset</link> *bytes,
 
29
                                                         <link linkend="goffset">goffset</link> *blocks);
 
30
<link linkend="gint64">gint64</link>              <link linkend="brasero-medium-get-next-writable-address">brasero_medium_get_next_writable_address</link>
 
31
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
 
32
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-can-be-rewritten">brasero_medium_can_be_rewritten</link>     (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
 
33
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-can-be-written">brasero_medium_can_be_written</link>       (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
 
34
const <link linkend="gchar">gchar</link> *       <link linkend="brasero-medium-get-CD-TEXT-title">brasero_medium_get_CD_TEXT_title</link>    (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
 
35
const <link linkend="gchar">gchar</link> *       <link linkend="brasero-medium-get-type-string">brasero_medium_get_type_string</link>      (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
 
36
<link linkend="gchar">gchar</link> *             <link linkend="brasero-medium-get-tooltip">brasero_medium_get_tooltip</link>          (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
 
37
<link linkend="BraseroDrive">BraseroDrive</link> *      <link linkend="brasero-medium-get-drive">brasero_medium_get_drive</link>            (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
 
38
<link linkend="guint">guint</link>               <link linkend="brasero-medium-get-track-num">brasero_medium_get_track_num</link>        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
 
39
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-get-last-data-track-space">brasero_medium_get_last_data_track_space</link>
 
40
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
 
41
                                                         <link linkend="goffset">goffset</link> *bytes,
 
42
                                                         <link linkend="goffset">goffset</link> *sectors);
 
43
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-get-last-data-track-address">brasero_medium_get_last_data_track_address</link>
 
44
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
 
45
                                                         <link linkend="goffset">goffset</link> *bytes,
 
46
                                                         <link linkend="goffset">goffset</link> *sectors);
 
47
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-get-track-space">brasero_medium_get_track_space</link>      (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
 
48
                                                         <link linkend="guint">guint</link> num,
 
49
                                                         <link linkend="goffset">goffset</link> *bytes,
 
50
                                                         <link linkend="goffset">goffset</link> *sectors);
 
51
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-get-track-address">brasero_medium_get_track_address</link>    (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
 
52
                                                         <link linkend="guint">guint</link> num,
 
53
                                                         <link linkend="goffset">goffset</link> *bytes,
 
54
                                                         <link linkend="goffset">goffset</link> *sectors);
 
55
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-can-use-dummy-for-sao">brasero_medium_can_use_dummy_for_sao</link>
 
56
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
 
57
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-can-use-dummy-for-tao">brasero_medium_can_use_dummy_for_tao</link>
 
58
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
 
59
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-can-use-burnfree">brasero_medium_can_use_burnfree</link>     (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
 
60
</synopsis>
 
61
</refsynopsisdiv>
 
62
 
 
63
 
 
64
 
 
65
 
 
66
 
 
67
 
 
68
 
 
69
 
 
70
 
 
71
<refsect1 id="libbrasero-media-BraseroMedium.description" role="desc">
 
72
<title role="desc.title">Description</title>
 
73
<para>
 
74
</para>
 
75
</refsect1>
 
76
 
 
77
<refsect1 id="libbrasero-media-BraseroMedium.details" role="details">
 
78
<title role="details.title">Details</title>
 
79
<refsect2 id="BraseroMedium" role="struct">
 
80
<title>BraseroMedium</title>
 
81
<indexterm zone="BraseroMedium"><primary sortas="BraseroMedium">BraseroMedium</primary></indexterm><programlisting>typedef struct {
 
82
        GObject parent_instance;
 
83
} BraseroMedium;
 
84
</programlisting>
 
85
<para>
 
86
</para></refsect2>
 
87
<refsect2 id="brasero-medium-get-status" role="function">
 
88
<title>brasero_medium_get_status ()</title>
 
89
<indexterm zone="brasero-medium-get-status"><primary sortas="brasero_medium_get_status">brasero_medium_get_status</primary></indexterm><programlisting><link linkend="BraseroMedia">BraseroMedia</link>        brasero_medium_get_status           (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
 
90
<para>
 
91
Gets the medium type and state.</para>
 
92
<para>
 
93
</para><variablelist role="params">
 
94
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
95
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
96
</simpara></listitem></varlistentry>
 
97
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="BraseroMedia"><type>BraseroMedia</type></link>.
 
98
 
 
99
</simpara></listitem></varlistentry>
 
100
</variablelist></refsect2>
 
101
<refsect2 id="brasero-medium-get-max-write-speed" role="function">
 
102
<title>brasero_medium_get_max_write_speed ()</title>
 
103
<indexterm zone="brasero-medium-get-max-write-speed"><primary sortas="brasero_medium_get_max_write_speed">brasero_medium_get_max_write_speed</primary></indexterm><programlisting><link linkend="guint64">guint64</link>             brasero_medium_get_max_write_speed  (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
 
104
<para>
 
105
Gets the maximum speed that can be used to write to <parameter>medium</parameter>.
 
106
Note: the speed are in B/sec.</para>
 
107
<para>
 
108
</para><variablelist role="params">
 
109
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
110
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
111
</simpara></listitem></varlistentry>
 
112
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="guint64"><type>guint64</type></link>.
 
113
 
 
114
</simpara></listitem></varlistentry>
 
115
</variablelist></refsect2>
 
116
<refsect2 id="brasero-medium-get-write-speeds" role="function">
 
117
<title>brasero_medium_get_write_speeds ()</title>
 
118
<indexterm zone="brasero-medium-get-write-speeds"><primary sortas="brasero_medium_get_write_speeds">brasero_medium_get_write_speeds</primary></indexterm><programlisting><link linkend="guint64">guint64</link> *           brasero_medium_get_write_speeds     (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
 
119
<para>
 
120
Gets an array holding all possible speeds to write to <parameter>medium</parameter>.
 
121
Note: the speed are in B/sec.</para>
 
122
<para>
 
123
</para><variablelist role="params">
 
124
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
125
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
126
</simpara></listitem></varlistentry>
 
127
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="guint64"><type>guint64</type></link> *.
 
128
 
 
129
</simpara></listitem></varlistentry>
 
130
</variablelist></refsect2>
 
131
<refsect2 id="brasero-medium-get-free-space" role="function">
 
132
<title>brasero_medium_get_free_space ()</title>
 
133
<indexterm zone="brasero-medium-get-free-space"><primary sortas="brasero_medium_get_free_space">brasero_medium_get_free_space</primary></indexterm><programlisting><link linkend="void">void</link>                brasero_medium_get_free_space       (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
 
134
                                                         <link linkend="goffset">goffset</link> *bytes,
 
135
                                                         <link linkend="goffset">goffset</link> *blocks);</programlisting>
 
136
<para>
 
137
Stores in either <parameter>size</parameter> (in bytes) or <parameter>blocks</parameter> (the number of blocks) the space
 
138
on the disc that can be used for writing.</para>
 
139
<para>
 
140
</para><variablelist role="params">
 
141
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
142
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
143
</simpara></listitem></varlistentry>
 
144
<varlistentry><term><parameter>bytes</parameter>&#160;:</term>
 
145
<listitem><simpara> a <link linkend="gint64"><type>gint64</type></link> * or NULL
 
146
</simpara></listitem></varlistentry>
 
147
<varlistentry><term><parameter>blocks</parameter>&#160;:</term>
 
148
<listitem><simpara> a <link linkend="gint64"><type>gint64</type></link> * or NULL
 
149
</simpara></listitem></varlistentry>
 
150
</variablelist></refsect2>
 
151
<refsect2 id="brasero-medium-get-capacity" role="function">
 
152
<title>brasero_medium_get_capacity ()</title>
 
153
<indexterm zone="brasero-medium-get-capacity"><primary sortas="brasero_medium_get_capacity">brasero_medium_get_capacity</primary></indexterm><programlisting><link linkend="void">void</link>                brasero_medium_get_capacity         (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
 
154
                                                         <link linkend="goffset">goffset</link> *bytes,
 
155
                                                         <link linkend="goffset">goffset</link> *blocks);</programlisting>
 
156
<para>
 
157
Stores in either <parameter>size</parameter> (in bytes) or <parameter>blocks</parameter> (the number of blocks) the total
 
158
disc space.
 
159
Note that when the disc is closed this space is the one occupied by data. 
 
160
Otherwise it is the sum of free and used space.</para>
 
161
<para>
 
162
</para><variablelist role="params">
 
163
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
164
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
165
</simpara></listitem></varlistentry>
 
166
<varlistentry><term><parameter>bytes</parameter>&#160;:</term>
 
167
<listitem><simpara> a <link linkend="gint64"><type>gint64</type></link> * or NULL
 
168
</simpara></listitem></varlistentry>
 
169
<varlistentry><term><parameter>blocks</parameter>&#160;:</term>
 
170
<listitem><simpara> a <link linkend="gint64"><type>gint64</type></link> * or NULL
 
171
</simpara></listitem></varlistentry>
 
172
</variablelist></refsect2>
 
173
<refsect2 id="brasero-medium-get-data-size" role="function">
 
174
<title>brasero_medium_get_data_size ()</title>
 
175
<indexterm zone="brasero-medium-get-data-size"><primary sortas="brasero_medium_get_data_size">brasero_medium_get_data_size</primary></indexterm><programlisting><link linkend="void">void</link>                brasero_medium_get_data_size        (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
 
176
                                                         <link linkend="goffset">goffset</link> *bytes,
 
177
                                                         <link linkend="goffset">goffset</link> *blocks);</programlisting>
 
178
<para>
 
179
Stores in either <parameter>size</parameter> (in bytes) or <parameter>blocks</parameter> (the number of blocks) the size
 
180
used to store data (including audio on CDs) on the disc.</para>
 
181
<para>
 
182
</para><variablelist role="params">
 
183
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
184
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
185
</simpara></listitem></varlistentry>
 
186
<varlistentry><term><parameter>bytes</parameter>&#160;:</term>
 
187
<listitem><simpara> a <link linkend="gint64"><type>gint64</type></link> * or NULL
 
188
</simpara></listitem></varlistentry>
 
189
<varlistentry><term><parameter>blocks</parameter>&#160;:</term>
 
190
<listitem><simpara> a <link linkend="gint64"><type>gint64</type></link> * or NULL
 
191
</simpara></listitem></varlistentry>
 
192
</variablelist></refsect2>
 
193
<refsect2 id="brasero-medium-get-next-writable-address" role="function">
 
194
<title>brasero_medium_get_next_writable_address ()</title>
 
195
<indexterm zone="brasero-medium-get-next-writable-address"><primary sortas="brasero_medium_get_next_writable_address">brasero_medium_get_next_writable_address</primary></indexterm><programlisting><link linkend="gint64">gint64</link>              brasero_medium_get_next_writable_address
 
196
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
 
197
<para>
 
198
Gets the address (block number) that can be used to write a new session on <parameter>medium</parameter></para>
 
199
<para>
 
200
</para><variablelist role="params">
 
201
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
202
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
203
</simpara></listitem></varlistentry>
 
204
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gint64"><type>gint64</type></link>.
 
205
 
 
206
</simpara></listitem></varlistentry>
 
207
</variablelist></refsect2>
 
208
<refsect2 id="brasero-medium-can-be-rewritten" role="function">
 
209
<title>brasero_medium_can_be_rewritten ()</title>
 
210
<indexterm zone="brasero-medium-can-be-rewritten"><primary sortas="brasero_medium_can_be_rewritten">brasero_medium_can_be_rewritten</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_can_be_rewritten     (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
 
211
<para>
 
212
Gets whether the medium can be rewritten. Note: it also checks that the drive
 
213
can rewrite the medium type.</para>
 
214
<para>
 
215
</para><variablelist role="params">
 
216
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
217
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
218
</simpara></listitem></varlistentry>
 
219
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the medium can be rewritten, FALSE otherwise.
 
220
 
 
221
</simpara></listitem></varlistentry>
 
222
</variablelist></refsect2>
 
223
<refsect2 id="brasero-medium-can-be-written" role="function">
 
224
<title>brasero_medium_can_be_written ()</title>
 
225
<indexterm zone="brasero-medium-can-be-written"><primary sortas="brasero_medium_can_be_written">brasero_medium_can_be_written</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_can_be_written       (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
 
226
<para>
 
227
Gets whether the medium can be written. It also checks that the medium can
 
228
write the medium.</para>
 
229
<para>
 
230
</para><variablelist role="params">
 
231
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
232
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
233
</simpara></listitem></varlistentry>
 
234
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the medium can be rewritten, FALSE otherwise.
 
235
 
 
236
</simpara></listitem></varlistentry>
 
237
</variablelist></refsect2>
 
238
<refsect2 id="brasero-medium-get-CD-TEXT-title" role="function">
 
239
<title>brasero_medium_get_CD_TEXT_title ()</title>
 
240
<indexterm zone="brasero-medium-get-CD-TEXT-title"><primary sortas="brasero_medium_get_CD_TEXT_title">brasero_medium_get_CD_TEXT_title</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       brasero_medium_get_CD_TEXT_title    (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
 
241
<para>
 
242
Gets the CD-TEXT title for <parameter>Medium</parameter>.</para>
 
243
<para>
 
244
</para><variablelist role="params">
 
245
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
246
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
247
</simpara></listitem></varlistentry>
 
248
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gchar"><type>gchar</type></link> *.
 
249
 
 
250
</simpara></listitem></varlistentry>
 
251
</variablelist></refsect2>
 
252
<refsect2 id="brasero-medium-get-type-string" role="function">
 
253
<title>brasero_medium_get_type_string ()</title>
 
254
<indexterm zone="brasero-medium-get-type-string"><primary sortas="brasero_medium_get_type_string">brasero_medium_get_type_string</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       brasero_medium_get_type_string      (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
 
255
<para>
 
256
Returns the medium type as a string to be displayed in a UI.</para>
 
257
<para>
 
258
</para><variablelist role="params">
 
259
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
260
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
261
</simpara></listitem></varlistentry>
 
262
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gchar"><type>gchar</type></link> *.
 
263
 
 
264
</simpara></listitem></varlistentry>
 
265
</variablelist></refsect2>
 
266
<refsect2 id="brasero-medium-get-tooltip" role="function">
 
267
<title>brasero_medium_get_tooltip ()</title>
 
268
<indexterm zone="brasero-medium-get-tooltip"><primary sortas="brasero_medium_get_tooltip">brasero_medium_get_tooltip</primary></indexterm><programlisting><link linkend="gchar">gchar</link> *             brasero_medium_get_tooltip          (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
 
269
<para>
 
270
Returns a tooltip to be displayed in the UI.
 
271
It is of the form {content type} {disc type} in {drive name}.</para>
 
272
<para>
 
273
</para><variablelist role="params">
 
274
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
275
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
276
</simpara></listitem></varlistentry>
 
277
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gchar"><type>gchar</type></link> *.
 
278
 
 
279
</simpara></listitem></varlistentry>
 
280
</variablelist></refsect2>
 
281
<refsect2 id="brasero-medium-get-drive" role="function">
 
282
<title>brasero_medium_get_drive ()</title>
 
283
<indexterm zone="brasero-medium-get-drive"><primary sortas="brasero_medium_get_drive">brasero_medium_get_drive</primary></indexterm><programlisting><link linkend="BraseroDrive">BraseroDrive</link> *      brasero_medium_get_drive            (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
 
284
<para>
 
285
Gets the <link linkend="BraseroDrive"><type>BraseroDrive</type></link> in which the medium is inserted.</para>
 
286
<para>
 
287
</para><variablelist role="params">
 
288
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
289
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
290
</simpara></listitem></varlistentry>
 
291
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="BraseroDrive"><type>BraseroDrive</type></link>. No need to unref after use.
 
292
 
 
293
</simpara></listitem></varlistentry>
 
294
</variablelist></refsect2>
 
295
<refsect2 id="brasero-medium-get-track-num" role="function">
 
296
<title>brasero_medium_get_track_num ()</title>
 
297
<indexterm zone="brasero-medium-get-track-num"><primary sortas="brasero_medium_get_track_num">brasero_medium_get_track_num</primary></indexterm><programlisting><link linkend="guint">guint</link>               brasero_medium_get_track_num        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
 
298
<para>
 
299
Gets the number of tracks on the medium.</para>
 
300
<para>
 
301
</para><variablelist role="params">
 
302
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
303
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
304
</simpara></listitem></varlistentry>
 
305
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="guint"><type>guint</type></link>.
 
306
 
 
307
</simpara></listitem></varlistentry>
 
308
</variablelist></refsect2>
 
309
<refsect2 id="brasero-medium-get-last-data-track-space" role="function">
 
310
<title>brasero_medium_get_last_data_track_space ()</title>
 
311
<indexterm zone="brasero-medium-get-last-data-track-space"><primary sortas="brasero_medium_get_last_data_track_space">brasero_medium_get_last_data_track_space</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_get_last_data_track_space
 
312
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
 
313
                                                         <link linkend="goffset">goffset</link> *bytes,
 
314
                                                         <link linkend="goffset">goffset</link> *sectors);</programlisting>
 
315
<para>
 
316
Stores in either <parameter>bytes</parameter> (in bytes) or in <parameter>sectors</parameter> (in blocks) the space used by
 
317
the last track on the medium.</para>
 
318
<para>
 
319
</para><variablelist role="params">
 
320
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
321
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
322
</simpara></listitem></varlistentry>
 
323
<varlistentry><term><parameter>bytes</parameter>&#160;:</term>
 
324
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
 
325
</simpara></listitem></varlistentry>
 
326
<varlistentry><term><parameter>sectors</parameter>&#160;:</term>
 
327
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
 
328
</simpara></listitem></varlistentry>
 
329
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. Returns TRUE if information could be retrieved.
 
330
 
 
331
</simpara></listitem></varlistentry>
 
332
</variablelist></refsect2>
 
333
<refsect2 id="brasero-medium-get-last-data-track-address" role="function">
 
334
<title>brasero_medium_get_last_data_track_address ()</title>
 
335
<indexterm zone="brasero-medium-get-last-data-track-address"><primary sortas="brasero_medium_get_last_data_track_address">brasero_medium_get_last_data_track_address</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_get_last_data_track_address
 
336
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
 
337
                                                         <link linkend="goffset">goffset</link> *bytes,
 
338
                                                         <link linkend="goffset">goffset</link> *sectors);</programlisting>
 
339
<para>
 
340
Stores in either <parameter>bytes</parameter> (in bytes) or in <parameter>sectors</parameter> (in blocks) the address where
 
341
the last session starts. This is useful when creating a multisession image or
 
342
when reading the contents of this last track.</para>
 
343
<para>
 
344
</para><variablelist role="params">
 
345
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
346
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
347
</simpara></listitem></varlistentry>
 
348
<varlistentry><term><parameter>bytes</parameter>&#160;:</term>
 
349
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
 
350
</simpara></listitem></varlistentry>
 
351
<varlistentry><term><parameter>sectors</parameter>&#160;:</term>
 
352
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
 
353
</simpara></listitem></varlistentry>
 
354
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. Returns TRUE if information could be retrieved.
 
355
 
 
356
</simpara></listitem></varlistentry>
 
357
</variablelist></refsect2>
 
358
<refsect2 id="brasero-medium-get-track-space" role="function">
 
359
<title>brasero_medium_get_track_space ()</title>
 
360
<indexterm zone="brasero-medium-get-track-space"><primary sortas="brasero_medium_get_track_space">brasero_medium_get_track_space</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_get_track_space      (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
 
361
                                                         <link linkend="guint">guint</link> num,
 
362
                                                         <link linkend="goffset">goffset</link> *bytes,
 
363
                                                         <link linkend="goffset">goffset</link> *sectors);</programlisting>
 
364
<para>
 
365
Stores in either <parameter>bytes</parameter> (in bytes) or in <parameter>sectors</parameter> (in blocks) the space used
 
366
by session <parameter>num</parameter> on the disc.</para>
 
367
<para>
 
368
</para><variablelist role="params">
 
369
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
370
<listitem><simpara> a <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
371
</simpara></listitem></varlistentry>
 
372
<varlistentry><term><parameter>num</parameter>&#160;:</term>
 
373
<listitem><simpara> a <link linkend="guint"><type>guint</type></link>
 
374
</simpara></listitem></varlistentry>
 
375
<varlistentry><term><parameter>bytes</parameter>&#160;:</term>
 
376
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
 
377
</simpara></listitem></varlistentry>
 
378
<varlistentry><term><parameter>sectors</parameter>&#160;:</term>
 
379
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
 
380
</simpara></listitem></varlistentry>
 
381
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. Returns TRUE if information could be retrieved;
 
382
FALSE otherwise (usually when track <parameter>num</parameter> doesn't exist).
 
383
 
 
384
</simpara></listitem></varlistentry>
 
385
</variablelist></refsect2>
 
386
<refsect2 id="brasero-medium-get-track-address" role="function">
 
387
<title>brasero_medium_get_track_address ()</title>
 
388
<indexterm zone="brasero-medium-get-track-address"><primary sortas="brasero_medium_get_track_address">brasero_medium_get_track_address</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_get_track_address    (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
 
389
                                                         <link linkend="guint">guint</link> num,
 
390
                                                         <link linkend="goffset">goffset</link> *bytes,
 
391
                                                         <link linkend="goffset">goffset</link> *sectors);</programlisting>
 
392
<para>
 
393
Stores in either <parameter>bytes</parameter> (in bytes) or in <parameter>sectors</parameter> (in blocks) the address at
 
394
which the session identified by <parameter>num</parameter> starts.</para>
 
395
<para>
 
396
</para><variablelist role="params">
 
397
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
398
<listitem><simpara> a <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
399
</simpara></listitem></varlistentry>
 
400
<varlistentry><term><parameter>num</parameter>&#160;:</term>
 
401
<listitem><simpara> a <link linkend="guint"><type>guint</type></link>
 
402
</simpara></listitem></varlistentry>
 
403
<varlistentry><term><parameter>bytes</parameter>&#160;:</term>
 
404
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
 
405
</simpara></listitem></varlistentry>
 
406
<varlistentry><term><parameter>sectors</parameter>&#160;:</term>
 
407
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
 
408
</simpara></listitem></varlistentry>
 
409
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. Returns TRUE if information could be retrieved;
 
410
FALSE otherwise (usually when track <parameter>num</parameter> doesn't exist).
 
411
 
 
412
</simpara></listitem></varlistentry>
 
413
</variablelist></refsect2>
 
414
<refsect2 id="brasero-medium-can-use-dummy-for-sao" role="function">
 
415
<title>brasero_medium_can_use_dummy_for_sao ()</title>
 
416
<indexterm zone="brasero-medium-can-use-dummy-for-sao"><primary sortas="brasero_medium_can_use_dummy_for_sao">brasero_medium_can_use_dummy_for_sao</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_can_use_dummy_for_sao
 
417
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
 
418
<para>
 
419
Gets whether the medium supports doing a test write with SAO on.</para>
 
420
<para>
 
421
</para><variablelist role="params">
 
422
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
423
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
424
</simpara></listitem></varlistentry>
 
425
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the medium can use SAO write mode during a test write, FALSE otherwise.
 
426
 
 
427
</simpara></listitem></varlistentry>
 
428
</variablelist></refsect2>
 
429
<refsect2 id="brasero-medium-can-use-dummy-for-tao" role="function">
 
430
<title>brasero_medium_can_use_dummy_for_tao ()</title>
 
431
<indexterm zone="brasero-medium-can-use-dummy-for-tao"><primary sortas="brasero_medium_can_use_dummy_for_tao">brasero_medium_can_use_dummy_for_tao</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_can_use_dummy_for_tao
 
432
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
 
433
<para>
 
434
Gets whether the medium supports doing a test write with TAO on.</para>
 
435
<para>
 
436
</para><variablelist role="params">
 
437
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
438
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
439
</simpara></listitem></varlistentry>
 
440
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the medium can use TAO write mode during a test write, FALSE otherwise.
 
441
 
 
442
</simpara></listitem></varlistentry>
 
443
</variablelist></refsect2>
 
444
<refsect2 id="brasero-medium-can-use-burnfree" role="function">
 
445
<title>brasero_medium_can_use_burnfree ()</title>
 
446
<indexterm zone="brasero-medium-can-use-burnfree"><primary sortas="brasero_medium_can_use_burnfree">brasero_medium_can_use_burnfree</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_can_use_burnfree     (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
 
447
<para>
 
448
Gets whether the medium supports any burnfree technology.</para>
 
449
<para>
 
450
</para><variablelist role="params">
 
451
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
 
452
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
 
453
</simpara></listitem></varlistentry>
 
454
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the medium can use any burnfree technology, FALSE otherwise.
 
455
 
 
456
</simpara></listitem></varlistentry>
 
457
</variablelist></refsect2>
 
458
 
 
459
</refsect1>
 
460
 
 
461
 
 
462
 
 
463
 
 
464
</refentry>