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
|
#ifndef _Picture_h_
#define _Picture_h_
/* Picture.h
*
* Copyright (C) 1992-2011,2012 Paul Boersma
*
* 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, write to the Free Software
* Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
/* A self-recording picture inside a DrawingArea widget.
All drawing is kept in a Graphics.
If the picture is sensitive,
the user can select the viewport by dragging the mouse across the drawing area.
If the viewport is smaller than the entire drawing area, it is highlighted.
Usage:
You should put highlighting off during drawing.
Do not use the workstation Graphics routines,
like clearWs, flushWs, closeWs, updateWs, setWsViewport.
Example:
Picture p = Picture_create (myDrawingArea);
Any g = Picture_getGraphics (p);
Picture_unhighlight (p);
Graphics_setTextAlignment (g, Graphics_CENTRE, Graphics_HALF);
Graphics_text (g, 0.5, 0.7, L"Hello");
Graphics_text (g, 0.5, 0.6, L"there");
Picture_highlight (p);
... (event handling)
Picture_unhighlight (p);
Graphics_text (g, 0.5, 0.3, L"Goodbye");
Picture_highlight (p);
... (event handling)
Picture_writeToEpsFile (p, L"HelloGoodbye.eps");
Picture_print (p, GraphicsPostscript_FINE);
Picture_remove (& p);
*/
#ifdef macintosh
#define Picture PictureNotMac
#endif
#include "Graphics.h"
typedef struct structPicture *Picture;
Picture Picture_create (GuiObject drawingArea, Boolean sensitive);
/*
Function:
create an empty self-recording picture inside 'drawingArea'.
Precondition:
'drawingArea' must have been realized.
Postconditions:
a Graphics has been created from Graphics_create_macintosh or Graphics_create_xwindow;
the workstation viewport of this Graphics is [0, 1] x [0, 1];
selection is [0, 1] x [0, 1] (NDC), which is invisible;
*/
Graphics Picture_getGraphics (Picture me);
/*
Function:
return the Graphics object.
Usage:
send the graphics output that you want to be in the picture to this Graphics,
bracketed by calls to Picture_startRecording and Picture_stopRecording.
*/
void Picture_unhighlight (Picture me);
/*
Function:
hide the viewport.
Usage:
call just before sending graphics output.
*/
void Picture_highlight (Picture me);
/*
Function:
visualize the viewport.
Usage:
call just after sending graphics output.
*/
void Picture_setSelectionChangedCallback (Picture me,
void (*selectionChangedCallback) (Picture, XtPointer closure,
double x1NDC, double x2NDC, double y1NDC, double y2NDC),
XtPointer selectionChangedClosure);
void Picture_setMouseSelectsInnerViewport (Picture me, int mouseSelectsInnerViewport);
void Picture_remove (Picture *me);
/*
Function:
remove a Picture from memory.
Preconditions:
none
Postconditions:
*me == NULL;
*/
void Picture_erase (Picture me); /* Clears the screen. */
void Picture_writeToPraatPictureFile (Picture me, MelderFile file);
void Picture_readFromPraatPictureFile (Picture me, MelderFile file);
void Picture_writeToEpsFile (Picture me, MelderFile file, int includeFonts, int useSilipaPS);
void Picture_writeToPdfFile (Picture me, MelderFile file);
void Picture_print (Picture me);
void Picture_printToPostScriptPrinter (Picture me, int spots, int paperSize, int rotation, double magnification);
#ifdef macintosh
void Picture_copyToClipboard (Picture me);
#endif
#ifdef _WIN32
void Picture_copyToClipboard (Picture me);
void Picture_writeToWindowsMetafile (Picture me, MelderFile file);
#endif
void Picture_setSelection
(Picture me, double x1NDC, double x2NDC, double y1NDC, double y2NDC, Boolean notify);
/*
Preconditions:
0.0 <= x1NDC < x2NDC <= 1.0;
0.0 <= y1NDC < y2NDC <= 1.0;
*/
void Picture_background (Picture me);
void Picture_foreground (Picture me);
void Picture_selfExpose (Picture me);
/* End of file Picture.h */
#endif
|
