1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
/************************************************************************
*
* Copyright (C) 2023-2025 IRCAD France
*
* This file is part of Sight.
*
* Sight is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Sight 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 Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with Sight. If not, see <https://www.gnu.org/licenses/>.
*
***********************************************************************/
#pragma once
#include <sight/io/bitmap/config.hpp>
#include "backend.hpp"
#include <core/location/single_file.hpp>
#include <data/container.hpp>
#include <data/image.hpp>
#include <io/__/reader/generic_object_reader.hpp>
// cspell:ignore nvjpeg LIBJPEG OPENJPEG
namespace sight::io::bitmap::detail
{
class reader_impl;
}
namespace sight::io::bitmap
{
/**
* @brief Fast generic bitmap reader. It supports JPEG2000, JPEG, PNG and TIFF format.
*
* If a NVIDIA GPU is available and the support has been compiled in, NVidia nvJPEG / nvJPEG2000 library is used to
* achieve very fast decoding. Otherwise, libjpeg-turbo, openJPEG, libtiff or libPNG are used as fallback.
* The performance should still be better than VTK or even OpenCV because of direct API calls and avoided unneeded
* buffer copy.
*/
class SIGHT_IO_BITMAP_CLASS_API reader final : public io::reader::generic_object_reader<data::image>,
public core::location::single_file
{
public:
SIGHT_DECLARE_CLASS(reader, io::reader::generic_object_reader<data::image>);
SIGHT_ALLOW_SHARED_FROM_THIS();
/// Delete default constructors and assignment operators
reader(const reader&) = delete;
reader(reader&&) = delete;
reader& operator=(const reader&) = delete;
reader& operator=(reader&&) = delete;
/// Constructor/Destructor
SIGHT_IO_BITMAP_API reader();
SIGHT_IO_BITMAP_API ~reader() final;
/// Main writing method from generic_object_reader
SIGHT_IO_BITMAP_API void read(SPTR(sight::core::progress::observer) _progress) final;
/// Specialized reading method that allows to specify the backend
/// @arg _backend: the backend to use. Can be LIBJPEG, LIBTIFF, LIBPNG, OPENJPEG or, if available, NVJPEG and
/// NVJPEG2K. DEFAULT is LIBTIFF and ANY will guess using the file extension. "*J2K" variant are
/// JPEG2000 "stream", without normal meta-data and is only useful for DICOM
SIGHT_IO_BITMAP_API void read(backend _backend);
/// Specialized reading method that allows to read from a istream
/// @arg _istream: the stream to read from. It is up to the user to open it.
/// @arg _backend: the backend to use. Can be LIBJPEG, LIBTIFF, LIBPNG, OPENJPEG or, if available, NVJPEG and
/// NVJPEG2K. DEFAULT is LIBTIFF. "*_J2K" variant are
/// JPEG2000 "stream", without normal meta-data and is only useful for DICOM
SIGHT_IO_BITMAP_API void read(
std::istream& _istream,
backend _backend = backend::libtiff
);
/// Specialized reading method that allows to read from a buffer
/// @note This method is only efficient for nvjpeg / nvjpeg2k backends. For other backends, it will create a
/// std::istream on the fly, which is not optimal.
/// @arg _input: the buffer to read from. It is up to the user to manage it.
/// @arg _input_size: the size of the buffer in bytes.
/// @arg _output: optional pre-allocated output buffer. If nullptr, we will use get_concrete_object()
/// @arg _backend: the backend to use. Can be LIBJPEG, LIBTIFF, LIBPNG, OPENJPEG or, if available, NVJPEG and
/// NVJPEG2K. DEFAULT is LIBTIFF. "*_J2K" variant are
/// JPEG2000 "stream", without normal meta-data and is only useful for DICOM
SIGHT_IO_BITMAP_API void read(
const std::uint8_t* const _input,
std::size_t _input_size,
backend _backend = backend::libtiff,
std::uint8_t* const _output = nullptr
);
/// Return the extension to use, by default, or the one from file set by single_file::set_file(), if valid
/// @return an extension as string
[[nodiscard]] SIGHT_IO_BITMAP_API std::string extension() const final;
private:
/// PImpl
std::unique_ptr<detail::reader_impl> m_pimpl;
};
} // namespace sight::io::bitmap
|
