ROOT  6.06/09
Reference Guide
Public Member Functions | Protected Attributes | Private Member Functions | Private Attributes | List of all members
TPie Class Reference

Draw a Pie Chart,.

Example:

void piechart()
{
// Pie chart example.
//Authors: Olivier Couet, Guido Volpi
Float_t vals[] = {.2,1.1,.6,.9,2.3};
Int_t colors[] = {2,3,4,5,6};
Int_t nvals = sizeof(vals)/sizeof(vals[0]);
TCanvas *cpie = new TCanvas("cpie","TPie test",700,700);
cpie->Divide(2,2);
TPie *pie1 = new TPie("pie1",
"Pie with offset and no colors",nvals,vals);
TPie *pie2 = new TPie("pie2",
"Pie with radial labels",nvals,vals,colors);
TPie *pie3 = new TPie("pie3",
"Pie with tangential labels",nvals,vals,colors);
TPie *pie4 = new TPie("pie4",
"Pie with verbose labels",nvals,vals,colors);
cpie->cd(1);
pie1->SetAngularOffset(30.);
pie1->SetEntryRadiusOffset( 4, 0.1);
pie1->SetRadius(.35);
pie1->Draw("3d");
cpie->cd(2);
pie2->SetEntryRadiusOffset(2,.05);
pie2->SetEntryLineColor(2,2);
pie2->SetEntryLineWidth(2,5);
pie2->SetEntryLineStyle(2,2);
pie2->SetEntryFillStyle(1,3030);
pie2->SetCircle(.5,.45,.3);
pie2->Draw("rsc");
cpie->cd(3);
pie3->SetY(.32);
pie3->GetSlice(0)->SetValue(.8);
pie3->GetSlice(1)->SetFillStyle(3031);
pie3->SetLabelsOffset(-.1);
pie3->Draw("3d t nol");
TLegend *pieleg = pie3->MakeLegend();
pieleg->SetY1(.56); pieleg->SetY2(.86);
cpie->cd(4);
pie4->SetRadius(.2);
pie4->SetLabelsOffset(.01);
pie4->SetLabelFormat("#splitline{%val (%perc)}{%txt}");
pie4->Draw("nol <");
}
TPie_001.png

Definition at line 31 of file TPie.h.

Public Member Functions

 TPie ()
 Default constructor. More...
 
 TPie (const char *, const char *, Int_t)
 This constructor creates a pie chart when only the number of the slices is known. More...
 
 TPie (const char *, const char *, Int_t, Double_t *, Int_t *cols=0, const char *lbls[]=0)
 Normal constructor. More...
 
 TPie (const char *, const char *, Int_t, Float_t *, Int_t *cols=0, const char *lbls[]=0)
 Normal constructor (Float_t). More...
 
 TPie (const TH1 *h)
 Constructor from a TH1. More...
 
 TPie (const TPie &)
 Copy constructor. More...
 
 ~TPie ()
 Destructor. More...
 
virtual Int_t DistancetoPrimitive (Int_t px, Int_t py)
 Evaluate the distance to the chart in gPad. More...
 
Int_t DistancetoSlice (Int_t, Int_t)
 Returns the slice number at the pixel position (px,py). More...
 
virtual void Draw (Option_t *option="l")
 Draw the pie chart. More...
 
virtual void ExecuteEvent (Int_t, Int_t, Int_t)
 Execute the mouse events. More...
 
Float_t GetAngle3D ()
 
Double_t GetAngularOffset ()
 
Int_t GetEntryFillColor (Int_t)
 Return the color of the slice number "i". More...
 
Int_t GetEntryFillStyle (Int_t)
 Return the style use to fill the slice number "i". More...
 
const char * GetEntryLabel (Int_t)
 Returns the label of the entry number "i". More...
 
Int_t GetEntryLineColor (Int_t)
 Return the line color used to outline thi "i" slice. More...
 
Int_t GetEntryLineStyle (Int_t)
 Return the style used to outline thi "i" slice. More...
 
Int_t GetEntryLineWidth (Int_t)
 Return the line width used to outline thi "i" slice. More...
 
Double_t GetEntryRadiusOffset (Int_t)
 Return the radial offset's value for the slice number "i". More...
 
Double_t GetEntryVal (Int_t)
 Return the value associated with the slice number "i". More...
 
const char * GetFractionFormat ()
 
Double_t GetHeight ()
 
const char * GetLabelFormat ()
 
