TAttAxis.cxx

Go to the documentation of this file.

// @(#)root/base:$Id$
// Author: Rene Brun   12/12/94
 
/*************************************************************************
 * Copyright (C) 1995-2000, Rene Brun and Fons Rademakers.               *
 * All rights reserved.                                                  *
 *                                                                       *
 * For the licensing terms see $ROOTSYS/LICENSE.                         *
 * For the list of contributors see $ROOTSYS/README/CREDITS.             *
 *************************************************************************/
 
#include "TAttAxis.h"
#include "TBuffer.h"
#include "TStyle.h"
#include "TVirtualPad.h"
#include "TColor.h"
#include "TMathBase.h"
#include <cstdlib>
#include <iostream>
 
 
/** \class TAttAxis
\ingroup Base
\ingroup GraphicsAtt
 
Manages histogram axis attributes.
 
They are:
 
  - The number of divisions: TAttAxis::SetNdivisions.
  - The line axis' color: TAttAxis::SetAxisColor.
  - The axis labels' color: TAttAxis::SetLabelColor.
  - The axis labels' font: TAttAxis::SetLabelFont.
  - The axis labels' offset: TAttAxis::SetLabelOffset.
  - The axis labels' size: TAttAxis::SetLabelSize.
  - The tick marks's length: TAttAxis::SetTickLength or TAttAxis::SetTickSize .
  - The axis title's offset: TAttAxis::SetTitleOffset.
  - The axis title's size: TAttAxis::SetTitleSize.
  - The axis title's color: TAttAxis::SetTitleColor.
  - The axis title's font: TAttAxis::SetTitleFont.
 
*/
 
