/usr/share/doc/python-collada/html/loading.html is in python-collada 0.4-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Loading A Collada Document — pycollada 0.4 documentation</title>
<link rel="stylesheet" href="_static/sphinxdoc.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '0.4',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="pycollada 0.4 documentation" href="index.html" />
<link rel="next" title="Collada Object Structure" href="structure.html" />
<link rel="prev" title="Installation" href="install.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="structure.html" title="Collada Object Structure"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="install.html" title="Installation"
accesskey="P">previous</a> |</li>
<li><a href="index.html">pycollada 0.4 documentation</a> »</li>
</ul>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<p class="topless"><a href="install.html"
title="previous chapter">Installation</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="structure.html"
title="next chapter">Collada Object Structure</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/loading.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="loading-a-collada-document">
<h1>Loading A Collada Document<a class="headerlink" href="#loading-a-collada-document" title="Permalink to this headline">ΒΆ</a></h1>
<p>Collada documents can be loaded with the <a class="reference internal" href="reference/generated/collada.Collada.html#collada.Collada" title="collada.Collada"><tt class="xref py py-class docutils literal"><span class="pre">Collada</span></tt></a> class:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">mesh</span> <span class="o">=</span> <span class="n">Collada</span><span class="p">(</span><span class="s">'file.dae'</span><span class="p">)</span>
</pre></div>
</div>
<p>Zip archives are also supported. The archive will be searched for
a dae file.</p>
<p>The constructor can also accept a file-like object:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">f</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="s">'file.dae'</span><span class="p">)</span>
<span class="n">mesh</span> <span class="o">=</span> <span class="n">Collada</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
</pre></div>
</div>
<p>Note that this will also work with the <cite>StringIO</cite> module. When
loading from non-file sources, the <cite>aux_file_loader</cite> parameter can
be passed to the constructor. This is useful if loading from
an unusual source, like a database:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">dae_file</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="s">'file.dae'</span><span class="p">)</span>
<span class="n">dae_data</span> <span class="o">=</span> <span class="n">dae_file</span><span class="o">.</span><span class="n">read</span><span class="p">()</span>
<span class="n">texture_file</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="s">'texture.jpg'</span><span class="p">)</span>
<span class="n">texture_data</span> <span class="o">=</span> <span class="n">texture_file</span><span class="o">.</span><span class="n">read</span><span class="p">()</span>
<span class="k">def</span> <span class="nf">my_aux_loader</span><span class="p">(</span><span class="n">filename</span><span class="p">):</span>
<span class="k">if</span> <span class="n">filename</span> <span class="o">==</span> <span class="s">'texture.jpg'</span><span class="p">:</span>
<span class="k">return</span> <span class="n">texture_data</span>
<span class="k">return</span> <span class="bp">None</span>
<span class="n">mesh</span> <span class="o">=</span> <span class="n">Collada</span><span class="p">(</span><span class="n">StringIO</span><span class="p">(</span><span class="n">dae_data</span><span class="p">),</span> <span class="n">aux_file_loader</span><span class="o">=</span><span class="n">my_aux_loader</span><span class="p">)</span>
</pre></div>
</div>
<p>When using the Collada object (see <a class="reference internal" href="structure.html#structure"><em>Collada Object Structure</em></a>), if you try and
read a texture, the <cite>my_aux_loader</cite> function will be invoked.</p>
<p>Loading a collada document can result in an exception being thrown.
For a list of possible exceptions, see <a class="reference internal" href="reference/exceptions.html#exception-summary"><em>Exceptions</em></a>.
Sometimes, you may want to ignore some exceptions and let the loader
try to continue loading the file. For example, the following will
ignore errors about broken references and features that pycollada
doesn’t support:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">mesh</span> <span class="o">=</span> <span class="n">Collada</span><span class="p">(</span><span class="s">'file.dae'</span><span class="p">,</span> <span class="n">ignore</span><span class="o">=</span><span class="p">[</span><span class="n">DaeUnsupportedError</span><span class="p">,</span> <span class="n">DaeBrokenRefError</span><span class="p">])</span>
</pre></div>
</div>
<p>If any errors occurred during the load, you can find them in <a class="reference internal" href="reference/generated/collada.Collada.html#collada.Collada.errors" title="collada.Collada.errors"><tt class="xref py py-attr docutils literal"><span class="pre">Collada.errors</span></tt></a>.</p>
</div>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="structure.html" title="Collada Object Structure"
>next</a> |</li>
<li class="right" >
<a href="install.html" title="Installation"
>previous</a> |</li>
<li><a href="index.html">pycollada 0.4 documentation</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2011, Jeff Terrace and contributors.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.
</div>
</body>
</html>
|