blob: 129fa8b81452ff9b408267d2304ae4a5151f6687 [file] [log] [blame]
Joe Gregorio5dc0f5c2012-06-05 13:34:31 -04001<?xml version="1.0" encoding="ascii"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3 "DTD/xhtml1-transitional.dtd">
4<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5<head>
6 <title>apiclient.http.MediaUpload</title>
7 <link rel="stylesheet" href="epydoc.css" type="text/css" />
8 <script type="text/javascript" src="epydoc.js"></script>
9</head>
10
11<body bgcolor="white" text="black" link="blue" vlink="#204080"
12 alink="#204080">
13<!-- ==================== NAVIGATION BAR ==================== -->
14<table class="navbar" border="0" width="100%" cellpadding="0"
15 bgcolor="#a0c0ff" cellspacing="0">
16 <tr valign="middle">
17
18 <!-- Tree link -->
19 <th>&nbsp;&nbsp;&nbsp;<a
20 href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
21
22 <!-- Index link -->
23 <th>&nbsp;&nbsp;&nbsp;<a
24 href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
25
26 <!-- Help link -->
27 <th>&nbsp;&nbsp;&nbsp;<a
28 href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
29
30 <th class="navbar" width="100%"></th>
31 </tr>
32</table>
33<table width="100%" cellpadding="0" cellspacing="0">
34 <tr valign="top">
35 <td width="100%">
36 <span class="breadcrumbs">
37 <a href="apiclient-module.html">Package&nbsp;apiclient</a> ::
38 <a href="apiclient.http-module.html">Module&nbsp;http</a> ::
39 Class&nbsp;MediaUpload
40 </span>
41 </td>
42 <td>
43 <table cellpadding="0" cellspacing="0">
44 <!-- hide/show private -->
45 <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
46 onclick="toggle_private();">hide&nbsp;private</a>]</span></td></tr>
47 <tr><td align="right"><span class="options"
48 >[<a href="frames.html" target="_top">frames</a
49 >]&nbsp;|&nbsp;<a href="apiclient.http.MediaUpload-class.html"
50 target="_top">no&nbsp;frames</a>]</span></td></tr>
51 </table>
52 </td>
53 </tr>
54</table>
55<!-- ==================== CLASS DESCRIPTION ==================== -->
56<h1 class="epydoc">Class MediaUpload</h1><p class="nomargin-top"><span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload">source&nbsp;code</a></span></p>
57<center>
Joe Gregorio746096f2012-06-15 10:53:36 -040058<center> <map id="class_hierarchy_for_mediauploa_2" name="class_hierarchy_for_mediauploa_2">
59<area shape="rect" href="apiclient.http.MediaFileUpload-class.html" title="MediaFileUpload" alt="" coords="5,61,123,88"/>
60<area shape="rect" href="apiclient.http.MediaInMemoryUpload-class.html" title="MediaInMemoryUpload" alt="" coords="147,61,299,88"/>
61<area shape="rect" href="apiclient.http.MediaIoBaseUpload-class.html" title="MediaIoBaseUpload" alt="" coords="323,61,459,88"/>
62<area shape="rect" href="apiclient.http.MediaUpload-class.html" title="MediaUpload" alt="" coords="175,5,271,32"/>
Joe Gregorio5dc0f5c2012-06-05 13:34:31 -040063</map>
Joe Gregorio746096f2012-06-15 10:53:36 -040064 <img src="class_hierarchy_for_mediauploa_2.gif" alt='' usemap="#class_hierarchy_for_mediauploa_2" ismap="ismap" class="graph-without-title" />
Joe Gregorio5dc0f5c2012-06-05 13:34:31 -040065</center>
66</center>
67<hr />
68<pre class="literalblock">
69Describes a media object to upload.
70
71Base class that defines the interface of MediaUpload subclasses.
72
Joe Gregorio66212032012-06-14 09:10:14 -040073Note that subclasses of MediaUpload may allow you to control the chunksize
74when upload a media object. It is important to keep the size of the chunk as
75large as possible to keep the upload efficient. Other factors may influence
76the size of the chunk you use, particularly if you are working in an
77environment where individual HTTP requests may have a hardcoded time limit,
78such as under certain classes of requests under Google App Engine.
79
Joe Gregorio5dc0f5c2012-06-05 13:34:31 -040080</pre>
81
82<!-- ==================== INSTANCE METHODS ==================== -->
83<a name="section-InstanceMethods"></a>
84<table class="summary" border="1" cellpadding="3"
85 cellspacing="0" width="100%" bgcolor="white">
86<tr bgcolor="#70b0f0" class="table-header">
87 <td colspan="2" class="table-header">
88 <table border="0" cellpadding="0" cellspacing="0" width="100%">
89 <tr valign="top">
90 <td align="left"><span class="table-header">Instance Methods</span></td>
91 <td align="right" valign="top"
92 ><span class="options">[<a href="#section-InstanceMethods"
93 class="privatelink" onclick="toggle_private();"
94 >hide private</a>]</span></td>
95 </tr>
96 </table>
97 </td>
98</tr>
99<tr>
100 <td width="15%" align="right" valign="top" class="summary">
101 <span class="summary-type">&nbsp;</span>
102 </td><td class="summary">
103 <table width="100%" cellpadding="0" cellspacing="0" border="0">
104 <tr>
Joe Gregorio66212032012-06-14 09:10:14 -0400105 <td><span class="summary-sig"><a href="apiclient.http.MediaUpload-class.html#chunksize" class="summary-sig-name">chunksize</a>(<span class="summary-sig-arg">self</span>)</span><br />
106 Chunk size for resumable uploads.</td>
Joe Gregorio5dc0f5c2012-06-05 13:34:31 -0400107 <td align="right" valign="top">
108 <span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload.chunksize">source&nbsp;code</a></span>
109
110 </td>
111 </tr>
112 </table>
113
114 </td>
115 </tr>
116<tr>
117 <td width="15%" align="right" valign="top" class="summary">
118 <span class="summary-type">&nbsp;</span>
119 </td><td class="summary">
120 <table width="100%" cellpadding="0" cellspacing="0" border="0">
121 <tr>
Joe Gregorio66212032012-06-14 09:10:14 -0400122 <td><span class="summary-sig"><a href="apiclient.http.MediaUpload-class.html#mimetype" class="summary-sig-name">mimetype</a>(<span class="summary-sig-arg">self</span>)</span><br />
123 Mime type of the body.</td>
Joe Gregorio5dc0f5c2012-06-05 13:34:31 -0400124 <td align="right" valign="top">
125 <span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload.mimetype">source&nbsp;code</a></span>
126
127 </td>
128 </tr>
129 </table>
130
131 </td>
132 </tr>
133<tr>
134 <td width="15%" align="right" valign="top" class="summary">
135 <span class="summary-type">&nbsp;</span>
136 </td><td class="summary">
137 <table width="100%" cellpadding="0" cellspacing="0" border="0">
138 <tr>
Joe Gregorio66212032012-06-14 09:10:14 -0400139 <td><span class="summary-sig"><a href="apiclient.http.MediaUpload-class.html#size" class="summary-sig-name">size</a>(<span class="summary-sig-arg">self</span>)</span><br />
140 Size of upload.</td>
141 <td align="right" valign="top">
142 <span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload.size">source&nbsp;code</a></span>
143
144 </td>
145 </tr>
146 </table>
147
148 </td>
149 </tr>
150<tr>
151 <td width="15%" align="right" valign="top" class="summary">
152 <span class="summary-type">&nbsp;</span>
153 </td><td class="summary">
154 <table width="100%" cellpadding="0" cellspacing="0" border="0">
155 <tr>
156 <td><span class="summary-sig"><a href="apiclient.http.MediaUpload-class.html#resumable" class="summary-sig-name">resumable</a>(<span class="summary-sig-arg">self</span>)</span><br />
157 Whether this upload is resumable.</td>
Joe Gregorio5dc0f5c2012-06-05 13:34:31 -0400158 <td align="right" valign="top">
159 <span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload.resumable">source&nbsp;code</a></span>
160
161 </td>
162 </tr>
163 </table>
164
165 </td>
166 </tr>
Joe Gregorio66212032012-06-14 09:10:14 -0400167<tr>
168 <td width="15%" align="right" valign="top" class="summary">
169 <span class="summary-type">&nbsp;</span>
170 </td><td class="summary">
171 <table width="100%" cellpadding="0" cellspacing="0" border="0">
172 <tr>
173 <td><span class="summary-sig"><a href="apiclient.http.MediaUpload-class.html#getbytes" class="summary-sig-name">getbytes</a>(<span class="summary-sig-arg">self</span>,
174 <span class="summary-sig-arg">begin</span>,
175 <span class="summary-sig-arg">end</span>)</span><br />
176 Get bytes from the media.</td>
177 <td align="right" valign="top">
178 <span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload.getbytes">source&nbsp;code</a></span>
179
180 </td>
181 </tr>
182 </table>
183
184 </td>
185 </tr>
Joe Gregorio5dc0f5c2012-06-05 13:34:31 -0400186<tr class="private">
187 <td width="15%" align="right" valign="top" class="summary">
188 <span class="summary-type">&nbsp;</span>
189 </td><td class="summary">
190 <table width="100%" cellpadding="0" cellspacing="0" border="0">
191 <tr>
192 <td><span class="summary-sig"><a href="apiclient.http.MediaUpload-class.html#_to_json" class="summary-sig-name" onclick="show_private();">_to_json</a>(<span class="summary-sig-arg">self</span>,
193 <span class="summary-sig-arg">strip</span>=<span class="summary-sig-default">None</span>)</span><br />
194 Utility function for creating a JSON representation of a MediaUpload.</td>
195 <td align="right" valign="top">
196 <span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload._to_json">source&nbsp;code</a></span>
197
198 </td>
199 </tr>
200 </table>
201
202 </td>
203 </tr>
204<tr>
205 <td width="15%" align="right" valign="top" class="summary">
206 <span class="summary-type">&nbsp;</span>
207 </td><td class="summary">
208 <table width="100%" cellpadding="0" cellspacing="0" border="0">
209 <tr>
210 <td><span class="summary-sig"><a href="apiclient.http.MediaUpload-class.html#to_json" class="summary-sig-name">to_json</a>(<span class="summary-sig-arg">self</span>)</span><br />
211 Create a JSON representation of an instance of MediaUpload.</td>
212 <td align="right" valign="top">
213 <span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload.to_json">source&nbsp;code</a></span>
214
215 </td>
216 </tr>
217 </table>
218
219 </td>
220 </tr>
221 <tr>
222 <td colspan="2" class="summary">
223 <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
224 <code>__delattr__</code>,
225 <code>__format__</code>,
226 <code>__getattribute__</code>,
227 <code>__hash__</code>,
228 <code>__init__</code>,
229 <code>__new__</code>,
230 <code>__reduce__</code>,
231 <code>__reduce_ex__</code>,
232 <code>__repr__</code>,
233 <code>__setattr__</code>,
234 <code>__sizeof__</code>,
235 <code>__str__</code>,
236 <code>__subclasshook__</code>
237 </p>
238 </td>
239 </tr>
240</table>
241<!-- ==================== CLASS METHODS ==================== -->
242<a name="section-ClassMethods"></a>
243<table class="summary" border="1" cellpadding="3"
244 cellspacing="0" width="100%" bgcolor="white">
245<tr bgcolor="#70b0f0" class="table-header">
246 <td colspan="2" class="table-header">
247 <table border="0" cellpadding="0" cellspacing="0" width="100%">
248 <tr valign="top">
249 <td align="left"><span class="table-header">Class Methods</span></td>
250 <td align="right" valign="top"
251 ><span class="options">[<a href="#section-ClassMethods"
252 class="privatelink" onclick="toggle_private();"
253 >hide private</a>]</span></td>
254 </tr>
255 </table>
256 </td>
257</tr>
258<tr>
259 <td width="15%" align="right" valign="top" class="summary">
260 <span class="summary-type">&nbsp;</span>
261 </td><td class="summary">
262 <table width="100%" cellpadding="0" cellspacing="0" border="0">
263 <tr>
264 <td><span class="summary-sig"><a href="apiclient.http.MediaUpload-class.html#new_from_json" class="summary-sig-name">new_from_json</a>(<span class="summary-sig-arg">cls</span>,
265 <span class="summary-sig-arg">s</span>)</span><br />
266 Utility class method to instantiate a MediaUpload subclass from a JSON
267representation produced by to_json().</td>
268 <td align="right" valign="top">
269 <span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload.new_from_json">source&nbsp;code</a></span>
270
271 </td>
272 </tr>
273 </table>
274
275 </td>
276 </tr>
277</table>
278<!-- ==================== PROPERTIES ==================== -->
279<a name="section-Properties"></a>
280<table class="summary" border="1" cellpadding="3"
281 cellspacing="0" width="100%" bgcolor="white">
282<tr bgcolor="#70b0f0" class="table-header">
283 <td colspan="2" class="table-header">
284 <table border="0" cellpadding="0" cellspacing="0" width="100%">
285 <tr valign="top">
286 <td align="left"><span class="table-header">Properties</span></td>
287 <td align="right" valign="top"
288 ><span class="options">[<a href="#section-Properties"
289 class="privatelink" onclick="toggle_private();"
290 >hide private</a>]</span></td>
291 </tr>
292 </table>
293 </td>
294</tr>
295 <tr>
296 <td colspan="2" class="summary">
297 <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
298 <code>__class__</code>
299 </p>
300 </td>
301 </tr>
302</table>
303<!-- ==================== METHOD DETAILS ==================== -->
304<a name="section-MethodDetails"></a>
305<table class="details" border="1" cellpadding="3"
306 cellspacing="0" width="100%" bgcolor="white">
307<tr bgcolor="#70b0f0" class="table-header">
308 <td colspan="2" class="table-header">
309 <table border="0" cellpadding="0" cellspacing="0" width="100%">
310 <tr valign="top">
311 <td align="left"><span class="table-header">Method Details</span></td>
312 <td align="right" valign="top"
313 ><span class="options">[<a href="#section-MethodDetails"
314 class="privatelink" onclick="toggle_private();"
315 >hide private</a>]</span></td>
316 </tr>
317 </table>
318 </td>
319</tr>
320</table>
Joe Gregorio66212032012-06-14 09:10:14 -0400321<a name="chunksize"></a>
322<div>
323<table class="details" border="1" cellpadding="3"
324 cellspacing="0" width="100%" bgcolor="white">
325<tr><td>
326 <table width="100%" cellpadding="0" cellspacing="0" border="0">
327 <tr valign="top"><td>
328 <h3 class="epydoc"><span class="sig"><span class="sig-name">chunksize</span>(<span class="sig-arg">self</span>)</span>
329 </h3>
330 </td><td align="right" valign="top"
331 ><span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload.chunksize">source&nbsp;code</a></span>&nbsp;
332 </td>
333 </tr></table>
334
335 <pre class="literalblock">
336Chunk size for resumable uploads.
337
338Returns:
339 Chunk size in bytes.
340
341</pre>
342 <dl class="fields">
343 </dl>
344</td></tr></table>
345</div>
346<a name="mimetype"></a>
347<div>
348<table class="details" border="1" cellpadding="3"
349 cellspacing="0" width="100%" bgcolor="white">
350<tr><td>
351 <table width="100%" cellpadding="0" cellspacing="0" border="0">
352 <tr valign="top"><td>
353 <h3 class="epydoc"><span class="sig"><span class="sig-name">mimetype</span>(<span class="sig-arg">self</span>)</span>
354 </h3>
355 </td><td align="right" valign="top"
356 ><span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload.mimetype">source&nbsp;code</a></span>&nbsp;
357 </td>
358 </tr></table>
359
360 <pre class="literalblock">
361Mime type of the body.
362
363Returns:
364 Mime type.
365
366</pre>
367 <dl class="fields">
368 </dl>
369</td></tr></table>
370</div>
371<a name="size"></a>
372<div>
373<table class="details" border="1" cellpadding="3"
374 cellspacing="0" width="100%" bgcolor="white">
375<tr><td>
376 <table width="100%" cellpadding="0" cellspacing="0" border="0">
377 <tr valign="top"><td>
378 <h3 class="epydoc"><span class="sig"><span class="sig-name">size</span>(<span class="sig-arg">self</span>)</span>
379 </h3>
380 </td><td align="right" valign="top"
381 ><span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload.size">source&nbsp;code</a></span>&nbsp;
382 </td>
383 </tr></table>
384
385 <pre class="literalblock">
386Size of upload.
387
388Returns:
389 Size of the body, or None of the size is unknown.
390
391</pre>
392 <dl class="fields">
393 </dl>
394</td></tr></table>
395</div>
396<a name="resumable"></a>
397<div>
398<table class="details" border="1" cellpadding="3"
399 cellspacing="0" width="100%" bgcolor="white">
400<tr><td>
401 <table width="100%" cellpadding="0" cellspacing="0" border="0">
402 <tr valign="top"><td>
403 <h3 class="epydoc"><span class="sig"><span class="sig-name">resumable</span>(<span class="sig-arg">self</span>)</span>
404 </h3>
405 </td><td align="right" valign="top"
406 ><span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload.resumable">source&nbsp;code</a></span>&nbsp;
407 </td>
408 </tr></table>
409
410 <pre class="literalblock">
411Whether this upload is resumable.
412
413Returns:
414 True if resumable upload or False.
415
416</pre>
417 <dl class="fields">
418 </dl>
419</td></tr></table>
420</div>
421<a name="getbytes"></a>
422<div>
423<table class="details" border="1" cellpadding="3"
424 cellspacing="0" width="100%" bgcolor="white">
425<tr><td>
426 <table width="100%" cellpadding="0" cellspacing="0" border="0">
427 <tr valign="top"><td>
428 <h3 class="epydoc"><span class="sig"><span class="sig-name">getbytes</span>(<span class="sig-arg">self</span>,
429 <span class="sig-arg">begin</span>,
430 <span class="sig-arg">end</span>)</span>
431 </h3>
432 </td><td align="right" valign="top"
433 ><span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload.getbytes">source&nbsp;code</a></span>&nbsp;
434 </td>
435 </tr></table>
436
437 <pre class="literalblock">
438Get bytes from the media.
439
440Args:
441 begin: int, offset from beginning of file.
442 length: int, number of bytes to read, starting at begin.
443
444Returns:
445 A string of bytes read. May be shorter than length if EOF was reached
446 first.
447
448</pre>
449 <dl class="fields">
450 </dl>
451</td></tr></table>
452</div>
Joe Gregorio5dc0f5c2012-06-05 13:34:31 -0400453<a name="_to_json"></a>
454<div class="private">
455<table class="details" border="1" cellpadding="3"
456 cellspacing="0" width="100%" bgcolor="white">
457<tr><td>
458 <table width="100%" cellpadding="0" cellspacing="0" border="0">
459 <tr valign="top"><td>
460 <h3 class="epydoc"><span class="sig"><span class="sig-name">_to_json</span>(<span class="sig-arg">self</span>,
461 <span class="sig-arg">strip</span>=<span class="sig-default">None</span>)</span>
462 </h3>
463 </td><td align="right" valign="top"
464 ><span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload._to_json">source&nbsp;code</a></span>&nbsp;
465 </td>
466 </tr></table>
467
468 <pre class="literalblock">
469Utility function for creating a JSON representation of a MediaUpload.
470
471Args:
472 strip: array, An array of names of members to not include in the JSON.
473
474Returns:
475 string, a JSON representation of this instance, suitable to pass to
476 from_json().
477
478</pre>
479 <dl class="fields">
480 </dl>
481</td></tr></table>
482</div>
483<a name="to_json"></a>
484<div>
485<table class="details" border="1" cellpadding="3"
486 cellspacing="0" width="100%" bgcolor="white">
487<tr><td>
488 <table width="100%" cellpadding="0" cellspacing="0" border="0">
489 <tr valign="top"><td>
490 <h3 class="epydoc"><span class="sig"><span class="sig-name">to_json</span>(<span class="sig-arg">self</span>)</span>
491 </h3>
492 </td><td align="right" valign="top"
493 ><span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload.to_json">source&nbsp;code</a></span>&nbsp;
494 </td>
495 </tr></table>
496
497 <pre class="literalblock">
498Create a JSON representation of an instance of MediaUpload.
499
500Returns:
501 string, a JSON representation of this instance, suitable to pass to
502 from_json().
503
504</pre>
505 <dl class="fields">
506 </dl>
507</td></tr></table>
508</div>
509<a name="new_from_json"></a>
510<div>
511<table class="details" border="1" cellpadding="3"
512 cellspacing="0" width="100%" bgcolor="white">
513<tr><td>
514 <table width="100%" cellpadding="0" cellspacing="0" border="0">
515 <tr valign="top"><td>
516 <h3 class="epydoc"><span class="sig"><span class="sig-name">new_from_json</span>(<span class="sig-arg">cls</span>,
517 <span class="sig-arg">s</span>)</span>
518 <br /><em class="fname">Class Method</em>
519 </h3>
520 </td><td align="right" valign="top"
521 ><span class="codelink"><a href="apiclient.http-pysrc.html#MediaUpload.new_from_json">source&nbsp;code</a></span>&nbsp;
522 </td>
523 </tr></table>
524
525 <pre class="literalblock">
526Utility class method to instantiate a MediaUpload subclass from a JSON
527representation produced by to_json().
528
529Args:
530 s: string, JSON from to_json().
531
532Returns:
533 An instance of the subclass of MediaUpload that was serialized with
534 to_json().
535
536</pre>
537 <dl class="fields">
538 </dl>
539</td></tr></table>
540</div>
541<br />
542<!-- ==================== NAVIGATION BAR ==================== -->
543<table class="navbar" border="0" width="100%" cellpadding="0"
544 bgcolor="#a0c0ff" cellspacing="0">
545 <tr valign="middle">
546
547 <!-- Tree link -->
548 <th>&nbsp;&nbsp;&nbsp;<a
549 href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
550
551 <!-- Index link -->
552 <th>&nbsp;&nbsp;&nbsp;<a
553 href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
554
555 <!-- Help link -->
556 <th>&nbsp;&nbsp;&nbsp;<a
557 href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
558
559 <th class="navbar" width="100%"></th>
560 </tr>
561</table>
562<table border="0" cellpadding="0" cellspacing="0" width="100%%">
563 <tr>
564 <td align="left" class="footer">
Joe Gregorio672051e2012-07-10 09:11:45 -0400565 Generated by Epydoc 3.0.1 on Tue Jul 10 07:59:18 2012
Joe Gregorio5dc0f5c2012-06-05 13:34:31 -0400566 </td>
567 <td align="right" class="footer">
568 <a target="mainFrame" href="http://epydoc.sourceforge.net"
569 >http://epydoc.sourceforge.net</a>
570 </td>
571 </tr>
572</table>
573
574<script type="text/javascript">
575 <!--
576 // Private objects are initially displayed (because if
577 // javascript is turned off then we want them to be
578 // visible); but by default, we want to hide them. So hide
579 // them unless we have a cookie that says to show them.
580 checkCookie();
581 // -->
582</script>
583</body>
584</html>