File: sig_match.h

package info (click to toggle)
faumachine 20180503-4
  • links: PTS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 61,272 kB
  • sloc: ansic: 272,290; makefile: 6,199; asm: 4,251; sh: 3,022; perl: 886; xml: 563; pascal: 311; lex: 214; vhdl: 204
file content (154 lines) | stat: -rw-r--r-- 4,128 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
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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
/*
 * Copyright (C) 2007-2009 FAUmachine Team <info@faumachine.org>.
 * This program is free software. You can redistribute it and/or modify it
 * under the terms of the GNU General Public License, either version 2 of
 * the License, or (at your option) any later version. See COPYING.
 */

#ifndef __SIG_MATCH_H_INCLUDED
#define __SIG_MATCH_H_INCLUDED

#include <inttypes.h>
#include <stdbool.h>

#include "sig_gen.h"

/** callback functions for sig_match */
struct sig_match_funcs {

	/** get's called every time an image get's matched 
	 *  @param s instance 
	 *  @param visible is the match visible?
	 *  @param x x coordinate of match (or 0 if not visible)
	 *  @param y y coordinate of match (or 0 if not visible)
	 *  @param w width of the matched pattern (or 0 if not visible)
	 *  @param h height of the matched pattern (or 0 if not visible)
	 *  (TODO: x,y offset)
	 */
	void (*event)(void *s, bool visible, uint16_t x, uint16_t y, 
	                                     uint16_t w, uint16_t h);

	/** callback to add a fullscreen match for the pattern matcher.
	 *  @param s instance.
	 *  @param image path to the image.
	 */
	void (*add_match)(void *s, const char* image);

	/** callback for adding a match for a limited area to the pattern
	 *  matcher.
	 *  @param s instance.
	 *  @param image path to the image.
	 *  @param x x part of the top/left corner.
	 *  @param y y part of the top/left corner.
	 *  @param w width.
	 *  @param h height.
	 */
	void (*add_match_partial)(void *s, const char* image, uint16_t x, 
				  uint16_t y, uint16_t w, uint16_t h);

	/** disable a match. 
	 *  @param s instance.
	 */
	void (*remove_match)(void *s);
};

/** structure with callbacks
 *  FIXME: partial rectangle of screen! */
struct sig_match {
	enum sig_gen_type type;
	/** members participating on signal */
	struct {
		/** object data. */
		void *s;
		/** callback functions */
		const struct sig_match_funcs *f;
	} member[2];
	/** number of members on signal. */
	unsigned int nmembers;
};

/** Emit a match event.
 *  @param m signal instance
 *  @param s sender instance
 *  @param x x coordinate
 *  @param y y coordinate
 *  @param w width of matched pattern
 *  @param h height of matched pattern
 */
extern void
sig_match_event(const struct sig_match* m, void *s, uint16_t x, uint16_t y,
                                                    uint16_t w, uint16_t h);

/** Emit a no longer matching event.
 *  @param m signal instance
 *  @param s sender instance
 */
extern void
sig_match_invisible(const struct sig_match* m, void *s);

/** Add a fullscreen match for the pattern matcher.
 *  @param m signal instance.
 *  @param s sender instance.
 *  @param image path to the image.
 */
extern void
sig_match_add_match(const struct sig_match* m, void *s, const char* image);

/** Add a match for a limited area to the pattern matcher.
 *  @param m signal instance.
 *  @param s sender instance.
 *  @param image path to the image.
 *  @param x x part of the top/left corner.
 *  @param y y part of the top/left corner.
 *  @param w width.
 *  @param h height.
 */
extern void
sig_match_add_match_partial(
	const struct sig_match* m,
	void *s, 
	const char* image,
	uint16_t x, 
	uint16_t y,
	uint16_t w,
	uint16_t h
);

/** Disable a registered match again.
 *  @param m signal instance.
 *  @param s sender instance.
 */
extern void
sig_match_remove_match(const struct sig_match* m, void *s);

/** connect to match signal.
 *  @param m signal instance.
 *  @param s sender instance.
 *  @param f callback functions.
 */
extern void
sig_match_connect(
	struct sig_match* m,
	void *s, 
	const struct sig_match_funcs *f
);

/** create a match signal.
 *  @param name name of signal.
 *  @param nr number of signal.
 *  @return initialized sig_match signal. */
extern struct sig_match*
sig_match_create(const char *name);

/** destroy a match signal.
 *  @sig signal to be destroyed.
 */
extern void
sig_match_destroy(struct sig_match *sig);

extern void
sig_match_suspend(struct sig_match *b, FILE *fSig);
extern void
sig_match_resume(struct sig_match *b, FILE *fSig);

#endif /* __SIG_MATCH_H_INCLUDED */