File: MouseEventMask.h

package info (click to toggle)
0ad 0.0.26-3
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 130,460 kB
  • sloc: cpp: 261,824; ansic: 198,392; javascript: 19,067; python: 14,557; sh: 7,629; perl: 4,072; xml: 849; makefile: 741; java: 533; ruby: 229; php: 190; pascal: 30; sql: 21; tcl: 4
file content (69 lines) | stat: -rw-r--r-- 2,088 bytes parent folder | download
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
/* Copyright (C) 2021 Wildfire Games.
 * This file is part of 0 A.D.
 *
 * 0 A.D. 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.
 *
 * 0 A.D. 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 0 A.D.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef INCLUDED_GUI_MOUSE_EVENT_MASK
#define INCLUDED_GUI_MOUSE_EVENT_MASK

#include "gui/CGUISetting.h"
#include "ps/CStr.h"

#include <string>
#include <memory>

class CRect;
class CVector2D;
class IGUIObject;
class ScriptRequest;

/**
 * A custom shape that changes the object's "over-ability", and thus where one can click on it.
 * Supported:
 *  - "texture:[path]" loads a texture and uses either the alpha or the red channel. Any non-0 is clickable.
 *    The texture is always 'stretched' in sprite terminology.
 *
 * TODO:
 *  - the minimap circular shape should be moved here.
 */
class CGUIMouseEventMask : public IGUISetting
{
public:
	CGUIMouseEventMask(IGUIObject* owner);
	~CGUIMouseEventMask();

	/**
	 * @return true if the mask is initialised <=> its spec is not ""
	 */
	explicit operator bool() const { return !!m_Impl; }

	/**
	 * @return true if the mouse pointer is over the mask. False if the mask is not initialised.
	 */
	bool IsMouseOver(const CVector2D& mousePos, const CRect& objectSize) const;

	void ToJSVal(const ScriptRequest& rq, JS::MutableHandleValue value) override;

	class Impl;
protected:
	bool DoFromString(const CStrW& value) override;
	bool DoFromJSVal(const ScriptRequest& rq, JS::HandleValue value) override;
	CStr GetName() const override;

	std::string m_Spec;
	std::unique_ptr<Impl> m_Impl;
};

#endif // INCLUDED_GUI_MOUSE_EVENT_MASK