aboutsummaryrefslogtreecommitdiff
path: root/Plugins/plugin.h
blob: 69ed29868ba98a55df708a954e614f4d5b995c2e (plain)
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
//
// send the name of the plugin to fs.frame, and fs will call
// perform_effect(struct frame f, struct args a) in your dll.
//
// send it to the right inlet of fs.copy, and
// perform_copy(struct frame f1, struct frame f2, struct args a)
// will be used as a copy operation.
//

#ifndef _PLUGINH
#define _PLUGINH

typedef unsigned char byte;
#define pixel8 byte
#define pixel16 unsigned short
#define pixel24 struct pixel24data
#define pixel32 unsigned long
#define _frame struct frame
#define _args struct args

struct pixel24data { byte b; byte g; byte r; };

struct frame
{
	byte *bits;		// pixel data
	int lpitch;		// used to get row position in bits, see scanline below
				// this is not always width*(pixelformat/8), you tell me why
	int width;
	int height;
	int pixelformat;	// pixelformat is bitcount of your screen, 8, 16, 24 or 32.
};

struct args
{
	char *s;		// effect/copy arguments in a string
	char *ret;		// return values. data given in the form
				// "pd_receive_name=value;..." will be sent back to Pd.
				// memory allocated: 256 characters.
};

// 8-bit pointer to row y
__inline byte *scanline(struct frame f, int y)	{ return &f.bits[y*f.lpitch]; }

// pointer to 16 bit pixels
__inline pixel16 *scanline16(struct frame f, int y) { return (pixel16 *)scanline(f, y); }

// pointer to 24 bit pixels
__inline pixel24 *scanline24(struct frame f, int y) { return (pixel24 *)scanline(f, y); }

// pointer to 32 bit pixels
__inline pixel32 *scanline32(struct frame f, int y) { return (pixel32 *)scanline(f, y); }

__inline byte r16(pixel16 color)
{
	return (color >> 11) << 3;
}

__inline byte g16(pixel16 color)
{
	return ((color & 2016) >> 5) << 2;
}

__inline byte b16(pixel16 color)
{
	return (color & 31) << 3;
}

__inline byte r24(pixel24 color)
{
	return color.r;
}

__inline byte g24(pixel24 color)
{
	return color.g;
}

__inline byte b24(pixel24 color)
{
	return color.b;
}

__inline byte r32(pixel32 color)
{
	return (byte)color;
}

__inline byte g32(pixel32 color)
{
	return (byte)(((pixel16)color) >> 8);
}

__inline byte b32(pixel32 color)
{
	return (byte)(color >> 16);
}

__inline pixel16 rgbtocolor16(byte r, byte g, byte b)
{
	return 	((r >> 3) << 11) |	// r value shifted
		((g >> 2) << 5) |	// g value shifted
		(b >> 3);		// add blue
}

__inline pixel24 rgbtocolor24(byte r, byte g, byte b)
{
	pixel24 p;
	p.r = r;
	p.g = g;
	p.b = b;
	return p;
}

__inline pixel32 rgbtocolor32(byte r, byte g, byte b)
{
	return (b << 16) | (g << 8) | r;
}

// restrict input to be 0..255 <olaf.matthes@gmx.de>
__inline byte klamp255(long in)
{
	byte out = in<0 ? 0 : in;
	out = 255<out ? 255 : out;
	return(out);
}

// restrict input to be 16..235 as it is usual with signals
// conforming to ITU-R 601     <olaf.matthes@gmx.de>
__inline byte klamp601(long in)
{
	byte out = in<16 ? 16 : in;
	out = 235<out ? 235 : out;
	return(out);
}

// use this to easily describe your plugins:

#define INFO(x) void info(char *s) { sprintf(s, x); }

#endif // #ifndef _PLUGINH