TMarker.cxx

Go to the documentation of this file.

// @(#)root/graf:$Id$
// Author: Rene Brun   12/05/95
 
/*************************************************************************
 * 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 "TROOT.h"
#include "TBuffer.h"
#include "TVirtualPad.h"
#include "TMarker.h"
#include "TMath.h"
#include "TPoint.h"
#include "TText.h"
 
#include <cstdlib>
#include <iostream>
#include <cstdio>
 
 
/** \class TMarker
\ingroup BasicGraphics
 
Manages Markers.
 
Use the TMarker constructor to create a marker.
 
~~~ {.cpp}
   TMarker(Double_t x,Double_t y,Int_t marker)
~~~
 
The parameters `x` and `y` are the marker coordinates and `marker` is the marker type.
 
Use the TPolyMarker to create an array on N points in a 2D space.
At each point `x[i]`, `y[i]` a marker is drawn.
 
Use the TAttMarker class to change the attributes color, style and size of a marker.
 
_**Example**_
 
- Use the `TAttMarker::SetMarkerSize(size)` method to set the `size` of a marker.
 
*/
 
////////////////////////////////////////////////////////////////////////////////
/// Marker default constructor.
 
TMarker::TMarker(): TObject(), TAttMarker()
{
   fX = 0;
   fY = 0;
}
 
////////////////////////////////////////////////////////////////////////////////
/// Marker normal constructor.
 
TMarker::TMarker(Double_t x, Double_t y, Int_t marker)
      :TObject(), TAttMarker()
{
   fX = x;
   fY = y;
   fMarkerStyle = marker;
}
 
////////////////////////////////////////////////////////////////////////////////
/// Marker default destructor.
 
TMarker::~TMarker()
{
}
 
////////////////////////////////////////////////////////////////////////////////
/// Marker copy constructor.
 
TMarker::TMarker(const TMarker &marker) : TObject(marker), TAttMarker(marker), TAttBBox2D(marker)
{
   fX = 0;
   fY = 0;
   marker.TMarker::Copy(*this);
}
 
////////////////////////////////////////////////////////////////////////////////
/// Copy this marker to marker.
 
void TMarker::Copy(TObject &obj) const
{
   TObject::Copy(obj);
   TAttMarker::Copy(((TMarker &)obj));
   ((TMarker &)obj).fX = fX;
   ((TMarker &)obj).fY = fY;
}
 
////////////////////////////////////////////////////////////////////////////////
/// Display the table of markers with their numbers.
 
void TMarker::DisplayMarkerTypes()
{
   TMarker marker;
   TText text;
   marker.SetMarkerSize(3);
   text.SetTextFont(62);
   text.SetTextAlign(22);
   text.SetTextSize(0.1);
   TString atext;
   Double_t x = 0;
   Double_t dx = 1/16.0;
   for (Int_t i=1;i<16;i++) {
      x += dx;
      atext.Form("%d",i);
      marker.SetMarkerStyle(i);
      marker.DrawMarker(x,.25);
      text.DrawText(x,.12,atext.Data());
      atext.Form("%d",i+19);
      marker.SetMarkerStyle(i+19);
      marker.DrawMarker(x,.55);
      text.DrawText(x,.42,atext.Data());
      atext.Form("%d",i+34);
      marker.SetMarkerStyle(i+34);
      marker.DrawMarker(x,.85);
      text.DrawText(x,.72,atext.Data());
   }
}
 
////////////////////////////////////////////////////////////////////////////////
/// Display the table of markers with different line widths and their numbers.
 
void TMarker::DisplayMarkerLineWidths()
{
   TMarker marker;
   TText text;
   marker.SetMarkerSize(3);
   text.SetTextFont(62);
   text.SetTextAlign(22);
   text.SetTextSize(0.075);
   TString atext;
   Double_t x = 0;
   Double_t dx = 1/19.0;
   for (Int_t i=1;i<19;i++) {
      x += dx;
      atext.Form("%d",i+49);
      marker.SetMarkerStyle(i+49);
      marker.DrawMarker(x,0.19);
      text.DrawText(x,0.08,atext.Data());
      atext.Form("%d",i+67);
      marker.SetMarkerStyle(i+67);
      marker.DrawMarker(x,0.42);
      text.DrawText(x,0.31,atext.Data());
      atext.Form("%d",i+85);
      marker.SetMarkerStyle(i+85);
      marker.DrawMarker(x,0.65);
      text.DrawText(x,0.54,atext.Data());
      atext.Form("%d",i+103);
      marker.SetMarkerStyle(i+103);
      marker.DrawMarker(x,0.88);
      text.DrawText(x,0.77,atext.Data());
   }
}
 