Float_t GetLabelsOffset ()
 
TLegendGetLegend ()
 If created before by Paint option or by MakeLegend method return the pointer to the legend, otherwise return 0;. More...
 
Int_t GetEntries ()
 
const char * GetPercentFormat ()
 
Double_t GetRadius ()
 
TPieSliceGetSlice (Int_t i)
 Return the reference to the slice of index 'id'. More...
 
const char * GetValueFormat ()
 
Double_t GetX ()
 
Double_t GetY ()
 
TLegendMakeLegend (Double_t x1=.65, Double_t y1=.65, Double_t x2=.95, Double_t y2=.95, const char *leg_header="")
 This method create a legend that explains the contents of the slice for this pie-chart. More...
 
void MakeSlices (Bool_t force=kFALSE)
 Make the slices. More...
 
virtual void Paint (Option_t *)
 Paint a Pie chart in a canvas. More...
 
void SavePrimitive (std::ostream &out, Option_t *opts="")
 Save primitive as a C++ statement(s) on output stream out. More...
 
void SetAngle3D (Float_t val=30.)
 Set the value of for the pseudo 3D view angle, in degree. More...
 
void SetAngularOffset (Double_t)
 Set the global angular offset for slices in degree [0,360]. More...
 
void SetCircle (Double_t x=.5, Double_t y=.5, Double_t rad=.4)
 Set the coordinates of the circle that describe the pie: More...
 
void SetEntryLabel (Int_t, const char *text="Slice")
 Set slice number "i" label. More...
 
void SetEntryLineColor (Int_t, Int_t)
 Set the color for the slice's outline. "i" is the slice number. More...
 
void SetEntryLineStyle (Int_t, Int_t)
 Set the style for the slice's outline. "i" is the slice number. More...
 
void SetEntryLineWidth (Int_t, Int_t)
 Set the width of the slice's outline. "i" is the slice number. More...
 
void SetEntryFillColor (Int_t, Int_t)
 Set the color for the slice "i". More...
 
void SetEntryFillStyle (Int_t, Int_t)
 Set the fill style for the "i" slice. More...
 
void SetEntryRadiusOffset (Int_t, Double_t)
 Set the distance, in the direction of the radius of the slice. More...
 
void SetEntryVal (Int_t, Double_t)
 Set the value of a slice. More...
 
void SetFillColors (Int_t *)
 Set the fill colors for all the TPie's slices. More...
 
void SetFractionFormat (const char *)
 Set numeric format in the label, is used if the label format there is the modifier frac, in this case the value is printed using this format. More...
 
void SetHeight (Double_t val=.08)
 Set the height, in pixel, for the piechart if is drawn using the pseudo-3d mode. More...
 
void SetLabelFormat (const char *)
 This method is used to customize the label format. More...
 
void SetLabels (const char *[])
 Set the labels for all the slices. More...
 
void SetLabelsOffset (Float_t)
 Set the distance between the label end the external line of the TPie. More...
 
void SetPercentFormat (const char *)
 Set the numeric format for the percent value of a slice, default: %3.1f. More...
 
void SetRadius (Double_t)
 Set the pie chart's radius' value. More...
 
void SetValueFormat (const char *)
 Set the numeric format the slices' values. More...
 
void SetX (Double_t)
 Set X value. More...
 
void SetY (Double_t)
 Set Y value. More...
 
void SortSlices (Bool_t amode=kTRUE, Float_t merge_thresold=.0)
 This method, mainly intended for internal use, ordered the slices according their values. More...
 
- Public Member Functions inherited from TNamed
 TNamed ()
 
 TNamed (const char *name, const char *title)
 
 TNamed (const TString &name, const TString &title)
 
 TNamed (const TNamed &named)
 
TNamedoperator= (const TNamed &rhs)
 TNamed assignment operator. More...
 
virtual ~TNamed ()
 
virtual void Clear (Option_t *option="")
 Set name and title to empty strings (""). More...
 
virtual TObjectClone (const char *newname="") const
 Make a clone of an object using the Streamer facility. More...
 
virtual Int_t Compare (const TObject *obj) const
 Compare two TNamed objects. More...
 
virtual void Copy (TObject &named) const
 Copy this to obj. More...
 
virtual void FillBuffer (char *&buffer)
 Encode TNamed into output buffer. More...
 
virtual const char * GetName () const
 Returns name of object. More...
 
virtual const char * GetTitle () const
 Returns title of object. More...
 
