<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>STL — Blender Manual</title>
<link rel="shortcut icon" href="../_static/favicon.ico"/>
<link rel="canonical" href="https://docs.blender.org/manual/en/latest/addons/io_mesh_stl.html"/>
<script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></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>
<script type="text/javascript" src="../_static/language_data.js"></script>
<script type="text/javascript" src="../_static/js/version_switch.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="../_static/js/theme.js"></script>
<link rel="search" type="application/opensearchdescription+xml"
title="Search within Blender Manual"
href="../_static/opensearch.xml"/>
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme_overrides.css" type="text/css" />
<link rel="alternate" hreflang="en" href="https://docs.blender.org/manual/en/latest/">
<link rel="alternate" hreflang="de" href="https://docs.blender.org/manual/de/latest/">
<link rel="alternate" hreflang="es" href="https://docs.blender.org/manual/es/latest/">
<link rel="alternate" hreflang="fi" href="https://docs.blender.org/manual/fi/latest/">
<link rel="alternate" hreflang="fr" href="https://docs.blender.org/manual/fr/latest/">
<link rel="alternate" hreflang="it" href="https://docs.blender.org/manual/it/latest/">
<link rel="alternate" hreflang="ja" href="https://docs.blender.org/manual/ja/latest/">
<link rel="alternate" hreflang="ko" href="https://docs.blender.org/manual/ko/latest/">
<link rel="alternate" hreflang="nb" href="https://docs.blender.org/manual/nb/latest/">
<link rel="alternate" hreflang="pt" href="https://docs.blender.org/manual/pt/latest/">
<link rel="alternate" hreflang="ru" href="https://docs.blender.org/manual/ru/latest/">
<link rel="alternate" hreflang="sl" href="https://docs.blender.org/manual/sl/latest/">
<link rel="alternate" hreflang="sr" href="https://docs.blender.org/manual/sr/latest/">
<link rel="alternate" hreflang="uk" href="https://docs.blender.org/manual/uk/latest/">
<link rel="alternate" hreflang="vi" href="https://docs.blender.org/manual/vi/latest/">
<link rel="alternate" hreflang="zh-Hans" href="https://docs.blender.org/manual/zh-hans/latest/">
<link rel="alternate" hreflang="zh-Hant" href="https://docs.blender.org/manual/zh-hant/latest/">
<link rel="alternate" hreflang="x-default" href="https://docs.blender.org/manual/en/latest/">
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="UV Layout" href="io_mesh_uv_layout.html" />
<link rel="prev" title="Stanford PLY" href="io_mesh_ply.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="../index.html" class="icon icon-home"> Blender 2.80 Manual
<img src="../_static/blender-logo.svg" class="logo" alt="Logo"/>
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../getting_started/index.html">Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="../interface/index.html">User Interface</a></li>
<li class="toctree-l1"><a class="reference internal" href="../editors/index.html">Editors</a></li>
<li class="toctree-l1"><a class="reference internal" href="../scene_layout/index.html">Scenes & Objects</a></li>
<li class="toctree-l1"><a class="reference internal" href="../modeling/index.html">Modeling</a></li>
<li class="toctree-l1"><a class="reference internal" href="../sculpt_paint/index.html">Sculpting & Painting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../grease_pencil/index.html">Grease Pencil</a></li>
<li class="toctree-l1"><a class="reference internal" href="../animation/index.html">Animation & Rigging</a></li>
<li class="toctree-l1"><a class="reference internal" href="../physics/index.html">Physics</a></li>
<li class="toctree-l1"><a class="reference internal" href="../render/index.html">Rendering</a></li>
<li class="toctree-l1"><a class="reference internal" href="../compositing/index.html">Compositing</a></li>
<li class="toctree-l1"><a class="reference internal" href="../movie_clip/index.html">Tracking & Masking</a></li>
<li class="toctree-l1"><a class="reference internal" href="../video_editing/index.html">Video Editing</a></li>
<li class="toctree-l1"><a class="reference internal" href="../files/index.html">Files & Data System</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="index.html">Add-ons</a><ul class="current">
<li class="toctree-l2 current"><a class="reference internal" href="index.html#import-export">Import-Export</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="io_anim_bvh.html">BioVision Motion Capture (BVH)</a></li>
<li class="toctree-l3"><a class="reference internal" href="io_curve_svg.html">Scalable Vector Graphics (SVG)</a></li>
<li class="toctree-l3"><a class="reference internal" href="io_mesh_ply.html">Stanford PLY</a></li>
<li class="toctree-l3 current"><a class="current reference internal" href="#">STL</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#properties">Properties</a></li>
<li class="toctree-l4"><a class="reference internal" href="#usage">Usage</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="io_mesh_uv_layout.html">UV Layout</a></li>
<li class="toctree-l3"><a class="reference internal" href="io_scene_fbx.html">FBX</a></li>
<li class="toctree-l3"><a class="reference internal" href="io_scene_gltf2.html">glTF 2.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="io_scene_obj.html">Wavefront OBJ</a></li>
<li class="toctree-l3"><a class="reference internal" href="io_scene_x3d.html">Web3D X3D/VRML2</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="index.html#render">Render</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../advanced/index.html">Advanced</a></li>
<li class="toctree-l1"><a class="reference internal" href="../troubleshooting/index.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../glossary/index.html">Glossary</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../about/index.html">About this Manual</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../index.html">Blender 2.80 Manual</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="../index.html">Docs</a> »</li>
<li><a href="index.html">Add-ons</a> »</li>
<li>STL</li>
<li class="wy-breadcrumbs-aside">
<a href="../_sources/addons/io_mesh_stl.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<div class="section" id="stl">
<h1>STL<a class="headerlink" href="#stl" title="Permalink to this headline">¶</a></h1>
<div class="refbox admonition">
<p class="first admonition-title">Reference</p>
<table class="last docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field-odd field"><th class="field-name">Category:</th><td class="field-body">Import-Export</td>
</tr>
<tr class="field-even field"><th class="field-name">Menu:</th><td class="field-body"><span class="menuselection">File ‣ Import/Export ‣ Stl (.stl)</span></td>
</tr>
</tbody>
</table>
</div>
<p>This format is useful if you intend to import/export the files for CAD software.
It is also commonly used for loading into 3D printing software.</p>
<div class="admonition warning">
<p class="first admonition-title">Warning</p>
<p class="last">Currently the script does not handle importing or exporting of normals
and does not handle endianness, there is nothing in the STL specification about it.</p>
</div>
<div class="section" id="properties">
<h2>Properties<a class="headerlink" href="#properties" title="Permalink to this headline">¶</a></h2>
<div class="section" id="common">
<h3>Common<a class="headerlink" href="#common" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt>Forward / Up Axis</dt>
<dd><p class="first">Since many applications use a different axis for ‘Up’, these are axis conversion for these settings,
Forward and Up axes – By mapping these to different axes you can convert rotations
between applications default up and forward axes.</p>
<p class="last">Blender uses Y Forward, Z Up (since the front view looks along the +Y direction).
For example, it’s common for applications to use Y as the up axis, in that case -Z Forward, Y Up is needed.</p>
</dd>
<dt>Scale</dt>
<dd>TODO.</dd>
<dt>Scene Unit</dt>
<dd>TODO.</dd>
</dl>
</div>
<div class="section" id="import">
<h3>Import<a class="headerlink" href="#import" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt>Facet Normals</dt>
<dd>TODO.</dd>
</dl>
</div>
<div class="section" id="export">
<h3>Export<a class="headerlink" href="#export" title="Permalink to this headline">¶</a></h3>
<dl class="docutils">
<dt>Selection Only</dt>
<dd>TODO.</dd>
<dt>ASCII</dt>
<dd>TODO.</dd>
<dt>Apply Modifiers</dt>
<dd>TODO.</dd>
<dt>Batch Mode</dt>
<dd>TODO.</dd>
</dl>
</div>
</div>
<div class="section" id="usage">
<h2>Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
<p>Use the operator to import ASCII or binary STL-files, you can select multiple files at once.
For exporting you can select multiple objects and they will be exported as a single STL-file.
You can select between ASCII/binary file format (binary is more compact).
You can also choose to enable or disable the modifiers during the export.</p>
</div>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="io_mesh_uv_layout.html" class="btn btn-neutral float-right" title="UV Layout" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="io_mesh_ply.html" class="btn btn-neutral float-left" title="Stanford PLY" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
© Copyright : This page is licensed under a CC-BY-SA 4.0 Int. License
</p>
</div>
</footer>
</div>
</div>
</section>
</div>
<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="document versions">
<ul id="versionwrap" role="presentation">
<li style="float:left" role="presentation">
<span id="version-dropdown" class="version-btn" tabindex="0" role="button" aria-label="versions selector" aria-haspopup="true" aria-controls="version-vsnlist" aria-disabled="true">
2.80
</span>
<ul id="version-vsnlist" class="version-list" role="menu" aria-labelledby="version-dropdown" aria-hidden="true">
<li role="presentation">Loading...</li>
</ul>
</li>
<li style="float:right" role="presentation">
<span id="lang-dropdown" class="version-btn" tabindex="0" role="button" aria-label="language selector" aria-haspopup="true" aria-controls="version-langlist">
en
</span>
<ul id="version-langlist" class="version-list" role="menu" aria-labelledby="lang-dropdown" aria-hidden="true">
<li role="presentation">Loading...</li>
</ul>
</li>
</ul>
</div>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
<script>
window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)};ga.l=+new Date;
ga('create', 'UA-1418081-1', 'auto');
ga('send', 'pageview');
</script>
<script async src='https://www.google-analytics.com/analytics.js'></script>
</body>
</html>