////////////////////////////////////////////////////////////////////////////////
/// Compute distance from point px,py to a marker.
///
///  Compute the closest distance of approach from point px,py to this marker.
///  The distance is computed in pixels units.
///  \return 0 if the distance <= markerRadius
///          exact computed distance if dist in [markerRadius+1, markerRadius+2]
///          999 if larger than markerRadius + 3
///          9999 if no pad
 
Int_t TMarker::DistancetoPrimitive(Int_t px, Int_t py)
{
   if (!gPad) return 9999;
   Int_t pxm, pym;
   if (TestBit(kMarkerNDC)) {
      pxm = gPad->UtoAbsPixel(fX);
      pym = gPad->VtoAbsPixel(fY);
   } else {
      pxm  = gPad->XtoAbsPixel(gPad->XtoPad(fX));
      pym  = gPad->YtoAbsPixel(gPad->YtoPad(fY));
   }
   Int_t dist = static_cast<Int_t>(std::min<Long64_t>(INT_MAX, TMath::Sqrt(Long64_t(px-pxm)*(px-pxm) + Long64_t(py-pym)*(py-pym))));
 
   //marker size = 1 is about 8 pixels
   Int_t markerRadius = Int_t(4*fMarkerSize);
   if (dist <= markerRadius)   return 0;
   if (dist >  markerRadius+3) return 999;
   return dist;
}
 
////////////////////////////////////////////////////////////////////////////////
/// Draw this marker with its current attributes.
 
void TMarker::Draw(Option_t *option)
{
   AppendPad(option);
}
 
////////////////////////////////////////////////////////////////////////////////
/// Draw this marker with new coordinates.
 
TMarker *TMarker::DrawMarker(Double_t x, Double_t y)
{
   TMarker *newmarker = new TMarker(x, y, 1);
   TAttMarker::Copy(*newmarker);
   newmarker->SetBit(kCanDelete);
   newmarker->AppendPad();
   return newmarker;
}
 
////////////////////////////////////////////////////////////////////////////////
/// Execute action corresponding to one event.
///
///  This member function is called when a marker is clicked with the locator
///
///  If Left button is clicked on a marker, the marker is moved to
///  a new position when the mouse button is released.
 
void TMarker::ExecuteEvent(Int_t event, Int_t px, Int_t py)
{
   if (!gPad || !gPad->IsEditable()) return;
 
   auto &parent = *gPad;
 
   Bool_t opaque = parent.OpaqueMoving();
 
   auto action = [this, &parent](Bool_t paint, Int_t posx, Int_t posy) {
      Double_t x = parent.AbsPixeltoX(posx);
      Double_t y = parent.AbsPixeltoY(posy);
      if (paint) {
         Double_t scale = TMath::Max(5., 4. * GetMarkerSize());
         Double_t dx = (parent.GetX2() - parent.GetX1()) / parent.GetPadWidth() * scale;
         Double_t dy = (parent.GetY2() - parent.GetY1()) / parent.GetPadHeight() * scale;
 
         Double_t xc[5] = { x, x + dx, x, x - dx, x };
         Double_t yc[5] = { y - dy, y, y + dy, y, y - dy };
         TAttLine(1,1,1).ModifyOn(parent);
         parent.PaintPolyLine(5, xc, yc, "imarker");
      } else if (TestBit(kMarkerNDC)) {
         SetX((x - parent.GetX1()) / (parent.GetX2() - parent.GetX1()));
         SetY((y - parent.GetY1()) / (parent.GetY2() - parent.GetY1()));
      } else {
         SetX(parent.PadtoX(x));
         SetY(parent.PadtoY(y));
      }
   };
 
   switch (event) {
 
   case kButton1Down:
   case kMouseMotion:
      parent.SetCursor(kMove);
      break;
 
   case kButton1Motion:
      if (opaque) {
         action(false, px, py);
         parent.ShowGuidelines(this, event, 'i', true);
         parent.Modified();
      } else {
         action(true, px, py);
      }
      parent.UpdateAsync();
      break;
 
   case kButton1Up:
      if (opaque) {
         parent.ShowGuidelines(this, event);
      } else {
         action(false, px, py);
         parent.Modified();
      }
      parent.UpdateAsync();
      break;
   }
}
 
////////////////////////////////////////////////////////////////////////////////
/// List this marker with its attributes.
 
void TMarker::ls(Option_t *) const
{
   TROOT::IndentLevel();
   printf("Marker  X=%f Y=%f marker type=%d\n",fX,fY,fMarkerStyle);
}
 
////////////////////////////////////////////////////////////////////////////////
/// Paint this marker with its current attributes.
 
void TMarker::Paint(Option_t *)
{
   if (!gPad)
      return;
   if (TestBit(kMarkerNDC))
      PaintMarkerNDC(GetX(), GetY());
   else
      PaintMarker(gPad->XtoPad(GetX()), gPad->YtoPad(GetY()));
}
 