virtual ULong_t Hash () const
 Return hash value for this object. More...
 
virtual Bool_t IsSortable () const
 
virtual void SetName (const char *name)
 Change (i.e. More...
 
virtual void SetNameTitle (const char *name, const char *title)
 Change (i.e. set) all the TNamed parameters (name and title). More...
 
virtual void SetTitle (const char *title="")
 Change (i.e. set) the title of the TNamed. More...
 
virtual void ls (Option_t *option="") const
 List TNamed name and title. More...
 
virtual void Print (Option_t *option="") const
 Print TNamed name and title. More...
 
virtual Int_t Sizeof () const
 Return size of the TNamed part of the TObject. More...
 
- Public Member Functions inherited from TObject
 TObject ()
 
 TObject (const TObject &object)
 TObject copy ctor. More...
 
TObjectoperator= (const TObject &rhs)
 TObject assignment operator. More...
 
virtual ~TObject ()
 TObject destructor. More...
 
virtual void AppendPad (Option_t *option="")
 Append graphics object to current pad. More...
 
virtual void Browse (TBrowser *b)
 Browse object. May be overridden for another default action. More...
 
virtual const char * ClassName () const
 Returns name of class to which the object belongs. More...
 
virtual void Delete (Option_t *option="")
 Delete this object. More...
 
virtual void DrawClass () const
 Draw class inheritance tree of the class to which this object belongs. More...
 
virtual TObjectDrawClone (Option_t *option="") const
 Draw a clone of this object in the current pad. More...
 
virtual void Dump () const
 Dump contents of object on stdout. More...
 
virtual void Execute (const char *method, const char *params, Int_t *error=0)
 Execute method on this object with the given parameter string, e.g. More...
 
virtual void Execute (TMethod *method, TObjArray *params, Int_t *error=0)
 Execute method on this object with parameters stored in the TObjArray. More...
 
virtual TObjectFindObject (const char *name) const
 Must be redefined in derived classes. More...
 
virtual TObjectFindObject (const TObject *obj) const
 Must be redefined in derived classes. More...
 
virtual Option_tGetDrawOption () const
 Get option used by the graphics system to draw this object. More...
 
virtual UInt_t GetUniqueID () const
 Return the unique object id. More...
 
virtual const char * GetIconName () const
 Returns mime type name of object. More...
 
virtual Option_tGetOption () const
 
virtual char * GetObjectInfo (Int_t px, Int_t py) const
 Returns string containing info about the object at position (px,py). More...
 
virtual Bool_t HandleTimer (TTimer *timer)
 Execute action in response of a timer timing out. More...
 
virtual Bool_t InheritsFrom (const char *classname) const
 Returns kTRUE if object inherits from class "classname". More...
 
virtual Bool_t InheritsFrom (const TClass *cl) const
 Returns kTRUE if object inherits from TClass cl. More...
 
virtual void Inspect () const
 Dump contents of this object in a graphics canvas. More...
 
virtual Bool_t IsFolder () const
 Returns kTRUE in case object contains browsable objects (like containers or lists of other objects). More...
 
virtual Bool_t IsEqual (const TObject *obj) const
 Default equal comparison (objects are equal if they have the same address in memory). More...
 
Bool_t IsOnHeap () const
 
Bool_t IsZombie () const
 
virtual Bool_t Notify ()
 This method must be overridden to handle object notification. More...
 
virtual void Pop ()
 Pop on object drawn in a pad to the top of the display list. More...
 
virtual Int_t Read (const char *name)
 Read contents of object with specified name from the current directory. More...
 
virtual void RecursiveRemove (TObject *obj)
 Recursively remove this object from a list. More...
 
virtual void SaveAs (const char *filename="", Option_t *option="") const
 Save this object in the file specified by filename. More...
 
virtual void SetDrawOption (Option_t *option="")
 Set drawing option for object. More...
 
virtual void SetUniqueID (UInt_t uid)
 Set the unique object id. More...
 
virtual void UseCurrentStyle ()
 Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked. More...
 
virtual Int_t Write (const char *name=0, Int_t option=0, Int_t bufsize=0)
 Write this object to the current directory. More...
 
virtual Int_t Write (const char *name=0, Int_t option=0, Int_t bufsize=0) const
 Write this object to the current directory. More...
 
voidoperator new (size_t sz)
 
voidoperator new[] (size_t sz)
 
voidoperator new (size_t sz, void *vp)
 
voidoperator new[] (size_t sz, void *vp)
 
void operator delete (void *ptr)
 Operator delete. More...
 
void operator delete[] (void *ptr)
 Operator delete []. More...
 
void SetBit (UInt_t f, Bool_t set)
 Set or unset the user status bits as specified in f. More...
 
void SetBit (UInt_t f)
 
void ResetBit (UInt_t f)
 
Bool_t TestBit (UInt_t f) const
 
Int_t TestBits (UInt_t f) const
 
void InvertBit (UInt_t f)
 
virtual void Info (const char *method, const char *msgfmt,...) const
 Issue info message. More...
 
virtual void Warning (const char *method, const char *msgfmt,...) const
 Issue warning message. More...
 
virtual void Error (const char *method, const char *msgfmt,...) const
 Issue error message. More...
 
virtual void SysError (const char *method, const char *msgfmt,...) const
 Issue system error message. More...
 
virtual void Fatal (const char *method, const char *msgfmt,...) const
 Issue fatal error message. More...
 
void AbstractMethod (const char *method) const
 Use this method to implement an "abstract" method that you don't want to leave purely abstract. More...
 
void MayNotUse (const char *method) const
 Use this method to signal that a method (defined in a base class) may not be called in a derived class (in principle against good design since a child class should not provide less functionality than its parent, however, sometimes it is necessary). More...
 
void Obsolete (const char *method, const char *asOfVers, const char *removedFromVers) const
 Use this method to declare a method obsolete. More...
 
- Public Member Functions inherited from TAttText
 TAttText ()
 
 TAttText (Int_t align, Float_t angle, Color_t color, Style_t font, Float_t tsize)
 AttText normal constructor. More...
 
virtual ~TAttText ()
 AttText destructor. More...
 
void Copy (TAttText &atttext) const
 Copy this text attributes to a new TAttText. More...
 
virtual Short_t GetTextAlign () const
 
virtual Float_t GetTextAngle () const
 
virtual Color_t GetTextColor () const
 
virtual Font_t GetTextFont () const
 
virtual Float_t GetTextSize () const
 
virtual void Modify ()
 Change current text attributes if necessary. More...
 
virtual void ResetAttText (Option_t *toption="")
 Reset this text attributes to default values. More...
 
virtual void SaveTextAttributes (std::ostream &out, const char *name, Int_t alidef=12, Float_t angdef=0, Int_t coldef=1, Int_t fondef=61, Float_t sizdef=1)
 Save text attributes as C++ statement(s) on output stream out. More...
 
virtual void SetTextAttributes ()
 Invoke the DialogCanvas Text attributes. More...
 
virtual void SetTextAlign (Short_t align=11)
 
virtual void SetTextAngle (Float_t tangle=0)
 
virtual void SetTextColor (Color_t tcolor=1)
 
virtual void SetTextColorAlpha (Color_t tcolor, Float_t talpha)
 Set a transparent marker color. More...
 
virtual void SetTextFont (Font_t tfont=62)
 
virtual void SetTextSize (Float_t tsize=1)
 
virtual void SetTextSizePixels (Int_t npixels)
 Set the text size in pixels. More...
 

Protected Attributes

Double_t fX
 Legend for this piechart. More...
 
Double_t fY
 
Double_t fRadius
 
Double_t fAngularOffset
 
Float_t fLabelsOffset
 
TString fLabelFormat
 
TString fValueFormat
 
TString fFractionFormat
 
TString fPercentFormat
 
Int_t fNvals
 
TPieSlice ** fPieSlices
 
Bool_t fIs3D
 
Double_t fHeight
 true if the pseudo-3d is enabled More...
 
Float_t fAngle3D
 
- Protected Attributes inherited from TNamed
TString fName
 
TString fTitle
 
- Protected Attributes inherited from TAttText
Float_t fTextAngle
 
Float_t fTextSize
 
Short_t fTextAlign
 
Color_t fTextColor
 
Font_t fTextFont
 

Private Member Functions

void Init (Int_t np, Double_t ao, Double_t x, Double_t y, Double_t r)
 Common initialization for all constructors. More...
 
void DrawGhost ()
 This method is for internal use. More...
 

Private Attributes

Float_t fSum
 
Float_tfSlices
 Sum for the slice values. More...
 
TLegendfLegend
 Subdivisions of the slices. More...
 

Additional Inherited Members

- Public Types inherited from TObject
enum  EStatusBits {
  kCanDelete = BIT(0), kMustCleanup = BIT(3), kObjInCanvas = BIT(3), kIsReferenced = BIT(4),
  kHasUUID = BIT(5), kCannotPick = BIT(6), kNoContextMenu = BIT(8), kInvalidObject = BIT(13)
}
 
enum  { kIsOnHeap = 0x01000000, kNotDeleted = 0x02000000, kZombie = 0x04000000, kBitMask = 0x00ffffff }
 
enum  { kSingleKey = BIT(0), kOverwrite = BIT(1), kWriteDelete = BIT(2) }
 
- Static Public Member Functions inherited from TObject
static Long_t GetDtorOnly ()
 Return destructor only flag. More...
 
static void SetDtorOnly (void *obj)
 Set destructor only flag. More...
 
static Bool_t GetObjectStat ()
 Get status of object stat flag. More...
 
static void SetObjectStat (Bool_t stat)
 Turn on/off tracking of objects in the TObjectTable. More...
 
- Protected Member Functions inherited from TObject
void MakeZombie ()
 
virtual void DoError (int level, const char *location, const char *fmt, va_list va) const
 Interface to ErrorHandler (protected). More...
 

#include <TPie.h>

+ Inheritance diagram for TPie:
+ Collaboration diagram for TPie:

Constructor & Destructor Documentation

TPie::TPie ( )

Default constructor.

Definition at line 62 of file TPie.cxx.

TPie::TPie ( const char *  name,
const char *  title,
Int_t  npoints 
)

This constructor creates a pie chart when only the number of the slices is known.

The number of slices is fixed.

Definition at line 71 of file TPie.cxx.

TPie::TPie ( const char *  name,
const char *  title,
Int_t  npoints,
Double_t vals,
Int_t colors = 0,
const char *  lbls[] = 0 
)

Normal constructor.

The 1st and 2nd parameters are the name of the object and its title.

The number of points passed at this point is used to allocate the memory.

Slices values are given as Double_t.

The 4th elements is an array containing, in double precision format, the value of each slice. It is also possible to specify the filled color of each slice. If the color array is not specified the slices are colored using a color sequence in the standard palette.

Definition at line 90 of file TPie.cxx.

TPie::TPie ( const char *  name,
const char *  title,
Int_t  npoints,
Float_t vals,
Int_t cols = 0,
const char *  lbls[] = 0 
)

Normal constructor (Float_t).

Definition at line 104 of file TPie.cxx.

TPie::TPie ( const TH1 h)

Constructor from a TH1.

Definition at line 119 of file TPie.cxx.

TPie::TPie ( const TPie cpy)

Copy constructor.

Definition at line 143 of file TPie.cxx.

TPie::~TPie ( )

Destructor.

Definition at line 155 of file TPie.cxx.

Member Function Documentation

Int_t TPie::DistancetoPrimitive ( Int_t  px,
Int_t  py 
)
virtual

Evaluate the distance to the chart in gPad.

Reimplemented from TObject.

Definition at line 168 of file TPie.cxx.

Referenced by THistPainter::DistancetoPrimitive().

Int_t TPie::DistancetoSlice ( Int_t  px,
Int_t  py 
)

Returns the slice number at the pixel position (px,py).

Returns -1 if no slice is picked.

Used by DistancetoPrimitive.

Definition at line 188 of file TPie.cxx.

Referenced by DistancetoPrimitive().

void TPie::Draw ( Option_t option = "l")
virtual

Draw the pie chart.

The possible options are listed in the TPie::Paint() method.

Reimplemented from TObject.

Definition at line 274 of file TPie.cxx.

void TPie::DrawGhost ( )
private

This method is for internal use.

It is used by Execute event to draw the outline of "this" TPie. Used when the opaque movements are not permitted.

Definition at line 297 of file TPie.cxx.

Referenced by ExecuteEvent().

void TPie::ExecuteEvent ( Int_t  event,
Int_t  px,
Int_t  py 
)
virtual

Execute the mouse events.

Reimplemented from TObject.

Definition at line 393 of file TPie.cxx.

Referenced by THistPainter::ExecuteEvent().

Float_t TPie::GetAngle3D ( )
inline

Definition at line 69 of file TPie.h.

Referenced by TPieEditor::SetModel().

Double_t TPie::GetAngularOffset ( )
inline

Definition at line 70 of file TPie.h.

Referenced by SavePrimitive().

Int_t TPie::GetEntries ( )
inline

Definition at line 84 of file TPie.h.

Int_t TPie::GetEntryFillColor ( Int_t  i)

Return the color of the slice number "i".

Definition at line 646 of file TPie.cxx.

Int_t TPie::GetEntryFillStyle ( Int_t  i)

Return the style use to fill the slice number "i".

Definition at line 654 of file TPie.cxx.

const char * TPie::GetEntryLabel ( Int_t  i)

Returns the label of the entry number "i".

Definition at line 638 of file TPie.cxx.

Int_t TPie::GetEntryLineColor ( Int_t  i)

Return the line color used to outline thi "i" slice.

Definition at line 662 of file TPie.cxx.

Int_t TPie::GetEntryLineStyle ( Int_t  i)

Return the style used to outline thi "i" slice.

Definition at line 670 of file TPie.cxx.

Int_t TPie::GetEntryLineWidth ( Int_t  i)

Return the line width used to outline thi "i" slice.

Definition at line 678 of file TPie.cxx.

Double_t TPie::GetEntryRadiusOffset ( Int_t  i)

Return the radial offset's value for the slice number "i".

Definition at line 686 of file TPie.cxx.

Double_t TPie::GetEntryVal ( Int_t  i)

Return the value associated with the slice number "i".

Definition at line 694 of file TPie.cxx.

const char* TPie::GetFractionFormat ( )
inline

Definition at line 79 of file TPie.h.

Double_t TPie::GetHeight ( )
inline

Definition at line 80 of file TPie.h.

Referenced by TPieEditor::SetModel().

const char* TPie::GetLabelFormat ( )
inline

Definition at line 81 of file TPie.h.

Referenced by SavePrimitive().

Float_t TPie::GetLabelsOffset ( )
inline

Definition at line 82 of file TPie.h.

Referenced by SavePrimitive().

TLegend * TPie::GetLegend ( )

If created before by Paint option or by MakeLegend method return the pointer to the legend, otherwise return 0;.

Definition at line 703 of file TPie.cxx.

const char* TPie::GetPercentFormat ( )
inline

Definition at line 85 of file TPie.h.

Referenced by SavePrimitive().

Double_t TPie::GetRadius ( )
inline

Definition at line 86 of file TPie.h.

TPieSlice * TPie::GetSlice ( Int_t  id)

Return the reference to the slice of index 'id'.

There are no controls of memory corruption, be carefull.

Definition at line 712 of file TPie.cxx.

Referenced by GetEntryFillColor(), GetEntryFillStyle(), GetEntryLabel(), GetEntryLineColor(), GetEntryLineStyle(), GetEntryLineWidth(), GetEntryRadiusOffset(), and GetEntryVal().

const char* TPie::GetValueFormat ( )
inline

Definition at line 88 of file TPie.h.

Referenced by SavePrimitive().

Double_t TPie::GetX ( )
inline

Definition at line 89 of file TPie.h.

Double_t TPie::GetY ( )
inline

Definition at line 90 of file TPie.h.

void TPie::Init ( Int_t  np,
Double_t  ao,
Double_t  x,
Double_t  y,
Double_t  r 
)
private

Common initialization for all constructors.

This is a private function called to allocate the memory.

Definition at line 721 of file TPie.cxx.

Referenced by TPie().

TLegend * TPie::MakeLegend ( Double_t  x1 = .65,
Double_t  y1 = .65,
Double_t  x2 = .95,
Double_t  y2 = .95,
const char *  leg_header = "" 
)

This method create a legend that explains the contents of the slice for this pie-chart.

The parameter passed reppresents the option passed to shown the slices, see TLegend::AddEntry() for further details.

The pointer of the TLegend is returned.

Definition at line 768 of file TPie.cxx.

void TPie::MakeSlices ( Bool_t  force = kFALSE)

Make the slices.

If they already exist it does nothing unless force=kTRUE.

Definition at line 1406 of file TPie.cxx.

Referenced by DistancetoSlice(), DrawGhost(), ExecuteEvent(), Paint(), SetAngularOffset(), SetEntryVal(), TPieSlice::SetValue(), and SortSlices().

void TPie::Paint ( Option_t option)
virtual

Paint a Pie chart in a canvas.

The possible option are:

  • "R" Print the labels along the central "R"adius of slices.
  • "T" Print the label in a direction "T"angent to circle that describes the TPie.
  • "SC" Paint the the labels with the "S"ame "C"olor as the slices.
  • "3D" Draw the pie-chart with a pseudo 3D effect.
  • "NOL" No OutLine: Don't draw the slices' outlines, any property over the slices' line is ignored.
  • ">" Sort the slices in increasing order.
  • "<" Sort the slices in decreasing order.

After the use of > or < options the internal order of the TPieSlices is changed.

Other options changing the labels' format are described in TPie::SetLabelFormat().

Reimplemented from TObject.

Definition at line 802 of file TPie.cxx.

Referenced by THistPainter::Paint().

void TPie::SavePrimitive ( std::ostream &  out,
Option_t opts = "" 
)
virtual

Save primitive as a C++ statement(s) on output stream out.

Reimplemented from TObject.

Definition at line 1123 of file TPie.cxx.

void TPie::SetAngle3D ( Float_t  val = 30.)

Set the value of for the pseudo 3D view angle, in degree.

The range of the permitted values is: [0,90]

Definition at line 1178 of file TPie.cxx.

Referenced by TPieEditor::DoChange3DAngle().

void TPie::SetAngularOffset ( Double_t  offset)

Set the global angular offset for slices in degree [0,360].

Definition at line 1191 of file TPie.cxx.

Referenced by ExecuteEvent().

void TPie::SetCircle ( Double_t  x = .5,
Double_t  y = .5,
Double_t  rad = .4 
)

Set the coordinates of the circle that describe the pie:

  • the 1st and the 2nd arguments are the x and y center's coordinates.
  • the 3rd value is the pie-chart's radius.

All the coordinates are in NDC space.

Definition at line 1208 of file TPie.cxx.

void TPie::SetEntryFillColor ( Int_t  i,
Int_t  color 
)

Set the color for the slice "i".

Definition at line 1252 of file TPie.cxx.

void TPie::SetEntryFillStyle ( Int_t  i,
Int_t  style 
)

Set the fill style for the "i" slice.

Definition at line 1260 of file TPie.cxx.

void TPie::SetEntryLabel ( Int_t  i,
const char *  text = "Slice" 
)

Set slice number "i" label.

The first parameter is the index of the slice, the other is the label text.

Definition at line 1219 of file TPie.cxx.

void TPie::SetEntryLineColor ( Int_t  i,
Int_t  color 
)

Set the color for the slice's outline. "i" is the slice number.

Definition at line 1228 of file TPie.cxx.

void TPie::SetEntryLineStyle ( Int_t  i,
Int_t  style 
)

Set the style for the slice's outline. "i" is the slice number.

Definition at line 1236 of file TPie.cxx.

void TPie::SetEntryLineWidth ( Int_t  i,
Int_t  width 
)

Set the width of the slice's outline. "i" is the slice number.

Definition at line 1244 of file TPie.cxx.

void TPie::SetEntryRadiusOffset ( Int_t  i,
Double_t  shift 
)

Set the distance, in the direction of the radius of the slice.

Definition at line 1268 of file TPie.cxx.

void TPie::SetEntryVal ( Int_t  i,
Double_t  val 
)

Set the value of a slice.

Definition at line 1276 of file TPie.cxx.

void TPie::SetFillColors ( Int_t colors)

Set the fill colors for all the TPie's slices.

Definition at line 1286 of file TPie.cxx.

Referenced by TPie().

void TPie::SetFractionFormat ( const char *  fmt)

Set numeric format in the label, is used if the label format there is the modifier frac, in this case the value is printed using this format.

The numeric format use the standard C modifier used in stdio library: f, %2.1$, e... for further documentation you can use the printf man page ("man 3 printf" on linux)

Example:

mypie->SetLabelFormat("%txt (%frac)");
mypie->SetFractionFormat("2.1f");

Definition at line 1334 of file TPie.cxx.

void TPie::SetHeight ( Double_t  val = .08)

Set the height, in pixel, for the piechart if is drawn using the pseudo-3d mode.

The default value is 20 pixel.

Definition at line 1298 of file TPie.cxx.

Referenced by TPieEditor::DoChange3DAngle().

void TPie::SetLabelFormat ( const char *  fmt)

This method is used to customize the label format.

The format string must contain one of these modifiers:

  • txt : to print the text label associated with the slice
  • val : to print the numeric value of the slice
  • frac : to print the relative fraction of this slice
  • perc : to print the % of this slice

ex. : mypie->SetLabelFormat("%txt (%frac)");

Definition at line 1314 of file TPie.cxx.

Referenced by TPie().

void TPie::SetLabels ( const char *  lbls[])

Set the labels for all the slices.

Definition at line 1342 of file TPie.cxx.

Referenced by TPie().

void TPie::SetLabelsOffset ( Float_t  labelsoffset)

Set the distance between the label end the external line of the TPie.

Definition at line 1351 of file TPie.cxx.

void TPie::SetPercentFormat ( const char *  fmt)

Set the numeric format for the percent value of a slice, default: %3.1f.

Definition at line 1359 of file TPie.cxx.

void TPie::SetRadius ( Double_t  rad)

Set the pie chart's radius' value.

Definition at line 1367 of file TPie.cxx.

void TPie::SetValueFormat ( const char *  fmt)

Set the numeric format the slices' values.

Used by val (see SetLabelFormat()).

Definition at line 1381 of file TPie.cxx.

void TPie::SetX ( Double_t  x)

Set X value.

Definition at line 1389 of file TPie.cxx.

void TPie::SetY ( Double_t  y)

Set Y value.

Definition at line 1397 of file TPie.cxx.

void TPie::SortSlices ( Bool_t  amode = kTRUE,
Float_t  merge_threshold = .0 
)

This method, mainly intended for internal use, ordered the slices according their values.

The default (amode=kTRUE) is increasing order, but is also possible in decreasing order (amode=kFALSE).

If the merge_threshold>0 the slice that contains a quantity smaller than merge_threshold are merged together

Definition at line 1441 of file TPie.cxx.

Referenced by Paint().

Member Data Documentation

Float_t TPie::fAngle3D
protected

Definition at line 54 of file TPie.h.

Referenced by DistancetoSlice(), DrawGhost(), ExecuteEvent(), GetAngle3D(), Init(), Paint(), and SetAngle3D().

Double_t TPie::fAngularOffset
protected

Definition at line 44 of file TPie.h.

Referenced by ExecuteEvent(), GetAngularOffset(), Init(), MakeSlices(), SetAngularOffset(), and TPie().

TString TPie::fFractionFormat
protected

Definition at line 48 of file TPie.h.

Referenced by Init(), Paint(), and SetFractionFormat().

Double_t TPie::fHeight
protected

true if the pseudo-3d is enabled

Definition at line 53 of file TPie.h.

Referenced by DrawGhost(), GetHeight(), Init(), Paint(), and SetHeight().

Bool_t TPie::fIs3D
protected

Definition at line 52 of file TPie.h.

Referenced by DistancetoSlice(), DrawGhost(), ExecuteEvent(), Init(), and Paint().

TString TPie::fLabelFormat
protected

Definition at line 46 of file TPie.h.

Referenced by Init(), Paint(), and SetLabelFormat().

Float_t TPie::fLabelsOffset
protected

Definition at line 45 of file TPie.h.

Referenced by GetLabelsOffset(), Init(), Paint(), and SetLabelsOffset().

TLegend* TPie::fLegend
private

Subdivisions of the slices.

Definition at line 38 of file TPie.h.

Referenced by GetLegend(), Init(), MakeLegend(), and ~TPie().

Int_t TPie::fNvals
protected
TString TPie::fPercentFormat
protected

Definition at line 49 of file TPie.h.

Referenced by Init(), and SetPercentFormat().

TPieSlice** TPie::fPieSlices
protected
Double_t TPie::fRadius
protected
Float_t* TPie::fSlices
private

Sum for the slice values.

Definition at line 37 of file TPie.h.

Referenced by DistancetoSlice(), DrawGhost(), ExecuteEvent(), Init(), MakeSlices(), Paint(), and ~TPie().

Float_t TPie::fSum
private

Definition at line 36 of file TPie.h.

Referenced by Init(), MakeSlices(), and Paint().

TString TPie::fValueFormat
protected

Definition at line 47 of file TPie.h.

Referenced by Init(), Paint(), and SetValueFormat().

Double_t TPie::fX
protected

Legend for this piechart.

Definition at line 41 of file TPie.h.

Referenced by DistancetoSlice(), ExecuteEvent(), GetX(), Init(), Paint(), SavePrimitive(), SetCircle(), SetX(), and TPie().

Double_t TPie::fY
protected

Definition at line 42 of file TPie.h.

Referenced by DistancetoSlice(), ExecuteEvent(), GetY(), Init(), Paint(), SavePrimitive(), SetCircle(), SetY(), and TPie().


The documentation for this class was generated from the following files: