KiBot/docs/build/html/configuration/outputs/render_3d.html

302 lines
28 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>3D render of the PCB &mdash; KiBot 1.6.4 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
<script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
<script src="../../_static/jquery.js"></script>
<script src="../../_static/underscore.js"></script>
<script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
<script src="../../_static/doctools.js"></script>
<script src="../../_static/sphinx_highlight.js"></script>
<script src="../../_static/js/theme.js"></script>
<link rel="index" title="Index" href="../../genindex.html" />
<link rel="search" title="Search" href="../../search.html" />
<link rel="next" title="Design report" href="report.html" />
<link rel="prev" title="QR_Lib" href="qr_lib.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">
KiBot
<img src="../../_static/kibot_370x200.png" 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" aria-label="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="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../introduction.html">Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../installation.html">Installation</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../../configuration.html">Configuration</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="../quick_start.html">Quick start</a></li>
<li class="toctree-l2"><a class="reference internal" href="../section_order.html">Section order</a></li>
<li class="toctree-l2"><a class="reference internal" href="../header.html">The header</a></li>
<li class="toctree-l2"><a class="reference internal" href="../preflight.html">The <em>preflight</em> section</a></li>
<li class="toctree-l2"><a class="reference internal" href="../global.html">Default global options</a></li>
<li class="toctree-l2"><a class="reference internal" href="../filters.html">Filters and variants</a></li>
<li class="toctree-l2 current"><a class="reference internal" href="../outputs.html">The <em>outputs</em> section</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="../outputs.html#specifying-the-layers">Specifying the layers</a></li>
<li class="toctree-l3 current"><a class="reference internal" href="../outputs.html#supported-outputs">Supported outputs</a><ul class="current">
<li class="toctree-l4"><a class="reference internal" href="blender_export.html">Blender Export <strong>Experimental</strong></a></li>
<li class="toctree-l4"><a class="reference internal" href="boardview.html">BoardView</a></li>
<li class="toctree-l4"><a class="reference internal" href="bom.html">BoM (Bill of Materials)</a></li>
<li class="toctree-l4"><a class="reference internal" href="compress.html">Archiver (files compressor)</a></li>
<li class="toctree-l4"><a class="reference internal" href="copy_files.html">Files copier</a></li>
<li class="toctree-l4"><a class="reference internal" href="diff.html">Diff</a></li>
<li class="toctree-l4"><a class="reference internal" href="download_datasheets.html">Datasheets downloader</a></li>
<li class="toctree-l4"><a class="reference internal" href="dxf.html">DXF (Drawing Exchange Format)</a></li>
<li class="toctree-l4"><a class="reference internal" href="dxf_sch_print.html">DXF Schematic Print (Drawing Exchange Format)</a></li>
<li class="toctree-l4"><a class="reference internal" href="excellon.html">Excellon drill format</a></li>
<li class="toctree-l4"><a class="reference internal" href="gencad.html">GenCAD</a></li>
<li class="toctree-l4"><a class="reference internal" href="gerb_drill.html">Gerber drill format</a></li>
<li class="toctree-l4"><a class="reference internal" href="gerber.html">Gerber format</a></li>
<li class="toctree-l4"><a class="reference internal" href="hpgl.html">HPGL (Hewlett &amp; Packard Graphics Language)</a></li>
<li class="toctree-l4"><a class="reference internal" href="hpgl_sch_print.html">HPGL Schematic Print (Hewlett &amp; Packard Graphics Language)</a></li>
<li class="toctree-l4"><a class="reference internal" href="ibom.html">IBoM (Interactive HTML BoM)</a></li>
<li class="toctree-l4"><a class="reference internal" href="info.html">Info</a></li>
<li class="toctree-l4"><a class="reference internal" href="kibom.html">KiBoM (KiCad Bill of Materials)</a></li>
<li class="toctree-l4"><a class="reference internal" href="kicost.html">KiCost (KiCad Cost calculator)</a></li>
<li class="toctree-l4"><a class="reference internal" href="kikit_present.html">KiKits Present - Project Presentation</a></li>
<li class="toctree-l4"><a class="reference internal" href="navigate_results.html">Navigate Results</a></li>
<li class="toctree-l4"><a class="reference internal" href="netlist.html">Netlist</a></li>
<li class="toctree-l4"><a class="reference internal" href="panelize.html">Panelize</a></li>
<li class="toctree-l4"><a class="reference internal" href="pcb2blender_tools.html">PCB2Blender Tools</a></li>
<li class="toctree-l4"><a class="reference internal" href="pcb_print.html">PCB Print</a></li>
<li class="toctree-l4"><a class="reference internal" href="pcb_variant.html">PCB with variant generator</a></li>
<li class="toctree-l4"><a class="reference internal" href="pcbdraw.html">PcbDraw - Beautiful 2D PCB render</a></li>
<li class="toctree-l4"><a class="reference internal" href="pdf.html">PDF (Portable Document Format)</a></li>
<li class="toctree-l4"><a class="reference internal" href="pdf_pcb_print.html">PDF PCB Print (Portable Document Format) <em>Deprecated</em></a></li>
<li class="toctree-l4"><a class="reference internal" href="pdf_sch_print.html">PDF Schematic Print (Portable Document Format)</a></li>
<li class="toctree-l4"><a class="reference internal" href="pdfunite.html">PDF joiner</a></li>
<li class="toctree-l4"><a class="reference internal" href="populate.html">Populate - Assembly instructions builder</a></li>
<li class="toctree-l4"><a class="reference internal" href="position.html">Pick &amp; place</a></li>
<li class="toctree-l4"><a class="reference internal" href="ps.html">PS (Postscript)</a></li>
<li class="toctree-l4"><a class="reference internal" href="ps_sch_print.html">PS Schematic Print (Postscript)</a></li>
<li class="toctree-l4"><a class="reference internal" href="qr_lib.html">QR_Lib</a></li>
<li class="toctree-l4 current"><a class="current reference internal" href="#">3D render of the PCB</a></li>
<li class="toctree-l4"><a class="reference internal" href="report.html">Design report</a></li>
<li class="toctree-l4"><a class="reference internal" href="sch_variant.html">Schematic with variant generator</a></li>
<li class="toctree-l4"><a class="reference internal" href="stencil_3d.html">3D Printed Stencils</a></li>
<li class="toctree-l4"><a class="reference internal" href="stencil_for_jig.html">Steel Stencils for Alignment Jig</a></li>
<li class="toctree-l4"><a class="reference internal" href="step.html">STEP (ISO 10303-21 Clear Text Encoding of the Exchange Structure)</a></li>
<li class="toctree-l4"><a class="reference internal" href="svg.html">SVG (Scalable Vector Graphics)</a></li>
<li class="toctree-l4"><a class="reference internal" href="svg_pcb_print.html">SVG PCB Print (Scalable Vector Graphics) <em>Deprecated</em></a></li>
<li class="toctree-l4"><a class="reference internal" href="svg_sch_print.html">SVG Schematic Print</a></li>
<li class="toctree-l4"><a class="reference internal" href="vrml.html">VRML (Virtual Reality Modeling Language)</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../outputs.html#consolidating-boms">Consolidating BoMs</a></li>
<li class="toctree-l3"><a class="reference internal" href="../outputs.html#importing-outputs-from-another-file">Importing outputs from another file</a></li>
<li class="toctree-l3"><a class="reference internal" href="../outputs.html#importing-other-stuff-from-another-file">Importing other stuff from another file</a></li>
<li class="toctree-l3"><a class="reference internal" href="../outputs.html#parametrizable-imports">Parametrizable imports</a></li>
<li class="toctree-l3"><a class="reference internal" href="../outputs.html#importing-internal-templates">Importing internal templates</a></li>
<li class="toctree-l3"><a class="reference internal" href="../outputs.html#using-other-output-as-base-for-a-new-one">Using other output as base for a new one</a></li>
<li class="toctree-l3"><a class="reference internal" href="../outputs.html#grouping-outputs">Grouping outputs</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../substitution.html">Doing YAML substitution or preprocessing</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../usage.html">Usage</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../usage_with_ci_cd.html">Usage for CI/CD</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Notes and extra information:</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../notes_gerber.html">Notes about Gerber format</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../notes_position.html">Notes about the position file</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../notes_3d.html">Notes about 3D models</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../propose.html">Proposed advanced KiCad usage</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../KiPlotYAML.html">KiPlot YAML</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Final notes:</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../contributing.html">Contributing</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../credits.html">Credits</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Indices and tables:</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../genindex.html">Index</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../../index.html">KiBot</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item"><a href="../../configuration.html">Configuration</a></li>
<li class="breadcrumb-item"><a href="../outputs.html">The <em>outputs</em> section</a></li>
<li class="breadcrumb-item active">3D render of the PCB</li>
<li class="wy-breadcrumbs-aside">
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="d-render-of-the-pcb">
<span id="index-0"></span><h1>3D render of the PCB<a class="headerlink" href="#d-render-of-the-pcb" title="Permalink to this heading"></a></h1>
<p>Exports the image generated by KiCads 3D viewer.</p>
<p>Type: <code class="docutils literal notranslate"><span class="pre">render_3d</span></code></p>
<p>Category: <strong>PCB/3D</strong></p>
<p>Parameters:</p>
<ul class="simple">
<li><p><strong>comment</strong> <span class="target" id="index-1"></span>: [string=] A comment for documentation purposes. It helps to identify the output.</p></li>
<li><p><strong>dir</strong> <span class="target" id="index-2"></span>: [string=./] Output directory for the generated files.
If it starts with <cite>+</cite> the rest is concatenated to the default dir.</p></li>
<li><p><strong>name</strong> <span class="target" id="index-3"></span>: [string=] Used to identify this particular output definition.
Avoid using <cite>_</cite> as first character. These names are reserved for KiBot.</p></li>
<li><p><strong>options</strong> <span class="target" id="index-4"></span>: [dict] Options for the <cite>render_3d</cite> output.</p>
<ul>
<li><p>Valid keys:</p>
<ul>
<li><p><strong>download</strong> <span class="target" id="index-5"></span>: [boolean=true] Downloads missing 3D models from KiCad git.
Only applies to models in KISYS3DMOD and KICAD6_3DMODEL_DIR.
They are downloaded to a temporal directory and discarded.
If you want to cache the downloaded files specify a directory using the
KIBOT_3D_MODELS environment variable.</p></li>
<li><p><strong>move_x</strong> <span class="target" id="index-6"></span>: [number=0] Steps to move in the X axis, positive is to the right.
Just like pressing the right arrow in the 3D viewer.</p></li>
<li><p><strong>move_y</strong> <span class="target" id="index-7"></span>: [number=0] Steps to move in the Y axis, positive is up.
Just like pressing the up arrow in the 3D viewer.</p></li>
<li><p><strong>no_virtual</strong> <span class="target" id="index-8"></span>: [boolean=false] Used to exclude 3D models for components with virtual attribute.</p></li>
<li><p><strong>output</strong> <span class="target" id="index-9"></span>: [string=%f-%i%I%v.%x] Name for the generated image file (%i=3D_$VIEW %x=png). Affected by global options.</p></li>
<li><p><strong>ray_tracing</strong> <span class="target" id="index-10"></span>: [boolean=false] Enable the ray tracing. Much better result, but slow, and youll need to adjust <cite>wait_rt</cite>.</p></li>
<li><p><strong>rotate_x</strong> <span class="target" id="index-11"></span>: [number=0] Steps to rotate around the X axis, positive is clockwise.
Each step is currently 10 degrees. Only for KiCad 6 or newer.</p></li>
<li><p><strong>rotate_y</strong> <span class="target" id="index-12"></span>: [number=0] Steps to rotate around the Y axis, positive is clockwise.
Each step is currently 10 degrees. Only for KiCad 6 or newer.</p></li>
<li><p><strong>rotate_z</strong> <span class="target" id="index-13"></span>: [number=0] Steps to rotate around the Z axis, positive is clockwise.
Each step is currently 10 degrees. Only for KiCad 6 or newer.</p></li>
<li><p><strong>show_components</strong> <span class="target" id="index-14"></span>: [list(string)|string=all] [none,all] List of components to draw, can be also a string for <cite>none</cite> or <cite>all</cite>.
Unlike the <cite>pcbdraw</cite> output, the default is <cite>all</cite>.</p></li>
<li><p><strong>view</strong> <span class="target" id="index-15"></span>: [string=top] [top,bottom,front,rear,right,left,z,Z,y,Y,x,X] Point of view.</p></li>
<li><p><strong>zoom</strong> <span class="target" id="index-16"></span>: [number=0] Zoom steps. Use positive to enlarge, get closer, and negative to reduce.
Same result as using the mouse wheel in the 3D viewer.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">auto_crop</span></code> <span class="target" id="index-17"></span>: [boolean=false] When enabled the image will be post-processed to remove the empty space around the image.
In this mode the <cite>background2</cite> is changed to be the same as <cite>background1</cite>.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">background1</span></code> <span class="target" id="index-18"></span>: [string=#66667F] First color for the background gradient.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">background2</span></code> <span class="target" id="index-19"></span>: [string=#CCCCE5] Second color for the background gradient.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">board</span></code> <span class="target" id="index-20"></span>: [string=#332B16] Color for the board without copper or solder mask.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">clip_silk_on_via_annulus</span></code> <span class="target" id="index-21"></span>: [boolean=true] Clip silkscreen at via annuli (KiCad 6+).</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">copper</span></code> <span class="target" id="index-22"></span>: [string=#8b898c] Color for the copper.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">dnf_filter</span></code> <span class="target" id="index-23"></span>: [string|list(string)=_none] Name of the filter to mark components as not fitted.
A short-cut to use for simple cases where a variant is an overkill.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">height</span></code> <span class="target" id="index-24"></span>: [number=720] Image height (aprox.).</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">highlight</span></code> <span class="target" id="index-25"></span>: [list(string)=[]] List of components to highlight.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">highlight_on_top</span></code> <span class="target" id="index-26"></span>: [boolean=false] Highlight over the component (not under).</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">highlight_padding</span></code> <span class="target" id="index-27"></span>: [number=1.5] [0,1000] How much the highlight extends around the component [mm].</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">kicad_3d_url</span></code> <span class="target" id="index-28"></span>: [string=<a class="reference external" href="https://gitlab.com/kicad/libraries/kicad-packages3D/-/raw/master/">https://gitlab.com/kicad/libraries/kicad-packages3D/-/raw/master/</a>] Base URL for the KiCad 3D models.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">kicad_3d_url_suffix</span></code> <span class="target" id="index-29"></span>: [string=] Text added to the end of the download URL.
Can be used to pass variables to the GET request, i.e. ?VAR1=VAL1&amp;VAR2=VAL2.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">no_smd</span></code> <span class="target" id="index-30"></span>: [boolean=false] Used to exclude 3D models for surface mount components.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">no_tht</span></code> <span class="target" id="index-31"></span>: [boolean=false] Used to exclude 3D models for through hole components.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">orthographic</span></code> <span class="target" id="index-32"></span>: [boolean=false] Enable the orthographic projection mode (top view looks flat).</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">pre_transform</span></code> <span class="target" id="index-33"></span>: [string|list(string)=_none] Name of the filter to transform fields before applying other filters.
A short-cut to use for simple cases where a variant is an overkill.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">realistic</span></code> <span class="target" id="index-34"></span>: [boolean=true] When disabled we use the colors of the layers used by the GUI. KiCad 6 or newer.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">show_adhesive</span></code> <span class="target" id="index-35"></span>: [boolean=false] Show the content of F.Adhesive/B.Adhesive layers. KiCad 6 or newer.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">show_board_body</span></code> <span class="target" id="index-36"></span>: [boolean=true] Show the PCB core material. KiCad 6 or newer.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">show_comments</span></code> <span class="target" id="index-37"></span>: [boolean=false] Show the content of the User.Comments layer. KiCad 6 or newer and ray tracing disabled.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">show_eco</span></code> <span class="target" id="index-38"></span>: [boolean=false] Show the content of the Eco1.User/Eco2.User layers. KiCad 6 or newer and ray tracing disabled.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">show_silkscreen</span></code> <span class="target" id="index-39"></span>: [boolean=true] Show the silkscreen layers (KiCad 6+).</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">show_soldermask</span></code> <span class="target" id="index-40"></span>: [boolean=true] Show the solder mask layers (KiCad 6+).</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">show_solderpaste</span></code> <span class="target" id="index-41"></span>: [boolean=true] Show the solder paste layers (KiCad 6+).</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">show_zones</span></code> <span class="target" id="index-42"></span>: [boolean=true] Show filled areas in zones (KiCad 6+).</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">silk</span></code> <span class="target" id="index-43"></span>: [string=#d5dce4] Color for the silk screen.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">solder_mask</span></code> <span class="target" id="index-44"></span>: [string=#208b47] Color for the solder mask.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">solder_paste</span></code> <span class="target" id="index-45"></span>: [string=#808080] Color for the solder paste.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">subtract_mask_from_silk</span></code> <span class="target" id="index-46"></span>: [boolean=true] Clip silkscreen at solder mask edges (KiCad 6+).</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">transparent_background</span></code> <span class="target" id="index-47"></span>: [boolean=false] When enabled the image will be post-processed to make the background transparent.
In this mode the <cite>background1</cite> and <cite>background2</cite> colors are ignored.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">transparent_background_color</span></code> <span class="target" id="index-48"></span>: [string=#00ff00] Color used for the chroma key. Adjust it if some regions of the board becomes transparent.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">transparent_background_fuzz</span></code> <span class="target" id="index-49"></span>: [number=15] [0,100] Chroma key tolerance (percent). Bigger values will remove more pixels.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">variant</span></code> <span class="target" id="index-50"></span>: [string=] Board variant to apply.</p></li>
<li><p><em>wait_ray_tracing</em> <span class="target" id="index-51"></span>: Alias for wait_render.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">wait_render</span></code> <span class="target" id="index-52"></span>: [number=-600] How many seconds we must wait before capturing the render (ray tracing or normal).
Lamentably KiCad can save an unfinished image. Enlarge it if your image looks partially rendered.
Use negative values to enable the auto-detect using CPU load.
In this case the value is interpreted as a time-out..</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">width</span></code> <span class="target" id="index-53"></span>: [number=1280] Image width (aprox.).</p></li>
</ul>
</li>
</ul>
</li>
<li><p><strong>type</strong> <span class="target" id="index-54"></span>: [string=] Type of output.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">category</span></code> <span class="target" id="index-55"></span>: [string|list(string)=] The category for this output. If not specified an internally defined category is used.
Categories looks like file system paths, i.e. <strong>PCB/fabrication/gerber</strong>.
The categories are currently used for <cite>navigate_results</cite>.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">disable_run_by_default</span></code> <span class="target" id="index-56"></span>: [string|boolean] Use it to disable the <cite>run_by_default</cite> status of other output.
Useful when this output extends another and you dont want to generate the original.
Use the boolean true value to disable the output you are extending.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">extends</span></code> <span class="target" id="index-57"></span>: [string=] Copy the <cite>options</cite> section from the indicated output.
Used to inherit options from another output of the same type.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">groups</span></code> <span class="target" id="index-58"></span>: [string|list(string)=] One or more groups to add this output. In order to catch typos
we recommend to add outputs only to existing groups. You can create an empty group if
needed.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">output_id</span></code> <span class="target" id="index-59"></span>: [string=] Text to use for the %I expansion content. To differentiate variations of this output.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">priority</span></code> <span class="target" id="index-60"></span>: [number=50] [0,100] Priority for this output. High priority outputs are created first.
Internally we use 10 for low priority, 90 for high priority and 50 for most outputs.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">run_by_default</span></code> <span class="target" id="index-61"></span>: [boolean=true] When enabled this output will be created when no specific outputs are requested.</p></li>
</ul>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="qr_lib.html" class="btn btn-neutral float-left" title="QR_Lib" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="report.html" class="btn btn-neutral float-right" title="Design report" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; Copyright 2018-2023, Salvador E. Tropea/INTI/John Beard.</p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>