////////////////////////////////////////////////////////////////////////////////
/// Draw this marker with new coordinates.
 
void TMarker::PaintMarker(Double_t x, Double_t y)
{
   TAttMarker::Modify();  //Change line attributes only if necessary
   if (gPad) gPad->PaintPolyMarker(-1, &x, &y, "");
}
 
////////////////////////////////////////////////////////////////////////////////
/// Draw this marker with new coordinates in NDC.
 
void TMarker::PaintMarkerNDC(Double_t u, Double_t v)
{
   Double_t x = gPad->GetX1() + u * (gPad->GetX2() - gPad->GetX1());
   Double_t y = gPad->GetY1() + v * (gPad->GetY2() - gPad->GetY1());
   PaintMarker(x, y);
}
 
////////////////////////////////////////////////////////////////////////////////
/// Dump this marker with its attributes.
 
void TMarker::Print(Option_t *) const
{
   printf("Marker  X=%f Y=%f",fX,fY);
   if (GetMarkerColor() != 1) printf(" Color=%d",GetMarkerColor());
   if (GetMarkerStyle() != 1) printf(" MarkerStyle=%d",GetMarkerStyle());
   if (GetMarkerSize()  != 1) printf(" MarkerSize=%f",GetMarkerSize());
   printf("\n");
}
 
////////////////////////////////////////////////////////////////////////////////
/// Save primitive as a C++ statement(s) on output stream out
 
void TMarker::SavePrimitive(std::ostream &out, Option_t *option)
{
   SavePrimitiveConstructor(out, Class(), "marker", TString::Format("%g, %g, %d", fX, fY, fMarkerStyle), kFALSE);
 
   SaveMarkerAttributes(out, "marker", 1, 1, 1);
 
   SavePrimitiveDraw(out, "marker", option);
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set NDC mode on if isNDC = kTRUE, off otherwise
 
void TMarker::SetNDC(Bool_t isNDC)
{
   ResetBit(kMarkerNDC);
   if (isNDC) SetBit(kMarkerNDC);
}
 
////////////////////////////////////////////////////////////////////////////////
/// Stream an object of class TMarker.
 
void TMarker::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 > 1) {
         R__b.ReadClassBuffer(TMarker::Class(), this, R__v, R__s, R__c);
         return;
      }
      //====process old versions before automatic schema evolution
      TObject::Streamer(R__b);
      TAttMarker::Streamer(R__b);
      Float_t x,y;
      R__b >> x;  fX = x;
      R__b >> y;  fY = y;
      //====end of old versions
 
   } else {
      R__b.WriteClassBuffer(TMarker::Class(),this);
   }
}
 
////////////////////////////////////////////////////////////////////////////////
/// Return the bounding Box of the marker
 
Rectangle_t TMarker::GetBBox()
{
   auto size = GetMarkerSize();
   Rectangle_t bbox{0, 0, (UShort_t) (2*size), (UShort_t) (2*size) };
   if (gPad) {
      if (TestBit(kMarkerNDC)) {
         bbox.fX = gPad->UtoPixel(GetX()) - size;
         bbox.fY = gPad->VtoPixel(GetY()) - size;
      } else {
         bbox.fX = gPad->XtoPixel(gPad->XtoPad(GetX())) - size;
         bbox.fY = gPad->YtoPixel(gPad->YtoPad(GetY())) - size;
      }
   }
   return bbox;
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set X coordinate of the center of the BoundingBox
 
void TMarker::SetBBoxCenterX(const Int_t x)
{
   SetX(GetXCoord(x, TestBit(kMarkerNDC)));
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set Y coordinate of the center of the BoundingBox
 
void TMarker::SetBBoxCenterY(const Int_t y)
{
   SetY(GetYCoord(y, TestBit(kMarkerNDC)));
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set left hand side of BoundingBox to a value
/// (resize in x direction on left)
 
void TMarker::SetBBoxX1(const Int_t x)
{
   SetBBoxCenterX(x + GetMarkerSize());
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set right hand side of BoundingBox to a value
/// (resize in x direction on right)
 
void TMarker::SetBBoxX2(const Int_t x)
{
   SetBBoxCenterX(x - GetMarkerSize());
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set top of BoundingBox to a value (resize in y direction on top)
 
void TMarker::SetBBoxY1(const Int_t y)
{
   SetBBoxCenterY(y + GetMarkerSize());
}
 
////////////////////////////////////////////////////////////////////////////////
/// Set bottom of BoundingBox to a value
/// (resize in y direction on bottom)
 
void TMarker::SetBBoxY2(const Int_t y)
{
   SetBBoxCenterY(y - GetMarkerSize());
}