Skip to content

[skip-ci] improve TPad::Divide help #20260

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Nov 3, 2025
Merged

[skip-ci] improve TPad::Divide help #20260

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
816cd1c
[skip-ci] improve TPad::Divide help
couet Oct 31, 2025
b88d663
Better definitions of xmargin and ymargin
couet Nov 3, 2025
4b297f0
simplify the example
couet Nov 3, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 34 additions & 5 deletions graf2d/gpad/src/TPad.cxx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1225,8 +1225,12 @@ Int_t TPad::DistancetoPrimitive(Int_t px, Int_t py)
/// Automatic pad generation by division.
///
/// - The current canvas is divided in nx by ny equal divisions (pads).
/// - xmargin is the space along x between pads in percent of canvas.
/// - ymargin is the space along y between pads in percent of canvas.
/// - xmargin defines the horizontal spacing around each pad as a percentage of the canvas
/// width. Therefore, the distance between two adjacent pads along the x-axis is equal
/// to twice the xmargin value.
/// - ymargin defines the vertical spacing around each pad as a percentage of the canvas
/// height. Therefore, the distance between two adjacent pads along the y-axis is equal
/// to twice the ymargin value.
/// - color is the color of the new pads. If 0, color is the canvas color.
///
/// Pads are automatically named `canvasname_n` where `n` is the division number
Expand All @@ -1253,7 +1257,32 @@ Int_t TPad::DistancetoPrimitive(Int_t px, Int_t py)
///
/// __Note3:__ in case xmargin < 0 or ymargin < 0, there is no space
/// between pads. The current pad margins are recomputed to
/// optimize the layout.
/// optimize the layout in order to have similar frames' areas.
/// See the following example:
///
/// ~~~ {.cpp}
/// void divpad(Int_t nx=3, Int_t ny=2) {
/// gStyle->SetOptStat(0);
/// auto C = new TCanvas();
/// C->SetMargin(0.3, 0.3, 0.3, 0.3);
/// C->Divide(nx,ny,-1);
/// Int_t number = 0;
/// auto h = new TH1F("","",100,-3.3,3.3);
/// h->GetXaxis()->SetLabelFont(43);
/// h->GetXaxis()->SetLabelSize(12);
/// h->GetYaxis()->SetLabelFont(43);
/// h->GetYaxis()->SetLabelSize(12);
/// h->GetYaxis()->SetNdivisions(505);
/// h->SetMaximum(30*nx*ny);
/// h->SetFillColor(42);
/// for (Int_t i=0;i<nx*ny;i++) {
/// number++;
/// C->cd(number);
/// h->FillRandom("gaus",1000);
/// h->DrawCopy();
/// }
/// }
/// ~~~

void TPad::Divide(Int_t nx, Int_t ny, Float_t xmargin, Float_t ymargin, Int_t color)
{
Expand Down Expand Up @@ -4492,7 +4521,7 @@ void TPad::PaintLine3D(Float_t *p1, Float_t *p2)
void TPad::PaintLine3D(Double_t *p1, Double_t *p2)
{
if (!fView) return;

// convert from 3-D to 2-D pad coordinate system
Double_t xpad[6];
Double_t temp[3];
Expand All @@ -4510,7 +4539,7 @@ void TPad::PaintLine3D(Double_t *p1, Double_t *p2)
void TPad::PaintMarker3D(Double_t x, Double_t y, Double_t z)
{
if (!fView) return;

Double_t rmin[3], rmax[3];
fView->GetRange(rmin, rmax);

Expand Down