pixel_buffer_set.h
1 /*
2 ** ClanLib SDK
3 ** Copyright (c) 1997-2015 The ClanLib Team
4 **
5 ** This software is provided 'as-is', without any express or implied
6 ** warranty. In no event will the authors be held liable for any damages
7 ** arising from the use of this software.
8 **
9 ** Permission is granted to anyone to use this software for any purpose,
10 ** including commercial applications, and to alter it and redistribute it
11 ** freely, subject to the following restrictions:
12 **
13 ** 1. The origin of this software must not be misrepresented; you must not
14 ** claim that you wrote the original software. If you use this software
15 ** in a product, an acknowledgment in the product documentation would be
16 ** appreciated but is not required.
17 ** 2. Altered source versions must be plainly marked as such, and must not be
18 ** misrepresented as being the original software.
19 ** 3. This notice may not be removed or altered from any source distribution.
20 **
21 ** Note: Some of the libraries ClanLib may link to may have additional
22 ** requirements or restrictions.
23 **
24 ** File Author(s):
25 **
26 ** Magnus Norddahl
27 */
28 
29 
30 #pragma once
31 
32 #include <memory>
33 #include "../../Core/Math/rect.h"
34 #include "../Render/texture.h"
35 #include "texture_format.h"
36 
37 namespace clan
38 {
41 
42 class PixelBuffer;
43 class PixelBufferSet_Impl;
44 
47 {
50 public:
53 
55  PixelBufferSet(TextureDimensions dimensions, TextureFormat format, int width, int height = 1, int slices = 1);
56 
58  PixelBufferSet(const PixelBuffer &image);
60 
63 public:
65  bool is_null() const { return !impl; }
66 
68  void throw_if_null() const;
69 
72 
75 
77  int get_width() const;
78 
80  int get_height() const;
81 
83  int get_slice_count() const;
84 
86  int get_base_level() const;
87 
89  int get_max_level() const;
90 
92  PixelBuffer get_image(int slice, int level);
94 
97 public:
99  void set_image(int slice, int level, const PixelBuffer &image);
101 
104 private:
105  std::shared_ptr<PixelBufferSet_Impl> impl;
107 };
108 
109 }
110 
PixelBufferSet()
Constructs a null instance.
int get_base_level() const
Returns the lowest mip level specified in the set.
int get_max_level() const
Returns the highest mip level specified in the set.
TextureDimensions
Texture dimensions.
Definition: texture.h:92
int get_width() const
Returns the width of the image.
int get_slice_count() const
Returns the number of depth/array/cube slices in the set.
PixelBuffer get_image(int slice, int level)
Returns the pixel buffer for a specific slice and level.
bool is_null() const
Returns true if this object is invalid.
Definition: pixel_buffer_set.h:65
TextureFormat
Texture format.
Definition: texture_format.h:41
Definition: clanapp.h:36
PixelBufferSet(TextureDimensions dimensions, TextureFormat format, int width, int height=1, int slices=1)
Constructs an image set of the specified dimensions type and internal format.
Pixel data container.
Definition: pixel_buffer.h:69
Set of images that combined form a complete texture.
Definition: pixel_buffer_set.h:47
void throw_if_null() const
Throw an exception if this object is invalid.
void set_image(int slice, int level, const PixelBuffer &image)
Set the pixel buffer to be used for the specified slice and level.
TextureDimensions get_dimensions() const
Returns the texture dimensions used by the image set.
int get_height() const
Returns the height of the image.
TextureFormat get_format() const
Returns the internal texture format used by the image.
PixelBufferSet(const PixelBuffer &image)
Constructs an image set with a single image using the dimensions and internal format of the pixel buf...