upgrade to Filament 1.21.0

ios/include/ibl/CubemapUtils.h

@@ -0,0 +1,124 @@
+/*
+ * Copyright (C) 2015 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef IBL_CUBEMAP_UTILS_H
+#define IBL_CUBEMAP_UTILS_H
+
+#include <ibl/Cubemap.h>
+#include <ibl/Image.h>
+
+#include <utils/compiler.h>
+
+#include <functional>
+
+namespace utils {
+class JobSystem;
+} // namespace utils
+
+namespace filament {
+namespace ibl {
+
+class CubemapIBL;
+
+/**
+ * Create and convert Cubemap formats
+ */
+class UTILS_PUBLIC CubemapUtils {
+public:
+    //! Creates a cubemap object and its backing Image
+    static Cubemap create(Image& image, size_t dim, bool horizontal = true);
+
+    struct EmptyState {
+    };
+
+    template<typename STATE>
+    using ScanlineProc = std::function<
+            void(STATE& state, size_t y, Cubemap::Face f, Cubemap::Texel* data, size_t width)>;
+
+    template<typename STATE>
+    using ReduceProc = std::function<void(STATE& state)>;
+
+    //! process the cubemap using multithreading
+    template<typename STATE>
+    static void process(Cubemap& cm,
+            utils::JobSystem& js,
+            ScanlineProc<STATE> proc,
+            ReduceProc<STATE> reduce = [](STATE&) {},
+            const STATE& prototype = STATE());
+
+    //! process the cubemap
+    template<typename STATE>
+    static void processSingleThreaded(Cubemap& cm,
+            utils::JobSystem& js,
+            ScanlineProc<STATE> proc,
+            ReduceProc<STATE> reduce = [](STATE&) {},
+            const STATE& prototype = STATE());
+
+    //! clamps image to acceptable range
+    static void clamp(Image& src);
+
+    static void highlight(Image& src);
+
+    //! Downsamples a cubemap by helf in x and y using a box filter
+    static void downsampleCubemapLevelBoxFilter(utils::JobSystem& js, Cubemap& dst, const Cubemap& src);
+
+    //! Return the name of a face (suitable for a file name)
+    static const char* getFaceName(Cubemap::Face face);
+
+    //! computes the solid angle of a pixel of a face of a cubemap
+    static float solidAngle(size_t dim, size_t u, size_t v);
+
+    //! Sets a Cubemap faces from a cross image
+    static void setAllFacesFromCross(Cubemap& cm, const Image& image);
+
+private:
+
+    //move these into cmgen?
+    static void setFaceFromCross(Cubemap& cm, Cubemap::Face face, const Image& image);
+    static Image createCubemapImage(size_t dim, bool horizontal = true);
+
+#ifndef FILAMENT_IBL_LITE
+
+public:
+
+    //! Converts horizontal or vertical cross Image to a Cubemap
+    static void crossToCubemap(utils::JobSystem& js, Cubemap& dst, const Image& src);
+
+    //! Converts equirectangular Image to a Cubemap
+    static void equirectangularToCubemap(utils::JobSystem& js, Cubemap& dst, const Image& src);
+
+    //! Converts a Cubemap to an equirectangular Image
+    static void cubemapToEquirectangular(utils::JobSystem& js, Image& dst, const Cubemap& src);
+
+    //! Converts a Cubemap to an octahedron
+    static void cubemapToOctahedron(utils::JobSystem& js, Image& dst, const Cubemap& src);
+
+    //! mirror the cubemap in the horizontal direction
+    static void mirrorCubemap(utils::JobSystem& js, Cubemap& dst, const Cubemap& src);
+
+    //! generates a UV grid in the cubemap -- useful for debugging.
+    static void generateUVGrid(utils::JobSystem& js, Cubemap& cml, size_t gridFrequencyX, size_t gridFrequencyY);
+
+#endif
+
+    friend class CubemapIBL;
+};
+
+
+} // namespace ibl
+} // namespace filament
+
+#endif /* IBL_CUBEMAP_UTILS_H */