summaryrefslogtreecommitdiff
path: root/backend/genesys/image_pipeline.h
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff-webhosting.net>2020-03-30 21:30:45 +0200
committerJörg Frings-Fürst <debian@jff-webhosting.net>2020-03-30 21:30:45 +0200
commitee770c2346eb37e0dcb8b6cf3eaacf3d8efd6bbc (patch)
tree58f05092be1a17a939e861f8cadcda1b6ca2ecef /backend/genesys/image_pipeline.h
parent0da9e21872802cfc6e975b1ebaf9efb9e5934d84 (diff)
parentfef76e17ed4c607ea73b81279f9ef1d7121be900 (diff)
Merge branch 'release/experimental/1.0.29-1_experimental1'experimental/1.0.29-1_experimental1
Diffstat (limited to 'backend/genesys/image_pipeline.h')
-rw-r--r--backend/genesys/image_pipeline.h572
1 files changed, 572 insertions, 0 deletions
diff --git a/backend/genesys/image_pipeline.h b/backend/genesys/image_pipeline.h
new file mode 100644
index 0000000..2986837
--- /dev/null
+++ b/backend/genesys/image_pipeline.h
@@ -0,0 +1,572 @@
+/* sane - Scanner Access Now Easy.
+
+ Copyright (C) 2019 Povilas Kanapickas <povilas@radix.lt>
+
+ This file is part of the SANE package.
+
+ 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 2 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, write to the Free Software
+ Foundation, Inc., 59 Temple Place - Suite 330, Boston,
+ MA 02111-1307, USA.
+
+ As a special exception, the authors of SANE give permission for
+ additional uses of the libraries contained in this release of SANE.
+
+ The exception is that, if you link a SANE library with other files
+ to produce an executable, this does not by itself cause the
+ resulting executable to be covered by the GNU General Public
+ License. Your use of that executable is in no way restricted on
+ account of linking the SANE library code into it.
+
+ This exception does not, however, invalidate any other reasons why
+ the executable file might be covered by the GNU General Public
+ License.
+
+ If you submit changes to SANE to the maintainers to be included in
+ a subsequent release, you agree by submitting the changes that
+ those changes may be distributed with this exception intact.
+
+ If you write modifications of your own for SANE, it is your choice
+ whether to permit this exception to apply to your modifications.
+ If you do not wish that, delete this exception notice.
+*/
+
+#ifndef BACKEND_GENESYS_IMAGE_PIPELINE_H
+#define BACKEND_GENESYS_IMAGE_PIPELINE_H
+
+#include "image.h"
+#include "image_pixel.h"
+#include "image_buffer.h"
+
+#include <algorithm>
+#include <functional>
+#include <memory>
+
+namespace genesys {
+
+class ImagePipelineNode
+{
+public:
+ virtual ~ImagePipelineNode();
+
+ virtual std::size_t get_width() const = 0;
+ virtual std::size_t get_height() const = 0;
+ virtual PixelFormat get_format() const = 0;
+
+ std::size_t get_row_bytes() const
+ {
+ return get_pixel_row_bytes(get_format(), get_width());
+ }
+
+ virtual bool eof() const = 0;
+
+ // returns true if the row was filled successfully, false otherwise (e.g. if not enough data
+ // was available.
+ virtual bool get_next_row_data(std::uint8_t* out_data) = 0;
+};
+
+class ImagePipelineNodeBytesSource : public ImagePipelineNode
+{
+public:
+ std::size_t remaining_bytes() const { return remaining_bytes_; }
+ void set_remaining_bytes(std::size_t bytes) { remaining_bytes_ = bytes; }
+
+ std::size_t consume_remaining_bytes(std::size_t bytes);
+
+private:
+ std::size_t remaining_bytes_ = 0;
+};
+
+// A pipeline node that produces data from a callable
+class ImagePipelineNodeCallableSource : public ImagePipelineNode
+{
+public:
+ using ProducerCallback = std::function<bool(std::size_t size, std::uint8_t* out_data)>;
+
+ ImagePipelineNodeCallableSource(std::size_t width, std::size_t height, PixelFormat format,
+ ProducerCallback producer) :
+ producer_{producer},
+ width_{width},
+ height_{height},
+ format_{format}
+ {}
+
+ std::size_t get_width() const override { return width_; }
+ std::size_t get_height() const override { return height_; }
+ PixelFormat get_format() const override { return format_; }
+
+ bool eof() const override { return eof_; }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+private:
+ ProducerCallback producer_;
+ std::size_t width_ = 0;
+ std::size_t height_ = 0;
+ PixelFormat format_ = PixelFormat::UNKNOWN;
+ bool eof_ = false;
+};
+
+// A pipeline node that produces data from a callable requesting fixed-size chunks.
+class ImagePipelineNodeBufferedCallableSource : public ImagePipelineNodeBytesSource
+{
+public:
+ using ProducerCallback = std::function<bool(std::size_t size, std::uint8_t* out_data)>;
+
+ ImagePipelineNodeBufferedCallableSource(std::size_t width, std::size_t height,
+ PixelFormat format, std::size_t input_batch_size,
+ ProducerCallback producer);
+
+ std::size_t get_width() const override { return width_; }
+ std::size_t get_height() const override { return height_; }
+ PixelFormat get_format() const override { return format_; }
+
+ bool eof() const override { return eof_; }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+ std::size_t buffer_size() const { return buffer_.size(); }
+ std::size_t buffer_available() const { return buffer_.available(); }
+
+private:
+ ProducerCallback producer_;
+ std::size_t width_ = 0;
+ std::size_t height_ = 0;
+ PixelFormat format_ = PixelFormat::UNKNOWN;
+
+ bool eof_ = false;
+ std::size_t curr_row_ = 0;
+
+ ImageBuffer buffer_;
+};
+
+class ImagePipelineNodeBufferedGenesysUsb : public ImagePipelineNodeBytesSource
+{
+public:
+ using ProducerCallback = std::function<void(std::size_t size, std::uint8_t* out_data)>;
+
+ ImagePipelineNodeBufferedGenesysUsb(std::size_t width, std::size_t height,
+ PixelFormat format, std::size_t total_size,
+ const FakeBufferModel& buffer_model,
+ ProducerCallback producer);
+
+ std::size_t get_width() const override { return width_; }
+ std::size_t get_height() const override { return height_; }
+ PixelFormat get_format() const override { return format_; }
+
+ bool eof() const override { return eof_; }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+ std::size_t buffer_available() const { return buffer_.available(); }
+
+private:
+ ProducerCallback producer_;
+ std::size_t width_ = 0;
+ std::size_t height_ = 0;
+ PixelFormat format_ = PixelFormat::UNKNOWN;
+
+ bool eof_ = false;
+
+ ImageBufferGenesysUsb buffer_;
+};
+
+// A pipeline node that produces data from the given array.
+class ImagePipelineNodeArraySource : public ImagePipelineNodeBytesSource
+{
+public:
+ ImagePipelineNodeArraySource(std::size_t width, std::size_t height, PixelFormat format,
+ std::vector<std::uint8_t> data);
+
+ std::size_t get_width() const override { return width_; }
+ std::size_t get_height() const override { return height_; }
+ PixelFormat get_format() const override { return format_; }
+
+ bool eof() const override { return eof_; }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+private:
+ std::size_t width_ = 0;
+ std::size_t height_ = 0;
+ PixelFormat format_ = PixelFormat::UNKNOWN;
+
+ bool eof_ = false;
+
+ std::vector<std::uint8_t> data_;
+ std::size_t next_row_ = 0;
+};
+
+
+/// A pipeline node that produces data from the given image
+class ImagePipelineNodeImageSource : public ImagePipelineNode
+{
+public:
+ ImagePipelineNodeImageSource(const Image& source);
+
+ std::size_t get_width() const override { return source_.get_width(); }
+ std::size_t get_height() const override { return source_.get_height(); }
+ PixelFormat get_format() const override { return source_.get_format(); }
+
+ bool eof() const override { return next_row_ >= get_height(); }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+private:
+ const Image& source_;
+ std::size_t next_row_ = 0;
+};
+
+// A pipeline node that converts between pixel formats
+class ImagePipelineNodeFormatConvert : public ImagePipelineNode
+{
+public:
+ ImagePipelineNodeFormatConvert(ImagePipelineNode& source, PixelFormat dst_format) :
+ source_(source),
+ dst_format_{dst_format}
+ {}
+
+ ~ImagePipelineNodeFormatConvert() override = default;
+
+ std::size_t get_width() const override { return source_.get_width(); }
+ std::size_t get_height() const override { return source_.get_height(); }
+ PixelFormat get_format() const override { return dst_format_; }
+
+ bool eof() const override { return source_.eof(); }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+private:
+ ImagePipelineNode& source_;
+ PixelFormat dst_format_;
+ std::vector<std::uint8_t> buffer_;
+};
+
+// A pipeline node that handles data that comes out of segmented sensors. Note that the width of
+// the output data does not necessarily match the input data width, because in many cases almost
+// all width of the image needs to be read in order to desegment it.
+class ImagePipelineNodeDesegment : public ImagePipelineNode
+{
+public:
+ ImagePipelineNodeDesegment(ImagePipelineNode& source,
+ std::size_t output_width,
+ const std::vector<unsigned>& segment_order,
+ std::size_t segment_pixels,
+ std::size_t interleaved_lines,
+ std::size_t pixels_per_chunk);
+
+ ImagePipelineNodeDesegment(ImagePipelineNode& source,
+ std::size_t output_width,
+ std::size_t segment_count,
+ std::size_t segment_pixels,
+ std::size_t interleaved_lines,
+ std::size_t pixels_per_chunk);
+
+ ~ImagePipelineNodeDesegment() override = default;
+
+ std::size_t get_width() const override { return output_width_; }
+ std::size_t get_height() const override { return source_.get_height() / interleaved_lines_; }
+ PixelFormat get_format() const override { return source_.get_format(); }
+
+ bool eof() const override { return source_.eof(); }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+private:
+ ImagePipelineNode& source_;
+ std::size_t output_width_;
+ std::vector<unsigned> segment_order_;
+ std::size_t segment_pixels_ = 0;
+ std::size_t interleaved_lines_ = 0;
+ std::size_t pixels_per_chunk_ = 0;
+
+ RowBuffer buffer_;
+};
+
+// A pipeline node that deinterleaves data on multiple lines
+class ImagePipelineNodeDeinterleaveLines : public ImagePipelineNodeDesegment
+{
+public:
+ ImagePipelineNodeDeinterleaveLines(ImagePipelineNode& source,
+ std::size_t interleaved_lines,
+ std::size_t pixels_per_chunk);
+};
+
+// A pipeline that swaps bytes in 16-bit components on big-endian systems
+class ImagePipelineNodeSwap16BitEndian : public ImagePipelineNode
+{
+public:
+ ImagePipelineNodeSwap16BitEndian(ImagePipelineNode& source);
+
+ std::size_t get_width() const override { return source_.get_width(); }
+ std::size_t get_height() const override { return source_.get_height(); }
+ PixelFormat get_format() const override { return source_.get_format(); }
+
+ bool eof() const override { return source_.eof(); }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+private:
+ ImagePipelineNode& source_;
+ bool needs_swapping_ = false;
+};
+
+// A pipeline node that merges 3 mono lines into a color channel
+class ImagePipelineNodeMergeMonoLines : public ImagePipelineNode
+{
+public:
+ ImagePipelineNodeMergeMonoLines(ImagePipelineNode& source,
+ ColorOrder color_order);
+
+ std::size_t get_width() const override { return source_.get_width(); }
+ std::size_t get_height() const override { return source_.get_height() / 3; }
+ PixelFormat get_format() const override { return output_format_; }
+
+ bool eof() const override { return source_.eof(); }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+private:
+ static PixelFormat get_output_format(PixelFormat input_format, ColorOrder order);
+
+ ImagePipelineNode& source_;
+ PixelFormat output_format_ = PixelFormat::UNKNOWN;
+
+ RowBuffer buffer_;
+};
+
+// A pipeline node that splits a color channel into 3 mono lines
+class ImagePipelineNodeSplitMonoLines : public ImagePipelineNode
+{
+public:
+ ImagePipelineNodeSplitMonoLines(ImagePipelineNode& source);
+
+ std::size_t get_width() const override { return source_.get_width(); }
+ std::size_t get_height() const override { return source_.get_height() * 3; }
+ PixelFormat get_format() const override { return output_format_; }
+
+ bool eof() const override { return source_.eof(); }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+private:
+ static PixelFormat get_output_format(PixelFormat input_format);
+
+ ImagePipelineNode& source_;
+ PixelFormat output_format_ = PixelFormat::UNKNOWN;
+
+ std::vector<std::uint8_t> buffer_;
+ unsigned next_channel_ = 0;
+};
+
+// A pipeline node that shifts colors across lines by the given offsets
+class ImagePipelineNodeComponentShiftLines : public ImagePipelineNode
+{
+public:
+ ImagePipelineNodeComponentShiftLines(ImagePipelineNode& source,
+ unsigned shift_r, unsigned shift_g, unsigned shift_b);
+
+ std::size_t get_width() const override { return source_.get_width(); }
+ std::size_t get_height() const override { return source_.get_height() - extra_height_; }
+ PixelFormat get_format() const override { return source_.get_format(); }
+
+ bool eof() const override { return source_.eof(); }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+private:
+ ImagePipelineNode& source_;
+ std::size_t extra_height_ = 0;
+
+ std::array<unsigned, 3> channel_shifts_;
+
+ RowBuffer buffer_;
+};
+
+// A pipeline node that shifts pixels across lines by the given offsets (performs unstaggering)
+class ImagePipelineNodePixelShiftLines : public ImagePipelineNode
+{
+public:
+ constexpr static std::size_t MAX_SHIFTS = 2;
+
+ ImagePipelineNodePixelShiftLines(ImagePipelineNode& source,
+ const std::vector<std::size_t>& shifts);
+
+ std::size_t get_width() const override { return source_.get_width(); }
+ std::size_t get_height() const override { return source_.get_height() - extra_height_; }
+ PixelFormat get_format() const override { return source_.get_format(); }
+
+ bool eof() const override { return source_.eof(); }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+private:
+ ImagePipelineNode& source_;
+ std::size_t extra_height_ = 0;
+
+ std::vector<std::size_t> pixel_shifts_;
+
+ RowBuffer buffer_;
+};
+
+// A pipeline node that extracts a sub-image from the image. Padding and cropping is done as needed.
+// The class can't pad to the left of the image currently, as only positive offsets are accepted.
+class ImagePipelineNodeExtract : public ImagePipelineNode
+{
+public:
+ ImagePipelineNodeExtract(ImagePipelineNode& source,
+ std::size_t offset_x, std::size_t offset_y,
+ std::size_t width, std::size_t height);
+
+ ~ImagePipelineNodeExtract() override;
+
+ std::size_t get_width() const override { return width_; }
+ std::size_t get_height() const override { return height_; }
+ PixelFormat get_format() const override { return source_.get_format(); }
+
+ bool eof() const override { return source_.eof(); }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+private:
+ ImagePipelineNode& source_;
+ std::size_t offset_x_ = 0;
+ std::size_t offset_y_ = 0;
+ std::size_t width_ = 0;
+ std::size_t height_ = 0;
+
+ std::size_t current_line_ = 0;
+ std::vector<std::uint8_t> cached_line_;
+};
+
+// A pipeline node that scales rows to the specified width by using a point filter
+class ImagePipelineNodeScaleRows : public ImagePipelineNode
+{
+public:
+ ImagePipelineNodeScaleRows(ImagePipelineNode& source, std::size_t width);
+
+ std::size_t get_width() const override { return width_; }
+ std::size_t get_height() const override { return source_.get_height(); }
+ PixelFormat get_format() const override { return source_.get_format(); }
+
+ bool eof() const override { return source_.eof(); }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+private:
+ ImagePipelineNode& source_;
+ std::size_t width_ = 0;
+
+ std::vector<std::uint8_t> cached_line_;
+};
+
+// A pipeline node that mimics the calibration behavior on Genesys chips
+class ImagePipelineNodeCalibrate : public ImagePipelineNode
+{
+public:
+
+ ImagePipelineNodeCalibrate(ImagePipelineNode& source, const std::vector<std::uint16_t>& bottom,
+ const std::vector<std::uint16_t>& top);
+
+ std::size_t get_width() const override { return source_.get_width(); }
+ std::size_t get_height() const override { return source_.get_height(); }
+ PixelFormat get_format() const override { return source_.get_format(); }
+
+ bool eof() const override { return source_.eof(); }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+private:
+ ImagePipelineNode& source_;
+
+ std::vector<float> offset_;
+ std::vector<float> multiplier_;
+};
+
+class ImagePipelineNodeDebug : public ImagePipelineNode
+{
+public:
+ ImagePipelineNodeDebug(ImagePipelineNode& source, const std::string& path);
+ ~ImagePipelineNodeDebug() override;
+
+ std::size_t get_width() const override { return source_.get_width(); }
+ std::size_t get_height() const override { return source_.get_height(); }
+ PixelFormat get_format() const override { return source_.get_format(); }
+
+ bool eof() const override { return source_.eof(); }
+
+ bool get_next_row_data(std::uint8_t* out_data) override;
+
+private:
+ ImagePipelineNode& source_;
+ std::string path_;
+ RowBuffer buffer_;
+};
+
+class ImagePipelineStack
+{
+public:
+ ImagePipelineStack() {}
+ ~ImagePipelineStack() { clear(); }
+
+ std::size_t get_input_width() const;
+ std::size_t get_input_height() const;
+ PixelFormat get_input_format() const;
+ std::size_t get_input_row_bytes() const;
+
+ std::size_t get_output_width() const;
+ std::size_t get_output_height() const;
+ PixelFormat get_output_format() const;
+ std::size_t get_output_row_bytes() const;
+
+ ImagePipelineNode& front() { return *(nodes_.front().get()); }
+
+ bool eof() const { return nodes_.back()->eof(); }
+
+ void clear();
+
+ template<class Node, class... Args>
+ void push_first_node(Args&&... args)
+ {
+ if (!nodes_.empty()) {
+ throw SaneException("Trying to append first node when there are existing nodes");
+ }
+ nodes_.emplace_back(std::unique_ptr<Node>(new Node(std::forward<Args>(args)...)));
+ }
+
+ template<class Node, class... Args>
+ void push_node(Args&&... args)
+ {
+ ensure_node_exists();
+ nodes_.emplace_back(std::unique_ptr<Node>(new Node(*nodes_.back(),
+ std::forward<Args>(args)...)));
+ }
+
+ bool get_next_row_data(std::uint8_t* out_data)
+ {
+ return nodes_.back()->get_next_row_data(out_data);
+ }
+
+ std::vector<std::uint8_t> get_all_data();
+
+ Image get_image();
+
+private:
+ void ensure_node_exists() const;
+
+ std::vector<std::unique_ptr<ImagePipelineNode>> nodes_;
+};
+
+} // namespace genesys
+
+#endif // ifndef BACKEND_GENESYS_IMAGE_PIPELINE_H