Prepare python binding 2 take those options

Author: user4223

source/lib/api/include/DecoderFacade.h

@@ -7,6 +7,8 @@
 #include <lib/infrastructure/include/ParameterCollector.h>
 #include <lib/infrastructure/include/ContextFwd.h>
 
+#include <lib/dip/include/PreProcessorOptions.h>
+
 #include <lib/input/api/include/InputElement.h>
 #include <lib/input/api/include/LoadResult.h>
 

source/lib/api/source/DecoderFacade.cpp

@@ -43,7 +43,7 @@ namespace api
         std::optional<unsigned int> loadOptionDpi;
         std::optional<int> imageRotation;
         std::optional<unsigned int> imageScale;
-        std::optional<std::string> imageSplit;
+        std::optional<std::string> imageSplitting;
         std::optional<unsigned int> imageFlipping;
         std::optional<detector::api::DetectorType> detectorType;
         std::optional<bool> pureBarcode;
@@ -62,7 +62,7 @@ namespace api
 
         unsigned int getImageScale() const { return imageScale.value_or(dip::PreProcessorOptions::DEFAULT.scalePercent); }
 
-        std::string getImageSplit() const { return imageSplit.value_or(dip::PreProcessorOptions::DEFAULT.split); }
+        std::string getImageSplit() const { return imageSplitting.value_or(dip::PreProcessorOptions::DEFAULT.splittingMode); }
 
         unsigned int getImageFlipping() const { return imageFlipping.value_or(dip::PreProcessorOptions::DEFAULT.flippingMode); }
 
@@ -199,7 +199,7 @@ namespace api
 
     DecoderFacadeBuilder &DecoderFacadeBuilder::withImageSplit(std::string split)
     {
-        options->imageSplit = std::make_optional(split);
+        options->imageSplitting = std::make_optional(split);
         return *this;
     }
 

source/lib/dip/include/PreProcessor.h

@@ -3,6 +3,8 @@
 
 #pragma once
 
+#include "PreProcessorOptions.h"
+
 #include "lib/input/api/include/InputElement.h"
 
 #include "lib/infrastructure/include/ParameterSupplier.h"
@@ -15,16 +17,6 @@
 
 namespace dip
 {
-  struct PreProcessorOptions
-  {
-    int rotationDegree = 0;
-    unsigned int scalePercent = 100u;
-    std::string split = "11";
-    unsigned int flippingMode = 0; // 0 nothing, 1 flip around X, 2 flip around Y, 3 flip around X and Y
-
-    static PreProcessorOptions const DEFAULT;
-  };
-
   std::pair<unsigned int, unsigned int> splitStringToPair(std::string input);
 
   std::map<unsigned int, unsigned int> splitPairToMap(std::pair<unsigned int, unsigned int> input);

source/lib/dip/include/PreProcessorOptions.h

@@ -0,0 +1,35 @@
+// SPDX-FileCopyrightText: (C) 2026 user4223 and (other) contributors to ticket-decoder <https://github.com/user4223/ticket-decoder>
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+#pragma once
+
+#include <string>
+
+namespace dip
+{
+  class OptionsBuilder;
+
+  struct PreProcessorOptions
+  {
+    int rotationDegree = 0;
+    unsigned int scalePercent = 100u;
+    std::string splittingMode = "11"; // 11 first of one part, 2x x of two parts, 4x x of four parts
+    unsigned int flippingMode = 0;    // 0 nothing, 1 flip around X, 2 flip around Y, 3 flip around X and Y
+
+    static PreProcessorOptions const DEFAULT;
+
+    OptionsBuilder create();
+  };
+
+  class OptionsBuilder
+  {
+    PreProcessorOptions options;
+
+    OptionsBuilder(PreProcessorOptions o);
+
+  public:
+    friend PreProcessorOptions;
+
+    PreProcessorOptions build();
+  };
+}

source/lib/dip/source/PreProcessor.cpp

@@ -11,8 +11,6 @@
 
 namespace dip
 {
-  PreProcessorOptions const PreProcessorOptions::DEFAULT = PreProcessorOptions{};
-
   std::pair<unsigned int, unsigned int> splitStringToPair(std::string input)
   {
     if (input.size() != 2)
@@ -69,7 +67,7 @@ namespace dip
       : logger(CREATE_LOGGER(context.getLoggerFactory())),
         options(std::move(o)),
         isEnabled(true),
-        partMap(splitPairToMap(splitStringToPair(options.split))),
+        partMap(splitPairToMap(splitStringToPair(options.splittingMode))),
         parts()
   {
     updatePartMap();
@@ -130,7 +128,7 @@ namespace dip
   std::string PreProcessor::reset()
   {
     auto const defaultOptions = PreProcessorOptions{};
-    partMap = splitPairToMap(splitStringToPair(defaultOptions.split));
+    partMap = splitPairToMap(splitStringToPair(defaultOptions.splittingMode));
     options.rotationDegree = defaultOptions.rotationDegree;
     options.scalePercent = defaultOptions.scalePercent;
     options.flippingMode = defaultOptions.flippingMode;

source/lib/dip/source/PreProcessorOptions.cpp

@@ -0,0 +1,25 @@
+// SPDX-FileCopyrightText: (C) 2026 user4223 and (other) contributors to ticket-decoder <https://github.com/user4223/ticket-decoder>
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+#include "../include/PreProcessorOptions.h"
+
+namespace dip
+{
+
+  PreProcessorOptions const PreProcessorOptions::DEFAULT = PreProcessorOptions{};
+
+  OptionsBuilder::OptionsBuilder(PreProcessorOptions o)
+      : options(std::move(o))
+  {
+  }
+
+  PreProcessorOptions OptionsBuilder::build()
+  {
+    return std::move(options);
+  }
+
+  OptionsBuilder PreProcessorOptions::create()
+  {
+    return OptionsBuilder(DEFAULT);
+  }
+}

source/python/source/Binding.cpp

@@ -72,8 +72,14 @@ class DecoderFacadeWrapper
         return get().decodeRawBase64ToJson(base64, origin);
     }
 
-    std::vector<std::pair<std::string, std::string>> decodeFiles(std::string const &path)
+    std::vector<std::pair<std::string, std::string>> decodeFiles(
+        std::string const &path,
+        int const rotationDegree,
+        unsigned int const scalePercent,
+        std::string const &splittingMode,
+        unsigned int const flippingMode)
     {
+        auto options = dip::PreProcessorOptions{rotationDegree, scalePercent, splittingMode, flippingMode};
         return get().decodeImageFilesToJson(path);
     }
 };
@@ -115,5 +121,9 @@ NB_MODULE(ticket_decoder, m)
              "Decode base64-encoded raw barcode data into structured json")
         .def("decode_files", &DecoderFacadeWrapper::decodeFiles,
              "path"_a,
+             "rotationDegree"_a = dip::PreProcessorOptions::DEFAULT.rotationDegree,
+             "scalePercent"_a = dip::PreProcessorOptions::DEFAULT.scalePercent,
+             "splittingMode"_a = dip::PreProcessorOptions::DEFAULT.splittingMode,
+             "flippingMode"_a = dip::PreProcessorOptions::DEFAULT.flippingMode,
              "Decode Aztec-Code and containing raw data from image/PDF file or files into structured json");
 }