fillholes doc example

Signed-off-by: Daniel Greenstein <[email protected]>

Author: grdanny

src/doc/imagebufalgo.rst

@@ -2569,21 +2569,26 @@ Image Enhancement / Restoration
 
   Examples:
 
-    .. tabs::
-  
-       .. code-tab:: c++
+   .. tabs::
 
-          ImageBuf Src ("holes.exr");
-          ImageBuf Filled = ImageBufAlgo::fillholes_pushpull (Src);
+      .. tab:: C++
+         .. literalinclude:: ../../testsuite/docs-examples-cpp/src/docs-examples-imagebufalgo.cpp
+              :language: c++
+              :start-after: BEGIN-imagebufalgo-fillholes_pushpull
+              :end-before: END-imagebufalgo-fillholes_pushpull
+              :dedent: 4
 
-       .. code-tab:: py
+      .. tab:: Python
+         .. literalinclude:: ../../testsuite/docs-examples-python/src/docs-examples-imagebufalgo.py
+              :language: py
+              :start-after: BEGIN-imagebufalgo-fillholes_pushpull
+              :end-before: END-imagebufalgo-fillholes_pushpull
+              :dedent: 4
 
-          Src = ImageBuf("holes.exr")
-          Filled = ImageBufAlgo.fillholes_pushpull (Src)
+      .. tab:: oiiotool
+         .. sourcecode:: bash
 
-       .. code-tab:: bash oiiotool
-                 
-          oiiotool holes.exr --fillholes -o filled.exr
+            oiiotool holes.exr --fillholes -o filled.exr
 
 |
 

testsuite/common/checker_with_alpha.exr

@@ -29,6 +29,7 @@ example_fit
 example_warp
 example_fixNonFinite
 Repaired 48 non-finite pixels
+example_fillholes_pushpull
 example_make_texture
 zero1.exr            :  512 x  512, 3 channel, half openexr
     SHA-1: 95823C334FCE55968E8D2827CCD1CF77CEE19ABD
@@ -110,6 +111,8 @@ texture.exr          :  256 x  256, 3 channel, half openexr (+mipmap)
     SHA-1: 4074B050432CE7C664CEC4546A46E74F9A310CDC
 with_nans_fixed.tif  :  256 x  256, 3 channel, float tiff
     SHA-1: FE830FB041FAE5F1AA16B23FB69B91DED4BF5B73
+checker_with_alpha_filled.exr :  256 x  256, 4 channel, half openexr
+    SHA-1: B245E027638D5C1BA2608FEDDB3BB9B5E9FA3A44
 Comparing "simple.tif" and "ref/simple.tif"
 PASS
 Comparing "scanlines.tif" and "ref/scanlines.tif"

testsuite/docs-examples-cpp/ref/out.txt

@@ -14,6 +14,7 @@
 command += run_app("cmake -E copy " + test_source_dir + "/../common/grid-small.exr grid.exr")
 command += run_app("cmake -E copy " + test_source_dir + "/../common/tahoe-small.tif tahoe.tif")
 command += run_app("cmake -E copy " + test_source_dir + "/../common/with_nans.tif with_nans.tif")
+command += run_app("cmake -E copy " + test_source_dir + "/../common/checker_with_alpha.exr checker_with_alpha.exr")
 
 # Build
 command += run_app("cmake -S " + test_source_dir + " -B build -DCMAKE_BUILD_TYPE=Release >> build.txt 2>&1", silent=True)
@@ -70,7 +71,9 @@
     "reorient.exr",
     "cshift.exr",
     "texture.exr",
-    "with_nans_fixed.tif"
+    "with_nans_fixed.tif",
+    "checker_with_alpha_filled.exr"
+
 ]
 for file in hashes :
     command += info_command(file, verbose=False)

testsuite/docs-examples-cpp/run.py

@@ -517,6 +517,21 @@ void example_fixNonFinite()
     Src.write("with_nans_fixed.tif");
 
 }
+
+void example_fillholes_pushpull()
+{
+    print("example_fillholes_pushpull\n");
+    // BEGIN-imagebufalgo-fillholes_pushpull
+
+    ImageBuf Src ("checker_with_alpha.exr");
+    ImageBuf Filled = ImageBufAlgo::fillholes_pushpull (Src);
+
+    // END-imagebufalgo-fillholes_pushpull
+    Filled.write("checker_with_alpha_filled.exr");
+
+}
+
+
 // Section: Morphological filters
 
 
@@ -592,6 +607,7 @@ int main(int /*argc*/, char** /*argv*/)
     // Section: Image enhancement / restoration
 
     example_fixNonFinite();
+    example_fillholes_pushpull();
 
     // Section: Morphological filters
 

testsuite/docs-examples-cpp/src/docs-examples-imagebufalgo.cpp

@@ -29,6 +29,7 @@ example_resample
 example_fit
 example_warp
 example_fixNonFinite
+example_fillholes_pushpull
 example_make_texture
 zero1.exr            :  512 x  512, 3 channel, half openexr
     SHA-1: 95823C334FCE55968E8D2827CCD1CF77CEE19ABD
@@ -110,6 +111,8 @@ texture.exr          :  256 x  256, 3 channel, half openexr (+mipmap)
     SHA-1: 4074B050432CE7C664CEC4546A46E74F9A310CDC
 with_nans_fixed.tif  :  256 x  256, 3 channel, float tiff
     SHA-1: FE830FB041FAE5F1AA16B23FB69B91DED4BF5B73
+checker_with_alpha_filled.exr :  256 x  256, 4 channel, half openexr
+    SHA-1: B245E027638D5C1BA2608FEDDB3BB9B5E9FA3A44
 Comparing "simple.tif" and "../docs-examples-cpp/ref/simple.tif"
 PASS
 Comparing "scanlines.tif" and "../docs-examples-cpp/ref/scanlines.tif"

testsuite/docs-examples-python/ref/out.txt

@@ -14,6 +14,7 @@
 command += run_app("cmake -E copy " + test_source_dir + "/../common/grid-small.exr grid.exr")
 command += run_app("cmake -E copy " + test_source_dir + "/../common/tahoe-small.tif tahoe.tif")
 command += run_app("cmake -E copy " + test_source_dir + "/../common/with_nans.tif with_nans.tif")
+command += run_app("cmake -E copy " + test_source_dir + "/../common/checker_with_alpha.exr checker_with_alpha.exr")
 
 # Run the examples for each chapter
 for chapter in [ "imageioapi", "imageoutput", "imageinput", "writingplugins",
@@ -66,7 +67,8 @@
     "reorient.exr",
     "cshift.exr",
     "texture.exr",
-    "with_nans_fixed.tif"
+    "with_nans_fixed.tif",
+    "checker_with_alpha_filled.exr"
 ]
 
 for file in hashes :

testsuite/docs-examples-python/run.py

@@ -455,6 +455,14 @@ def example_fixNonFinite():
     # END-imagebufalgo-fixNonFinite
 
 
+def example_fillholes_pushpull():
+    print("example_fillholes_pushpull")
+    # BEGIN-imagebufalgo-fillholes_pushpull
+    Src = ImageBuf("checker_with_alpha.exr")
+    Filled = ImageBufAlgo.fillholes_pushpull(Src)
+    # END-imagebufalgo-fillholes_pushpull
+    Filled.write("checker_with_alpha_filled.exr")
+
 
 # Section: Morphological filters
 
@@ -527,6 +535,7 @@ def example_make_texture():
 
     # Section: Image enhancement / restoration
     example_fixNonFinite()
+    example_fillholes_pushpull()
 
     # Section: Morphological filters