xref: /petsc/src/sys/classes/draw/impls/x/xops.c (revision 73ecf448920118c3addf6065a815eb40e5fb84d2)
1 /*
2     Defines the operations for the X PetscDraw implementation.
3 */
4 
5 #include <../src/sys/classes/draw/impls/x/ximpl.h>         /*I  "petscsys.h" I*/
6 
7 /*
8      These macros transform from the users coordinates to the  X-window pixel coordinates.
9 */
10 #define XTRANS(draw,xwin,x)  (int)(((xwin)->w)*((draw)->port_xl + (((x - (draw)->coor_xl)*((draw)->port_xr - (draw)->port_xl))/((draw)->coor_xr - (draw)->coor_xl))))
11 #define YTRANS(draw,xwin,y)  (int)(((xwin)->h)*(1 - (draw)->port_yl - (((y - (draw)->coor_yl)*((draw)->port_yr - (draw)->port_yl))/((draw)->coor_yr - (draw)->coor_yl))))
12 
13 #define ITRANS(draw,xwin,i)  (draw)->coor_xl + (i*((draw)->coor_xr - (draw)->coor_xl)/((xwin)->w) - (draw)->port_xl)/((draw)->port_xr - (draw)->port_xl)
14 #define JTRANS(draw,xwin,j)  draw->coor_yl + (((PetscReal)j)/xwin->h + draw->port_yl - 1)*(draw->coor_yr - draw->coor_yl)/(draw->port_yl - draw->port_yr)
15 
16 #undef __FUNCT__
17 #define __FUNCT__ "PetscDrawSetViewport_X"
18 static PetscErrorCode PetscDrawSetViewport_X(PetscDraw draw,PetscReal xl,PetscReal yl,PetscReal xr,PetscReal yr)
19 {
20   PetscDraw_X    *XiWin = (PetscDraw_X*)draw->data;
21   XRectangle     box;
22   PetscErrorCode ierr;
23 
24   PetscFunctionBegin;
25   ierr = PetscDrawCollectiveBegin(draw);CHKERRQ(ierr);
26   box.x = (short)(xl*XiWin->w);
27   box.y = (short)((1-yr)*XiWin->h);
28   box.width  = (unsigned short)((xr-xl)*XiWin->w);
29   box.height = (unsigned short)((yr-yl)*XiWin->h);
30   XSetClipRectangles(XiWin->disp,XiWin->gc.set,0,0,&box,1,Unsorted);
31   ierr = PetscDrawCollectiveEnd(draw);CHKERRQ(ierr);
32   PetscFunctionReturn(0);
33 }
34 
35 #undef __FUNCT__
36 #define __FUNCT__ "PetscDrawCoordinateToPixel_X"
37 static PetscErrorCode PetscDrawCoordinateToPixel_X(PetscDraw draw,PetscReal x,PetscReal y,PetscInt *i,PetscInt *j)
38 {
39   PetscDraw_X *XiWin = (PetscDraw_X*)draw->data;
40 
41   PetscFunctionBegin;
42   *i = XTRANS(draw,XiWin,x);
43   *j = YTRANS(draw,XiWin,y);
44   PetscFunctionReturn(0);
45 }
46 
47 #undef __FUNCT__
48 #define __FUNCT__ "PetscDrawPixelToCoordinate_X"
49 static PetscErrorCode PetscDrawPixelToCoordinate_X(PetscDraw draw,PetscInt i,PetscInt j,PetscReal *x,PetscReal *y)
50 {
51   PetscDraw_X *XiWin = (PetscDraw_X*)draw->data;
52 
53   PetscFunctionBegin;
54   *x = ITRANS(draw,XiWin,i);
55   *y = JTRANS(draw,XiWin,j);
56   PetscFunctionReturn(0);
57 }
58 
59 #undef __FUNCT__
60 #define __FUNCT__ "PetscDrawPoint_X"
61 static PetscErrorCode PetscDrawPoint_X(PetscDraw draw,PetscReal x,PetscReal y,int c)
62 {
63   PetscDraw_X *XiWin = (PetscDraw_X*)draw->data;
64   int         xx,yy,i,j;
65 
66   PetscFunctionBegin;
67   xx = XTRANS(draw,XiWin,x);  yy = YTRANS(draw,XiWin,y);
68   PetscDrawXiSetColor(XiWin,c);
69   for (i=-1; i<2; i++) {
70     for (j=-1; j<2; j++) {
71       XDrawPoint(XiWin->disp,PetscDrawXiDrawable(XiWin),XiWin->gc.set,xx+i,yy+j);
72     }
73   }
74   PetscFunctionReturn(0);
75 }
76 
77 #undef __FUNCT__
78 #define __FUNCT__ "PetscDrawPointPixel_X"
79 static PetscErrorCode PetscDrawPointPixel_X(PetscDraw draw,PetscInt x,PetscInt y,int c)
80 {
81   PetscDraw_X *XiWin = (PetscDraw_X*)draw->data;
82 
83   PetscFunctionBegin;
84   PetscDrawXiSetColor(XiWin,c);
85   XDrawPoint(XiWin->disp,PetscDrawXiDrawable(XiWin),XiWin->gc.set,x,y);
86   PetscFunctionReturn(0);
87 }
88 
89 #undef __FUNCT__
90 #define __FUNCT__ "PetscDrawLine_X"
91 static PetscErrorCode PetscDrawLine_X(PetscDraw draw,PetscReal xl,PetscReal yl,PetscReal xr,PetscReal yr,int cl)
92 {
93   PetscDraw_X *XiWin = (PetscDraw_X*)draw->data;
94   int         x1,y_1,x2,y2;
95 
96   PetscFunctionBegin;
97   PetscDrawXiSetColor(XiWin,cl);
98   x1  = XTRANS(draw,XiWin,xl);   x2  = XTRANS(draw,XiWin,xr);
99   y_1 = YTRANS(draw,XiWin,yl);   y2  = YTRANS(draw,XiWin,yr);
100   if (x1 == x2 && y_1 == y2) PetscFunctionReturn(0);
101   XDrawLine(XiWin->disp,PetscDrawXiDrawable(XiWin),XiWin->gc.set,x1,y_1,x2,y2);
102   PetscFunctionReturn(0);
103 }
104 
105 #undef __FUNCT__
106 #define __FUNCT__ "PetscDrawArrow_X"
107 static PetscErrorCode PetscDrawArrow_X(PetscDraw draw,PetscReal xl,PetscReal yl,PetscReal xr,PetscReal yr,int cl)
108 {
109   PetscDraw_X *XiWin = (PetscDraw_X*)draw->data;
110   int         x1,y_1,x2,y2;
111 
112   PetscFunctionBegin;
113   PetscDrawXiSetColor(XiWin,cl);
114   x1  = XTRANS(draw,XiWin,xl);   x2  = XTRANS(draw,XiWin,xr);
115   y_1 = YTRANS(draw,XiWin,yl);   y2  = YTRANS(draw,XiWin,yr);
116   if (x1 == x2 && y_1 == y2) PetscFunctionReturn(0);
117   XDrawLine(XiWin->disp,PetscDrawXiDrawable(XiWin),XiWin->gc.set,x1,y_1,x2,y2);
118   if (x1 == x2 && PetscAbs(y_1 - y2) > 7) {
119     if (y2 > y_1) {
120       XDrawLine(XiWin->disp,PetscDrawXiDrawable(XiWin),XiWin->gc.set,x2,y2,x2-3,y2-3);
121       XDrawLine(XiWin->disp,PetscDrawXiDrawable(XiWin),XiWin->gc.set,x2,y2,x2+3,y2-3);
122     } else {
123       XDrawLine(XiWin->disp,PetscDrawXiDrawable(XiWin),XiWin->gc.set,x2,y2,x2-3,y2+3);
124       XDrawLine(XiWin->disp,PetscDrawXiDrawable(XiWin),XiWin->gc.set,x2,y2,x2+3,y2+3);
125     }
126   }
127   PetscFunctionReturn(0);
128 }
129 
130 #undef __FUNCT__
131 #define __FUNCT__ "PetscDrawRectangle_X"
132 static PetscErrorCode PetscDrawRectangle_X(PetscDraw draw,PetscReal xl,PetscReal yl,PetscReal xr,PetscReal yr,int c1,int c2,int c3,int c4)
133 {
134   PetscDraw_X *XiWin = (PetscDraw_X*)draw->data;
135   int         x1,y_1,w,h,c = (c1 + c2 + c3 + c4)/4;
136 
137   PetscFunctionBegin;
138   PetscDrawXiSetColor(XiWin,c);
139   x1  = XTRANS(draw,XiWin,xl);   w  = XTRANS(draw,XiWin,xr) - x1;
140   y_1 = YTRANS(draw,XiWin,yr);   h  = YTRANS(draw,XiWin,yl) - y_1;
141   if (w <= 0) w = 1;
142   if (h <= 0) h = 1;
143   XFillRectangle(XiWin->disp,PetscDrawXiDrawable(XiWin),XiWin->gc.set,x1,y_1,w,h);
144   PetscFunctionReturn(0);
145 }
146 
147 #undef __FUNCT__
148 #define __FUNCT__ "PetscDrawEllipse_X"
149 static PetscErrorCode PetscDrawEllipse_X(PetscDraw Win,PetscReal x,PetscReal y,PetscReal a,PetscReal b,int c)
150 {
151   PetscDraw_X *XiWin = (PetscDraw_X*) Win->data;
152   int         xA,yA,w,h;
153 
154   PetscFunctionBegin;
155   PetscDrawXiSetColor(XiWin, c);
156   xA = XTRANS(Win, XiWin, x - a/2.0); w = XTRANS(Win, XiWin, x + a/2.0) - xA;
157   yA = YTRANS(Win, XiWin, y + b/2.0); h = PetscAbs(YTRANS(Win, XiWin, y - b/2.0) - yA);
158   XFillArc(XiWin->disp, PetscDrawXiDrawable(XiWin), XiWin->gc.set, xA, yA, w, h, 0, 23040);
159   PetscFunctionReturn(0);
160 }
161 
162 PETSC_INTERN PetscErrorCode PetscDrawInterpolatedTriangle_X(PetscDraw_X*,int,int,int,int,int,int,int,int,int);
163 
164 #undef __FUNCT__
165 #define __FUNCT__ "PetscDrawTriangle_X"
166 static PetscErrorCode PetscDrawTriangle_X(PetscDraw draw,PetscReal X1,PetscReal Y_1,PetscReal X2,PetscReal Y2,PetscReal X3,PetscReal Y3,int c1,int c2,int c3)
167 {
168   PetscDraw_X    *XiWin = (PetscDraw_X*)draw->data;
169   PetscErrorCode ierr;
170 
171   PetscFunctionBegin;
172   if (c1 == c2 && c2 == c3) {
173     XPoint pt[3];
174     PetscDrawXiSetColor(XiWin,c1);
175     pt[0].x = XTRANS(draw,XiWin,X1);
176     pt[0].y = YTRANS(draw,XiWin,Y_1);
177     pt[1].x = XTRANS(draw,XiWin,X2);
178     pt[1].y = YTRANS(draw,XiWin,Y2);
179     pt[2].x = XTRANS(draw,XiWin,X3);
180     pt[2].y = YTRANS(draw,XiWin,Y3);
181     XFillPolygon(XiWin->disp,PetscDrawXiDrawable(XiWin),XiWin->gc.set,pt,3,Convex,CoordModeOrigin);
182   } else {
183     int x1,y_1,x2,y2,x3,y3;
184     x1   = XTRANS(draw,XiWin,X1);
185     y_1  = YTRANS(draw,XiWin,Y_1);
186     x2   = XTRANS(draw,XiWin,X2);
187     y2   = YTRANS(draw,XiWin,Y2);
188     x3   = XTRANS(draw,XiWin,X3);
189     y3   = YTRANS(draw,XiWin,Y3);
190     ierr = PetscDrawInterpolatedTriangle_X(XiWin,x1,y_1,c1,x2,y2,c2,x3,y3,c3);CHKERRQ(ierr);
191   }
192   PetscFunctionReturn(0);
193 }
194 
195 #undef __FUNCT__
196 #define __FUNCT__ "PetscDrawStringSetSize_X"
197 static PetscErrorCode PetscDrawStringSetSize_X(PetscDraw draw,PetscReal x,PetscReal y)
198 {
199   PetscDraw_X    *XiWin = (PetscDraw_X*)draw->data;
200   int            w,h;
201   PetscErrorCode ierr;
202 
203   PetscFunctionBegin;
204   w    = (int)((XiWin->w)*x*(draw->port_xr - draw->port_xl)/(draw->coor_xr - draw->coor_xl));
205   h    = (int)((XiWin->h)*y*(draw->port_yr - draw->port_yl)/(draw->coor_yr - draw->coor_yl));
206   ierr = PetscFree(XiWin->font);CHKERRQ(ierr);
207   ierr = PetscDrawXiFontFixed(XiWin,w,h,&XiWin->font);CHKERRQ(ierr);
208   PetscFunctionReturn(0);
209 }
210 
211 #undef __FUNCT__
212 #define __FUNCT__ "PetscDrawStringGetSize_X"
213 static PetscErrorCode PetscDrawStringGetSize_X(PetscDraw draw,PetscReal *x,PetscReal  *y)
214 {
215   PetscDraw_X *XiWin = (PetscDraw_X*)draw->data;
216   PetscReal   w,h;
217 
218   PetscFunctionBegin;
219   w = XiWin->font->font_w; h = XiWin->font->font_h;
220   if (x) *x = w*(draw->coor_xr - draw->coor_xl)/((XiWin->w)*(draw->port_xr - draw->port_xl));
221   if (y) *y = h*(draw->coor_yr - draw->coor_yl)/((XiWin->h)*(draw->port_yr - draw->port_yl));
222   PetscFunctionReturn(0);
223 }
224 
225 #undef __FUNCT__
226 #define __FUNCT__ "PetscDrawString_X"
227 static PetscErrorCode PetscDrawString_X(PetscDraw draw,PetscReal x,PetscReal y,int c,const char chrs[])
228 {
229   PetscDraw_X    *XiWin = (PetscDraw_X*)draw->data;
230   int            xx,yy;
231   size_t         len;
232   char           *substr;
233   PetscToken     token;
234   PetscErrorCode ierr;
235 
236   PetscFunctionBegin;
237   xx = XTRANS(draw,XiWin,x);
238   yy = YTRANS(draw,XiWin,y);
239   PetscDrawXiSetColor(XiWin,c);
240 
241   ierr = PetscTokenCreate(chrs,'\n',&token);CHKERRQ(ierr);
242   ierr = PetscTokenFind(token,&substr);CHKERRQ(ierr);
243   ierr = PetscStrlen(substr,&len);CHKERRQ(ierr);
244   XDrawString(XiWin->disp,PetscDrawXiDrawable(XiWin),XiWin->gc.set,xx,yy - XiWin->font->font_descent,substr,len);
245   ierr = PetscTokenFind(token,&substr);CHKERRQ(ierr);
246   while (substr) {
247     yy  += 4*XiWin->font->font_descent;
248     ierr = PetscStrlen(substr,&len);CHKERRQ(ierr);
249     XDrawString(XiWin->disp,PetscDrawXiDrawable(XiWin),XiWin->gc.set,xx,yy - XiWin->font->font_descent,substr,len);
250     ierr = PetscTokenFind(token,&substr);CHKERRQ(ierr);
251   }
252   ierr = PetscTokenDestroy(&token);CHKERRQ(ierr);
253   PetscFunctionReturn(0);
254 }
255 
256 #undef __FUNCT__
257 #define __FUNCT__ "PetscDrawStringVertical_X"
258 static PetscErrorCode PetscDrawStringVertical_X(PetscDraw draw,PetscReal x,PetscReal y,int c,const char chrs[])
259 {
260   PetscDraw_X    *XiWin = (PetscDraw_X*)draw->data;
261   int            xx,yy;
262   char           tmp[2];
263   PetscReal      tw,th;
264   size_t         i,n;
265   PetscErrorCode ierr;
266 
267   PetscFunctionBegin;
268   ierr   = PetscStrlen(chrs,&n);CHKERRQ(ierr);
269   tmp[1] = 0;
270   PetscDrawXiSetColor(XiWin,c);
271   ierr = PetscDrawStringGetSize_X(draw,&tw,&th);CHKERRQ(ierr);
272   xx   = XTRANS(draw,XiWin,x);
273   for (i=0; i<n; i++) {
274     tmp[0] = chrs[i];
275     yy     = YTRANS(draw,XiWin,y-th*i);
276     XDrawString(XiWin->disp,PetscDrawXiDrawable(XiWin),XiWin->gc.set, xx,yy - XiWin->font->font_descent,tmp,1);
277   }
278   PetscFunctionReturn(0);
279 }
280 
281 #undef __FUNCT__
282 #define __FUNCT__ "PetscDrawFlush_X"
283 static PetscErrorCode PetscDrawFlush_X(PetscDraw draw)
284 {
285   PetscDraw_X    *XiWin = (PetscDraw_X*)draw->data;
286   PetscMPIInt    rank;
287   PetscErrorCode ierr;
288 
289   PetscFunctionBegin;
290   ierr = MPI_Comm_rank(PetscObjectComm((PetscObject)draw),&rank);CHKERRQ(ierr);
291 
292   ierr = PetscDrawCollectiveBegin(draw);CHKERRQ(ierr);
293   XSync(XiWin->disp,False);
294   ierr = PetscDrawCollectiveEnd(draw);CHKERRQ(ierr);
295   ierr = MPI_Barrier(PetscObjectComm((PetscObject)draw));CHKERRQ(ierr);
296 
297   ierr = PetscDrawCollectiveBegin(draw);CHKERRQ(ierr);
298   if (!rank && XiWin->drw && XiWin->win) {
299     XCopyArea(XiWin->disp,XiWin->drw,XiWin->win,XiWin->gc.set,0,0,XiWin->w,XiWin->h,0,0);
300     XSync(XiWin->disp,False);
301   }
302   ierr = PetscDrawCollectiveEnd(draw);CHKERRQ(ierr);
303   ierr = MPI_Barrier(PetscObjectComm((PetscObject)draw));CHKERRQ(ierr);
304 
305   ierr = PetscDrawSave(draw);CHKERRQ(ierr);
306   PetscFunctionReturn(0);
307 }
308 
309 #undef __FUNCT__
310 #define __FUNCT__ "PetscDrawClear_X"
311 static PetscErrorCode PetscDrawClear_X(PetscDraw draw)
312 {
313   PetscDraw_X    *XiWin = (PetscDraw_X*)draw->data;
314   PetscMPIInt    rank;
315   PetscErrorCode ierr;
316 
317   PetscFunctionBegin;
318   ierr = MPI_Comm_rank(PetscObjectComm((PetscObject)draw),&rank);CHKERRQ(ierr);
319 
320   ierr = PetscDrawCollectiveBegin(draw);CHKERRQ(ierr);
321   XSync(XiWin->disp,False);
322   ierr = PetscDrawCollectiveEnd(draw);CHKERRQ(ierr);
323   ierr = MPI_Barrier(PetscObjectComm((PetscObject)draw));CHKERRQ(ierr);
324 
325   ierr = PetscDrawCollectiveBegin(draw);CHKERRQ(ierr);
326   if (!rank) {
327     int x = (int)(draw->port_xl*XiWin->w);
328     int y = (int)((1-draw->port_yr)*XiWin->h);
329     int w = (int)((draw->port_xr - draw->port_xl)*XiWin->w);
330     int h = (int)((draw->port_yr - draw->port_yl)*XiWin->h);
331     PetscDrawXiSetPixVal(XiWin,XiWin->background);
332     XFillRectangle(XiWin->disp,PetscDrawXiDrawable(XiWin),XiWin->gc.set,x,y,w,h);
333     XSync(XiWin->disp,False);
334   }
335   ierr = PetscDrawCollectiveEnd(draw);CHKERRQ(ierr);
336   ierr = MPI_Barrier(PetscObjectComm((PetscObject)draw));CHKERRQ(ierr);
337   PetscFunctionReturn(0);
338 }
339 
340 #undef __FUNCT__
341 #define __FUNCT__ "PetscDrawSetDoubleBuffer_X"
342 static PetscErrorCode PetscDrawSetDoubleBuffer_X(PetscDraw draw)
343 {
344   PetscDraw_X    *win = (PetscDraw_X*)draw->data;
345   PetscMPIInt    rank;
346   PetscErrorCode ierr;
347 
348   PetscFunctionBegin;
349   if (win->drw) PetscFunctionReturn(0);
350   ierr = MPI_Comm_rank(PetscObjectComm((PetscObject)draw),&rank);CHKERRQ(ierr);
351 
352   ierr = PetscDrawCollectiveBegin(draw);CHKERRQ(ierr);
353   if (!rank) {ierr = PetscDrawXiQuickPixmap(win);CHKERRQ(ierr);}
354   ierr = PetscDrawCollectiveEnd(draw);CHKERRQ(ierr);
355   ierr = MPI_Bcast(&win->drw,1,MPI_UNSIGNED_LONG,0,PetscObjectComm((PetscObject)draw));CHKERRQ(ierr);
356   PetscFunctionReturn(0);
357 }
358 
359 #undef __FUNCT__
360 #define __FUNCT__ "PetscDrawGetPopup_X"
361 static PetscErrorCode PetscDrawGetPopup_X(PetscDraw draw,PetscDraw *popup)
362 {
363   PetscDraw_X    *win = (PetscDraw_X*)draw->data;
364   PetscBool      flg  = PETSC_TRUE;
365   PetscErrorCode ierr;
366 
367   PetscFunctionBegin;
368   ierr = PetscOptionsGetBool(((PetscObject)draw)->options,((PetscObject)draw)->prefix,"-draw_popup",&flg,NULL);CHKERRQ(ierr);
369   if (!flg || !win->win) {*popup = NULL; PetscFunctionReturn(0);}
370 
371   ierr = PetscDrawCreate(PetscObjectComm((PetscObject)draw),draw->display,NULL,win->x,win->y+win->h+36,220,220,popup);CHKERRQ(ierr);
372   ierr = PetscObjectSetOptionsPrefix((PetscObject)*popup,"popup_");CHKERRQ(ierr);
373   ierr = PetscObjectAppendOptionsPrefix((PetscObject)*popup,((PetscObject)draw)->prefix);CHKERRQ(ierr);
374   ierr = PetscDrawSetType(*popup,PETSC_DRAW_X);CHKERRQ(ierr);
375   draw->popup = *popup;
376   PetscFunctionReturn(0);
377 }
378 
379 #undef __FUNCT__
380 #define __FUNCT__ "PetscDrawSetTitle_X"
381 static PetscErrorCode PetscDrawSetTitle_X(PetscDraw draw,const char title[])
382 {
383   PetscDraw_X    *win = (PetscDraw_X*)draw->data;
384   PetscMPIInt    rank;
385   PetscErrorCode ierr;
386 
387   PetscFunctionBegin;
388   if (!win->win) PetscFunctionReturn(0);
389   ierr = MPI_Comm_rank(PetscObjectComm((PetscObject)draw),&rank);CHKERRQ(ierr);
390   ierr = PetscDrawCollectiveBegin(draw);CHKERRQ(ierr);
391   if (!rank) {
392     size_t        len;
393     XTextProperty prop;
394     ierr = PetscStrlen(title,&len);CHKERRQ(ierr);
395     XGetWMName(win->disp,win->win,&prop);
396     XFree((void*)prop.value);
397     prop.value  = (unsigned char*)title;
398     prop.nitems = (long)len;
399     XSetWMName(win->disp,win->win,&prop);
400   }
401   ierr = PetscDrawCollectiveEnd(draw);CHKERRQ(ierr);
402   PetscFunctionReturn(0);
403 }
404 
405 #undef __FUNCT__
406 #define __FUNCT__ "PetscDrawCheckResizedWindow_X"
407 static PetscErrorCode PetscDrawCheckResizedWindow_X(PetscDraw draw)
408 {
409   PetscDraw_X    *win = (PetscDraw_X*)draw->data;
410   int            xywh[4];
411   PetscMPIInt    rank;
412   PetscErrorCode ierr;
413 
414   PetscFunctionBegin;
415   if (!win->win) PetscFunctionReturn(0);
416   ierr = MPI_Comm_rank(PetscObjectComm((PetscObject)draw),&rank);CHKERRQ(ierr);
417 
418   ierr = PetscDrawCollectiveBegin(draw);CHKERRQ(ierr);
419   if (!rank) {
420     Window       root;
421     int          x,y;
422     unsigned int w,h,border,depth;
423     XGetGeometry(win->disp,win->win,&root,&x,&y,&w,&h,&border,&depth);
424     xywh[0] = x; xywh[1] = y; xywh[2] = (int)w; xywh[3] = (int)h;
425   }
426   ierr = PetscDrawCollectiveEnd(draw);CHKERRQ(ierr);
427 
428   ierr = MPI_Bcast(xywh,4,MPI_INT,0,PetscObjectComm((PetscObject)draw));CHKERRQ(ierr);
429   /* record new window position */
430   draw->x = win->x = xywh[0];
431   draw->y = win->y = xywh[1];
432   if (xywh[2] == win->w && xywh[3] == win->h) PetscFunctionReturn(0);
433   /* record new window sizes */
434   draw->w = win->w = xywh[2];
435   draw->h = win->h = xywh[3];
436 
437   /* recreate pixmap (only first processor does this) */
438   ierr = PetscDrawCollectiveBegin(draw);CHKERRQ(ierr);
439   if (!rank && win->drw) {ierr = PetscDrawXiQuickPixmap(win);CHKERRQ(ierr);}
440   ierr = PetscDrawCollectiveEnd(draw);CHKERRQ(ierr);
441   ierr = MPI_Bcast(&win->drw,1,MPI_UNSIGNED_LONG,0,PetscObjectComm((PetscObject)draw));CHKERRQ(ierr);
442 
443   /* reset the clipping */
444   ierr = PetscDrawSetViewport_X(draw,draw->port_xl,draw->port_yl,draw->port_xr,draw->port_yr);CHKERRQ(ierr);
445   PetscFunctionReturn(0);
446 }
447 
448 #undef __FUNCT__
449 #define __FUNCT__ "PetscDrawResizeWindow_X"
450 static PetscErrorCode PetscDrawResizeWindow_X(PetscDraw draw,int w,int h)
451 {
452   PetscDraw_X    *win = (PetscDraw_X*)draw->data;
453   PetscMPIInt    rank;
454   PetscErrorCode ierr;
455 
456   PetscFunctionBegin;
457   if (w == win->w && h == win->h) PetscFunctionReturn(0);
458   ierr = MPI_Comm_rank(PetscObjectComm((PetscObject)draw),&rank);CHKERRQ(ierr);
459 
460   if (win->win) {
461     ierr = PetscDrawCollectiveBegin(draw);CHKERRQ(ierr);
462     if (!rank) XResizeWindow(win->disp,win->win,(unsigned int)w,(unsigned int)h);
463     ierr = PetscDrawCollectiveEnd(draw);CHKERRQ(ierr);
464     ierr = PetscDrawCheckResizedWindow_X(draw);CHKERRQ(ierr);
465   } else if (win->drw) {
466     draw->w = win->w = w; draw->h = win->h = h;
467     /* recreate pixmap (only first processor does this) */
468     ierr = PetscDrawCollectiveBegin(draw);CHKERRQ(ierr);
469     if (!rank) {ierr = PetscDrawXiQuickPixmap(win);CHKERRQ(ierr);}
470     ierr = MPI_Bcast(&win->drw,1,MPI_UNSIGNED_LONG,0,PetscObjectComm((PetscObject)draw));CHKERRQ(ierr);
471     /* reset the clipping */
472     ierr = PetscDrawCollectiveEnd(draw);CHKERRQ(ierr);
473     ierr = PetscDrawSetViewport_X(draw,draw->port_xl,draw->port_yl,draw->port_xr,draw->port_yr);CHKERRQ(ierr);
474   }
475   PetscFunctionReturn(0);
476 }
477 
478 #include <X11/cursorfont.h>
479 
480 #undef __FUNCT__
481 #define __FUNCT__ "PetscDrawGetMouseButton_X"
482 static PetscErrorCode PetscDrawGetMouseButton_X(PetscDraw draw,PetscDrawButton *button,PetscReal *x_user,PetscReal *y_user,PetscReal *x_phys,PetscReal *y_phys)
483 {
484   PetscDraw_X    *win = (PetscDraw_X*)draw->data;
485   Cursor         cursor;
486   XEvent         report;
487   Window         root,child;
488   int            root_x,root_y,px=0,py=0;
489   unsigned int   w,h,border,depth;
490   unsigned int   keys_button;
491   PetscMPIInt    rank;
492   PetscReal      xx,yy;
493   PetscErrorCode ierr;
494 
495   PetscFunctionBegin;
496   *button = PETSC_BUTTON_NONE;
497   if (!win->win) PetscFunctionReturn(0);
498   ierr = MPI_Comm_rank(PetscObjectComm((PetscObject)draw),&rank);CHKERRQ(ierr);
499 
500   ierr = PetscDrawCollectiveBegin(draw);CHKERRQ(ierr);
501   if (rank) goto finally;
502 
503   /* change cursor to indicate input */
504   cursor = XCreateFontCursor(win->disp,XC_hand2); if (!cursor) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_LIB,"Unable to create X cursor");
505   XDefineCursor(win->disp,win->win,cursor);
506   /* wait for mouse button events */
507   XSelectInput(win->disp,win->win,ButtonPressMask|ButtonReleaseMask);
508   while (XCheckTypedEvent(win->disp,ButtonPress,&report));
509   XMaskEvent(win->disp,ButtonReleaseMask,&report);
510   /* get mouse pointer coordinates */
511   XQueryPointer(win->disp,report.xmotion.window,&root,&child,&root_x,&root_y,&px,&py,&keys_button);
512   /* the user may resize the window before pressing the mouse button */
513   XGetGeometry(win->disp,win->win,&root,&root_x,&root_y,&w,&h,&border,&depth);
514   /* cleanup input event handler and cursor  */
515   XSelectInput(win->disp,win->win,NoEventMask);
516   XUndefineCursor(win->disp,win->win);
517   XFreeCursor(win->disp, cursor);
518   XSync(win->disp,False);
519 
520   switch (report.xbutton.button) {
521   case Button1: *button = PETSC_BUTTON_LEFT; break;
522   case Button2: *button = PETSC_BUTTON_CENTER; break;
523   case Button3: *button = PETSC_BUTTON_RIGHT; break;
524   case Button4: *button = PETSC_BUTTON_WHEEL_UP; break;
525   case Button5: *button = PETSC_BUTTON_WHEEL_DOWN; break;
526   }
527   if (report.xbutton.state & ShiftMask) {
528     switch (report.xbutton.button) {
529     case Button1: *button = PETSC_BUTTON_LEFT_SHIFT; break;
530     case Button2: *button = PETSC_BUTTON_CENTER_SHIFT; break;
531     case Button3: *button = PETSC_BUTTON_RIGHT_SHIFT; break;
532     }
533   }
534   xx = ((PetscReal)px)/w;
535   yy = 1 - ((PetscReal)py)/h;
536   if (x_user) *x_user = draw->coor_xl + (xx - draw->port_xl)*(draw->coor_xr - draw->coor_xl)/(draw->port_xr - draw->port_xl);
537   if (y_user) *y_user = draw->coor_yl + (yy - draw->port_yl)*(draw->coor_yr - draw->coor_yl)/(draw->port_yr - draw->port_yl);
538   if (x_phys) *x_phys = xx;
539   if (y_phys) *y_phys = yy;
540 
541 finally:
542   ierr = PetscDrawCollectiveEnd(draw);CHKERRQ(ierr);
543   ierr = PetscDrawCheckResizedWindow_X(draw);CHKERRQ(ierr);
544   PetscFunctionReturn(0);
545 }
546 
547 #undef __FUNCT__
548 #define __FUNCT__ "PetscDrawPause_X"
549 static PetscErrorCode PetscDrawPause_X(PetscDraw draw)
550 {
551   PetscDraw_X    *win = (PetscDraw_X*)draw->data;
552   PetscErrorCode ierr;
553 
554   PetscFunctionBegin;
555   if (!win->win) PetscFunctionReturn(0);
556   if (draw->pause > 0) PetscSleep(draw->pause);
557   else if (draw->pause == -1) {
558     PetscDrawButton button = PETSC_BUTTON_NONE;
559     ierr = PetscDrawGetMouseButton(draw,&button,NULL,NULL,NULL,NULL);CHKERRQ(ierr);
560     if (button == PETSC_BUTTON_CENTER) draw->pause = 0;
561   }
562   PetscFunctionReturn(0);
563 }
564 
565 #undef __FUNCT__
566 #define __FUNCT__ "PetscDrawDestroy_X"
567 static PetscErrorCode PetscDrawDestroy_X(PetscDraw draw)
568 {
569   PetscDraw_X    *win = (PetscDraw_X*)draw->data;
570   PetscErrorCode ierr;
571 
572   PetscFunctionBegin;
573   ierr = PetscDrawDestroy(&draw->popup);CHKERRQ(ierr);
574   ierr = PetscDrawXiClose(win);CHKERRQ(ierr);
575   ierr = PetscFree(draw->data);CHKERRQ(ierr);
576   PetscFunctionReturn(0);
577 }
578 
579 static       PetscErrorCode PetscDrawGetSingleton_X(PetscDraw,PetscDraw*);
580 static       PetscErrorCode PetscDrawRestoreSingleton_X(PetscDraw,PetscDraw*);
581 PETSC_INTERN PetscErrorCode PetscDrawSave_X(PetscDraw);
582 PETSC_INTERN PetscErrorCode PetscDrawSetSave_X(PetscDraw,const char[]);
583 
584 static struct _PetscDrawOps DvOps = { PetscDrawSetDoubleBuffer_X,
585                                       PetscDrawFlush_X,
586                                       PetscDrawLine_X,
587                                       0,
588                                       0,
589                                       PetscDrawPoint_X,
590                                       0,
591                                       PetscDrawString_X,
592                                       PetscDrawStringVertical_X,
593                                       PetscDrawStringSetSize_X,
594                                       PetscDrawStringGetSize_X,
595                                       PetscDrawSetViewport_X,
596                                       PetscDrawClear_X,
597                                       PetscDrawRectangle_X,
598                                       PetscDrawTriangle_X,
599                                       PetscDrawEllipse_X,
600                                       PetscDrawGetMouseButton_X,
601                                       PetscDrawPause_X,
602                                       0,
603                                       0,
604                                       PetscDrawGetPopup_X,
605                                       PetscDrawSetTitle_X,
606                                       PetscDrawCheckResizedWindow_X,
607                                       PetscDrawResizeWindow_X,
608                                       PetscDrawDestroy_X,
609                                       0,
610                                       PetscDrawGetSingleton_X,
611                                       PetscDrawRestoreSingleton_X,
612                                       PetscDrawSave_X,
613                                       PetscDrawSetSave_X,
614                                       0,
615                                       PetscDrawArrow_X,
616                                       PetscDrawCoordinateToPixel_X,
617                                       PetscDrawPixelToCoordinate_X,
618                                       PetscDrawPointPixel_X,
619                                       0};
620 
621 
622 #undef __FUNCT__
623 #define __FUNCT__ "PetscDrawGetSingleton_X"
624 static PetscErrorCode PetscDrawGetSingleton_X(PetscDraw draw,PetscDraw *sdraw)
625 {
626   PetscDraw_X    *Xwin = (PetscDraw_X*)draw->data,*sXwin;
627   PetscErrorCode ierr;
628 
629   PetscFunctionBegin;
630   ierr = PetscDrawCreate(PETSC_COMM_SELF,draw->display,draw->title,draw->x,draw->y,draw->w,draw->h,sdraw);CHKERRQ(ierr);
631   ierr = PetscObjectChangeTypeName((PetscObject)*sdraw,PETSC_DRAW_X);CHKERRQ(ierr);
632   ierr = PetscMemcpy((*sdraw)->ops,&DvOps,sizeof(DvOps));CHKERRQ(ierr);
633 
634   if (draw->popup) {
635     PetscBool isnull;
636     ierr = PetscDrawIsNull(draw->popup,&isnull);CHKERRQ(ierr);
637     if (isnull) {ierr = PetscDrawOpenNull(PETSC_COMM_SELF,&(*sdraw)->popup);CHKERRQ(ierr);}
638     else        {ierr = PetscDrawGetSingleton(draw->popup,&(*sdraw)->popup);CHKERRQ(ierr);}
639   }
640 
641   (*sdraw)->pause   = draw->pause;
642   (*sdraw)->coor_xl = draw->coor_xl;
643   (*sdraw)->coor_xr = draw->coor_xr;
644   (*sdraw)->coor_yl = draw->coor_yl;
645   (*sdraw)->coor_yr = draw->coor_yr;
646   (*sdraw)->port_xl = draw->port_xl;
647   (*sdraw)->port_xr = draw->port_xr;
648   (*sdraw)->port_yl = draw->port_yl;
649   (*sdraw)->port_yr = draw->port_yr;
650 
651   /* share drawables (windows and/or pixmap) from the parent draw */
652   ierr = PetscNewLog(*sdraw,&sXwin);CHKERRQ(ierr);
653   (*sdraw)->data = (void*)sXwin;
654   ierr = PetscDrawXiInit(sXwin,draw->display);CHKERRQ(ierr);
655   if (Xwin->win) {
656     ierr = PetscDrawXiQuickWindowFromWindow(sXwin,Xwin->win);CHKERRQ(ierr);
657     sXwin->drw = Xwin->drw; /* XXX If the window is ever resized, this is wrong! */
658   } else if (Xwin->drw) {
659     ierr = PetscDrawXiColormap(sXwin);CHKERRQ(ierr);
660     sXwin->drw = Xwin->drw;
661   }
662   (*sdraw)->x = sXwin->x; (*sdraw)->y = sXwin->y;
663   (*sdraw)->w = sXwin->w; (*sdraw)->h = sXwin->h;
664   PetscFunctionReturn(0);
665 }
666 
667 #undef __FUNCT__
668 #define __FUNCT__ "PetscDrawRestoreSingleton_X"
669 static PetscErrorCode PetscDrawRestoreSingleton_X(PetscDraw draw,PetscDraw *sdraw)
670 {
671   PetscErrorCode ierr;
672 
673   PetscFunctionBegin;
674   if (draw->popup && (*sdraw)->popup) {
675     PetscBool isdrawx;
676     PetscDraw_X *pXwin = (PetscDraw_X*)draw->popup->data;
677     PetscDraw_X *sXwin = (PetscDraw_X*)(*sdraw)->popup->data;
678     ierr = PetscObjectTypeCompare((PetscObject)draw->popup,PETSC_DRAW_X,&isdrawx);CHKERRQ(ierr);
679     if (!isdrawx) goto finally;
680     ierr = PetscObjectTypeCompare((PetscObject)(*sdraw)->popup,PETSC_DRAW_X,&isdrawx);CHKERRQ(ierr);
681     if (!isdrawx) goto finally;
682     if (sXwin->win == pXwin->win) {
683       ierr = PetscDrawRestoreSingleton(draw->popup,&(*sdraw)->popup);CHKERRQ(ierr);
684     }
685   }
686 finally:
687   ierr = PetscDrawDestroy(sdraw);CHKERRQ(ierr);
688   PetscFunctionReturn(0);
689 }
690 
691 #undef __FUNCT__
692 #define __FUNCT__ "PetscDrawXGetDisplaySize_Private"
693 static PetscErrorCode PetscDrawXGetDisplaySize_Private(const char name[],int *width,int *height)
694 {
695   Display *display;
696 
697   PetscFunctionBegin;
698   display = XOpenDisplay(name);
699   if (!display) {
700     *width  = *height = 0;
701     SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_LIB,"Unable to open display on %s\n\
702     Make sure your COMPUTE NODES are authorized to connect\n\
703     to this X server and either your DISPLAY variable\n\
704     is set or you use the -display name option\n",name);
705   }
706   *width  = (int)DisplayWidth(display,DefaultScreen(display));
707   *height = (int)DisplayHeight(display,DefaultScreen(display));
708   XCloseDisplay(display);
709   PetscFunctionReturn(0);
710 }
711 
712 /*MC
713      PETSC_DRAW_X  - PETSc graphics device that uses either X windows or its virtual version Xvfb
714 
715    Options Database Keys:
716 +  -display <display> - sets the display to use
717 .  -x_virtual - forces use of a X virtual display Xvfb that will not display anything but -draw_save will still work.
718                 Xvfb is automatically started up in PetscSetDisplay() with this option
719 .  -draw_size w,h - percentage of screeen (either 1, .5, .3, .25), or size in pixels
720 .  -geometry x,y,w,h - set location and size in pixels
721 .  -draw_virtual - do not open a window (draw on a pixmap), -draw_save will still work
722 -  -draw_double_buffer - avoid window flickering (draw on pixmap and flush to window)
723 
724    Level: beginner
725 
726 .seealso:  PetscDrawOpenX(), PetscDrawSetDisplay(), PetscDrawSetFromOptions()
727 
728 M*/
729 
730 #undef __FUNCT__
731 #define __FUNCT__ "PetscDrawCreate_X"
732 PETSC_EXTERN PetscErrorCode PetscDrawCreate_X(PetscDraw draw)
733 {
734   PetscDraw_X    *Xwin;
735   PetscErrorCode ierr;
736   PetscMPIInt    rank;
737   int            x = draw->x,y = draw->y,w = draw->w,h = draw->h;
738   static int     xavailable = 0,yavailable = 0,ybottom = 0,xmax = 0,ymax = 0;
739   PetscBool      set,dvirtual = PETSC_FALSE,doublebuffer = PETSC_TRUE;
740   PetscInt       xywh[4],osize = 4,nsizes=2;
741   PetscReal      sizes[2] = {.3,.3};
742 
743   PetscFunctionBegin;
744   /* get the display variable */
745   if (!draw->display) {
746     ierr = PetscMalloc1(256,&draw->display);CHKERRQ(ierr);
747     ierr = PetscGetDisplay(draw->display,256);CHKERRQ(ierr);
748   }
749 
750   /* initialize the display size */
751   if (!xmax) {
752     ierr = PetscDrawXGetDisplaySize_Private(draw->display,&xmax,&ymax);
753     /* if some processors fail on this and others succed then this is a problem ! */
754     if (ierr) {
755       (*PetscErrorPrintf)("PETSc unable to use X windows\nproceeding without graphics\n");
756       ierr = PetscDrawSetType(draw,PETSC_DRAW_NULL);CHKERRQ(ierr);
757       PetscFunctionReturn(0);
758     }
759   }
760 
761   /* allow user to set size of drawable */
762   ierr = PetscOptionsGetRealArray(((PetscObject)draw)->options,((PetscObject)draw)->prefix,"-draw_size",sizes,&nsizes,&set);CHKERRQ(ierr);
763   if (set && nsizes == 1 && sizes[0] > 1.0) sizes[1] = sizes[0];
764   if (set) {
765     if (sizes[0] > 1.0)       w = (int)sizes[0];
766     else if (sizes[0] == 1.0) w = PETSC_DRAW_FULL_SIZE;
767     else if (sizes[0] == .5)  w = PETSC_DRAW_HALF_SIZE;
768     else if (sizes[0] == .3)  w = PETSC_DRAW_THIRD_SIZE;
769     else if (sizes[0] == .25) w = PETSC_DRAW_QUARTER_SIZE;
770     if (sizes[1] > 1.0)       h = (int)sizes[1];
771     else if (sizes[1] == 1.0) h = PETSC_DRAW_FULL_SIZE;
772     else if (sizes[1] == .5)  h = PETSC_DRAW_HALF_SIZE;
773     else if (sizes[1] == .3)  h = PETSC_DRAW_THIRD_SIZE;
774     else if (sizes[1] == .25) h = PETSC_DRAW_QUARTER_SIZE;
775   }
776   if (w == PETSC_DECIDE || w == PETSC_DEFAULT) w = draw->w = 300;
777   if (h == PETSC_DECIDE || h == PETSC_DEFAULT) h = draw->h = 300;
778   switch (w) {
779   case PETSC_DRAW_FULL_SIZE:    w = draw->w = (xmax - 10);   break;
780   case PETSC_DRAW_HALF_SIZE:    w = draw->w = (xmax - 20)/2; break;
781   case PETSC_DRAW_THIRD_SIZE:   w = draw->w = (xmax - 30)/3; break;
782   case PETSC_DRAW_QUARTER_SIZE: w = draw->w = (xmax - 40)/4; break;
783   }
784   switch (h) {
785   case PETSC_DRAW_FULL_SIZE:    h = draw->h = (ymax - 10);   break;
786   case PETSC_DRAW_HALF_SIZE:    h = draw->h = (ymax - 20)/2; break;
787   case PETSC_DRAW_THIRD_SIZE:   h = draw->h = (ymax - 30)/3; break;
788   case PETSC_DRAW_QUARTER_SIZE: h = draw->h = (ymax - 40)/4; break;
789   }
790 
791   ierr = PetscOptionsGetBool(((PetscObject)draw)->options,((PetscObject)draw)->prefix,"-draw_virtual",&dvirtual,NULL);CHKERRQ(ierr);
792 
793   if (!dvirtual) {
794 
795     /* allow user to set location and size of window */
796     xywh[0] = x; xywh[1] = y; xywh[2] = w; xywh[3] = h;
797     ierr = PetscOptionsGetIntArray(((PetscObject)draw)->options,((PetscObject)draw)->prefix,"-geometry",xywh,&osize,NULL);CHKERRQ(ierr);
798     x = (int)xywh[0]; y = (int)xywh[1]; w = (int)xywh[2]; h = (int)xywh[3];
799     if (w == PETSC_DECIDE || w == PETSC_DEFAULT) w = 300;
800     if (h == PETSC_DECIDE || h == PETSC_DEFAULT) h = 300;
801     draw->x = x; draw->y = y; draw->w = w; draw->h = h;
802 
803     if (draw->x == PETSC_DECIDE || draw->y == PETSC_DECIDE) {
804       /*
805        PETSc tries to place windows starting in the upper left corner
806         and moving across to the right.
807 
808        0,0+----------------------------------------------+
809        |  Region used so far  +xavailable,yavailable  |
810        |                      |                       |
811        |                      |                       |
812        +--------------------- +ybottom                |
813        |                                              |
814        |                                              |
815        +----------------------------------------------+xmax,ymax
816 
817        */
818       /*  First: can we add it to the right? */
819       if (xavailable+w+10 <= xmax) {
820         x       = xavailable;
821         y       = yavailable;
822         ybottom = PetscMax(ybottom,y + h + 30);
823       } else {
824         /* No, so add it below on the left */
825         x          = 0;
826         xavailable = 0;
827         y          = ybottom;
828         yavailable = ybottom;
829         ybottom    = ybottom + h + 30;
830       }
831     }
832     /* update available region */
833     xavailable = PetscMax(xavailable,x + w + 10);
834     if (xavailable >= xmax) {
835       xavailable = 0;
836       yavailable = yavailable + h + 30;
837       ybottom    = yavailable;
838     }
839     if (yavailable >= ymax) {
840       y          = 0;
841       yavailable = 0;
842       ybottom    = 0;
843     }
844 
845   } /* endif(!dvirtual) */
846 
847   ierr = MPI_Comm_rank(PetscObjectComm((PetscObject)draw),&rank);CHKERRQ(ierr);
848   if (!rank && (w <= 0 || h <= 0)) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Negative window width or height");
849 
850   ierr = PetscNewLog(draw,&Xwin);CHKERRQ(ierr);
851   ierr = PetscMemcpy(draw->ops,&DvOps,sizeof(DvOps));CHKERRQ(ierr);
852   draw->data = (void*)Xwin;
853 
854   ierr = PetscDrawXiInit(Xwin,draw->display);CHKERRQ(ierr);
855   if (!dvirtual) {
856     Xwin->x = x; Xwin->y = y;
857     Xwin->w = w; Xwin->h = h;
858     if (!rank) {ierr = PetscDrawXiQuickWindow(Xwin,draw->title,x,y,w,h);CHKERRQ(ierr);}
859     ierr = MPI_Bcast(&Xwin->win,1,MPI_UNSIGNED_LONG,0,PetscObjectComm((PetscObject)draw));CHKERRQ(ierr);
860     if (rank) {ierr = PetscDrawXiQuickWindowFromWindow(Xwin,Xwin->win);CHKERRQ(ierr);}
861   } else {
862     Xwin->x = 0; Xwin->y = 0;
863     Xwin->w = w; Xwin->h = h;
864     ierr = PetscDrawXiColormap(Xwin);CHKERRQ(ierr);
865     if (!rank) {ierr = PetscDrawXiQuickPixmap(Xwin);CHKERRQ(ierr);}
866     ierr = MPI_Bcast(&Xwin->drw,1,MPI_UNSIGNED_LONG,0,PetscObjectComm((PetscObject)draw));CHKERRQ(ierr);
867   }
868   draw->x = Xwin->x; draw->y = Xwin->y;
869   draw->w = Xwin->w; draw->h = Xwin->h;
870 
871   ierr = PetscOptionsGetBool(((PetscObject)draw)->options,((PetscObject)draw)->prefix,"-draw_double_buffer",&doublebuffer,NULL);CHKERRQ(ierr);
872   if (doublebuffer) {ierr = PetscDrawSetDoubleBuffer(draw);CHKERRQ(ierr);}
873   PetscFunctionReturn(0);
874 }
875