ROOT
6.07/01
Reference Guide
|
A poly-extrusion.
XTRU is a poly-extrusion with fixed outline shape in x-y, a sequence of z extents (segments) and two end faces perpendicular to the z axis. The x-y outline is defined by an ordered list of points; the overall scale of the outline scales linearly between z points and the center can have an x-y offset specified at each segment end.
A TXTRU has the following parameters:
All XTRU shapes are correctly rendered in wire mode but can encounter difficulty when rendered as a solid with hidden surfaces. These exceptions occur if the outline shape is not a convex polygon. Both the X3D and OpenGL renderers expect polygons to be convex. The OpenGL spec specifies that points defining a polygon using the GL_POLYGON primitive may be rendered as the convex hull of that set.
Solid rendering under X3D can also give unexpected artifacts if the combination of x-y-z offsets and scales for the segments are chosen in such a manner that they represent a concave shape when sliced along a plane parallel to the z axis.
Choosing sets of point that represent a malformed polygon is not supported, but testing for such a condition is not implemented and thus it is left to the user to avoid this mistake.
Public Member Functions | |
TXTRU () | |
TXTRU (const char *name, const char *title, const char *material, Int_t nyx, Int_t nz) | |
TXTRU shape - normal constructor. More... | |
TXTRU (const TXTRU &xtru) | |
TXTRU copy constructor. More... | |
virtual | ~TXTRU () |
TXTRU destructor deallocates arrays. More... | |
TXTRU & | operator= (const TXTRU &rhs) |
Deep assignment operator. More... | |
virtual void | Copy (TObject &xtru) const |
TXTRU Copy method. More... | |
virtual void | DefineSection (Int_t secNum, Float_t z, Float_t scale=1., Float_t x0=0., Float_t y0=0.) |
Set z section iz information expand size of array if necessary. More... | |
virtual void | DefineVertex (Int_t pointNum, Float_t x, Float_t y) |
Set vertex point ipt to (x,y) expand size of array if necessary. More... | |
virtual Int_t | DistancetoPrimitive (Int_t px, Int_t py) |
Compute the distance from point px,py to a TXTRU by calculating the closest approach to each corner. More... | |
virtual const TBuffer3D & | GetBuffer3D (Int_t) const |
Get buffer 3d. More... | |
virtual Int_t | GetNxy () const |
virtual Int_t | GetNz () const |
virtual Float_t | GetOutlinePointX (Int_t pointNum) const |
Return x coordinate of a vertex point. More... | |
virtual Float_t | GetOutlinePointY (Int_t pointNum) const |
Return y coordinate of a vertex point. More... | |
virtual Float_t | GetSectionX0 (Int_t secNum) const |
Return x0 shift of a z section. More... | |
virtual Float_t | GetSectionY0 (Int_t secNum) const |
Return y0 shift of a z section. More... | |
virtual Float_t | GetSectionScale (Int_t secNum) const |
Return scale factor for a z section. More... | |
virtual Float_t | GetSectionZ (Int_t secNum) const |
Return z of a z section. More... | |
virtual Float_t * | GetXvtx () const |
virtual Float_t * | GetYvtx () const |
virtual Float_t * | GetZ () const |
virtual Float_t * | GetScale () const |
virtual Float_t * | GetX0 () const |
virtual Float_t * | GetY0 () const |
virtual void | Print (Option_t *option="") const |
Dump the info of this TXTRU shape Option: More... | |
virtual void | Sizeof3D () const |
Return total X3D needed by TNode::ls (when called with option "x") More... | |
void | SplitConcavePolygon (Bool_t split=kTRUE) |
(Dis)Enable the splitting of concave polygon outlines into multiple convex polygons. More... | |
virtual void | TruncateNxy (Int_t npts) |
Truncate the vertex list. More... | |
virtual void | TruncateNz (Int_t npts) |
Truncate the z section list. More... | |
Public Member Functions inherited from TShape | |
TShape () | |
TShape (const char *name, const char *title, const char *material) | |
Shape normal constructor. More... | |
TShape (const TShape &) | |
copy constructor More... | |
TShape & | operator= (const TShape &) |
assignment operator More... | |
virtual | ~TShape () |
Shape default destructor. More... | |
TMaterial * | GetMaterial () const |
virtual Int_t | GetNumber () const |
Int_t | GetVisibility () const |
virtual void | Paint (Option_t *option="") |
This method is used only when a shape is painted outside a TNode. More... | |
virtual void | SetName (const char *name) |
Change (i.e. More... | |
virtual void | SetVisibility (Int_t vis) |
void | TransformPoints (Double_t *points, UInt_t NbPnts) const |
Transform points (LocalToMaster) 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) | |
TNamed & | operator= (const TNamed &rhs) |
TNamed assignment operator. More... | |
virtual | ~TNamed () |
virtual void | Clear (Option_t *option="") |
Set name and title to empty strings (""). More... | |
virtual TObject * | Clone (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 | 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 | 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 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... | |
TObject & | operator= (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 | Draw (Option_t *option="") |
Default Draw method for all objects. More... | |
virtual void | DrawClass () const |
Draw class inheritance tree of the class to which this object belongs. More... | |
virtual TObject * | DrawClone (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 void | ExecuteEvent (Int_t event, Int_t px, Int_t py) |
Execute action corresponding to an event at (px,py). More... | |
virtual TObject * | FindObject (const char *name) const |
Must be redefined in derived classes. More... | |
virtual TObject * | FindObject (const TObject *obj) const |
Must be redefined in derived classes. More... | |
virtual Option_t * | GetDrawOption () 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_t * | GetOption () 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 | SavePrimitive (std::ostream &out, Option_t *option="") |
Save a primitive as a C++ statement(s) on output stream "out". 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... | |
void * | operator new (size_t sz) |
void * | operator new[] (size_t sz) |
void * | operator new (size_t sz, void *vp) |
void * | operator 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 TAttLine | |
TAttLine () | |
AttLine default constructor. More... | |
TAttLine (Color_t lcolor, Style_t lstyle, Width_t lwidth) | |
AttLine normal constructor. More... | |
virtual | ~TAttLine () |
AttLine destructor. More... | |
void | Copy (TAttLine &attline) const |
Copy this line attributes to a new TAttLine. More... | |
Int_t | DistancetoLine (Int_t px, Int_t py, Double_t xp1, Double_t yp1, Double_t xp2, Double_t yp2) |
Compute distance from point px,py to a line. More... | |
virtual Color_t | GetLineColor () const |
virtual Style_t | GetLineStyle () const |
virtual Width_t | GetLineWidth () const |
virtual void | Modify () |
Change current line attributes if necessary. More... | |
virtual void | ResetAttLine (Option_t *option="") |
Reset this line attributes to default values. More... | |
virtual void | SaveLineAttributes (std::ostream &out, const char *name, Int_t coldef=1, Int_t stydef=1, Int_t widdef=1) |
Save line attributes as C++ statement(s) on output stream out. More... | |
virtual void | SetLineAttributes () |
Invoke the DialogCanvas Line attributes. More... | |
virtual void | SetLineColor (Color_t lcolor) |
virtual void | SetLineColorAlpha (Color_t lcolor, Float_t lalpha) |
Set a transparent line color. More... | |
virtual void | SetLineStyle (Style_t lstyle) |
virtual void | SetLineWidth (Width_t lwidth) |
ClassDef (TAttLine, 2) | |
Public Member Functions inherited from TAttFill | |
TAttFill () | |
TAttFill (Color_t fcolor, Style_t fstyle) | |
AttFill normal constructor. More... | |
virtual | ~TAttFill () |
AttFill destructor. More... | |
void | Copy (TAttFill &attfill) const |
Copy this fill attributes to a new TAttFill. More... | |
virtual Color_t | GetFillColor () const |
virtual Style_t | GetFillStyle () const |
virtual Bool_t | IsTransparent () const |
virtual void | Modify () |
Change current fill area attributes if necessary. More... | |
virtual void | ResetAttFill (Option_t *option="") |
Reset this fill attributes to default values. More... | |
virtual void | SaveFillAttributes (std::ostream &out, const char *name, Int_t coldef=1, Int_t stydef=1001) |
Save fill attributes as C++ statement(s) on output stream out. More... | |
virtual void | SetFillAttributes () |
Invoke the DialogCanvas Fill attributes. More... | |
virtual void | SetFillColor (Color_t fcolor) |
virtual void | SetFillColorAlpha (Color_t fcolor, Float_t falpha) |
Set a transparent fill color. More... | |
virtual void | SetFillStyle (Style_t fstyle) |
Public Member Functions inherited from TAtt3D | |
TAtt3D () | |
virtual | ~TAtt3D () |
Protected Types | |
enum | EXYChecked { kUncheckedXY, kMalformedXY, kConvexCCW, kConvexCW, kConcaveCCW, kConcaveCW } |
enum | EZChecked { kUncheckedZ, kMalformedZ, kConvexIncZ, kConvexDecZ, kConcaveIncZ, kConcaveDecZ } |
Protected Member Functions | |
void | CheckOrdering () |
Determine ordering over which to process points, segments, surfaces so that they render correctly. More... | |
virtual void | SetPoints (Double_t *points) const |
Create TXTRU points in buffer order as expected by other methods (counterclockwise xy, increasing z) More... | |
Protected Member Functions inherited from TShape | |
virtual void | FillBuffer3D (TBuffer3D &buffer, Int_t reqSections) const |
We have to set kRawSize (unless already done) to allocate buffer space before kRaw can be filled. More... | |
Int_t | GetBasicColor () const |
Get basic color. More... | |
Int_t | ShapeDistancetoPrimitive (Int_t numPoints, Int_t px, Int_t py) |
Distance to primitive. 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... | |
Protected Attributes | |
Int_t | fNxy |
Int_t | fNxyAlloc |
Int_t | fNz |
Int_t | fNzAlloc |
Float_t * | fXvtx |
Float_t * | fYvtx |
Float_t * | fZ |
Float_t * | fScale |
Float_t * | fX0 |
Float_t * | fY0 |
EXYChecked | fPolygonShape |
EZChecked | fZOrdering |
Bool_t | fSplitConcave |
Protected Attributes inherited from TShape | |
Int_t | fNumber |
Int_t | fVisibility |
TMaterial * | fMaterial |
Protected Attributes inherited from TNamed | |
TString | fName |
TString | fTitle |
Protected Attributes inherited from TAttLine | |
Color_t | fLineColor |
Style_t | fLineStyle |
Width_t | fLineWidth |
Protected Attributes inherited from TAttFill | |
Color_t | fFillColor |
Style_t | fFillStyle |
Private Member Functions | |
void | DumpPoints (int npoints, float *pointbuff) const |
Dump the vertex points for visual inspection. More... | |
void | DumpSegments (int nsegments, int *segbuff) const |
Dump the segment info for visual inspection. More... | |
void | DumpPolygons (int npolygons, int *polybuff, int buffsize) const |
Dump the derived polygon info for visual inspection. 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... | |
#include <TXTRU.h>
|
protected |
|
protected |
TXTRU::TXTRU | ( | ) |
TXTRU shape - normal constructor.
Parameters of Nxy positions must be entered via TXTRU::DefineVertex Parameters of Nz positions must be entered via TXTRU::DefineSection
TXTRU::TXTRU | ( | const TXTRU & | xtru | ) |
|
virtual |
|
protected |
Determine ordering over which to process points, segments, surfaces so that they render correctly.
Generally this has to do with getting outward normals in the hidden/solid surface case.
Definition at line 592 of file TXTRU.cxx.
Referenced by GetBuffer3D().
|
virtual |
Set z section iz information expand size of array if necessary.
Definition at line 250 of file TXTRU.cxx.
Referenced by xtruDraw(), and xtruSamples().
Set vertex point ipt to (x,y) expand size of array if necessary.
Definition at line 304 of file TXTRU.cxx.
Referenced by xtruDraw(), and xtruSamples().
|
private |
|
private |
|
private |
Create TXTRU points in buffer order as expected by other methods (counterclockwise xy, increasing z)
Reimplemented from TShape.
Definition at line 499 of file TXTRU.cxx.
Referenced by GetBuffer3D().
|
virtual |
|
protected |
Definition at line 63 of file TXTRU.h.
Referenced by CheckOrdering(), Copy(), DefineVertex(), DistancetoPrimitive(), GetBuffer3D(), GetNxy(), GetOutlinePointX(), GetOutlinePointY(), Print(), SetPoints(), Sizeof3D(), TruncateNxy(), TXTRU(), and ~TXTRU().
|
protected |
Definition at line 64 of file TXTRU.h.
Referenced by Copy(), DefineVertex(), operator=(), Print(), TXTRU(), and ~TXTRU().
|
protected |
Definition at line 65 of file TXTRU.h.
Referenced by CheckOrdering(), Copy(), DefineSection(), DistancetoPrimitive(), GetBuffer3D(), GetNz(), GetSectionScale(), GetSectionX0(), GetSectionY0(), GetSectionZ(), Print(), SetPoints(), Sizeof3D(), TruncateNz(), TXTRU(), and ~TXTRU().
|
protected |
Definition at line 66 of file TXTRU.h.
Referenced by Copy(), DefineSection(), operator=(), Print(), TXTRU(), and ~TXTRU().
|
protected |
Definition at line 81 of file TXTRU.h.
Referenced by CheckOrdering(), Copy(), DefineVertex(), GetBuffer3D(), Print(), SetPoints(), TXTRU(), and ~TXTRU().
|
protected |
Definition at line 70 of file TXTRU.h.
Referenced by CheckOrdering(), Copy(), DefineSection(), GetScale(), GetSectionScale(), operator=(), Print(), SetPoints(), TXTRU(), and ~TXTRU().
|
protected |
Definition at line 87 of file TXTRU.h.
Referenced by SplitConcavePolygon(), and TXTRU().
|
protected |
Definition at line 71 of file TXTRU.h.
Referenced by Copy(), DefineSection(), GetSectionX0(), GetX0(), operator=(), Print(), SetPoints(), TXTRU(), and ~TXTRU().
|
protected |
Definition at line 67 of file TXTRU.h.
Referenced by CheckOrdering(), Copy(), DefineVertex(), GetOutlinePointX(), GetXvtx(), operator=(), Print(), SetPoints(), TXTRU(), and ~TXTRU().
|
protected |
Definition at line 72 of file TXTRU.h.
Referenced by Copy(), DefineSection(), GetSectionY0(), GetY0(), operator=(), Print(), SetPoints(), TXTRU(), and ~TXTRU().
|
protected |
Definition at line 68 of file TXTRU.h.
Referenced by CheckOrdering(), Copy(), DefineVertex(), GetOutlinePointY(), GetYvtx(), operator=(), Print(), SetPoints(), TXTRU(), and ~TXTRU().
|
protected |
Definition at line 69 of file TXTRU.h.
Referenced by CheckOrdering(), Copy(), DefineSection(), GetSectionZ(), GetZ(), operator=(), Print(), SetPoints(), TXTRU(), and ~TXTRU().
|
protected |
Definition at line 82 of file TXTRU.h.
Referenced by CheckOrdering(), Copy(), DefineSection(), GetBuffer3D(), Print(), SetPoints(), TXTRU(), and ~TXTRU().