mirror of
https://github.com/vondas-network/videobeaux.git
synced 2026-01-27 01:01:13 +01:00
193 lines
9.1 KiB
HTML
193 lines
9.1 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="en-US">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||
|
||
<!-- Begin Jekyll SEO tag v2.8.0 -->
|
||
<title>lut_apply</title>
|
||
<meta name="generator" content="Jekyll v3.10.0" />
|
||
<meta property="og:title" content="lut_apply" />
|
||
<meta property="og:locale" content="en_US" />
|
||
<meta name="description" content="The friendly multilateral video toolkit built for artists by artists." />
|
||
<meta property="og:description" content="The friendly multilateral video toolkit built for artists by artists." />
|
||
<link rel="canonical" href="http://localhost:4000/videobeaux/programs/utilities/lut_apply.html" />
|
||
<meta property="og:url" content="http://localhost:4000/videobeaux/programs/utilities/lut_apply.html" />
|
||
<meta property="og:type" content="website" />
|
||
<meta name="twitter:card" content="summary" />
|
||
<meta property="twitter:title" content="lut_apply" />
|
||
<script type="application/ld+json">
|
||
{"@context":"https://schema.org","@type":"WebPage","description":"The friendly multilateral video toolkit built for artists by artists.","headline":"lut_apply","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"http://localhost:4000/videobeaux/assets/img/videobeaux.png"}},"url":"http://localhost:4000/videobeaux/programs/utilities/lut_apply.html"}</script>
|
||
<!-- End Jekyll SEO tag -->
|
||
|
||
<link rel="stylesheet" href="/videobeaux/assets/css/style.css?v=5e23701ed3967d38bab12937d79f95fae74b2a53">
|
||
<!--[if lt IE 9]>
|
||
<script src="https://cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv.min.js"></script>
|
||
<![endif]-->
|
||
<!-- start custom head snippets, customize with your own _includes/head-custom.html file -->
|
||
|
||
<!-- Setup Google Analytics -->
|
||
|
||
|
||
|
||
<!-- You can set your favicon here -->
|
||
<!-- link rel="shortcut icon" type="image/x-icon" href="/videobeaux/favicon.ico" -->
|
||
|
||
<!-- end custom head snippets -->
|
||
|
||
</head>
|
||
<body>
|
||
<div class="wrapper">
|
||
<header>
|
||
<h1><a href="http://localhost:4000/videobeaux/">videobeaux</a></h1>
|
||
|
||
|
||
<img src="/videobeaux/assets/img/videobeaux.png" alt="Logo" />
|
||
|
||
|
||
<p>The friendly multilateral video toolkit built for artists by artists.</p>
|
||
|
||
|
||
<p class="view"><a href="https://github.com/schwwaaa/videobeaux">View the Project on GitHub <small>schwwaaa/videobeaux</small></a></p>
|
||
|
||
|
||
|
||
|
||
|
||
</header>
|
||
<section>
|
||
|
||
<h1 id="lut_apply">lut_apply</h1>
|
||
|
||
<h2 id="description">Description</h2>
|
||
<p>Applies a 1D or 3D LUT to recolor a video, enabling film-style grading, color transforms, technical conversions, or creative look development.</p>
|
||
|
||
<h2 id="purpose">Purpose</h2>
|
||
<p><code class="language-plaintext highlighter-rouge">lut_apply</code> integrates LUT-based color grading into Videobeaux pipelines.<br />
|
||
It is useful for:</p>
|
||
<ul>
|
||
<li>applying film emulation looks,</li>
|
||
<li>technical color transforms (LOG → REC.709),</li>
|
||
<li>stylized grades for creative pieces,</li>
|
||
<li>batch processing LUT workflows,</li>
|
||
<li>previewing looks before finishing in a grading suite.</li>
|
||
</ul>
|
||
|
||
<h2 id="how-it-works">How It Works</h2>
|
||
<ol>
|
||
<li><strong>LUT Loading</strong><br />
|
||
Loads a <code class="language-plaintext highlighter-rouge">.cube</code>, <code class="language-plaintext highlighter-rouge">.3dl</code>, or other LUT file defined by the <code class="language-plaintext highlighter-rouge">lut</code> parameter.</li>
|
||
<li><strong>Interpolation</strong><br />
|
||
Chooses how input colors interpolate through the 3D LUT grid (<code class="language-plaintext highlighter-rouge">interp</code>).</li>
|
||
<li><strong>Intensity Blending</strong><br />
|
||
<code class="language-plaintext highlighter-rouge">intensity</code> controls the LUT’s strength—useful for subtle looks or partial grading mixes.</li>
|
||
<li><strong>Image Corrections</strong><br />
|
||
Optional adjustments for:
|
||
<ul>
|
||
<li><code class="language-plaintext highlighter-rouge">brightness</code></li>
|
||
<li><code class="language-plaintext highlighter-rouge">contrast</code></li>
|
||
<li><code class="language-plaintext highlighter-rouge">saturation</code></li>
|
||
<li><code class="language-plaintext highlighter-rouge">gamma</code><br />
|
||
These adjustments apply before or after LUT evaluation depending on implementation.</li>
|
||
</ul>
|
||
</li>
|
||
<li><strong>Output Encoding</strong><br />
|
||
Output is encoded with provided pixel format, CRF, preset, and optional audio copy.</li>
|
||
</ol>
|
||
|
||
<h2 id="program-template">Program Template</h2>
|
||
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>videobeaux -P lut_apply \
|
||
-i input.mp4 \
|
||
-o output.mp4 \
|
||
--outfile VALUE \
|
||
--vcodec VALUE \
|
||
--lut VALUE \
|
||
--interp VALUE \
|
||
--intensity VALUE \
|
||
--brightness VALUE \
|
||
--contrast VALUE \
|
||
--saturation VALUE \
|
||
--gamma VALUE \
|
||
--pix_fmt VALUE \
|
||
--x264_preset VALUE \
|
||
--crf VALUE \
|
||
--copy_audio VALUE
|
||
</code></pre></div></div>
|
||
|
||
<h2 id="arguments">Arguments</h2>
|
||
|
||
<ul>
|
||
<li><strong>outfile</strong> — Output file name for the rendered, LUT-applied video.</li>
|
||
<li><strong>vcodec</strong> — Video codec to use (e.g., <code class="language-plaintext highlighter-rouge">libx264</code>, <code class="language-plaintext highlighter-rouge">libx265</code>, <code class="language-plaintext highlighter-rouge">prores_ks</code>).</li>
|
||
<li><strong>lut</strong> — Path to the LUT file (.cube, .3dl, etc.).</li>
|
||
<li><strong>interp</strong> — LUT interpolation mode (<code class="language-plaintext highlighter-rouge">nearest</code>, <code class="language-plaintext highlighter-rouge">trilinear</code>, or other supported methods).</li>
|
||
<li><strong>intensity</strong> — Blending amount between original image and LUT-graded image (0.0–1.0).</li>
|
||
<li><strong>brightness</strong> — Brightness correction applied pre/post LUT.</li>
|
||
<li><strong>contrast</strong> — Contrast adjustment applied in grading pipeline.</li>
|
||
<li><strong>saturation</strong> — Saturation control for color richness.</li>
|
||
<li><strong>gamma</strong> — Gamma correction applied for tonal shaping.</li>
|
||
<li><strong>pix_fmt</strong> — Pixel format (e.g., <code class="language-plaintext highlighter-rouge">yuv420p</code>, <code class="language-plaintext highlighter-rouge">yuv422p10le</code>, <code class="language-plaintext highlighter-rouge">rgb24</code>).</li>
|
||
<li><strong>x264_preset</strong> — Encoding speed vs compression preset for libx264.</li>
|
||
<li><strong>crf</strong> — Constant Rate Factor controlling output quality.</li>
|
||
<li><strong>copy_audio</strong> — Copies audio from source without re-encoding when enabled.</li>
|
||
</ul>
|
||
|
||
<h2 id="real-world-example">Real World Example</h2>
|
||
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>videobeaux -P lut_apply \
|
||
-i myvideo.mp4 \
|
||
-o lut_apply_styled.mp4 \
|
||
--outfile EXAMPLE \
|
||
--vcodec EXAMPLE \
|
||
--lut EXAMPLE \
|
||
--interp EXAMPLE \
|
||
--intensity EXAMPLE \
|
||
--brightness EXAMPLE \
|
||
--contrast EXAMPLE \
|
||
--saturation EXAMPLE \
|
||
--gamma EXAMPLE \
|
||
--pix_fmt EXAMPLE \
|
||
--x264_preset EXAMPLE \
|
||
--crf EXAMPLE \
|
||
--copy_audio EXAMPLE
|
||
</code></pre></div></div>
|
||
|
||
<h2 id="technical-notes">Technical Notes</h2>
|
||
<ul>
|
||
<li>LUTs created for LOG footage require matching input color space before use.</li>
|
||
<li>Interpolation type affects smoothness—<code class="language-plaintext highlighter-rouge">trilinear</code> is typically best for high-quality grading.</li>
|
||
<li>Gamma adjustments can shift midtone density; use subtly for filmic shaping.</li>
|
||
<li>Blending via <code class="language-plaintext highlighter-rouge">intensity</code> is ideal for creative fades or adjustable look-dev.</li>
|
||
<li>Some LUTs clip out-of-gamut colors; test with challenging footage.</li>
|
||
</ul>
|
||
|
||
<h2 id="recommended-usage">Recommended Usage</h2>
|
||
<ul>
|
||
<li>Film emulation workflows and creative looks.</li>
|
||
<li>Technical transforms (camera LOG → REC.709).</li>
|
||
<li>Batch applying LUTs for directories of dailies or reference renders.</li>
|
||
<li>Experimenting with looks before importing into grading applications.</li>
|
||
</ul>
|
||
|
||
<h2 id="quality-tips">Quality Tips</h2>
|
||
<ul>
|
||
<li>For cinematic grading, keep <code class="language-plaintext highlighter-rouge">intensity</code> around <strong>0.6–0.85</strong> for balanced results.</li>
|
||
<li>Always preview LUTs with a variety of footage—some LUTs are extremely contrast-heavy.</li>
|
||
<li>When color banding appears, switch to a 10-bit pixel format like <code class="language-plaintext highlighter-rouge">yuv422p10le</code>.</li>
|
||
<li>Use lower CRF values (14–18) for grading-quality output.</li>
|
||
<li>Avoid stacking extreme brightness, saturation, and LUT intensity simultaneously to reduce clipping.</li>
|
||
</ul>
|
||
|
||
|
||
</section>
|
||
<footer>
|
||
|
||
<p>This project is maintained by <a href="https://github.com/schwwaaa">schwwaaa</a></p>
|
||
|
||
<p><small>Hosted on GitHub Pages — Theme by <a href="https://github.com/orderedlist">orderedlist</a></small></p>
|
||
</footer>
|
||
</div>
|
||
<script src="/videobeaux/assets/js/scale.fix.js"></script>
|
||
</body>
|
||
</html>
|