Add Chromium-only Blender WebEngine parity work

blender-5.2.0/source/blender/imbuf/IMB_metadata.hh

@@ -0,0 +1,66 @@
+/* SPDX-FileCopyrightText: 2024 Blender Authors
+ *
+ * SPDX-License-Identifier: GPL-2.0-or-later */
+
+/** \file
+ * \ingroup imbuf
+ */
+
+#pragma once
+
+#include <cstddef>
+
+namespace blender {
+
+struct IDProperty;
+struct ImBuf;
+
+/**
+ * The metadata is a list of key/value pairs (both char *) that can me
+ * saved in the header of several image formats.
+ * Apart from some common keys like
+ * 'Software' and 'Description' (PNG standard) we'll use keys within the
+ * Blender namespace, so should be called 'Blender::StampInfo' or 'Blender::FrameNum'
+ * etc...
+ *
+ * The keys & values are stored in ID properties, in the group "metadata".
+ */
+
+/**
+ * Ensure that the metadata property is a valid #IDProperty object.
+ * This is a no-op when *metadata != NULL.
+ */
+void IMB_metadata_ensure(IDProperty **metadata);
+void IMB_metadata_free(IDProperty *metadata);
+
+/**
+ * Read the field from the image info into the field.
+ * \param metadata: the #IDProperty that contains the metadata
+ * \param key: the key of the field
+ * \param value: the data in the field, first one found with key is returned,
+ * memory has to be allocated by user.
+ * \param value_maxncpy: length of value buffer allocated by user.
+ * \return 1 (true) if metadata is present and value for the key found, 0 (false) otherwise.
+ */
+bool IMB_metadata_get_field(const IDProperty *metadata,
+                            const char *key,
+                            char *value,
+                            size_t value_maxncpy);
+
+/**
+ * Set user data in the metadata.
+ * If the field already exists its value is overwritten, otherwise the field
+ * will be added with the given value.
+ * \param metadata: the #IDProperty that contains the metadata
+ * \param key: the key of the field
+ * \param value: the data to be written to the field. zero terminated string
+ */
+void IMB_metadata_set_field(IDProperty *metadata, const char *key, const char *value);
+
+void IMB_metadata_copy(ImBuf *ibuf_dst, const ImBuf *ibuf_src);
+
+/** Invoke callback for every value stored in the metadata. */
+using IMBMetadataForeachCb = void (*)(const char *field, const char *value, void *userdata);
+void IMB_metadata_foreach(const ImBuf *ibuf, IMBMetadataForeachCb callback, void *userdata);
+
+}  // namespace blender