cursor_description.h
1/*
2** ClanLib SDK
3** Copyright (c) 1997-2020 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** Kenneth Gangstoe
27*/
28
29#pragma once
30
31#include "../Render/graphic_context.h"
32#include "../Render/texture_2d.h"
33#include "../Image/pixel_buffer.h"
34#include <vector>
35
36namespace clan
37{
40
41 class CursorDescription_Impl;
42 class XMLResourceDocument;
43
61
70 {
71 public:
74
79
81
83 static CursorDescription load(GraphicContext &gc, const std::string &resource_id, const XMLResourceDocument &doc, const ImageImportDescription &import_desc = ImageImportDescription());
84
86 const std::vector<CursorDescriptionFrame> &get_frames() const;
87
90
91 bool operator==(const CursorDescription &that) const { return impl == that.impl; }
92 bool operator!=(const CursorDescription &that) const { return impl != that.impl; }
93 bool operator<(const CursorDescription &that) const { return impl < that.impl; }
94 bool operator>(const CursorDescription &that) const { return impl > that.impl; }
95 bool operator<=(const CursorDescription &that) const { return impl <= that.impl; }
96 bool operator>=(const CursorDescription &that) const { return impl >= that.impl; }
97
100
106 void add_frame(const PixelBuffer &pixelbuffer);
107
111 void add_frame(const std::string &fullname, const ImageImportDescription &import_desc = ImageImportDescription());
112
117 void add_frame(IODevice &file, const std::string &image_type, const ImageImportDescription &import_desc = ImageImportDescription());
118
123 void add_frame(const std::string &filename, FileSystem &fs, const ImageImportDescription &import_desc = ImageImportDescription());
124
126
135 const PixelBuffer &pixelbuffer,
136 int xpos, int ypos,
137 int width, int height,
138 int xarray = 1, int yarray = 1,
139 int array_skipframes = 0,
140 int xspacing = 0, int yspacing = 0);
141
143
153 const PixelBuffer &pixelbuffer,
154 int xpos = 0, int ypos = 0,
155 float trans_limit = 0.05f);
156
158
167 const PixelBuffer &pixelbuffer,
168 int xpos = 0, int ypos = 0,
169 float trans_limit = 0.05f);
170
172 void set_frame_delay(int frame, double delay);
173
175 void set_hotspot(const Point &hotspot);
176
177 private:
178 std::shared_ptr<CursorDescription_Impl> impl;
179 };
180
182}
This class describes a single frame in a cursor description.
Definition cursor_description.h:46
double delay
Definition cursor_description.h:58
PixelBuffer pixelbuffer
Definition cursor_description.h:56
Rect rect
Definition cursor_description.h:57
CursorDescriptionFrame(PixelBuffer pixelbuffer, Rect rect)
Constructs a CursorDescriptionFrame.
Definition cursor_description.h:54
This class contains everything to construct a cursor - its data, default settings etc.
Definition cursor_description.h:70
CursorDescription & operator=(const CursorDescription &copy)
Copy assignment operator.
Point get_hotspot() const
the offset of where the cursor is drawn relative to cursor image
void add_alphaclipped_frames_free(const PixelBuffer &pixelbuffer, int xpos=0, int ypos=0, float trans_limit=0.05f)
Adds images separated with pure alpha (within trans_limit).
void set_frame_delay(int frame, double delay)
Sets the duration this frame is displayed, in seconds.
CursorDescription()
Constructs a cursor description.
void add_frame(const std::string &filename, FileSystem &fs, const ImageImportDescription &import_desc=ImageImportDescription())
Add frame.
void add_frame(const PixelBuffer &pixelbuffer)
Adds a single image.
CursorDescription(const CursorDescription &copy)
Constructs a CursorDescription.
bool operator>(const CursorDescription &that) const
Definition cursor_description.h:94
static CursorDescription load(GraphicContext &gc, const std::string &resource_id, const XMLResourceDocument &doc, const ImageImportDescription &import_desc=ImageImportDescription())
Loads a CursorDescription from a XML resource definition.
bool operator>=(const CursorDescription &that) const
Definition cursor_description.h:96
bool operator==(const CursorDescription &that) const
Definition cursor_description.h:91
bool operator<=(const CursorDescription &that) const
Definition cursor_description.h:95
const std::vector< CursorDescriptionFrame > & get_frames() const
Returns a list over all available frames.
void add_alphaclipped_frames(const PixelBuffer &pixelbuffer, int xpos=0, int ypos=0, float trans_limit=0.05f)
Adds images separated with pure alpha (within trans_limit).
void set_hotspot(const Point &hotspot)
Sets the offset of where the cursor is drawn relative to the cursor image.
void add_frame(const std::string &fullname, const ImageImportDescription &import_desc=ImageImportDescription())
Add frame.
bool operator!=(const CursorDescription &that) const
Definition cursor_description.h:92
bool operator<(const CursorDescription &that) const
Definition cursor_description.h:93
void add_frame(IODevice &file, const std::string &image_type, const ImageImportDescription &import_desc=ImageImportDescription())
Add frame.
void add_gridclipped_frames(const PixelBuffer &pixelbuffer, int xpos, int ypos, int width, int height, int xarray=1, int yarray=1, int array_skipframes=0, int xspacing=0, int yspacing=0)
Adds images formed in a grid.
Virtual File System (VFS).
Definition file_system.h:47
Interface to drawing graphics.
Definition graphic_context.h:257
I/O Device interface.
Definition iodevice.h:50
Image Import Description Class.
Definition image_import_description.h:48
Pixel data container.
Definition pixel_buffer.h:68
2D (x,y) point structure - Integer
Definition point.h:62
2D (left,top,right,bottom) rectangle structure - Integer
Definition rect.h:489
XML Resource Document.
Definition xml_resource_document.h:48
Definition clanapp.h:36