Logo ROOT   6.30.04
Reference Guide
 All Namespaces Files Pages
TGProgressBar.cxx
Go to the documentation of this file.
1 // @(#)root/gui:$Id$
2 // Author: Fons Rademakers 10/10/2000
3 
4 /*************************************************************************
5  * Copyright (C) 1995-2000, Rene Brun and Fons Rademakers. *
6  * All rights reserved. *
7  * *
8  * For the licensing terms see $ROOTSYS/LICENSE. *
9  * For the list of contributors see $ROOTSYS/README/CREDITS. *
10  *************************************************************************/
11 
12 //////////////////////////////////////////////////////////////////////////
13 // //
14 // TGProgressBar, TGHProgressBar and TGVProgressBar //
15 // //
16 // The classes in this file implement progress bars. Progress bars can //
17 // be used to show progress of tasks taking more then a few seconds. //
18 // TGProgressBar is an abstract base class, use either TGHProgressBar //
19 // or TGVProgressBar. TGHProgressBar can in addition show the position //
20 // as text in the bar. //
21 // //
22 //////////////////////////////////////////////////////////////////////////
23 
24 #include "TGProgressBar.h"
25 #include "TGResourcePool.h"
26 #include "Riostream.h"
27 #include "TColor.h"
28 #include "TGMsgBox.h"
29 
30 
31 const TGFont *TGProgressBar::fgDefaultFont = 0;
32 TGGC *TGProgressBar::fgDefaultGC = 0;
33 
34 
35 ClassImp(TGProgressBar);
36 ClassImp(TGHProgressBar);
37 ClassImp(TGVProgressBar);
38 
39 ////////////////////////////////////////////////////////////////////////////////
40 /// Create progress bar.
41 
42 TGProgressBar::TGProgressBar(const TGWindow *p, UInt_t w, UInt_t h,
43  ULong_t back, ULong_t barcolor, GContext_t norm,
44  FontStruct_t font, UInt_t options) :
45  TGFrame(p, w, h, options | kOwnBackground, back)
46 {
47  fMin = 0;
48  fMax = 100;
49  fPos = 0;
50  fPosPix = 0;
51  fFillType = kSolidFill;
52  fBarType = kStandard;
53  fShowPos = kFALSE;
54  fPercent = kTRUE;
55  fNormGC = norm;
56  fFontStruct = font;
57  fBarColorGC.SetFillStyle(kFillSolid);
58  fBarColorGC.SetForeground(barcolor);
59  fBarWidth = kProgressBarStandardWidth;
60  fDrawBar = kFALSE;
61 }
62 
63 ////////////////////////////////////////////////////////////////////////////////
64 /// Set min and max of progress bar.
65 
66 void TGProgressBar::SetRange(Float_t min, Float_t max)
67 {
68  if (min >= max) {
69  Error("SetRange", "max must be > min");
70  return;
71  }
72 
73  Bool_t draw = kFALSE;
74  if (fPos > fMin) {
75  // already in progress... rescale
76  if (fPos < min) fPos = min;
77  if (fPos > max) fPos = max;
78  draw = kTRUE;
79  } else
80  fPos = min;
81 
82  fMin = min;
83  fMax = max;
84 
85  if (draw)
86  DoRedraw();
87 }
88 
89 ////////////////////////////////////////////////////////////////////////////////
90 /// Set progress position between [min,max].
91 
92 void TGProgressBar::SetPosition(Float_t pos)
93 {
94  if (pos < fMin) pos = fMin;
95  if (pos > fMax) pos = fMax;
96 
97  if (fPos == pos)
98  return;
99 
100  fPos = pos;
101 
102  //fClient->NeedRedraw(this);
103  fDrawBar = kTRUE;
104  DoRedraw();
105 }
106 
107 ////////////////////////////////////////////////////////////////////////////////
108 /// Increment progress position.
109 
110 void TGProgressBar::Increment(Float_t inc)
111 {
112  if (fPos == fMax)
113  return;
114 
115  fPos += inc;
116  if (fPos > fMax) fPos = fMax;
117 
118  //fClient->NeedRedraw(this);
119  fDrawBar = kTRUE;
120  DoRedraw();
121 }
122 
123 ////////////////////////////////////////////////////////////////////////////////
124 /// Reset progress bar (i.e. set pos to 0).
125 
126 void TGProgressBar::Reset()
127 {
128  fPos = 0;
129 
130  fClient->NeedRedraw(this);
131 }
132 
133 ////////////////////////////////////////////////////////////////////////////////
134 /// Set fill type.
135 
136 void TGProgressBar::SetFillType(EFillType type)
137 {
138  fFillType = type;
139 
140  fClient->NeedRedraw(this);
141 }
142 
143 ////////////////////////////////////////////////////////////////////////////////
144 /// Set bar type.
145 
146 void TGProgressBar::SetBarType(EBarType type)
147 {
148  fBarType = type;
149 
150  fClient->NeedRedraw(this);
151 }
152 
153 ////////////////////////////////////////////////////////////////////////////////
154 /// Set progress bar color.
155 
156 void TGProgressBar::SetBarColor(ULong_t color)
157 {
158  fBarColorGC.SetForeground(color);
159 
160  fClient->NeedRedraw(this);
161 }
162 
163 ////////////////////////////////////////////////////////////////////////////////
164 /// Set progress bar color.
165 
166 void TGProgressBar::SetBarColor(const char *color)
167 {
168  ULong_t ic;
169  fClient->GetColorByName(color, ic);
170  fBarColorGC.SetForeground(ic);
171  fClient->NeedRedraw(this);
172 }
173 
174 ////////////////////////////////////////////////////////////////////////////////
175 /// Set format for displaying a value.
176 
177 void TGProgressBar::Format(const char *format)
178 {
179  fFormat = format;
180 
181  fClient->NeedRedraw(this);
182 }
183 
184 ////////////////////////////////////////////////////////////////////////////////
185 /// Return default font structure in use.
186 
187 FontStruct_t TGProgressBar::GetDefaultFontStruct()
188 {
189  if (!fgDefaultFont)
190  fgDefaultFont = gClient->GetResourcePool()->GetDefaultFont();
191  return fgDefaultFont->GetFontStruct();
192 }
193 
194 ////////////////////////////////////////////////////////////////////////////////
195 /// Return default graphics context in use.
196 
197 const TGGC &TGProgressBar::GetDefaultGC()
198 {
199  if (!fgDefaultGC)
200  fgDefaultGC = new TGGC(*gClient->GetResourcePool()->GetFrameGC());
201  return *fgDefaultGC;
202 }
203 
204 ////////////////////////////////////////////////////////////////////////////////
205 /// Change text color drawing.
206 
207 void TGProgressBar::SetForegroundColor(Pixel_t pixel)
208 {
209  TGGC *gc = gClient->GetResourcePool()->GetGCPool()->FindGC(fNormGC);
210 
211  if (!gc) {
212  return;
213  }
214  gc->SetForeground(pixel);
215  fNormGC = gc->GetGC();
216 
217  fClient->NeedRedraw(this);
218 }
219 
220 ////////////////////////////////////////////////////////////////////////////////
221 /// Horizontal progress bar constructor.
222 
223 TGHProgressBar::TGHProgressBar(const TGWindow *p, UInt_t w, UInt_t h,
224  Pixel_t back, Pixel_t barcolor,
225  GContext_t norm, FontStruct_t font, UInt_t options) :
226  TGProgressBar(p, w, h, back, barcolor, norm, font, options)
227 {
228  fBarWidth = h;
229  fEditDisabled = kEditDisableHeight;
230 }
231 
232 ////////////////////////////////////////////////////////////////////////////////
233 /// Simple constructor allow you to create either a standard progress
234 /// bar, or a more fancy progress bar (fancy means: double sized border,
235 /// white background and a bit wider to allow for text to be printed
236 /// in the bar.
237 
238 TGHProgressBar::TGHProgressBar(const TGWindow *p, EBarType type, UInt_t w)
239  : TGProgressBar(p, w, type == kStandard ? kProgressBarStandardWidth :
240  kProgressBarTextWidth, type == kStandard ? GetDefaultFrameBackground() :
241  fgWhitePixel, fgDefaultSelectedBackground, GetDefaultGC()(),
242  GetDefaultFontStruct(),
243  type == kStandard ? kSunkenFrame : kDoubleBorder | kSunkenFrame)
244 {
245  fBarType = type;
246  fBarWidth = (type == kStandard) ? kProgressBarStandardWidth : kProgressBarTextWidth;
247  fEditDisabled = kEditDisableHeight;
248 }
249 
250 ////////////////////////////////////////////////////////////////////////////////
251 /// Show postion text, either in percent or formatted according format.
252 
253 void TGHProgressBar::ShowPosition(Bool_t set, Bool_t percent, const char *format)
254 {
255  fShowPos = set;
256  fPercent = percent;
257  fFormat = format;
258 
259  fClient->NeedRedraw(this);
260 }
261 
262 ////////////////////////////////////////////////////////////////////////////////
263 /// Draw horizontal progress bar.
264 
265 void TGHProgressBar::DoRedraw()
266 {
267  if (!fDrawBar) {
268  // calls TGProgressBar::DrawBorder()
269  TGFrame::DoRedraw();
270  }
271 
272  fPosPix = Int_t(((Float_t)fWidth - (fBorderWidth << 1)) *
273  (fPos - fMin) / (fMax - fMin) +
274  fBorderWidth);
275 
276  Int_t pospix = fPosPix;
277 
278  if (fFillType == kSolidFill)
279  gVirtualX->FillRectangle(fId, fBarColorGC(), fBorderWidth,
280  fBorderWidth, fPosPix - fBorderWidth, fBarWidth -
281  (fBorderWidth << 1));
282  else {
283  Int_t blocksize = kBlockSize;
284  Int_t delta = kBlockSpace;
285  Int_t pos = fBorderWidth;
286  while (pos < fPosPix) {
287  if (pos + blocksize > Int_t(fWidth)-fBorderWidth)
288  blocksize = fWidth-fBorderWidth-pos;
289  gVirtualX->FillRectangle(fId, fBarColorGC(), pos,
290  fBorderWidth, blocksize, fBarWidth -
291  (fBorderWidth << 1));
292  if (fDrawBar && fShowPos)
293  gVirtualX->ClearArea(fId, pos+blocksize, fBorderWidth,
294  delta, fBarWidth - (fBorderWidth << 1));
295 
296  pos += blocksize + delta;
297  }
298  pospix = pos - delta;
299  }
300 
301  if (fShowPos) {
302  TString buf;
303  if (fPercent)
304  buf = TString::Format("%d%%", Int_t((fPos-fMin)/(fMax-fMin)*100.));
305  else
306  buf = TString::Format(fFormat.Data(), fPos);
307 
308  Int_t x, y, max_ascent, max_descent;
309  UInt_t twidth = gVirtualX->TextWidth(fFontStruct, buf.Data(), buf.Length());
310  gVirtualX->GetFontProperties(fFontStruct, max_ascent, max_descent);
311  UInt_t theight = max_ascent + max_descent;
312 
313  x = (fWidth - twidth) >> 1;
314  y = (fHeight - theight) >> 1;
315 
316  if (fDrawBar && fPosPix < Int_t(x+twidth))
317  gVirtualX->ClearArea(fId, pospix, fBorderWidth,
318  fWidth - pospix - fBorderWidth,
319  fBarWidth - (fBorderWidth << 1));
320 
321  gVirtualX->DrawString(fId, fNormGC, x, y + max_ascent, buf.Data(), buf.Length());
322  }
323 
324  fDrawBar = kFALSE;
325 }
326 
327 ////////////////////////////////////////////////////////////////////////////////
328 /// cconstructor
329 
330 TGVProgressBar::TGVProgressBar(const TGWindow *p, UInt_t w, UInt_t h,
331  Pixel_t back, Pixel_t barcolor, GContext_t norm,
332  FontStruct_t font,UInt_t options) :
333  TGProgressBar(p, w, h, back, barcolor, norm, font, options)
334 {
335  fBarWidth = w;
336  fEditDisabled = kEditDisableWidth;
337 }
338 
339 ////////////////////////////////////////////////////////////////////////////////
340 /// Simple constructor allow you to create either a standard progress
341 /// bar, or a more fancy progress bar (fancy means: double sized border,
342 /// white background and a bit wider to allow for text to be printed
343 /// in the bar.
344 
345 TGVProgressBar::TGVProgressBar(const TGWindow *p, EBarType type, UInt_t h)
346  : TGProgressBar(p, type == kStandard ? kProgressBarStandardWidth :
347  kProgressBarTextWidth, h, type == kStandard ? GetDefaultFrameBackground() :
348  fgWhitePixel, fgDefaultSelectedBackground, GetDefaultGC()(),
349  GetDefaultFontStruct(),
350  type == kStandard ? kSunkenFrame : kDoubleBorder | kSunkenFrame)
351 {
352  fBarType = type;
353  fBarWidth = (type == kStandard) ? kProgressBarStandardWidth : kProgressBarTextWidth;
354  fDrawBar = kFALSE;
355  fEditDisabled = kEditDisableWidth;
356 }
357 
358 ////////////////////////////////////////////////////////////////////////////////
359 /// Draw vertical progress bar.
360 
361 void TGVProgressBar::DoRedraw()
362 {
363  if (!fDrawBar) {
364  // calls TGProgressBar::DrawBorder()
365  TGFrame::DoRedraw();
366  }
367 
368  fPosPix = Int_t(((Float_t)fHeight - (fBorderWidth << 1)) *
369  (fPos - fMin) / (fMax - fMin) +
370  fBorderWidth);
371 
372  if (fFillType == kSolidFill)
373  gVirtualX->FillRectangle(fId, fBarColorGC(), fBorderWidth,
374  fHeight - fPosPix, fBarWidth - (fBorderWidth << 1),
375  fPosPix - fBorderWidth);
376  else {
377  Int_t blocksize = kBlockSize;
378  Int_t delta = kBlockSpace;
379  Int_t pos = fBorderWidth;
380  while (pos < fPosPix) {
381  if (pos + blocksize > Int_t(fHeight)-fBorderWidth)
382  blocksize = fHeight-fBorderWidth-pos;
383  gVirtualX->FillRectangle(fId, fBarColorGC(), fBorderWidth,
384  fHeight - pos - blocksize, fBarWidth - (fBorderWidth << 1),
385  blocksize);
386  pos += blocksize + delta;
387  }
388  }
389 
390  if (fShowPos) {
391  // not text shown for vertical progress bars
392  }
393 
394  fDrawBar = kFALSE;
395 }
396 
397 ////////////////////////////////////////////////////////////////////////////////
398 /// Save progress bar parameters as a C++ statement(s) on output stream out.
399 
400 void TGProgressBar::SavePrimitive(std::ostream &out, Option_t *option /*= ""*/)
401 {
402  const char *barcolor;
403  char quote = '"';
404  switch (fBarType) {
405  case kFancy:
406  if (GetOptions() != (kSunkenFrame | kDoubleBorder | kOwnBackground))
407  out << " " << GetName() << "->ChangeOptions(" << GetOptionString()
408  << ");" << std::endl;
409  if (GetBackground() != GetWhitePixel()) {
410  SaveUserColor(out, option);
411  out << " " << GetName() << "->SetBackgroundColor(ucolor);" << std::endl;
412  }
413  break;
414 
415  case kStandard:
416  if (GetOptions() != (kSunkenFrame | kOwnBackground))
417  out << " " << GetName() << "->ChangeOptions(" << GetOptionString()
418  << ");" << std::endl;
419  if (GetBackground() != GetDefaultFrameBackground()) {
420  SaveUserColor(out, option);
421  out << " " << GetName() << "->SetBackgroundColor(ucolor);" << std::endl;
422  }
423  break;
424  }
425 
426  if (fBarColorGC.GetForeground() != GetDefaultSelectedBackground()) {
427  barcolor = TColor::PixelAsHexString(fBarColorGC.GetForeground());
428  out << " " << GetName() <<"->SetBarColor(" << quote << barcolor << quote
429  << ");" << std::endl;
430  }
431 
432  if (fMin != 0 && fMax != 100)
433  out << " " << GetName() << "->SetRange(" << fMin << "," << fMax << ");" << std::endl;
434 
435  out <<" "<< GetName() <<"->SetPosition("<< fPos <<");"<< std::endl;
436 
437 }
438 
439 ////////////////////////////////////////////////////////////////////////////////
440 /// Save a vertical progress bar as a C++ statement(s) on output stream out.
441 
442 void TGVProgressBar::SavePrimitive(std::ostream &out, Option_t *option /*= ""*/)
443 {
444 
445  out << " TGVProgressBar *";
446  out << GetName() << " = new TGVProgressBar(" << fParent->GetName();
447 
448  if ((fBarType == kFancy) && (fBarWidth == kProgressBarTextWidth)) {
449  out << ",TGProgressBar::kFancy";
450  } else if ((fBarType == kStandard) && (fBarWidth == kProgressBarStandardWidth)){
451  out << ",TGProgressBar::kStandard";
452  }
453 
454  out << "," << GetHeight() <<");" << std::endl;
455 
456  if (option && strstr(option, "keep_names"))
457  out << " " << GetName() << "->SetName(\"" << GetName() << "\");" << std::endl;
458 
459  if (GetFillType() == kBlockFill)
460  out << " " << GetName() <<"->SetFillType(TGProgressBar::kBlockFill);"<< std::endl;
461 
462  TGProgressBar::SavePrimitive(out, option);
463 }
464 
465 ////////////////////////////////////////////////////////////////////////////////
466 /// Save a horizontal progress bar as a C++ statement(s) on output stream out
467 
468 void TGHProgressBar::SavePrimitive(std::ostream &out, Option_t *option /*= ""*/)
469 {
470  char quote = '"';
471 
472  out <<" TGHProgressBar *";
473  out << GetName() <<" = new TGHProgressBar("<< fParent->GetName();
474 
475  if ((fBarType == kFancy) && (fBarWidth == kProgressBarTextWidth)) {
476  out << ",TGProgressBar::kFancy";
477  } else if ((fBarType == kStandard) && (fBarWidth == kProgressBarStandardWidth)){
478  out << ",TGProgressBar::kStandard";
479  }
480 
481  if (option && strstr(option, "keep_names"))
482  out << " " << GetName() << "->SetName(\"" << GetName() << "\");" << std::endl;
483 
484  out << "," << GetWidth() << ");" << std::endl;
485 
486  if (GetFillType() == kBlockFill)
487  out << " " << GetName() <<"->SetFillType(TGProgressBar::kBlockFill);"<< std::endl;
488 
489  if (GetShowPos()) {
490  out << " " << GetName() <<"->ShowPosition(kTRUE,";
491  if (UsePercent()) {
492  out << "kTRUE,";
493  } else {
494  out << "kFALSE,";
495  }
496  out << quote << GetFormat() << quote << ");"<< std::endl;
497 
498  } else if (UsePercent() && !GetFillType()) {
499  out << " " << GetName() <<"->ShowPosition();" << std::endl;
500  }
501  TGProgressBar::SavePrimitive(out, option);
502 }