color: global LUT library, LUT error reporting, clamp + display fixes

- Add a global LUT library: user-configurable directories (new Preferences > LUT tab) scanned recursively for .cube/.3dl files; LUT node file pickers offer the library dirs as sidebar shortcuts via a 'lut_library' input property handled by the param view bridge - OCIOLutNode no longer fails silently: missing files, unsupported extensions and OCIO load errors are recorded in last_error() and surfaced in the status bar (input still passes through for rendering safety) - ColorDialog: re-enable the display -> reference conversion using ColorProcessor::kInverse with a validity guard, and re-enable the Display tab in ColorValuesWidget; covered by a round-trip regression test proving the old OCIO inverse crash no longer occurs - OCIOGradingTransformLinearNode: enforce the OCIO clampWhite > clampBlack invariant per frame in Value() so keyframed/connected values cannot produce invalid grading transforms, and constrain the white clamp UI minimum whenever the black clamp is static - Regression tests for LUT extension checks, direction switching, node error reporting, LUT library scanning, display inverse round-trip and clamp enforcement
2026-07-16 22:53:33 +08:00
parent ddca6a5e01
commit 547c2480e0
18 changed files with 829 additions and 33 deletions
@@ -0,0 +1,68 @@
+/***
+
+  Oak - Non-Linear Video Editor
+  Copyright (C) 2026 Oak Team
+
+  This program is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+***/
+
+#ifndef LUTLIBRARY_H
+#define LUTLIBRARY_H
+
+#include <QString>
+#include <QStringList>
+
+namespace olive
+{
+
+/**
+ * @brief A global, user-configurable library of LUT files
+ *
+ * The library is a list of directories (stored in the application config
+ * under "LUTLibraryPaths") that are scanned for supported LUT files. LUT
+ * nodes can offer the library contents as quick picks instead of forcing
+ * the user to browse for a file path on every node.
+ */
+class LUTLibrary {
+public:
+	/**
+	 * @brief Returns true if the given file suffix is a supported LUT
+	 * extension (.cube or .3dl, case-insensitive, leading dot tolerated)
+	 */
+	static bool IsSupportedExtension(const QString &suffix);
+
+	/**
+	 * @brief The directories that make up the LUT library
+	 */
+	static QStringList GetDirectories();
+
+	/**
+	 * @brief Replaces the LUT library directories and saves them to the
+	 * application config
+	 */
+	static void SetDirectories(const QStringList &dirs);
+
+	/**
+	 * @brief All supported LUT files found under the library directories
+	 *
+	 * Directories are scanned recursively. Files in earlier directories
+	 * are listed first.
+	 */
+	static QStringList GetLutFiles();
+};
+
+}
+
+#endif // LUTLIBRARY_H