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
|
/*
* Copyright 2011 Alex Merry <dev@randomguy3.me.uk>
*
* This program 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.
*
* This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
*/
#import "TZFoundation.h"
#import "RenderContext.h"
#import "Transformer.h"
typedef enum {
NormalCursor,
ResizeRightCursor,
ResizeBottomRightCursor,
ResizeBottomCursor,
ResizeBottomLeftCursor,
ResizeLeftCursor,
ResizeTopLeftCursor,
ResizeTopCursor,
ResizeTopRightCursor
} Cursor;
@protocol Surface;
@protocol RenderDelegate <NSObject>
- (void) renderWithContext:(id<RenderContext>)context onSurface:(id<Surface>)surface;
@end
/**
* Represents a surface that can be rendered to
*
* This protocol should be implemented by drawing surfaces. It
* provides geometry information and methods to invalidate
* regions of the surface, triggering a redraw.
*
* The surface should send a "SurfaceSizeChanged" notification
* when the width or height changes.
*/
@protocol Surface <NSObject>
/**
* The width of the surface, in surface units
*
* The surface should send a "SurfaceSizeChanged" notification
* when this property changes.
*/
@property (readonly) int width;
/**
* The height of the surface, in surface units
*
* The surface should send a "SurfaceSizeChanged" notification
* when this property changes.
*/
@property (readonly) int height;
/**
* The transformer that converts between graph units and surface units
*/
@property (readonly) Transformer *transformer;
/**
* The render delegate.
*
* This will be used to redraw (parts of) the surface when necessary.
*/
@property (assign) id<RenderDelegate> renderDelegate;
/**
* Create a render context for the surface.
*/
- (id<RenderContext>) createRenderContext;
/**
* Invalidate a portion of the surface.
*
* This will request that part of the surface be redrawn.
*/
- (void) invalidateRect:(NSRect)rect;
/**
* Invalidate the whole surface.
*
* This will request that the whole surface be redrawn.
*/
- (void) invalidate;
- (void) zoomIn;
- (void) zoomOut;
- (void) zoomReset;
- (void) zoomInAboutPoint:(NSPoint)p;
- (void) zoomOutAboutPoint:(NSPoint)p;
- (void) zoomResetAboutPoint:(NSPoint)p;
- (void) setCursor:(Cursor)c;
- (BOOL) hasFocus;
- (void) renderFocus;
@end
// vim:ft=objc:ts=8:et:sts=4:sw=4
|