TAttAxis::TAttAxis()
{
   // Constructor.
   ResetAttAxis();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Destructor.
 
TAttAxis::~TAttAxis()
{
}
 
////////////////////////////////////////////////////////////////////////////////
/// Copy of the object.
 
void TAttAxis::Copy(TAttAxis &attaxis) const
{
   attaxis.fNdivisions  = fNdivisions;
   attaxis.fAxisColor   = fAxisColor;
   attaxis.fLabelColor  = fLabelColor;
   attaxis.fLabelFont   = fLabelFont;
   attaxis.fLabelOffset = fLabelOffset;
   attaxis.fLabelSize   = fLabelSize;
   attaxis.fTickLength  = fTickLength;
   attaxis.fTitleOffset = fTitleOffset;
   attaxis.fTitleSize   = fTitleSize;
   attaxis.fTitleColor  = fTitleColor;
   attaxis.fTitleFont   = fTitleFont;
}
 
////////////////////////////////////////////////////////////////////////////////
/// Reset axis attributes.
 
void TAttAxis::ResetAttAxis(Option_t *option)
{
   if (gStyle) {
      fNdivisions  = gStyle->GetNdivisions(option);
      fAxisColor   = gStyle->GetAxisColor(option);
      fLabelColor  = gStyle->GetLabelColor(option);
      fLabelFont   = gStyle->GetLabelFont(option);
      fLabelOffset = gStyle->GetLabelOffset(option);
      fLabelSize   = gStyle->GetLabelSize(option);
      fTickLength  = gStyle->GetTickLength(option);
      fTitleOffset = gStyle->GetTitleOffset(option);
      fTitleSize   = gStyle->GetTitleSize(option);
      fTitleColor  = gStyle->GetTitleColor(option);
      fTitleFont   = gStyle->GetTitleFont(option);
   } else {
      fNdivisions  = 510;
      fAxisColor   = 1;
      fLabelColor  = 1;
      fLabelFont   = 62;
      fLabelOffset = 0.005;
      fLabelSize   = 0.04;
      fTickLength  = 0.03;
      fTitleOffset = 1;
      fTitleSize   = fLabelSize;
      fTitleColor  = 1;
      fTitleFont   = 62;
   }
}
 
////////////////////////////////////////////////////////////////////////////////
/// Save axis attributes as C++ statement(s) on output stream out.
 
void TAttAxis::SaveAttributes(std::ostream &out, const char *name, const char *subname)
{
   TString prefix = TString("   ") + name + subname + "->";
 
   if (fNdivisions != 510)
      out << prefix << "SetNdivisions(" << fNdivisions << ");\n";
   if (fAxisColor != 1)
      out << prefix << "SetAxisColor(" << TColor::SavePrimitiveColor(fAxisColor) << ");\n";
   if (fLabelColor != 1)
      out << prefix << "SetLabelColor(" << TColor::SavePrimitiveColor(fLabelColor) << ");\n";
   if (fLabelFont != 62)
      out << prefix << "SetLabelFont(" << fLabelFont << ");\n";
   if (TMath::Abs(fLabelOffset - 0.005) > 0.0001)
      out << prefix << "SetLabelOffset(" << fLabelOffset << ");\n";
   if (TMath::Abs(fLabelSize - 0.035) > 0.001)
      out << prefix << "SetLabelSize(" << fLabelSize << ");\n";
   if (TMath::Abs(fTitleSize - 0.035) > 0.001)
      out << prefix << "SetTitleSize(" << fTitleSize << ");\n";
   if (TMath::Abs(fTickLength - 0.03) > 0.001)
      out << prefix << "SetTickLength(" << fTickLength << ");\n";
   if (TMath::Abs(fTitleOffset) > 0.001)
      out << prefix << "SetTitleOffset(" << fTitleOffset << ");\n";
   if (fTitleColor != 1)
      out << prefix << "SetTitleColor(" << TColor::SavePrimitiveColor(fTitleColor) << ");\n";
   if (fTitleFont != 62)
      out << prefix << "SetTitleFont(" << fTitleFont << ");\n";
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set color of the line axis and tick marks.
 
void TAttAxis::SetAxisColor(Color_t color, Float_t alpha)
{
   if (alpha<1.) fAxisColor = TColor::GetColorTransparent(color, alpha);
   else          fAxisColor = color;
   if (gPad) gPad->Modified();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set color of labels.
 
void TAttAxis::SetLabelColor(Color_t color, Float_t alpha)
{
   if (alpha<1.) fLabelColor = TColor::GetColorTransparent(color, alpha);
   else          fLabelColor = color;
   if (gPad) gPad->Modified();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set labels' font.
 
void TAttAxis::SetLabelFont(Style_t font)
{
   fLabelFont = font;
   if (gPad) gPad->Modified();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set distance between the axis and the labels.
/// The distance is expressed in per cent of the pad width.
/// A negative value allow to draw the label on the other side of the axis.
 
void TAttAxis::SetLabelOffset(Float_t offset)
{
   fLabelOffset = offset;
   if (gPad) gPad->Modified();
}
 
 
////////////////////////////////////////////////////////////////////////////////
/// Set size of axis labels.
/// The size is expressed in per cent of the pad size, unless the font precision
/// is 3 and in that case the size is expressed in pixels.
 
void TAttAxis::SetLabelSize(Float_t size)
{
   fLabelSize = size;
   if (gPad) gPad->Modified();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set the number of divisions for this axis.
///
///  - if optim = kTRUE (default), the number of divisions will be
///                     optimized around the specified value.
///  - if optim = kFALSE, or n < 0, the axis will be forced to use
///                     exactly n divisions.
///~~~ {.cpp}
/// n = n1 + 100*n2 + 10000*n3
///~~~
/// Where n1 is the number of primary divisions,
/// n2 is the number of second order divisions and
/// n3 is the number of third order divisions.
///
/// If the number of divisions is "optimized" (see above) n1, n2, n3 are
/// maximum values.
///
/// Examples:
///
///  - ndiv = 0: no tick marks.
///  - ndiv = 2: 2 divisions, one tick mark in the middle of the axis.
///  - ndiv = 510: 10 primary divisions, 5 secondary divisions.
///  - ndiv = -10: exactly 10 primary divisions.
 
void TAttAxis::SetNdivisions(Int_t n, Bool_t optim)
{
   Int_t ndiv                     = (n%1000000);
   Bool_t isOptimized             = optim && (ndiv>0);
   Int_t current_maxDigits        = abs(fNdivisions)/1000000;
   fNdivisions                    = abs(ndiv) + current_maxDigits*1000000;
   if (!isOptimized) fNdivisions  = -fNdivisions;
 
   if (gPad) gPad->Modified();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set the number of divisions for this axis using one `int` per division level.
 
void TAttAxis::SetNdivisions(Int_t n1, Int_t n2, Int_t n3, Bool_t optim)
{
   SetNdivisions(n1+100*n2+10000*n3, optim);
}
 
////////////////////////////////////////////////////////////////////////////////
/// This function sets the maximum number of digits permitted for the axis labels
/// above which the notation with 10^N is used.
///
/// For example, to accept 6 digits number like 900000 on the X axis of the
/// histogram `h` call:
///
/// ~~~ {.cpp}
///   h->GetXaxis()->SetMaxDigits(6);
/// ~~~
///
/// The default value is 5.
///
/// The default value for all axis can be set with the static function
/// `TGaxis::SetMaxDigits`.
 
void TAttAxis::SetMaxDigits(Int_t maxDigits)
{
   Bool_t isOptimized             = fNdivisions>0;
   Int_t absDiv                   = abs(fNdivisions);
   Int_t current_maxDigits        = absDiv/1000000;
   Int_t current_Ndivisions       = absDiv - (current_maxDigits*1000000);
   fNdivisions                    = (current_Ndivisions + (maxDigits*1000000));
   if (!isOptimized) fNdivisions  = -fNdivisions;
 
   if (gPad) gPad->Modified();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set tick mark length.
/// The length is expressed in per cent of the pad width.
 
void TAttAxis::SetTickLength(Float_t length)
{
   fTickLength = length;
   if (gPad) gPad->Modified();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set distance between the axis and the axis title.
/// Offset is a correction factor with respect to the "standard" value.
///  - offset = 1   uses standard position that is computed in function
///                 of the label offset and size.
///  - offset = 1.2 will add 20 per cent more to the standard offset.
///  - offset = 0   automatic placement for the Y axis title (default).
 
void TAttAxis::SetTitleOffset(Float_t offset)
{
   fTitleOffset = offset;
   if (gPad) gPad->Modified();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set size of axis title.
/// The size is expressed in per cent of the pad size, unless the font precision
/// is 3 and in that case the size is expressed in pixels.
 
void TAttAxis::SetTitleSize(Float_t size)
{
   fTitleSize = size;
   if (gPad) gPad->Modified();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set color of axis title.
 
void TAttAxis::SetTitleColor(Color_t color)
{
   fTitleColor = color;
   if (gPad) gPad->Modified();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set the title font.
 
void TAttAxis::SetTitleFont(Style_t font)
{
   fTitleFont = font;
   if (gPad) gPad->Modified();
}
 
////////////////////////////////////////////////////////////////////////////////
/// Stream an object of class TAttAxis.
 
void TAttAxis::Streamer(TBuffer &R__b)
{
   if (R__b.IsReading()) {
      UInt_t R__s, R__c;
      Version_t R__v = R__b.ReadVersion(&R__s, &R__c);
      if (R__v > 3) {
         R__b.ReadClassBuffer(TAttAxis::Class(), this, R__v, R__s, R__c);
         return;
      }
      //====process old versions before automatic schema evolution
      R__b >> fNdivisions;
      R__b >> fAxisColor;
      R__b >> fLabelColor;
      R__b >> fLabelFont;
      R__b >> fLabelOffset;
      R__b >> fLabelSize;
      R__b >> fTickLength;
      R__b >> fTitleOffset;
 
      if (R__v > 1 && R__b.GetVersionOwner() > 900)
         R__b >> fTitleSize;
      else
         fTitleSize = fLabelSize;
      if (R__v > 2) {
         R__b >> fTitleColor;
         R__b >> fTitleFont;
      }
      //====end of old versions
 
   } else {
      R__b.WriteClassBuffer(TAttAxis::Class(),this);
   }
}
 
void TAttAxis::SetLabelColor(TColorNumber lcolor)
{
   SetLabelColor(lcolor.number());
}