Files
RETableViewManager/RETableViewManagerExample/Pods/Documentation/SDWebImage/html/Classes/SDWebImageDownloader.html
2013-04-02 10:02:19 -05:00

595 lines
17 KiB
HTML

<!DOCTYPE HTML>
<html>
<head>
<meta http-equiv="Content-Type" content="html/html; charset=utf-8" />
<title>SDWebImageDownloader Class Reference</title>
<meta id="xcode-display" name="xcode-display" content="render"/>
<meta name="viewport" content="width=550" />
<link rel="stylesheet" type="text/css" href="../css/styles.css" media="all" />
<link rel="stylesheet" type="text/css" media="print" href="../css/stylesPrint.css" />
<meta name="generator" content="appledoc 2.1 (build 840)" />
</head>
<body>
<header id="top_header">
<div id="library" class="hideInXcode">
<h1><a id="libraryTitle" href="../index.html">SDWebImage 3.2 </a></h1>
<a id="developerHome" href="../index.html">Olivier Poitrey</a>
</div>
<div id="title" role="banner">
<h1 class="hideInXcode">SDWebImageDownloader Class Reference</h1>
</div>
<ul id="headerButtons" role="toolbar">
<li id="toc_button">
<button aria-label="Show Table of Contents" role="checkbox" class="open" id="table_of_contents"><span class="disclosure"></span>Table of Contents</button>
</li>
<li id="jumpto_button" role="navigation">
<select id="jumpTo">
<option value="top">Jump To&#133;</option>
<option value="overview">Overview</option>
<option value="tasks">Tasks</option>
<option value="properties">Properties</option>
<option value="//api/name/maxConcurrentDownloads">&nbsp;&nbsp;&nbsp;&nbsp;maxConcurrentDownloads</option>
<option value="//api/name/queueMode">&nbsp;&nbsp;&nbsp;&nbsp;queueMode</option>
<option value="class_methods">Class Methods</option>
<option value="//api/name/sharedDownloader">&nbsp;&nbsp;&nbsp;&nbsp;+ sharedDownloader</option>
<option value="instance_methods">Instance Methods</option>
<option value="//api/name/downloadImageWithURL:options:progress:completed:">&nbsp;&nbsp;&nbsp;&nbsp;- downloadImageWithURL:options:progress:completed:</option>
<option value="//api/name/setValue:forHTTPHeaderField:">&nbsp;&nbsp;&nbsp;&nbsp;- setValue:forHTTPHeaderField:</option>
<option value="//api/name/valueForHTTPHeaderField:">&nbsp;&nbsp;&nbsp;&nbsp;- valueForHTTPHeaderField:</option>
</select>
</li>
</ul>
</header>
<nav id="tocContainer" class="isShowingTOC">
<ul id="toc" role="tree">
<li role="treeitem"><span class="nodisclosure"></span><span class="sectionName"><a href="#overview">Overview</a></span></li>
<li role="treeitem" id="task_treeitem"><span class="nodisclosure"></span><span class="sectionName"><a href="#tasks">Tasks</a></span><ul>
</ul></li>
<li role="treeitem" class="children"><span class="disclosure"></span><span class="sectionName"><a href="#properties">Properties</a></span><ul>
<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/maxConcurrentDownloads">maxConcurrentDownloads</a></span></li>
<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/queueMode">queueMode</a></span></li>
</ul></li>
<li role="treeitem" class="children"><span class="disclosure"></span><span class="sectionName"><a href="#class_methods">Class Methods</a></span><ul>
<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/sharedDownloader">sharedDownloader</a></span></li>
</ul></li>
<li role="treeitem" class="children"><span class="disclosure"></span><span class="sectionName"><a href="#instance_methods">Instance Methods</a></span><ul>
<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/downloadImageWithURL:options:progress:completed:">downloadImageWithURL:options:progress:completed:</a></span></li>
<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/setValue:forHTTPHeaderField:">setValue:forHTTPHeaderField:</a></span></li>
<li><span class="nodisclosure"></span><span class="sectionName"><a href="#//api/name/valueForHTTPHeaderField:">valueForHTTPHeaderField:</a></span></li>
</ul></li>
</ul>
</nav>
<article>
<div id="contents" class="isShowingTOC" role="main">
<a title="SDWebImageDownloader Class Reference" name="top"></a>
<div class="main-navigation navigation-top">
<ul>
<li><a href="../index.html">Index</a></li>
<li><a href="../hierarchy.html">Hierarchy</a></li>
</ul>
</div>
<div id="header">
<div class="section-header">
<h1 class="title title-header">SDWebImageDownloader Class Reference</h1>
</div>
</div>
<div id="container">
<div class="section section-specification"><table cellspacing="0"><tbody>
<tr>
<td class="specification-title">Inherits from</td>
<td class="specification-value">NSObject</td>
</tr><tr>
<td class="specification-title">Declared in</td>
<td class="specification-value">SDWebImageDownloader.h</td>
</tr>
</tbody></table></div>
<div class="section section-overview">
<a title="Overview" name="overview"></a>
<h2 class="subtitle subtitle-overview">Overview</h2>
<p>Asynchronous downloader dedicated and optimized for image loading.</p>
</div>
<div class="section section-tasks">
<a title="Tasks" name="tasks"></a>
<h2 class="subtitle subtitle-tasks">Tasks</h2>
<ul class="task-list">
<li>
<span class="tooltip">
<code><a href="#//api/name/maxConcurrentDownloads">&nbsp;&nbsp;maxConcurrentDownloads</a></code>
</span>
<span class="task-item-suffix">property</span>
</li><li>
<span class="tooltip">
<code><a href="#//api/name/queueMode">&nbsp;&nbsp;queueMode</a></code>
<span class="tooltip"><p>Changes download operations unqueue mode. Default value is <code>SDWebImageDownloaderFILOQueueMode</code>.</p></span>
</span>
<span class="task-item-suffix">property</span>
</li><li>
<span class="tooltip">
<code><a href="#//api/name/sharedDownloader">+&nbsp;sharedDownloader</a></code>
</span>
</li><li>
<span class="tooltip">
<code><a href="#//api/name/setValue:forHTTPHeaderField:">&ndash;&nbsp;setValue:forHTTPHeaderField:</a></code>
<span class="tooltip"><p>Set a value for a HTTP header to be appended to each download HTTP request.</p></span>
</span>
</li><li>
<span class="tooltip">
<code><a href="#//api/name/valueForHTTPHeaderField:">&ndash;&nbsp;valueForHTTPHeaderField:</a></code>
<span class="tooltip"><p>Returns the value of the specified HTTP header field.</p></span>
</span>
</li><li>
<span class="tooltip">
<code><a href="#//api/name/downloadImageWithURL:options:progress:completed:">&ndash;&nbsp;downloadImageWithURL:options:progress:completed:</a></code>
<span class="tooltip"><p>Creates a SDWebImageDownloader async downloader instance with a given URL</p></span>
</span>
</li>
</ul>
</div>
<div class="section section-methods">
<a title="Properties" name="properties"></a>
<h2 class="subtitle subtitle-methods">Properties</h2>
<div class="section-method">
<a name="//api/name/maxConcurrentDownloads" title="maxConcurrentDownloads"></a>
<h3 class="subsubtitle method-title">maxConcurrentDownloads</h3>
<div class="method-subsection method-declaration"><code>@property (assign, nonatomic) NSInteger maxConcurrentDownloads</code></div>
</div>
<div class="section-method">
<a name="//api/name/queueMode" title="queueMode"></a>
<h3 class="subsubtitle method-title">queueMode</h3>
<div class="method-subsection brief-description">
<p>Changes download operations unqueue mode. Default value is <code>SDWebImageDownloaderFILOQueueMode</code>.</p>
</div>
<div class="method-subsection method-declaration"><code>@property (assign, nonatomic) SDWebImageDownloaderQueueMode queueMode</code></div>
<div class="method-subsection discussion-section">
<h4 class="method-subtitle">Discussion</h4>
<p>Changes download operations unqueue mode. Default value is <code>SDWebImageDownloaderFILOQueueMode</code>.</p>
</div>
<div class="method-subsection declared-in-section">
<h4 class="method-subtitle">Declared In</h4>
<code class="declared-in-ref">SDWebImageDownloader.h</code><br />
</div>
</div>
</div>
<div class="section section-methods">
<a title="Class Methods" name="class_methods"></a>
<h2 class="subtitle subtitle-methods">Class Methods</h2>
<div class="section-method">
<a name="//api/name/sharedDownloader" title="sharedDownloader"></a>
<h3 class="subsubtitle method-title">sharedDownloader</h3>
<div class="method-subsection method-declaration"><code>+ (SDWebImageDownloader *)sharedDownloader</code></div>
</div>
</div>
<div class="section section-methods">
<a title="Instance Methods" name="instance_methods"></a>
<h2 class="subtitle subtitle-methods">Instance Methods</h2>
<div class="section-method">
<a name="//api/name/downloadImageWithURL:options:progress:completed:" title="downloadImageWithURL:options:progress:completed:"></a>
<h3 class="subsubtitle method-title">downloadImageWithURL:options:progress:completed:</h3>
<div class="method-subsection brief-description">
<p>Creates a SDWebImageDownloader async downloader instance with a given URL</p>
</div>
<div class="method-subsection method-declaration"><code>- (id&lt;SDWebImageOperation&gt;)downloadImageWithURL:(NSURL *)<em>url</em> options:(SDWebImageDownloaderOptions)<em>options</em> progress:(SDWebImageDownloaderProgressBlock)<em>progressBlock</em> completed:(SDWebImageDownloaderCompletedBlock)<em>completedBlock</em></code></div>
<div class="method-subsection arguments-section parameters">
<h4 class="method-subtitle parameter-title">Parameters</h4>
<dl class="argument-def parameter-def">
<dt><em>url</em></dt>
<dd><p>The URL to the image to download</p></dd>
</dl>
<dl class="argument-def parameter-def">
<dt><em>options</em></dt>
<dd><p>The options to be used for this download</p></dd>
</dl>
<dl class="argument-def parameter-def">
<dt><em>completed</em></dt>
<dd><p>A block called once the download is completed.
If the download succeeded, the image parameter is set, in case of error,
error parameter is set with the error. The last parameter is always YES
if SDWebImageDownloaderProgressiveDownload isn&rsquo;t use. With the
SDWebImageDownloaderProgressiveDownload option, this block is called
repeatedly with the partial image object and the finished argument set to NO
before to be called a last time with the full image and finished argument
set to YES. In case of error, the finished argument is always YES.</p></dd>
</dl>
<dl class="argument-def parameter-def">
<dt><em>progress</em></dt>
<dd><p>A block called repeatedly while the image is downloading</p></dd>
</dl>
</div>
<div class="method-subsection return">
<h4 class="method-subtitle parameter-title">Return Value</h4>
<p>A cancellable <a href="../Protocols/SDWebImageOperation.html">SDWebImageOperation</a></p>
</div>
<div class="method-subsection discussion-section">
<h4 class="method-subtitle">Discussion</h4>
<p>Creates a SDWebImageDownloader async downloader instance with a given URL</p>
<p>The delegate will be informed when the image is finish downloaded or an error has happen.</p>
</div>
<div class="method-subsection declared-in-section">
<h4 class="method-subtitle">Declared In</h4>
<code class="declared-in-ref">SDWebImageDownloader.h</code><br />
</div>
</div>
<div class="section-method">
<a name="//api/name/setValue:forHTTPHeaderField:" title="setValue:forHTTPHeaderField:"></a>
<h3 class="subsubtitle method-title">setValue:forHTTPHeaderField:</h3>
<div class="method-subsection brief-description">
<p>Set a value for a HTTP header to be appended to each download HTTP request.</p>
</div>
<div class="method-subsection method-declaration"><code>- (void)setValue:(NSString *)<em>value</em> forHTTPHeaderField:(NSString *)<em>field</em></code></div>
<div class="method-subsection arguments-section parameters">
<h4 class="method-subtitle parameter-title">Parameters</h4>
<dl class="argument-def parameter-def">
<dt><em>value</em></dt>
<dd><p>The value for the header field. Use <code>nil</code> value to remove the header.</p></dd>
</dl>
<dl class="argument-def parameter-def">
<dt><em>field</em></dt>
<dd><p>The name of the header field to set.</p></dd>
</dl>
</div>
<div class="method-subsection discussion-section">
<h4 class="method-subtitle">Discussion</h4>
<p>Set a value for a HTTP header to be appended to each download HTTP request.</p>
</div>
<div class="method-subsection declared-in-section">
<h4 class="method-subtitle">Declared In</h4>
<code class="declared-in-ref">SDWebImageDownloader.h</code><br />
</div>
</div>
<div class="section-method">
<a name="//api/name/valueForHTTPHeaderField:" title="valueForHTTPHeaderField:"></a>
<h3 class="subsubtitle method-title">valueForHTTPHeaderField:</h3>
<div class="method-subsection brief-description">
<p>Returns the value of the specified HTTP header field.</p>
</div>
<div class="method-subsection method-declaration"><code>- (NSString *)valueForHTTPHeaderField:(NSString *)<em>field</em></code></div>
<div class="method-subsection return">
<h4 class="method-subtitle parameter-title">Return Value</h4>
<p>The value associated with the header field field, or <code>nil</code> if there is no corresponding header field.</p>
</div>
<div class="method-subsection discussion-section">
<h4 class="method-subtitle">Discussion</h4>
<p>Returns the value of the specified HTTP header field.</p>
</div>
<div class="method-subsection declared-in-section">
<h4 class="method-subtitle">Declared In</h4>
<code class="declared-in-ref">SDWebImageDownloader.h</code><br />
</div>
</div>
</div>
</div>
<div class="main-navigation navigation-bottom">
<ul>
<li><a href="../index.html">Index</a></li>
<li><a href="../hierarchy.html">Hierarchy</a></li>
</ul>
</div>
<div id="footer">
<hr />
<div class="footer-copyright">
<p><span class="copyright">&copy; 2013 Olivier Poitrey. All rights reserved. (Last updated: 2013-04-02)</span><br />
<span class="generator">Generated by <a href="http://appledoc.gentlebytes.com">appledoc 2.1 (build 840)</a>.</span></p>
</div>
</div>
</div>
</article>
<script type="text/javascript">
function jumpToChange()
{
window.location.hash = this.options[this.selectedIndex].value;
}
function toggleTOC()
{
var contents = document.getElementById('contents');
var tocContainer = document.getElementById('tocContainer');
if (this.getAttribute('class') == 'open')
{
this.setAttribute('class', '');
contents.setAttribute('class', '');
tocContainer.setAttribute('class', '');
window.name = "hideTOC";
}
else
{
this.setAttribute('class', 'open');
contents.setAttribute('class', 'isShowingTOC');
tocContainer.setAttribute('class', 'isShowingTOC');
window.name = "";
}
return false;
}
function toggleTOCEntryChildren(e)
{
e.stopPropagation();
var currentClass = this.getAttribute('class');
if (currentClass == 'children') {
this.setAttribute('class', 'children open');
}
else if (currentClass == 'children open') {
this.setAttribute('class', 'children');
}
return false;
}
function tocEntryClick(e)
{
e.stopPropagation();
return true;
}
function init()
{
var selectElement = document.getElementById('jumpTo');
selectElement.addEventListener('change', jumpToChange, false);
var tocButton = document.getElementById('table_of_contents');
tocButton.addEventListener('click', toggleTOC, false);
var taskTreeItem = document.getElementById('task_treeitem');
if (taskTreeItem.getElementsByTagName('li').length > 0)
{
taskTreeItem.setAttribute('class', 'children');
taskTreeItem.firstChild.setAttribute('class', 'disclosure');
}
var tocList = document.getElementById('toc');
var tocEntries = tocList.getElementsByTagName('li');
for (var i = 0; i < tocEntries.length; i++) {
tocEntries[i].addEventListener('click', toggleTOCEntryChildren, false);
}
var tocLinks = tocList.getElementsByTagName('a');
for (var i = 0; i < tocLinks.length; i++) {
tocLinks[i].addEventListener('click', tocEntryClick, false);
}
if (window.name == "hideTOC") {
toggleTOC.call(tocButton);
}
}
window.onload = init;
// If showing in Xcode, hide the TOC and Header
if (navigator.userAgent.match(/xcode/i)) {
document.getElementById("contents").className = "hideInXcode"
document.getElementById("tocContainer").className = "hideInXcode"
document.getElementById("top_header").className = "hideInXcode"
}
</script>
</body>
</html>