annotate OrthancStone/Sources/OpenGL/OpenGLTexture.h @ 2125:2e050ec85379 deep-learning

integration mainline->deep-learning
author Sebastien Jodogne <s.jodogne@gmail.com>
date Thu, 30 May 2024 17:06:53 +0200
parents de049fd88697 16c01cc201e7
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
579
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
1 /**
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
2 * Stone of Orthanc
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
3 * Copyright (C) 2012-2016 Sebastien Jodogne, Medical Physics
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
4 * Department, University Hospital of Liege, Belgium
2124
16c01cc201e7 updated copyright, as Osimis is not active on Orthanc anymore
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2114
diff changeset
5 * Copyright (C) 2017-2023 Osimis S.A., Belgium
2114
c23eef785569 update year to 2024
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2077
diff changeset
6 * Copyright (C) 2021-2024 Sebastien Jodogne, ICTEAM UCLouvain, Belgium
579
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
7 *
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
8 * This program is free software: you can redistribute it and/or
1598
8563ea5d8ae4 relicensing some files, cf. osimis bm26 and chu agreement on 2020-05-20
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1596
diff changeset
9 * modify it under the terms of the GNU Lesser General Public License
579
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
10 * as published by the Free Software Foundation, either version 3 of
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
11 * the License, or (at your option) any later version.
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
12 *
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
13 * This program is distributed in the hope that it will be useful, but
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
1598
8563ea5d8ae4 relicensing some files, cf. osimis bm26 and chu agreement on 2020-05-20
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1596
diff changeset
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
8563ea5d8ae4 relicensing some files, cf. osimis bm26 and chu agreement on 2020-05-20
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1596
diff changeset
16 * Lesser General Public License for more details.
1596
4fb8fdf03314 removed annoying whitespace
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1571
diff changeset
17 *
1598
8563ea5d8ae4 relicensing some files, cf. osimis bm26 and chu agreement on 2020-05-20
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1596
diff changeset
18 * You should have received a copy of the GNU Lesser General Public
8563ea5d8ae4 relicensing some files, cf. osimis bm26 and chu agreement on 2020-05-20
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1596
diff changeset
19 * License along with this program. If not, see
8563ea5d8ae4 relicensing some files, cf. osimis bm26 and chu agreement on 2020-05-20
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1596
diff changeset
20 * <http://www.gnu.org/licenses/>.
579
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
21 **/
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
22
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
23
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
24 #pragma once
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
25
582
e36e69a380a5 Scene2D
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 581
diff changeset
26 #include "OpenGLIncludes.h"
2032
d10bab7cc396 added OpenGLTexture::Download()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1871
diff changeset
27 #include "IOpenGLContext.h"
581
d933fc19214a fix windows build
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 579
diff changeset
28
1455
30deba7bc8e2 simplifying include_directories
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1270
diff changeset
29 #include <Images/ImageAccessor.h>
579
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
30
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
31 #include <boost/noncopyable.hpp>
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
32
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
33
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
34 namespace OrthancStone
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
35 {
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
36 namespace OpenGL
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
37 {
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
38 class OpenGLTexture : public boost::noncopyable
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
39 {
2060
86e0e92a2e0d added OpenGLTextureArray and OpenGLFramebuffer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2058
diff changeset
40 friend class OpenGLFramebuffer;
86e0e92a2e0d added OpenGLTextureArray and OpenGLFramebuffer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2058
diff changeset
41
579
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
42 private:
947
1091b2adeb5a Fixed animation frame stopping when returning false + big work on the OpenGL
Benjamin Golinvaux <bgo@osimis.io>
parents: 582
diff changeset
43 OpenGL::IOpenGLContext& context_;
2060
86e0e92a2e0d added OpenGLTextureArray and OpenGLFramebuffer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2058
diff changeset
44 GLuint texture_;
86e0e92a2e0d added OpenGLTextureArray and OpenGLFramebuffer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2058
diff changeset
45 unsigned int width_;
86e0e92a2e0d added OpenGLTextureArray and OpenGLFramebuffer
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2058
diff changeset
46 unsigned int height_;
2047
0b596428e60c added OpenGLTexture::GetFormat()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2042
diff changeset
47 Orthanc::PixelFormat format_;
2058
c0627145b441 added OpenGLTexture::IsLinearInterpolation()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2047
diff changeset
48 bool isLinearInterpolation_;
579
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
49
2034
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
50 void Setup(Orthanc::PixelFormat format,
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
51 unsigned int width,
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
52 unsigned int height,
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
53 bool isLinearInterpolation,
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
54 const void* data);
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
55
2038
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2037
diff changeset
56 /**
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2037
diff changeset
57 * Returns the low-level OpenGL handle of the texture. Beware to
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2037
diff changeset
58 * never change the size of the texture using this handle!
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2037
diff changeset
59 **/
2034
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
60 GLuint GetId() const
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
61 {
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
62 return texture_;
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
63 }
579
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
64
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
65 public:
1571
85e117739eca cppcheck
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1512
diff changeset
66 explicit OpenGLTexture(OpenGL::IOpenGLContext& context);
579
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
67
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
68 ~OpenGLTexture();
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
69
2047
0b596428e60c added OpenGLTexture::GetFormat()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2042
diff changeset
70 Orthanc::PixelFormat GetFormat() const
0b596428e60c added OpenGLTexture::GetFormat()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2042
diff changeset
71 {
0b596428e60c added OpenGLTexture::GetFormat()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2042
diff changeset
72 return format_;
0b596428e60c added OpenGLTexture::GetFormat()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2042
diff changeset
73 }
0b596428e60c added OpenGLTexture::GetFormat()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2042
diff changeset
74
579
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
75 unsigned int GetWidth() const
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
76 {
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
77 return width_;
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
78 }
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
79
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
80 unsigned int GetHeight() const
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
81 {
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
82 return height_;
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
83 }
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
84
2058
c0627145b441 added OpenGLTexture::IsLinearInterpolation()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2047
diff changeset
85 bool IsLinearInterpolation() const
c0627145b441 added OpenGLTexture::IsLinearInterpolation()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2047
diff changeset
86 {
c0627145b441 added OpenGLTexture::IsLinearInterpolation()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2047
diff changeset
87 return isLinearInterpolation_;
c0627145b441 added OpenGLTexture::IsLinearInterpolation()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2047
diff changeset
88 }
c0627145b441 added OpenGLTexture::IsLinearInterpolation()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2047
diff changeset
89
2034
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
90 void Setup(Orthanc::PixelFormat format,
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
91 unsigned int width,
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
92 unsigned int height,
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
93 bool isLinearInterpolation)
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
94 {
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
95 Setup(format, width, height, isLinearInterpolation, NULL);
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
96 }
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2032
diff changeset
97
579
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
98 void Load(const Orthanc::ImageAccessor& image,
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
99 bool isLinearInterpolation);
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
100
2039
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2038
diff changeset
101 void Bind(GLint location) const;
2032
d10bab7cc396 added OpenGLTexture::Download()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1871
diff changeset
102
2042
0fa4c0ca429d added OpenGLTexture::BindAsTextureUnit()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2039
diff changeset
103 void BindAsTextureUnit(GLint location,
0fa4c0ca429d added OpenGLTexture::BindAsTextureUnit()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2039
diff changeset
104 unsigned int unit) const;
0fa4c0ca429d added OpenGLTexture::BindAsTextureUnit()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2039
diff changeset
105
2039
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2038
diff changeset
106 Orthanc::ImageAccessor* Download(Orthanc::PixelFormat format) const;
2035
a73a8415780f added OpenGLTexture::SetClampingToZero()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2034
diff changeset
107
a73a8415780f added OpenGLTexture::SetClampingToZero()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2034
diff changeset
108 /**
a73a8415780f added OpenGLTexture::SetClampingToZero()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2034
diff changeset
109 * By default, textures are mirrored at the borders. This
a73a8415780f added OpenGLTexture::SetClampingToZero()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2034
diff changeset
110 * function will set out-of-image access to zero.
a73a8415780f added OpenGLTexture::SetClampingToZero()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2034
diff changeset
111 **/
a73a8415780f added OpenGLTexture::SetClampingToZero()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2034
diff changeset
112 void SetClampingToZero();
2037
d81a7157a846 added OpenGLTexture::ConvertToOpenGLFormats()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2035
diff changeset
113
d81a7157a846 added OpenGLTexture::ConvertToOpenGLFormats()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2035
diff changeset
114 static void ConvertToOpenGLFormats(GLenum& sourceFormat,
d81a7157a846 added OpenGLTexture::ConvertToOpenGLFormats()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2035
diff changeset
115 GLenum& internalFormat,
d81a7157a846 added OpenGLTexture::ConvertToOpenGLFormats()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2035
diff changeset
116 GLenum& pixelType,
d81a7157a846 added OpenGLTexture::ConvertToOpenGLFormats()
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 2035
diff changeset
117 Orthanc::PixelFormat format);
579
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
118 };
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
119 }
fadacfbf5538 OpenGL programs and textures
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
120 }