Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
TASImage Class Reference

Image class.

TASImage is the concrete interface to the image processing library libAfterImage.

It allows reading and writing of images in different formats, several image manipulations (scaling, tiling, merging, etc.) and displaying in pads. The size of the image on the screen does not depend on the original size of the image but on the size of the pad. Therefore it is very easy to resize the image on the screen by resizing the pad.

Besides reading an image from a file an image can be defined by a two dimensional array of values. A palette defines the color of each value.

The image can be zoomed by defining a rectangle with the mouse. The color palette can be modified with a GUI, just select StartPaletteEditor() from the context menu.

Several examples showing how to use this class are available in the ROOT tutorials: $ROOTSYS/tutorials/image/

Definition at line 31 of file TASImage.h.

Public Member Functions

 TASImage ()
 Default image constructor.
 
 TASImage (const char *file, EImageFileTypes type=kUnknown)
 Create an image object and read from specified file.
 
 TASImage (const char *name, const Double_t *imageData, UInt_t width, UInt_t height, TImagePalette *palette=nullptr)
 Create an image depending on the values of imageData.
 
 TASImage (const char *name, const TArrayD &imageData, UInt_t width, TImagePalette *palette=nullptr)
 Create an image depending on the values of imageData.
 
 TASImage (const char *name, const TVectorD &imageData, UInt_t width, TImagePalette *palette=nullptr)
 Create an image depending on the values of imageData.
 
 TASImage (const TASImage &img)
 Image copy constructor.
 
 TASImage (UInt_t w, UInt_t h)
 Create an empty image.
 
 ~TASImage () override
 Image destructor, clean up image and visual.
 
void Append (const TImage *im, const char *option="+", const char *color="#00000000") override
 Append image.
 
void BeginPaint (Bool_t fast=kTRUE) override
 BeginPaint initializes internal array[width x height] of ARGB32 pixel values.
 
void Bevel (Int_t x=0, Int_t y=0, UInt_t width=0, UInt_t height=0, const char *hi="#ffdddddd", const char *lo="#ff555555", UShort_t thick=1, Bool_t pressed=kFALSE) override
 Bevel is used to create 3D effect while drawing buttons, or any other image that needs to be framed.
 
void Blur (Double_t hr=3, Double_t vr=3) override
 Perform Gaussian blur of the image (useful for drop shadows).
 
void Browse (TBrowser *) override
 Browse image.
 
TObjectClone (const char *newname) const override
 Clone image.
 
void CopyArea (TImage *dst, Int_t xsrc, Int_t ysrc, UInt_t w, UInt_t h, Int_t xdst=0, Int_t ydst=0, Int_t gfunc=3, EColorChan chan=kAllChan) override
 Copy source region to the destination image.
 
void Crop (Int_t x=0, Int_t y=0, UInt_t width=0, UInt_t height=0) override
 Crop an image.
 
void CropPolygon (UInt_t npt, TPoint *ppt) override
 Crop a convex polygon.
 
void CropSpans (UInt_t npt, TPoint *ppt, UInt_t *widths) override
 Crop spans.
 
Int_t DistancetoPrimitive (Int_t px, Int_t py) override
 Is the mouse in the image ?
 
void Draw (Option_t *option="") override
 Draw image.
 
void DrawBox (Int_t x1, Int_t y1, Int_t x2, Int_t y2, const char *col="#000000", UInt_t thick=1, Int_t mode=0) override
 Draw a box.
 
void DrawCellArray (Int_t x1, Int_t y1, Int_t x2, Int_t y2, Int_t nx, Int_t ny, UInt_t *ic) override
 Draw a cell array.
 
void DrawCircle (Int_t x, Int_t y, Int_t r, const char *col="#000000", Int_t thick=1) override
 Draw a circle.
 
void DrawCubeBezier (Int_t x1, Int_t y1, Int_t x2, Int_t y2, Int_t x3, Int_t y3, const char *col="#000000", UInt_t thick=1) override
 Draw a cubic bezier line.
 
void DrawDashLine (UInt_t x1, UInt_t y1, UInt_t x2, UInt_t y2, UInt_t nDash, const char *pDash, const char *col="#000000", UInt_t thick=1) override
 Draw a dashed line.
 
void DrawEllips (Int_t x, Int_t y, Int_t rx, Int_t ry, Int_t angle, const char *col="#000000", Int_t thick=1) override
 Draw an ellipse.
 
void DrawEllips2 (Int_t x, Int_t y, Int_t rx, Int_t ry, Int_t angle, const char *col="#000000", Int_t thick=1) override
 Draw an ellipse.
 
void DrawFillArea (UInt_t npt, TPoint *ppt, const char *col="#000000", const char *stipple=nullptr, UInt_t w=16, UInt_t h=16) override
 Fill a polygon (any type convex, non-convex).
 
void DrawFillArea (UInt_t npt, TPoint *ppt, TImage *tile) override
 Fill a polygon (any type convex, non-convex).
 
void DrawLine (UInt_t x1, UInt_t y1, UInt_t x2, UInt_t y2, const char *col="#000000", UInt_t thick=1) override
 Draw a line.
 
void DrawPolyLine (UInt_t nn, TPoint *xy, const char *col="#000000", UInt_t thick=1, TImage::ECoordMode mode=kCoordModeOrigin) override
 Draw a polyline.
 
void DrawRectangle (UInt_t x, UInt_t y, UInt_t w, UInt_t h, const char *col="#000000", UInt_t thick=1) override
 Draw a rectangle.
 
void DrawSegments (UInt_t nseg, Segment_t *seg, const char *col="#000000", UInt_t thick=1) override
 Draw segments.
 
void DrawStraightEllips (Int_t x, Int_t y, Int_t rx, Int_t ry, const char *col="#000000", Int_t thick=1) override
 Draw a straight ellipse.
 
void DrawText (Int_t x=0, Int_t y=0, const char *text="", Int_t size=12, const char *color=nullptr, const char *font="fixed", EText3DType type=TImage::kPlain, const char *fore_file=nullptr, Float_t angle=0) override
 Draw text of size (in pixels for TrueType fonts) at position (x, y) with color specified by hex string.
 
void DrawText (TText *text, Int_t x=0, Int_t y=0) override
 Draw text at the pixel position (x,y).
 
void EndPaint () override
 EndPaint does internal RLE compression of image data.
 
void ExecuteEvent (Int_t event, Int_t px, Int_t py) override
 Execute mouse events.
 
void FillPolygon (UInt_t npt, TPoint *ppt, const char *col="#000000", const char *stipple=nullptr, UInt_t w=16, UInt_t h=16) override
 Fill a convex polygon with background color or bitmap.
 
void FillPolygon (UInt_t npt, TPoint *ppt, TImage *tile) override
 Fill a convex polygon with background image.
 
void FillRectangle (const char *col=nullptr, Int_t x=0, Int_t y=0, UInt_t width=0, UInt_t height=0) override
 Fill rectangle of size (width, height) at position (x,y) within the existing image with specified color.
 
void FillSpans (UInt_t npt, TPoint *ppt, UInt_t *widths, const char *col="#000000", const char *stipple=nullptr, UInt_t w=16, UInt_t h=16) override
 Fill spans with specified color or/and stipple.
 
void FillSpans (UInt_t npt, TPoint *ppt, UInt_t *widths, TImage *tile) override
 Fill spans with tile image.
 
void Flip (Int_t flip=180) override
 Flip image in place.
 
void FloodFill (Int_t x, Int_t y, const char *col, const char *min_col, const char *max_col=nullptr) override
 Flood fill.
 
void FromGLBuffer (UChar_t *buf, UInt_t w, UInt_t h) override
 Creates an image (screenshot) from a RGBA buffer.
 
void FromPad (TVirtualPad *pad, Int_t x=0, Int_t y=0, UInt_t w=0, UInt_t h=0) override
 Create an image from the given pad, afterwards this image can be saved in any of the supported image formats.
 
void FromWindow (Drawable_t wid, Int_t x=0, Int_t y=0, UInt_t w=0, UInt_t h=0) override
 Create an image (screenshot) from specified window.
 
UInt_tGetArgbArray () override
 Return a pointer to internal array[width x height] of ARGB32 values This array is directly accessible.
 
TArrayDGetArray (UInt_t w=0, UInt_t h=0, TImagePalette *pal=gWebImagePalette) override
 In case of vectorized image return an associated array of doubles otherwise this method creates and returns a 2D array of doubles corresponding to palette.
 
UInt_t GetHeight () const override
 Return height of original image not of the displayed image.
 
const char * GetIconName () const override
 Returns mime type name of object.
 
ASImage * GetImage () const
 
void GetImageBuffer (char **buffer, int *size, EImageFileTypes type=TImage::kPng) override
 Return in-memory buffer compressed according image type.
 
Pixmap_t GetMask () override
 Returns image mask pixmap (alpha channel).
 
char * GetObjectInfo (Int_t px, Int_t py) const override
 Get image pixel coordinates and the pixel value at the mouse pointer.
 
TArrayLGetPixels (Int_t x=0, Int_t y=0, UInt_t w=0, UInt_t h=0) override
 Return 2D array of machine dependent pixel values.
 
Pixmap_t GetPixmap () override
 Returns image pixmap.
 
UInt_tGetRgbaArray () override
 Return a pointer to an array[width x height] of RGBA32 values.
 
UInt_t GetScaledHeight () const
 Return height of the displayed image not of the original image.
 
TImageGetScaledImage () const override
 
UInt_t GetScaledWidth () const
 Return width of the displayed image not of the original image.
 
UInt_tGetScanline (UInt_t y) override
 Return a pointer to scan-line.
 
const char * GetTitle () const override
 Title is used to keep 32x32 xpm image's thumbnail.
 
Double_tGetVecArray () override
 Return a pointer to internal array[width x height] of double values [0,1].
 
UInt_t GetWidth () const override
 Return width of original image not of the displayed image.
 
void GetZoomPosition (UInt_t &x, UInt_t &y, UInt_t &w, UInt_t &h) const
 Return the zoom parameters.
 
void Gradient (UInt_t angle=0, const char *colors="#FFFFFF #000000", const char *offsets=nullptr, Int_t x=0, Int_t y=0, UInt_t width=0, UInt_t height=0) override
 Render multipoint gradient inside rectangle of size (width, height) at position (x,y) within the existing image.
 
void Gray (Bool_t on=kTRUE) override
 Convert RGB image to Gray image and vice versa.
 
void HSV (UInt_t hue=0, UInt_t radius=360, Int_t H=0, Int_t S=0, Int_t V=0, Int_t x=0, Int_t y=0, UInt_t width=0, UInt_t height=0) override
 This function will tile original image to specified size with offsets requested, and then it will go though it and adjust hue, saturation and value of those pixels that have specific hue, set by affected_hue/ affected_radius parameters.
 
TClassIsA () const override
 
Bool_t IsEditable () const override
 
Bool_t IsGray () const override
 
Bool_t IsValid () const override
 
void Merge (const TImage *im, const char *op="alphablend", Int_t x=0, Int_t y=0) override
 Merge two images.
 
void Mirror (Bool_t vert=kTRUE) override
 Mirror image in place.
 
TASImageoperator= (const TASImage &img)
 Image assignment operator.
 
void Pad (const char *color="#00FFFFFF", UInt_t left=0, UInt_t right=0, UInt_t top=0, UInt_t bottom=0) override
 Enlarge image, padding it with specified color on each side in accordance with requested geometry.
 
void Paint (Option_t *option="") override
 Paint image.
 
void PaintImage (Drawable_t wid, Int_t x, Int_t y, Int_t xsrc=0, Int_t ysrc=0, UInt_t wsrc=0, UInt_t hsrc=0, Option_t *opt="") override
 Draw image on the drawable wid (pixmap, window) at x,y position.
 
void PolyPoint (UInt_t npt, TPoint *ppt, const char *col="#000000", TImage::ECoordMode mode=kCoordModeOrigin) override
 Draw a poly point.
 
void PutPixel (Int_t x, Int_t y, const char *col="#000000") override
 Draw a point at the specified position.
 
void ReadImage (const char *file, EImageFileTypes type=TImage::kUnknown) override
 Read specified image file.
 
void SavePrimitive (std::ostream &out, Option_t *option="") override
 Save a primitive as a C++ statement(s) on output stream "out".
 
void Scale (UInt_t width, UInt_t height) override
 Scale the original image.
 
void SetEditable (Bool_t on=kTRUE) override
 
void SetImage (ASImage *image)
 
void SetImage (const Double_t *imageData, UInt_t width, UInt_t height, TImagePalette *palette=nullptr) override
 Deletes the old image and creates a new image depending on the values of imageData.
 
void SetImage (const TArrayD &imageData, UInt_t width, TImagePalette *palette=nullptr) override
 Delete the old image and creates a new image depending on the values of imageData.
 
void SetImage (const TVectorD &imageData, UInt_t width, TImagePalette *palette=nullptr) override
 Delete the old image and creates a new image depending on the values of imageData.
 
void SetImage (Pixmap_t pxm, Pixmap_t mask=0) override
 Create image from pixmap.
 
Bool_t SetImageBuffer (char **buffer, EImageFileTypes type=TImage::kPng) override
 Create image from compressed buffer.
 
Bool_t SetJpegDpi (const char *name, UInt_t dpi=72)
 Set an image printing resolution in Dots Per Inch units.
 
void SetPalette (const TImagePalette *palette) override
 Set a new palette to an image.
 
void SetPaletteEnabled (Bool_t on=kTRUE) override
 Switch on/off the image palette.
 
void SetTitle (const char *title="") override
 Set a title for an image.
 
void Slice (UInt_t xStart, UInt_t xEnd, UInt_t yStart, UInt_t yEnd, UInt_t toWidth, UInt_t toHeight) override
 Another method of enlarging images where corners remain unchanged, but middle part gets tiled.
 
void StartPaletteEditor () override
 Start palette editor.
 
void Streamer (TBuffer &) override
 Streamer for ROOT I/O.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
void Tile (UInt_t width, UInt_t height) override
 Tile the original image.
 
void UnZoom () override
 Un-zoom the image to original size.
 
Double_tVectorize (UInt_t max_colors=256, UInt_t dither=4, Int_t opaque_threshold=1) override
 Reduce color-depth of an image and fills vector of "scientific data" [0...1].
 
void WriteImage (const char *file, EImageFileTypes type=TImage::kUnknown) override
 Write image to specified file.
 
void Zoom (UInt_t offX, UInt_t offY, UInt_t width, UInt_t height) override
 The area of an image displayed in a pad is defined by this function.
 
- Public Member Functions inherited from TImage
 TImage (const TImage &img)
 
 TImage (UInt_t, UInt_t)
 
 ~TImage () override
 
TObjectClone (const char *) const override
 Make a clone of an object using the Streamer facility.
 
TClassIsA () const override
 
void ls (Option_t *option="") const override
 List this image with its attributes.
 
TImageoperator+= (const TImage &i)
 
TImageoperator/= (const TImage &i)
 
TImageoperator= (const TImage &img)
 
void Streamer (TBuffer &) override
 Stream an object of class TObject.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
- Public Member Functions inherited from TNamed
 TNamed ()
 
 TNamed (const char *name, const char *title)
 
 TNamed (const TNamed &named)
 TNamed copy ctor.
 
 TNamed (const TString &name, const TString &title)
 
virtual ~TNamed ()
 TNamed destructor.
 
void Clear (Option_t *option="") override
 Set name and title to empty strings ("").
 
TObjectClone (const char *newname="") const override
 Make a clone of an object using the Streamer facility.
 
Int_t Compare (const TObject *obj) const override
 Compare two TNamed objects.
 
void Copy (TObject &named) const override
 Copy this to obj.
 
virtual void FillBuffer (char *&buffer)
 Encode TNamed into output buffer.
 
const char * GetName () const override
 Returns name of object.
 
const char * GetTitle () const override
 Returns title of object.
 
ULong_t Hash () const override
 Return hash value for this object.
 
TClassIsA () const override
 
Bool_t IsSortable () const override
 
void ls (Option_t *option="") const override
 List TNamed name and title.
 
TNamedoperator= (const TNamed &rhs)
 TNamed assignment operator.
 
void Print (Option_t *option="") const override
 Print TNamed name and title.
 
virtual void SetName (const char *name)
 Set the name of the TNamed.
 
virtual void SetNameTitle (const char *name, const char *title)
 Set all the TNamed parameters (name and title).
 
virtual Int_t Sizeof () const
 Return size of the TNamed part of the TObject.
 
void Streamer (TBuffer &) override
 Stream an object of class TObject.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
- Public Member Functions inherited from TObject
 TObject ()
 TObject constructor.
 
 TObject (const TObject &object)
 TObject copy ctor.
 
virtual ~TObject ()
 TObject destructor.
 
void AbstractMethod (const char *method) const
 Use this method to implement an "abstract" method that you don't want to leave purely abstract.
 
virtual void AppendPad (Option_t *option="")
 Append graphics object to current pad.
 
ULong_t CheckedHash ()
 Check and record whether this class has a consistent Hash/RecursiveRemove setup (*) and then return the regular Hash value for this object.
 
virtual const char * ClassName () const
 Returns name of class to which the object belongs.
 
virtual void Delete (Option_t *option="")
 Delete this object.
 
virtual void DrawClass () const
 Draw class inheritance tree of the class to which this object belongs.
 
virtual TObjectDrawClone (Option_t *option="") const
 Draw a clone of this object in the current selected pad with: gROOT->SetSelectedPad(c1).
 
virtual void Dump () const
 Dump contents of object on stdout.
 
virtual void Error (const char *method, const char *msgfmt,...) const
 Issue error message.
 
virtual void Execute (const char *method, const char *params, Int_t *error=nullptr)
 Execute method on this object with the given parameter string, e.g.
 
virtual void Execute (TMethod *method, TObjArray *params, Int_t *error=nullptr)
 Execute method on this object with parameters stored in the TObjArray.
 
virtual void Fatal (const char *method, const char *msgfmt,...) const
 Issue fatal error message.
 
virtual TObjectFindObject (const char *name) const
 Must be redefined in derived classes.
 
virtual TObjectFindObject (const TObject *obj) const
 Must be redefined in derived classes.
 
virtual Option_tGetDrawOption () const
 Get option used by the graphics system to draw this object.
 
virtual Option_tGetOption () const
 
virtual UInt_t GetUniqueID () const
 Return the unique object id.
 
virtual Bool_t HandleTimer (TTimer *timer)
 Execute action in response of a timer timing out.
 
Bool_t HasInconsistentHash () const
 Return true is the type of this object is known to have an inconsistent setup for Hash and RecursiveRemove (i.e.
 
virtual void Info (const char *method, const char *msgfmt,...) const
 Issue info message.
 
virtual Bool_t InheritsFrom (const char *classname) const
 Returns kTRUE if object inherits from class "classname".
 
virtual Bool_t InheritsFrom (const TClass *cl) const
 Returns kTRUE if object inherits from TClass cl.
 
virtual void Inspect () const
 Dump contents of this object in a graphics canvas.
 
void InvertBit (UInt_t f)
 
Bool_t IsDestructed () const
 IsDestructed.
 
virtual Bool_t IsEqual (const TObject *obj) const
 Default equal comparison (objects are equal if they have the same address in memory).
 
virtual Bool_t IsFolder () const
 Returns kTRUE in case object contains browsable objects (like containers or lists of other objects).
 
R__ALWAYS_INLINE Bool_t IsOnHeap () const
 
R__ALWAYS_INLINE Bool_t IsZombie () const
 
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).
 
virtual Bool_t Notify ()
 This method must be overridden to handle object notification (the base implementation is no-op).
 
void Obsolete (const char *method, const char *asOfVers, const char *removedFromVers) const
 Use this method to declare a method obsolete.
 
void operator delete (void *ptr)
 Operator delete.
 
void operator delete (void *ptr, void *vp)
 Only called by placement new when throwing an exception.
 
void operator delete[] (void *ptr)
 Operator delete [].
 
void operator delete[] (void *ptr, void *vp)
 Only called by placement new[] when throwing an exception.
 
void * operator new (size_t sz)
 
void * operator new (size_t sz, void *vp)
 
void * operator new[] (size_t sz)
 
void * operator new[] (size_t sz, void *vp)
 
TObjectoperator= (const TObject &rhs)
 TObject assignment operator.
 
virtual void Pop ()
 Pop on object drawn in a pad to the top of the display list.
 
virtual Int_t Read (const char *name)
 Read contents of object with specified name from the current directory.
 
virtual void RecursiveRemove (TObject *obj)
 Recursively remove this object from a list.
 
void ResetBit (UInt_t f)
 
virtual void SaveAs (const char *filename="", Option_t *option="") const
 Save this object in the file specified by filename.
 
void SetBit (UInt_t f)
 
void SetBit (UInt_t f, Bool_t set)
 Set or unset the user status bits as specified in f.
 
virtual void SetDrawOption (Option_t *option="")
 Set drawing option for object.
 
virtual void SetUniqueID (UInt_t uid)
 Set the unique object id.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
virtual void SysError (const char *method, const char *msgfmt,...) const
 Issue system error message.
 
R__ALWAYS_INLINE Bool_t TestBit (UInt_t f) const
 
Int_t TestBits (UInt_t f) const
 
virtual void UseCurrentStyle ()
 Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked.
 
virtual void Warning (const char *method, const char *msgfmt,...) const
 Issue warning message.
 
virtual Int_t Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0)
 Write this object to the current directory.
 
virtual Int_t Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0) const
 Write this object to the current directory.
 
- Public Member Functions inherited from TAttImage
 TAttImage ()
 TAttImage default constructor.
 
 TAttImage (EImageQuality lquality, UInt_t lcompression, Bool_t constRatio)
 TAttImage normal constructor.
 
virtual ~TAttImage ()
 TAttImage destructor.
 
void Copy (TAttImage &attline) const
 Copy this image attributes to a new attimage.
 
virtual void EditorClosed ()
 
Bool_t GetConstRatio () const
 
UInt_t GetImageCompression () const
 
EImageQuality GetImageQuality () const
 
virtual const TImagePaletteGetPalette () const
 
Bool_t IsPaletteEnabled () const
 
virtual void ResetAttImage (Option_t *option="")
 Reset this image attributes to default values.
 
virtual void SaveImageAttributes (std::ostream &out, const char *name, EImageQuality qualdef=kImgDefault, UInt_t comprdef=0, Bool_t constRatiodef=kTRUE)
 Save image attributes as C++ statement(s) on output stream, but not the palette.
 
virtual void SetConstRatio (Bool_t constRatio=kTRUE)
 Set (constRatio = kTRUE) or unset (constRadio = kFALSE) the ratio flag.
 
virtual void SetImageCompression (UInt_t lcompression)
 
virtual void SetImageQuality (EImageQuality lquality)
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 

Static Public Member Functions

static UInt_t AlphaBlend (UInt_t bot, UInt_t top)
 Return alpha-blended value computed from bottom and top pixel values.
 
static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
static const ASVisual * GetVisual ()
 Return visual.
 
static void Image2Drawable (ASImage *im, Drawable_t wid, Int_t x, Int_t y, Int_t xsrc=0, Int_t ysrc=0, UInt_t wsrc=0, UInt_t hsrc=0, Option_t *opt="")
 Draw asimage on drawable.
 
- Static Public Member Functions inherited from TImage
static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static TImageCreate ()
 Create an image.
 
static const char * DeclFileName ()
 
static EImageFileTypes GetImageFileTypeFromFilename (const char *opt)
 Return the image type for the extension specified in filename.
 
static TImageOpen (char **data)
 Create image from XPM data array.
 
static TImageOpen (const char *file, EImageFileTypes type=kUnknown)
 Open a specified image file.
 
static TImageOpen (const char *name, const Double_t *imageData, UInt_t width, UInt_t height, TImagePalette *palette)
 Open an image with the specified data in a Double_t array.
 
static TImageOpen (const char *name, const TArrayD &imageData, UInt_t width, TImagePalette *palette=nullptr)
 Open an image with the specified data in a TArrayD.
 
static TImageOpen (const char *name, const TVectorD &imageData, UInt_t width, TImagePalette *palette=nullptr)
 Open an image with the specified data in a TVectorD.
 
- Static Public Member Functions inherited from TNamed
static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
- Static Public Member Functions inherited from TObject
static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
static Longptr_t GetDtorOnly ()
 Return destructor only flag.
 
static Bool_t GetObjectStat ()
 Get status of object stat flag.
 
static void SetDtorOnly (void *obj)
 Set destructor only flag.
 
static void SetObjectStat (Bool_t stat)
 Turn on/off tracking of objects in the TObjectTable.
 
- Static Public Member Functions inherited from TAttImage
static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 

Protected Member Functions

EImageFileTypes GetFileType (const char *ext)
 Return file type depending on specified extension.
 
void MapFileTypes (EImageFileTypes &type, UInt_t &astype, Bool_t toas=kTRUE)
 Map file type to/from AfterImage types.
 
void MapQuality (EImageQuality &quality, UInt_t &asquality, Bool_t toas=kTRUE)
 Map quality to/from AfterImage quality.
 
- Protected Member Functions inherited from TImage
 TImage ()
 
 TImage (const char *file)
 
- Protected Member Functions inherited from TObject
virtual void DoError (int level, const char *location, const char *fmt, va_list va) const
 Interface to ErrorHandler (protected).
 
void MakeZombie ()
 

Static Protected Member Functions

static Bool_t InitVisual ()
 Static function to initialize the ASVisual.
 

Protected Attributes

Bool_t fEditable
 ! kTRUE image can be resized, moved by resizing/moving gPad
 
ASImage * fGrayImage
 ! gray image
 
ASImage * fImage
 ! pointer to image structure of original image
 
Bool_t fIsGray
 ! kTRUE if image is gray
 
Double_t fMaxValue
 ! max value in image
 
Double_t fMinValue
 ! min value in image
 
Int_t fPaintMode
 ! 1 - fast mode, 0 - low memory slow mode
 
TASImagefScaledImage
 ! temporary scaled and zoomed image produced from original image
 
UInt_t fZoomHeight
 ! hight of zoomed image in image pixels
 
UInt_t fZoomOffX
 ! X - offset for zooming in image pixels
 
UInt_t fZoomOffY
 ! Y - offset for zooming im image pixels
 
Int_t fZoomUpdate
 ! kZoom - new zooming required, kZoomOps - other ops in action, kNoZoom - no zooming or ops
 
UInt_t fZoomWidth
 ! width of zoomed image in image pixels
 
- Protected Attributes inherited from TNamed
TString fName
 
TString fTitle
 
- Protected Attributes inherited from TAttImage
Bool_t fConstRatio {kFALSE}
 keep aspect ratio of image on the screen
 
UInt_t fImageCompression {0}
 compression [0 .. 100] 0: no compression
 
EImageQuality fImageQuality {kImgDefault}
 OPTION={GetMethod="GetImageQuality";SetMethod="SetImageQuality";Items=(kImgDefault="Default",kImgPoor="Poor",kImgFast="Fast",kImgGood="Good",kImgBest="Best")}
 
TImagePalette fPalette
 color palette for value -> color conversion
 
TPaletteEditorfPaletteEditor {nullptr}
 ! GUI to edit the color palette
 
Bool_t fPaletteEnabled {kFALSE}
 ! kTRUE - palette is drawn on the image
 

Static Protected Attributes

static Bool_t fgInit = kFALSE
 global flag to init afterimage only once
 
static THashTablefgPlugList = new THashTable(50)
 ! hash table containing loaded plugins
 
static ASVisual * fgVisual = nullptr
 pointer to visual structure
 

Private Types

enum  { kNoZoom = 0 , kZoom = 1 , kZoomOps = -1 }
 
enum  { kReadWritePNG , kReadWriteVector }
 

Private Member Functions

void CreateThumbnail ()
 Create image thumbnail.
 
void DestroyImage ()
 Destroy image.
 
void DrawDashHLine (UInt_t y, UInt_t x1, UInt_t x2, UInt_t nDash, const char *pDash, UInt_t col, UInt_t thick)
 Draw a dashed horizontal line.
 
void DrawDashVLine (UInt_t x, UInt_t y1, UInt_t y2, UInt_t nDash, const char *pDash, UInt_t col, UInt_t thick)
 Draw a dashed vertical line.
 
void DrawDashZLine (UInt_t x1, UInt_t y1, UInt_t x2, UInt_t y2, UInt_t nDash, const char *pDash, UInt_t col)
 Draw a dashed line with one pixel width.
 
void DrawDashZTLine (UInt_t x1, UInt_t y1, UInt_t x2, UInt_t y2, UInt_t nDash, const char *pDash, UInt_t col, UInt_t thick)
 Draw a dashed line with thick pixel width.
 
void DrawGlyph (void *bitmap, UInt_t color, Int_t x, Int_t y)
 Draw glyph bitmap.
 
void DrawHLine (UInt_t y, UInt_t x1, UInt_t x2, UInt_t col, UInt_t thick)
 Draw an horizontal line.
 
void DrawLineInternal (UInt_t x1, UInt_t y1, UInt_t x2, UInt_t y2, UInt_t col, UInt_t thick)
 Internal line drawing.
 
void DrawTextTTF (Int_t x, Int_t y, const char *text, Int_t size, UInt_t color, const char *font_name, Float_t angle)
 Draw text using TrueType fonts.
 
void DrawVLine (UInt_t x, UInt_t y1, UInt_t y2, UInt_t col, UInt_t thick)
 Draw a vertical line.
 
void DrawWideLine (UInt_t x1, UInt_t y1, UInt_t x2, UInt_t y2, UInt_t col, UInt_t thick)
 Draw wide line.
 
void FillRectangleInternal (UInt_t col, Int_t x, Int_t y, UInt_t width, UInt_t height)
 Fill rectangle of size (width, height) at position (x,y) within the existing image with specified color.
 
void GetFillAreaSpans (UInt_t npt, TPoint *ppt, UInt_t *nspans, TPoint **firstPoint, UInt_t **firstWidth)
 
Bool_t GetPolygonSpans (UInt_t npt, TPoint *ppt, UInt_t *nspans, TPoint **firstPoint, UInt_t **firstWidth)
 The code is based on Xserver/mi/mipolycon.c "Copyright 1987, 1998 The Open Group".
 
Int_t Idx (Int_t idx)
 Return a valid index in fImage tables to avoid seg-fault by accessing out of indices out of array's ranges.
 
void SetDefaults ()
 Set default parameters.
 
const char * TypeFromMagicNumber (const char *file)
 Guess the file type from the first byte of file.
 

Additional Inherited Members

- Public Types inherited from TImage
enum  ECharType { kUTF8 = 0 , kChar = 1 , kUnicode = 4 }
 
enum  EColorChan {
  kRedChan = (1ULL << ( 0 )) , kGreenChan = (1ULL << ( 1 )) , kBlueChan = (1ULL << ( 2 )) , kAlphaChan = (1ULL << ( 3 )) ,
  kAllChan = kRedChan | kGreenChan | kBlueChan | kAlphaChan
}
 
enum  ECoordMode { kCoordModeOrigin = 0 , kCoordModePrevious }
 
enum  EImageFileTypes {
  kXpm = 0 , kZCompressedXpm , kGZCompressedXpm , kPng ,
  kJpeg , kXcf , kPpm , kPnm ,
  kBmp , kIco , kCur , kGif ,
  kTiff , kXbm , kFits , kTga ,
  kXml , kUnknown , kAnimGif
}
 
enum  EText3DType {
  kPlain = 0 , kEmbossed , kSunken , kShadeAbove ,
  kShadeBelow , kEmbossedThick , kSunkenThick , kOutlineAbove ,
  kOutlineBelow , kOutlineFull , k3DTypes
}
 
enum  ETileType { kStretch = 0 , kTile , kStretchY , kStretchX }
 
- Public Types inherited from TObject
enum  {
  kIsOnHeap = 0x01000000 , kNotDeleted = 0x02000000 , kZombie = 0x04000000 , kInconsistent = 0x08000000 ,
  kBitMask = 0x00ffffff
}
 
enum  { kSingleKey = (1ULL << ( 0 )) , kOverwrite = (1ULL << ( 1 )) , kWriteDelete = (1ULL << ( 2 )) }
 
enum  EDeprecatedStatusBits { kObjInCanvas = (1ULL << ( 3 )) }
 
enum  EStatusBits {
  kCanDelete = (1ULL << ( 0 )) , kMustCleanup = (1ULL << ( 3 )) , kIsReferenced = (1ULL << ( 4 )) , kHasUUID = (1ULL << ( 5 )) ,
  kCannotPick = (1ULL << ( 6 )) , kNoContextMenu = (1ULL << ( 8 )) , kInvalidObject = (1ULL << ( 13 ))
}
 
- Public Types inherited from TAttImage
enum  EImageQuality {
  kImgDefault = -1 , kImgPoor = 0 , kImgFast = 1 , kImgGood = 2 ,
  kImgBest = 3
}
 
- Protected Types inherited from TObject
enum  { kOnlyPrepStep = (1ULL << ( 3 )) }
 

#include <TASImage.h>

Inheritance diagram for TASImage:
[legend]

Member Enumeration Documentation

◆ anonymous enum

anonymous enum
private
Enumerator
kNoZoom 
kZoom 
kZoomOps 

Definition at line 34 of file TASImage.h.

◆ anonymous enum

anonymous enum
private
Enumerator
kReadWritePNG 
kReadWriteVector 

Definition at line 35 of file TASImage.h.

Constructor & Destructor Documentation

◆ TASImage() [1/7]

TASImage::TASImage ( )

Default image constructor.

Definition at line 227 of file TASImage.cxx.

◆ TASImage() [2/7]

TASImage::TASImage ( UInt_t  w,
UInt_t  h 
)

Create an empty image.

Definition at line 235 of file TASImage.cxx.

◆ TASImage() [3/7]

TASImage::TASImage ( const char *  file,
EImageFileTypes  type = kUnknown 
)

Create an image object and read from specified file.

For more information see description of function ReadImage() which is called by this constructor.

Definition at line 247 of file TASImage.cxx.

◆ TASImage() [4/7]

TASImage::TASImage ( const char *  name,
const Double_t imageData,
UInt_t  width,
UInt_t  height,
TImagePalette palette = nullptr 
)

Create an image depending on the values of imageData.

For more information see function SetImage() which is called by this constructor.

Definition at line 260 of file TASImage.cxx.

◆ TASImage() [5/7]

TASImage::TASImage ( const char *  name,
const TArrayD imageData,
UInt_t  width,
TImagePalette palette = nullptr 
)

Create an image depending on the values of imageData.

The size of the image is width X (imageData.fN / width). For more information see function SetImage() which is called by this constructor.

Definition at line 273 of file TASImage.cxx.

◆ TASImage() [6/7]

TASImage::TASImage ( const char *  name,
const TVectorD imageData,
UInt_t  width,
TImagePalette palette = nullptr 
)

Create an image depending on the values of imageData.

The size of the image is width X (imageData.fN / width). For more information see function SetImage() which is called by this constructor.

Definition at line 286 of file TASImage.cxx.

◆ TASImage() [7/7]

TASImage::TASImage ( const TASImage img)

Image copy constructor.

Definition at line 296 of file TASImage.cxx.

◆ ~TASImage()

TASImage::~TASImage ( )
override

Image destructor, clean up image and visual.

Definition at line 358 of file TASImage.cxx.

Member Function Documentation

◆ AlphaBlend()

UInt_t TASImage::AlphaBlend ( UInt_t  bot,
UInt_t  top 
)
static

Return alpha-blended value computed from bottom and top pixel values.

Definition at line 5151 of file TASImage.cxx.

◆ Append()

void TASImage::Append ( const TImage im,
const char *  option = "+",
const char *  color = "#00000000" 
)
overridevirtual

Append image.

option:

  • "+" - appends to the right side
  • "/" - appends to the bottom

Reimplemented from TImage.

Definition at line 3491 of file TASImage.cxx.

◆ BeginPaint()

void TASImage::BeginPaint ( Bool_t  mode = kTRUE)
overridevirtual

BeginPaint initializes internal array[width x height] of ARGB32 pixel values.

That provides quick access to image during paint operations. To RLE compress image one needs to call EndPaint method when painting is over.

Reimplemented from TImage.

Definition at line 3532 of file TASImage.cxx.

◆ Bevel()

void TASImage::Bevel ( Int_t  x = 0,
Int_t  y = 0,
UInt_t  width = 0,
UInt_t  height = 0,
const char *  hi_color = "#ffdddddd",
const char *  lo_color = "#ff555555",
UShort_t  thick = 1,
Bool_t  reverse = kFALSE 
)
overridevirtual

Bevel is used to create 3D effect while drawing buttons, or any other image that needs to be framed.

Bevel is drawn using 2 primary colors: one for top and left sides - hi color, and another for bottom and right sides - low color. Bevel can be drawn over existing image or as newly created, as it is shown in code below:

img->Bevel(0, 0, 400, 300, "#dddddd", "#000000", 3);
An abstract interface to image processing library.
Definition TImage.h:29
static TImage * Create()
Create an image.
Definition TImage.cxx:35
virtual void Bevel(Int_t=0, Int_t=0, UInt_t=0, UInt_t=0, const char *="#ffdddddd", const char *="#ff555555", UShort_t=1, Bool_t=kFALSE)
Definition TImage.h:178

Reimplemented from TImage.

Definition at line 3251 of file TASImage.cxx.

◆ Blur()

void TASImage::Blur ( Double_t  hr = 3,
Double_t  vr = 3 
)
overridevirtual

Perform Gaussian blur of the image (useful for drop shadows).

  • hr - horizontal radius of the blur
  • vr - vertical radius of the blur

Reimplemented from TImage.

Definition at line 2757 of file TASImage.cxx.

◆ Browse()

void TASImage::Browse ( TBrowser )
overridevirtual

Browse image.

Reimplemented from TObject.

Definition at line 6267 of file TASImage.cxx.

◆ Class()

static TClass * TASImage::Class ( )
static
Returns
TClass describing this class

◆ Class_Name()

static const char * TASImage::Class_Name ( )
static
Returns
Name of this class

◆ Class_Version()

static constexpr Version_t TASImage::Class_Version ( )
inlinestaticconstexpr
Returns
Version of this class

Definition at line 211 of file TASImage.h.

◆ Clone()

TObject * TASImage::Clone ( const char *  newname) const
overridevirtual

Clone image.

Reimplemented from TObject.

Definition at line 2786 of file TASImage.cxx.

◆ CopyArea()

void TASImage::CopyArea ( TImage dst,
Int_t  xsrc,
Int_t  ysrc,
UInt_t  w,
UInt_t  h,
Int_t  xdst = 0,
Int_t  ydst = 0,
Int_t  gfunc = 3,
EColorChan  chan = kAllChan 
)
overridevirtual

Copy source region to the destination image.

Copy is done according to specified function:

kGXclear = 0, // 0
kGXand, // src AND dst
kGXandReverse, // src AND NOT dst
kGXcopy, // src (default)
kGXandInverted, // NOT src AND dst
kGXnoop, // dst
kGXxor, // src XOR dst
kGXor, // src OR dst
kGXnor, // NOT src AND NOT dst
kGXequiv, // NOT src XOR dst
kGXinvert, // NOT dst
kGXorReverse, // src OR NOT dst
kGXcopyInverted, // NOT src
kGXorInverted, // NOT src OR dst
kGXnand, // NOT src OR NOT dst
kGXset // 1
};
EGraphicsFunction
Definition GuiTypes.h:67
@ kGXorReverse
src OR NOT dst
Definition GuiTypes.h:79
@ kGXnand
NOT src OR NOT dst.
Definition GuiTypes.h:82
@ kGXandReverse
src AND NOT dst
Definition GuiTypes.h:70
@ kGXor
src OR dst
Definition GuiTypes.h:75
@ kGXcopy
src
Definition GuiTypes.h:71
@ kGXorInverted
NOT src OR dst.
Definition GuiTypes.h:81
@ kGXandInverted
NOT src AND dst.
Definition GuiTypes.h:72
@ kGXequiv
NOT src XOR dst.
Definition GuiTypes.h:77
@ kGXset
1
Definition GuiTypes.h:83
@ kGXnor
NOT src AND NOT dst.
Definition GuiTypes.h:76
@ kGXnoop
dst
Definition GuiTypes.h:73
@ kGXinvert
NOT dst.
Definition GuiTypes.h:78
@ kGXxor
src XOR dst
Definition GuiTypes.h:74
@ kGXand
src AND dst
Definition GuiTypes.h:69
@ kGXclear
0
Definition GuiTypes.h:68
@ kGXcopyInverted
NOT src.
Definition GuiTypes.h:80

Reimplemented from TImage.

Definition at line 5008 of file TASImage.cxx.

◆ CreateThumbnail()

void TASImage::CreateThumbnail ( )
private

Create image thumbnail.

Definition at line 6091 of file TASImage.cxx.

◆ Crop()

void TASImage::Crop ( Int_t  x = 0,
Int_t  y = 0,
UInt_t  width = 0,
UInt_t  height = 0 
)
overridevirtual

Crop an image.

Reimplemented from TImage.

Definition at line 3414 of file TASImage.cxx.

◆ CropPolygon()

void TASImage::CropPolygon ( UInt_t  npt,
TPoint ppt 
)
overridevirtual

Crop a convex polygon.

Reimplemented from TImage.

Definition at line 5400 of file TASImage.cxx.

◆ CropSpans()

void TASImage::CropSpans ( UInt_t  npt,
TPoint ppt,
UInt_t widths 
)
overridevirtual

Crop spans.

Reimplemented from TImage.

Definition at line 4920 of file TASImage.cxx.

◆ DeclFileName()

static const char * TASImage::DeclFileName ( )
inlinestatic
Returns
Name of the file containing the class declaration

Definition at line 211 of file TASImage.h.

◆ DestroyImage()

void TASImage::DestroyImage ( )
private

Destroy image.

Definition at line 182 of file TASImage.cxx.

◆ DistancetoPrimitive()

Int_t TASImage::DistancetoPrimitive ( Int_t  px,
Int_t  py 
)
overridevirtual

Is the mouse in the image ?

Reimplemented from TObject.

Definition at line 1686 of file TASImage.cxx.

◆ Draw()

void TASImage::Draw ( Option_t option = "")
overridevirtual

Draw image.

Support the following drawing options:

  • "T[x,y[,tint]]" : tile image (use specified offset and tint), e.g. "T100,100,#556655" with this option the zooming is not possible and disabled
  • "N" : display in new canvas (of original image size)
  • "X" : image is drawn expanded to pad size
  • "Z" : image is vectorized and image palette is drawn

The default is to display the image in the current gPad.

Reimplemented from TObject.

Definition at line 1176 of file TASImage.cxx.

◆ DrawBox()

void TASImage::DrawBox ( Int_t  x1,
Int_t  y1,
Int_t  x2,
Int_t  y2,
const char *  col = "#000000",
UInt_t  thick = 1,
Int_t  mode = 0 
)
overridevirtual

Draw a box.

Reimplemented from TImage.

Definition at line 4118 of file TASImage.cxx.

◆ DrawCellArray()

void TASImage::DrawCellArray ( Int_t  x1,
Int_t  y1,
Int_t  x2,
Int_t  y2,
Int_t  nx,
Int_t  ny,
UInt_t ic 
)
overridevirtual

Draw a cell array.

Parameters
[in]x1,y1: left down corner
[in]x2,y2: right up corner
[in]nx,ny: array size
[in]ic: array of ARGB32 colors

Draw a cell array. The drawing is done with the pixel precision if (X2-X1)/NX (or Y) is not a exact pixel number the position of the top right corner may be wrong.

Reimplemented from TImage.

Definition at line 5122 of file TASImage.cxx.

◆ DrawCircle()

void TASImage::DrawCircle ( Int_t  x,
Int_t  y,
Int_t  r,
const char *  col = "#000000",
Int_t  thick = 1 
)
overridevirtual

Draw a circle.

If thick < 0 - draw filled circle

Reimplemented from TImage.

Definition at line 6397 of file TASImage.cxx.

◆ DrawCubeBezier()

void TASImage::DrawCubeBezier ( Int_t  x1,
Int_t  y1,
Int_t  x2,
Int_t  y2,
Int_t  x3,
Int_t  y3,
const char *  col = "#000000",
UInt_t  thick = 1 
)
overridevirtual

Draw a cubic bezier line.

Reimplemented from TImage.

Definition at line 6318 of file TASImage.cxx.

◆ DrawDashHLine()

void TASImage::DrawDashHLine ( UInt_t  y,
UInt_t  x1,
UInt_t  x2,
UInt_t  nDash,
const char *  pDash,
UInt_t  col,
UInt_t  thick 
)
private

Draw a dashed horizontal line.

Definition at line 4167 of file TASImage.cxx.

◆ DrawDashLine()

void TASImage::DrawDashLine ( UInt_t  x1,
UInt_t  y1,
UInt_t  x2,
UInt_t  y2,
UInt_t  nDash,
const char *  pDash,
const char *  col = "#000000",
UInt_t  thick = 1 
)
overridevirtual

Draw a dashed line.

Reimplemented from TImage.

Definition at line 4620 of file TASImage.cxx.

◆ DrawDashVLine()

void TASImage::DrawDashVLine ( UInt_t  x,
UInt_t  y1,
UInt_t  y2,
UInt_t  nDash,
const char *  pDash,
UInt_t  col,
UInt_t  thick 
)
private

Draw a dashed vertical line.

Definition at line 4221 of file TASImage.cxx.

◆ DrawDashZLine()

void TASImage::DrawDashZLine ( UInt_t  x1,
UInt_t  y1,
UInt_t  x2,
UInt_t  y2,
UInt_t  nDash,
const char *  pDash,
UInt_t  col 
)
private

Draw a dashed line with one pixel width.

Definition at line 4278 of file TASImage.cxx.

◆ DrawDashZTLine()

void TASImage::DrawDashZTLine ( UInt_t  x1,
UInt_t  y1,
UInt_t  x2,
UInt_t  y2,
UInt_t  nDash,
const char *  pDash,
UInt_t  col,
UInt_t  thick 
)
private

Draw a dashed line with thick pixel width.

Definition at line 4462 of file TASImage.cxx.

◆ DrawEllips()

void TASImage::DrawEllips ( Int_t  x,
Int_t  y,
Int_t  rx,
Int_t  ry,
Int_t  angle,
const char *  col = "#000000",
Int_t  thick = 1 
)
overridevirtual

Draw an ellipse.

If thick < 0 - draw filled ellips

Reimplemented from TImage.

Definition at line 6437 of file TASImage.cxx.

◆ DrawEllips2()

void TASImage::DrawEllips2 ( Int_t  x,
Int_t  y,
Int_t  rx,
Int_t  ry,
Int_t  angle,
const char *  col = "#000000",
Int_t  thick = 1 
)
overridevirtual

Draw an ellipse.

If thick < 0 - draw filled ellipse.

Reimplemented from TImage.

Definition at line 6477 of file TASImage.cxx.

◆ DrawFillArea() [1/2]

void TASImage::DrawFillArea ( UInt_t  npt,
TPoint ppt,
const char *  col = "#000000",
const char *  stipple = nullptr,
UInt_t  w = 16,
UInt_t  h = 16 
)
overridevirtual

Fill a polygon (any type convex, non-convex).

Reimplemented from TImage.

Definition at line 5426 of file TASImage.cxx.

◆ DrawFillArea() [2/2]

void TASImage::DrawFillArea ( UInt_t  npt,
TPoint ppt,
TImage tile 
)
overridevirtual

Fill a polygon (any type convex, non-convex).

Reimplemented from TImage.

Definition at line 5543 of file TASImage.cxx.

◆ DrawGlyph()

void TASImage::DrawGlyph ( void *  bitmap,
UInt_t  color,
Int_t  x,
Int_t  y 
)
private

Draw glyph bitmap.

Definition at line 5713 of file TASImage.cxx.

◆ DrawHLine()

void TASImage::DrawHLine ( UInt_t  y,
UInt_t  x1,
UInt_t  x2,
UInt_t  col,
UInt_t  thick 
)
private

Draw an horizontal line.

Definition at line 3873 of file TASImage.cxx.

◆ DrawLine()

void TASImage::DrawLine ( UInt_t  x1,
UInt_t  y1,
UInt_t  x2,
UInt_t  y2,
const char *  col = "#000000",
UInt_t  thick = 1 
)
overridevirtual

Draw a line.

Reimplemented from TImage.

Definition at line 3908 of file TASImage.cxx.

◆ DrawLineInternal()

void TASImage::DrawLineInternal ( UInt_t  x1,
UInt_t  y1,
UInt_t  x2,
UInt_t  y2,
UInt_t  col,
UInt_t  thick 
)
private

Internal line drawing.

Definition at line 3919 of file TASImage.cxx.

◆ DrawPolyLine()

void TASImage::DrawPolyLine ( UInt_t  nn,
TPoint xy,
const char *  col = "#000000",
UInt_t  thick = 1,
TImage::ECoordMode  mode = kCoordModeOrigin 
)
overridevirtual

Draw a polyline.

Reimplemented from TImage.

Definition at line 4664 of file TASImage.cxx.

◆ DrawRectangle()

void TASImage::DrawRectangle ( UInt_t  x,
UInt_t  y,
UInt_t  w,
UInt_t  h,
const char *  col = "#000000",
UInt_t  thick = 1 
)
overridevirtual

Draw a rectangle.

Reimplemented from TImage.

Definition at line 4080 of file TASImage.cxx.

◆ DrawSegments()

void TASImage::DrawSegments ( UInt_t  nseg,
Segment_t seg,
const char *  col = "#000000",
UInt_t  thick = 1 
)
overridevirtual

Draw segments.

Reimplemented from TImage.

Definition at line 4784 of file TASImage.cxx.

◆ DrawStraightEllips()

void TASImage::DrawStraightEllips ( Int_t  x,
Int_t  y,
Int_t  rx,
Int_t  ry,
const char *  col = "#000000",
Int_t  thick = 1 
)
overridevirtual

Draw a straight ellipse.

If thick < 0 - draw filled ellipse.

Reimplemented from TImage.

Definition at line 6357 of file TASImage.cxx.

◆ DrawText() [1/2]

void TASImage::DrawText ( Int_t  x = 0,
Int_t  y = 0,
const char *  text = "",
Int_t  size = 12,
const char *  color = nullptr,
const char *  font_name = "fixed",
EText3DType  type = TImage::kPlain,
const char *  fore_file = nullptr,
Float_t  angle = 0 
)
overridevirtual

Draw text of size (in pixels for TrueType fonts) at position (x, y) with color specified by hex string.

  • font_name: TrueType font's filename or X font spec or alias. 3D style of text is one of the following:
    • 0 plain 2D text,
    • 1 embossed,
    • 2 sunken,
    • 3 shade above,
    • 4 shade below,
    • 5 embossed thick,
    • 6 sunken thick.
    • 7 outline above,
    • 8 ouline below,
    • 9 full ouline.
  • fore_file specifies foreground texture of text.

Reimplemented from TImage.

Definition at line 2577 of file TASImage.cxx.

◆ DrawText() [2/2]

void TASImage::DrawText ( TText text,
Int_t  x = 0,
Int_t  y = 0 
)
overridevirtual

Draw text at the pixel position (x,y).

Reimplemented from TImage.

Definition at line 5811 of file TASImage.cxx.

◆ DrawTextTTF()

void TASImage::DrawTextTTF ( Int_t  x,
Int_t  y,
const char *  text,
Int_t  size,
UInt_t  color,
const char *  font_name,
Float_t  angle 
)
private

Draw text using TrueType fonts.

Definition at line 5954 of file TASImage.cxx.

◆ DrawVLine()

void TASImage::DrawVLine ( UInt_t  x,
UInt_t  y1,
UInt_t  y2,
UInt_t  col,
UInt_t  thick 
)
private

Draw a vertical line.

Definition at line 3838 of file TASImage.cxx.

◆ DrawWideLine()

void TASImage::DrawWideLine ( UInt_t  x1,
UInt_t  y1,
UInt_t  x2,
UInt_t  y2,
UInt_t  col,
UInt_t  thick 
)
private

Draw wide line.

Definition at line 5666 of file TASImage.cxx.

◆ EndPaint()

void TASImage::EndPaint ( )
overridevirtual

EndPaint does internal RLE compression of image data.

Reimplemented from TImage.

Definition at line 3564 of file TASImage.cxx.

◆ ExecuteEvent()

void TASImage::ExecuteEvent ( Int_t  event,
Int_t  px,
Int_t  py 
)
overridevirtual

Execute mouse events.

Reimplemented from TObject.

Definition at line 1709 of file TASImage.cxx.

◆ FillPolygon() [1/2]

void TASImage::FillPolygon ( UInt_t  npt,
TPoint ppt,
const char *  col = "#000000",
const char *  stipple = nullptr,
UInt_t  w = 16,
UInt_t  h = 16 
)
overridevirtual

Fill a convex polygon with background color or bitmap.

For non convex polygon one must use DrawFillArea method

Reimplemented from TImage.

Definition at line 5344 of file TASImage.cxx.

◆ FillPolygon() [2/2]

void TASImage::FillPolygon ( UInt_t  npt,
TPoint ppt,
TImage tile 
)
overridevirtual

Fill a convex polygon with background image.

For non convex polygon one must use DrawFillArea method

Reimplemented from TImage.

Definition at line 5376 of file TASImage.cxx.

◆ FillRectangle()

void TASImage::FillRectangle ( const char *  col = nullptr,
Int_t  x = 0,
Int_t  y = 0,
UInt_t  width = 0,
UInt_t  height = 0 
)
overridevirtual

Fill rectangle of size (width, height) at position (x,y) within the existing image with specified color.

To create new image with Fill method the following code can be used:

img->Fill("#FF00FF", 0, 0, 400, 300);

Reimplemented from TImage.

Definition at line 3812 of file TASImage.cxx.

◆ FillRectangleInternal()

void TASImage::FillRectangleInternal ( UInt_t  col,
Int_t  x,
Int_t  y,
UInt_t  width,
UInt_t  height 
)
private

Fill rectangle of size (width, height) at position (x,y) within the existing image with specified color.

Definition at line 3734 of file TASImage.cxx.

◆ FillSpans() [1/2]

void TASImage::FillSpans ( UInt_t  npt,
TPoint ppt,
UInt_t widths,
const char *  col = "#000000",
const char *  stipple = nullptr,
UInt_t  w = 16,
UInt_t  h = 16 
)
overridevirtual

Fill spans with specified color or/and stipple.

Reimplemented from TImage.

Definition at line 4807 of file TASImage.cxx.

◆ FillSpans() [2/2]

void TASImage::FillSpans ( UInt_t  npt,
TPoint ppt,
UInt_t widths,
TImage tile 
)
overridevirtual

Fill spans with tile image.

Reimplemented from TImage.

Definition at line 4866 of file TASImage.cxx.

◆ Flip()

void TASImage::Flip ( Int_t  flip = 180)
overridevirtual

Flip image in place.

Flip is either 90, 180, 270, 180 is default. This function manipulates the original image and destroys the scaled and zoomed image which will be recreated at the next call of the Draw function. If the image is zoomed the zoom - coordinates are now relative to the new image. This function cannot be used for images which were created with the SetImage() functions, because the original pixel values would be destroyed.

Reimplemented from TImage.

Definition at line 2077 of file TASImage.cxx.

◆ FloodFill()

void TASImage::FloodFill ( Int_t  x,
Int_t  y,
const char *  col,
const char *  min_col,
const char *  max_col = nullptr 
)
overridevirtual

Flood fill.

Reimplemented from TImage.

Definition at line 6516 of file TASImage.cxx.

◆ FromGLBuffer()

void TASImage::FromGLBuffer ( UChar_t buf,
UInt_t  w,
UInt_t  h 
)
overridevirtual

Creates an image (screenshot) from a RGBA buffer.

Reimplemented from TImage.

Definition at line 6690 of file TASImage.cxx.

◆ FromPad()

void TASImage::FromPad ( TVirtualPad pad,
Int_t  x = 0,
Int_t  y = 0,
UInt_t  w = 0,
UInt_t  h = 0 
)
overridevirtual

Create an image from the given pad, afterwards this image can be saved in any of the supported image formats.

Reimplemented from TImage.

Definition at line 1080 of file TASImage.cxx.

◆ FromWindow()

void TASImage::FromWindow ( Drawable_t  wid,
Int_t  x = 0,
Int_t  y = 0,
UInt_t  w = 0,
UInt_t  h = 0 
)
overridevirtual

Create an image (screenshot) from specified window.

Reimplemented from TImage.

Definition at line 6638 of file TASImage.cxx.

◆ GetArgbArray()

UInt_t * TASImage::GetArgbArray ( )
overridevirtual

Return a pointer to internal array[width x height] of ARGB32 values This array is directly accessible.

That allows to manipulate/change the image.

Reimplemented from TImage.

Definition at line 3591 of file TASImage.cxx.

◆ GetArray()

TArrayD * TASImage::GetArray ( UInt_t  w = 0,
UInt_t  h = 0,
TImagePalette palette = gWebImagePalette 
)
overridevirtual

In case of vectorized image return an associated array of doubles otherwise this method creates and returns a 2D array of doubles corresponding to palette.

If palette is ZERO a color converted to double value [0, 1] according to formula

Double_t((r << 16) + (g << 8) + b)/0xFFFFFF
#define b(i)
Definition RSha256.hxx:100
#define g(i)
Definition RSha256.hxx:105
double Double_t
Definition RtypesCore.h:59
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t Float_t r

The returned array must be deleted after usage.

Reimplemented from TImage.

Definition at line 2501 of file TASImage.cxx.

◆ GetFileType()

TImage::EImageFileTypes TASImage::GetFileType ( const char *  ext)
protected

Return file type depending on specified extension.

Protected method.

Definition at line 827 of file TASImage.cxx.

◆ GetFillAreaSpans()

void TASImage::GetFillAreaSpans ( UInt_t  npt,
TPoint ppt,
UInt_t nspans,
TPoint **  firstPoint,
UInt_t **  firstWidth 
)
private

◆ GetHeight()

UInt_t TASImage::GetHeight ( ) const
overridevirtual

Return height of original image not of the displayed image.

(Number of image pixels)

Reimplemented from TImage.

Definition at line 2163 of file TASImage.cxx.

◆ GetIconName()

const char * TASImage::GetIconName ( ) const
inlineoverridevirtual

Returns mime type name of object.

Used by the TBrowser (via TGMimeTypes class). Override for class of which you would like to have different icons for objects of the same class.

Reimplemented from TObject.

Definition at line 99 of file TASImage.h.

◆ GetImage()

ASImage * TASImage::GetImage ( ) const
inline

Definition at line 186 of file TASImage.h.

◆ GetImageBuffer()

void TASImage::GetImageBuffer ( char **  buffer,
int size,
EImageFileTypes  type = TImage::kPng 
)
overridevirtual

Return in-memory buffer compressed according image type.

Buffer must be deallocated after usage with free(buffer) call. This method can be used for sending images over network.

Reimplemented from TImage.

Definition at line 5989 of file TASImage.cxx.

◆ GetMask()

Pixmap_t TASImage::GetMask ( )
overridevirtual

Returns image mask pixmap (alpha channel).

The pixmap must deleted by user.

Reimplemented from TImage.

Definition at line 2303 of file TASImage.cxx.

◆ GetObjectInfo()

char * TASImage::GetObjectInfo ( Int_t  px,
Int_t  py 
) const
overridevirtual

Get image pixel coordinates and the pixel value at the mouse pointer.

Reimplemented from TObject.

Definition at line 1820 of file TASImage.cxx.

◆ GetPixels()

TArrayL * TASImage::GetPixels ( Int_t  x = 0,
Int_t  y = 0,
UInt_t  w = 0,
UInt_t  h = 0 
)
overridevirtual

Return 2D array of machine dependent pixel values.

Reimplemented from TImage.

Definition at line 2409 of file TASImage.cxx.

◆ GetPixmap()

Pixmap_t TASImage::GetPixmap ( )
overridevirtual

Returns image pixmap.

The pixmap must deleted by user.

Reimplemented from TImage.

Definition at line 2271 of file TASImage.cxx.

◆ GetPolygonSpans()

Bool_t TASImage::GetPolygonSpans ( UInt_t  npt,
TPoint ppt,
UInt_t nspans,
TPoint **  firstPoint,
UInt_t **  firstWidth 
)
private

The code is based on Xserver/mi/mipolycon.c "Copyright 1987, 1998 The Open Group".

Definition at line 5199 of file TASImage.cxx.

◆ GetRgbaArray()

UInt_t * TASImage::GetRgbaArray ( )
overridevirtual

Return a pointer to an array[width x height] of RGBA32 values.

This array is created from internal ARGB32 array, must be deleted after usage.

Reimplemented from TImage.

Definition at line 3619 of file TASImage.cxx.

◆ GetScaledHeight()

UInt_t TASImage::GetScaledHeight ( ) const

Return height of the displayed image not of the original image.

(Number of screen pixels)

Definition at line 2181 of file TASImage.cxx.

◆ GetScaledImage()

TImage * TASImage::GetScaledImage ( ) const
inlineoverridevirtual

Reimplemented from TImage.

Definition at line 188 of file TASImage.h.

◆ GetScaledWidth()

UInt_t TASImage::GetScaledWidth ( ) const

Return width of the displayed image not of the original image.

(Number of screen pixels)

Definition at line 2172 of file TASImage.cxx.

◆ GetScanline()

UInt_t * TASImage::GetScanline ( UInt_t  y)
overridevirtual

Return a pointer to scan-line.

Reimplemented from TImage.

Definition at line 3664 of file TASImage.cxx.

◆ GetTitle()

const char * TASImage::GetTitle ( ) const
overridevirtual

Title is used to keep 32x32 xpm image's thumbnail.

Reimplemented from TObject.

Definition at line 6280 of file TASImage.cxx.

◆ GetVecArray()

Double_t * TASImage::GetVecArray ( )
overridevirtual

Return a pointer to internal array[width x height] of double values [0,1].

This array is directly accessible. That allows to manipulate/change the image.

Reimplemented from TImage.

Definition at line 2479 of file TASImage.cxx.

◆ GetVisual()

const ASVisual * TASImage::GetVisual ( )
static

Return visual.

Definition at line 5162 of file TASImage.cxx.

◆ GetWidth()

UInt_t TASImage::GetWidth ( ) const
overridevirtual

Return width of original image not of the displayed image.

(Number of image pixels)

Reimplemented from TImage.

Definition at line 2154 of file TASImage.cxx.

◆ GetZoomPosition()

void TASImage::GetZoomPosition ( UInt_t x,
UInt_t y,
UInt_t w,
UInt_t h 
) const

Return the zoom parameters.

This is useful when the zoom has been done interactively using the mouse.

Definition at line 2190 of file TASImage.cxx.

◆ Gradient()

void TASImage::Gradient ( UInt_t  angle = 0,
const char *  colors = "#FFFFFF #000000",
const char *  offsets = nullptr,
Int_t  x = 0,
Int_t  y = 0,
UInt_t  width = 0,
UInt_t  height = 0 
)
overridevirtual

Render multipoint gradient inside rectangle of size (width, height) at position (x,y) within the existing image.

Parameters
[in]angleGiven in degrees. Default is 0. This is the direction of the gradient. Currently the only supported values are 0, 45, 90, 135, 180, 225, 270, 315. 0 means left to right, 90 means top to bottom, etc.
[in]colorsWhitespace-separated list of colors. At least two colors are required. Each color in this list will be visited in turn, at the intervals given by the offsets attribute.
[in]offsetsWhitespace-separated list of floating point values ranging from 0.0 to 1.0. The colors from the colors attribute are given these offsets, and the final gradient is rendered from the combination of the two. If both colors and offsets are given but the number of colors and offsets do not match, the minimum of the two will be used, and the other will be truncated to match. If offsets are not given, a smooth stepping from 0.0 to 1.0 will be used.
[in]xx position coordinate
[in]yy position coordinate
[in]widthimage width, if 0, it will be read from fImage
[in]heightimage height, if 0, it will be read from fImage

Reimplemented from TImage.

Definition at line 3011 of file TASImage.cxx.

◆ Gray()

void TASImage::Gray ( Bool_t  on = kTRUE)
overridevirtual

Convert RGB image to Gray image and vice versa.

Reimplemented from TImage.

Definition at line 6524 of file TASImage.cxx.

◆ HSV()

void TASImage::HSV ( UInt_t  hue = 0,
UInt_t  radius = 360,
Int_t  H = 0,
Int_t  S = 0,
Int_t  V = 0,
Int_t  x = 0,
Int_t  y = 0,
UInt_t  width = 0,
UInt_t  height = 0 
)
overridevirtual

This function will tile original image to specified size with offsets requested, and then it will go though it and adjust hue, saturation and value of those pixels that have specific hue, set by affected_hue/ affected_radius parameters.

When affected_radius is greater then 180 entire image will be adjusted. Note that since grayscale colors have no hue - the will not get adjusted. Only saturation and value will be adjusted in gray pixels.

Hue is measured as an angle on a 360 degree circle, The following is relationship of hue values to regular color names :

  • red - 0
  • yellow - 60
  • green - 120
  • cyan - 180
  • blue - 240
  • magenta - 300
  • red - 360

All the hue values in parameters will be adjusted to fall within 0-360 range.

Parameters
[in]huehue in degrees in range 0-360. This allows to limit impact of color adjustment to affect only limited range of hues.
[in]radiusvalue in degrees to be used in order to calculate the range of affected hues. Range is determined by substracting and adding this value from/to affected_hue.
[in]Hvalue by which to change hues in affected range.
[in]Svalue by which to change saturation of the pixels in affected hue range.
[in]Vvalue by which to change Value(brightness) of pixels in affected hue range.
[in]x,yposition on infinite surface tiled with original image, of the left-top corner of the area to be used for new image.
[in]width,heightsize of the area of the original image to be used for new image. Default is current width, height of the image.

Reimplemented from TImage.

Definition at line 2945 of file TASImage.cxx.

◆ Idx()

Int_t TASImage::Idx ( Int_t  idx)
inlineprivate

Return a valid index in fImage tables to avoid seg-fault by accessing out of indices out of array's ranges.

Definition at line 6838 of file TASImage.cxx.

◆ Image2Drawable()

void TASImage::Image2Drawable ( ASImage *  im,
Drawable_t  wid,
Int_t  x,
Int_t  y,
Int_t  xsrc = 0,
Int_t  ysrc = 0,
UInt_t  wsrc = 0,
UInt_t  hsrc = 0,
Option_t opt = "" 
)
static

Draw asimage on drawable.

Definition at line 1228 of file TASImage.cxx.

◆ InitVisual()

Bool_t TASImage::InitVisual ( )
staticprotected

Static function to initialize the ASVisual.

Definition at line 2201 of file TASImage.cxx.

◆ IsA()

TClass * TASImage::IsA ( ) const
inlineoverridevirtual
Returns
TClass describing current object

Reimplemented from TObject.

Definition at line 211 of file TASImage.h.

◆ IsEditable()

Bool_t TASImage::IsEditable ( ) const
inlineoverridevirtual

Reimplemented from TImage.

Definition at line 95 of file TASImage.h.

◆ IsGray()

Bool_t TASImage::IsGray ( ) const
inlineoverridevirtual

Reimplemented from TImage.

Definition at line 185 of file TASImage.h.

◆ IsValid()

Bool_t TASImage::IsValid ( ) const
inlineoverridevirtual

Reimplemented from TImage.

Definition at line 184 of file TASImage.h.

◆ MapFileTypes()

void TASImage::MapFileTypes ( EImageFileTypes type,
UInt_t astype,
Bool_t  toas = kTRUE 
)
protected

Map file type to/from AfterImage types.

Protected method.

Definition at line 871 of file TASImage.cxx.

◆ MapQuality()

void TASImage::MapQuality ( EImageQuality quality,
UInt_t asquality,
Bool_t  toas = kTRUE 
)
protected

Map quality to/from AfterImage quality.

Protected method.

Definition at line 956 of file TASImage.cxx.

◆ Merge()

void TASImage::Merge ( const TImage im,
const char *  op = "alphablend",
Int_t  x = 0,
Int_t  y = 0 
)
overridevirtual

Merge two images.

op is string which specifies overlay operation. Supported operations are:

  • add - color addition with saturation
  • alphablend - alpha-blending
  • allanon - color values averaging
  • colorize - hue and saturate bottom image same as top image
  • darken - use lowest color value from both images
  • diff - use absolute value of the color difference between two images
  • dissipate - randomly alpha-blend images
  • hue - hue bottom image same as top image
  • lighten - use highest color value from both images
  • overlay - some weird image overlaying(see GIMP)
  • saturate - saturate bottom image same as top image
  • screen - another weird image overlaying(see GIMP)
  • sub - color substraction with saturation
  • tint - tinting image with image
  • value - value bottom image same as top image

Reimplemented from TImage.

Definition at line 2718 of file TASImage.cxx.

◆ Mirror()

void TASImage::Mirror ( Bool_t  vert = kTRUE)
overridevirtual

Mirror image in place.

If vert is true mirror in vertical axis, horizontal otherwise. Vertical is default. This function manipulates the original image and destroys the scaled and zoomed image which will be recreated at the next call of the Draw function. If the image is zoomed the zoom - coordinates are now relative to the new image. This function cannot be used for images which were created with the SetImage() functions, because the original pixel values would be destroyed.

Reimplemented from TImage.

Definition at line 2124 of file TASImage.cxx.

◆ operator=()

TASImage & TASImage::operator= ( const TASImage img)

Image assignment operator.

Definition at line 324 of file TASImage.cxx.

◆ Pad()

void TASImage::Pad ( const char *  color = "#00FFFFFF",
UInt_t  left = 0,
UInt_t  right = 0,
UInt_t  top = 0,
UInt_t  bottom = 0 
)
overridevirtual

Enlarge image, padding it with specified color on each side in accordance with requested geometry.

Reimplemented from TImage.

Definition at line 3367 of file TASImage.cxx.

◆ Paint()

void TASImage::Paint ( Option_t option = "")
overridevirtual

Paint image.

Support the following drawing options:

  • "T[x,y[,tint]]" : tile image (use specified offset and tint), e.g. "T100,100,#556655" with this option the zooming is not possible and disabled
  • "N" : display in new canvas (of original image size)
  • "X" : image is drawn expanded to pad size
  • "Z" : image is vectorized and image palette is drawn

The default is to display the image in the current gPad.

Reimplemented from TObject.

Definition at line 1371 of file TASImage.cxx.

◆ PaintImage()

void TASImage::PaintImage ( Drawable_t  wid,
Int_t  x,
Int_t  y,
Int_t  xsrc = 0,
Int_t  ysrc = 0,
UInt_t  wsrc = 0,
UInt_t  hsrc = 0,
Option_t opt = "" 
)
overridevirtual

Draw image on the drawable wid (pixmap, window) at x,y position.

Parameters
[in]wid: Drawable (pixmap or window) on which image is drawn.
[in]x,y: Window coordinates where image is drawn.
[in]xsrc,ysrc: X and Y coordinates of an image area to be drawn.
[in]wsrc,hsrc: Width and height image area to be drawn.
[in]opt: specific options

Reimplemented from TImage.

Definition at line 1351 of file TASImage.cxx.

◆ PolyPoint()

void TASImage::PolyPoint ( UInt_t  npt,
TPoint ppt,
const char *  col = "#000000",
TImage::ECoordMode  mode = kCoordModeOrigin 
)
overridevirtual

Draw a poly point.

Reimplemented from TImage.

Definition at line 4724 of file TASImage.cxx.

◆ PutPixel()

void TASImage::PutPixel ( Int_t  x,
Int_t  y,
const char *  col = "#000000" 
)
overridevirtual

Draw a point at the specified position.

Reimplemented from TImage.

Definition at line 4689 of file TASImage.cxx.

◆ ReadImage()

void TASImage::ReadImage ( const char *  filename,
EImageFileTypes  type = TImage::kUnknown 
)
overridevirtual

Read specified image file.

The file type is determined by the file extension (the type argument is ignored). It will attempt to append .gz and then .Z to the filename and find such a file. If the filename ends with extension consisting of digits only, it will attempt to find the file with this extension stripped off. On success this extension will be used to load subimage from the file with that number. Subimage is supported for GIF files (ICO, BMP, CUR, TIFF, XCF to be supported in future). For example,

i1 = TImage::Open("anim.gif.0"); // read the first subimage
i4 = TImage::Open("anim.gif.3"); // read the forth subimage
static TImage * Open(const char *file, EImageFileTypes type=kUnknown)
Open a specified image file.
Definition TImage.cxx:118

It is also possible to put XPM raw string (see also SetImageBuffer) as the first input parameter ("filename"), such string is returned by GetImageBuffer method.

Reimplemented from TImage.

Definition at line 487 of file TASImage.cxx.

◆ SavePrimitive()

void TASImage::SavePrimitive ( std::ostream &  out,
Option_t option = "" 
)
overridevirtual

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

Reimplemented from TObject.

Definition at line 6740 of file TASImage.cxx.

◆ Scale()

void TASImage::Scale ( UInt_t  toWidth,
UInt_t  toHeight 
)
overridevirtual

Scale the original image.

The size of the image on the screen does not change because it is defined by the size of the pad. This function can be used to change the size of an image before writing it into a file. The colors of the new pixels are interpolated. An image created with the SetImage() functions cannot be modified with the function SetPalette() any more after a call of this function!

Reimplemented from TImage.

Definition at line 1917 of file TASImage.cxx.

◆ SetDefaults()

void TASImage::SetDefaults ( )
private

Set default parameters.

Definition at line 200 of file TASImage.cxx.

◆ SetEditable()

void TASImage::SetEditable ( Bool_t  on = kTRUE)
inlineoverridevirtual

Reimplemented from TImage.

Definition at line 94 of file TASImage.h.

◆ SetImage() [1/5]

void TASImage::SetImage ( ASImage *  image)
inline

Definition at line 187 of file TASImage.h.

◆ SetImage() [2/5]

void TASImage::SetImage ( const Double_t imageData,
UInt_t  width,
UInt_t  height,
TImagePalette palette = nullptr 
)
overridevirtual

Deletes the old image and creates a new image depending on the values of imageData.

The size of the image is width X height.

The color of each pixel depends on the imageData of the corresponding pixel. The palette is used to convert an image value into its color. If palette is not defined (palette = 0) a default palette is used. Any previously defined zooming is reset.

Reimplemented from TImage.

Definition at line 993 of file TASImage.cxx.

◆ SetImage() [3/5]

void TASImage::SetImage ( const TArrayD imageData,
UInt_t  width,
TImagePalette palette = nullptr 
)
overridevirtual

Delete the old image and creates a new image depending on the values of imageData.

The size of the image is width X (imageData.fN / width). The color of each pixel depends on the imageData of the corresponding pixel. The palette is used to convert an image value into its color. If palette is not defined (palette = 0) a default palette is used. Any previously defined zooming is reset.

Reimplemented from TImage.

Definition at line 1057 of file TASImage.cxx.

◆ SetImage() [4/5]

void TASImage::SetImage ( const TVectorD imageData,
UInt_t  width,
TImagePalette palette = nullptr 
)
overridevirtual

Delete the old image and creates a new image depending on the values of imageData.

The size of the image is width X (imageData.fN / width). The color of each pixel depends on the imageData of the corresponding pixel. The palette is used to convert an image value into its color. If palette is not defined (palette = 0) a default palette is used. Any previously defined zooming is reset.

Reimplemented from TImage.

Definition at line 1070 of file TASImage.cxx.

◆ SetImage() [5/5]

void TASImage::SetImage ( Pixmap_t  pxm,
Pixmap_t  mask = 0 
)
overridevirtual

Create image from pixmap.

Reimplemented from TImage.

Definition at line 2365 of file TASImage.cxx.

◆ SetImageBuffer()

Bool_t TASImage::SetImageBuffer ( char **  buffer,
EImageFileTypes  type = TImage::kPng 
)
overridevirtual

Create image from compressed buffer.

Supported formats:

  • PNG - by default
  • XPM - two options exist:
    1. xpm as a single string (raw buffer). Such string is returned by GetImageBuffer method. For example:
      char *buf;
      int sz;
      im1->GetImageBuffer(&buf, &int, TImage::kXpm); /*raw buffer*&zwj;/
      TImage *im2 = TImage::Create();
      im2->SetImageBuffer(&buf, TImage::kXpm);
      @ kXpm
      Definition TImage.h:37
    2. xpm as an array of strings (pre-parsed)
      For example:
      char *xpm[] = {
      "64 28 58 1",
      " c #0A030C",
      ". c #1C171B"
      ...
      TImage *im = TImage::Create();
      im->SetImageBuffer(xpm, TImage::kXpm);

Reimplemented from TImage.

Definition at line 6042 of file TASImage.cxx.

◆ SetJpegDpi()

Bool_t TASImage::SetJpegDpi ( const char *  name,
UInt_t  set = 72 
)

Set an image printing resolution in Dots Per Inch units.

Parameters
[in]name- the name of jpeg file.
[in]set- dpi resolution.

Returns kFALSE in case of error.

Definition at line 6782 of file TASImage.cxx.

◆ SetPalette()

void TASImage::SetPalette ( const TImagePalette palette)
overridevirtual

Set a new palette to an image.

Only images that were created with the SetImage() functions can be modified with this function. The previously used palette is destroyed.

Reimplemented from TAttImage.

Definition at line 1861 of file TASImage.cxx.

◆ SetPaletteEnabled()

void TASImage::SetPaletteEnabled ( Bool_t  on = kTRUE)
overridevirtual

Switch on/off the image palette.

That also invokes calling vectorization of image.

Reimplemented from TAttImage.

Definition at line 6711 of file TASImage.cxx.

◆ SetTitle()

void TASImage::SetTitle ( const char *  title = "")
overridevirtual

Set a title for an image.

Reimplemented from TNamed.

Definition at line 6297 of file TASImage.cxx.

◆ Slice()

void TASImage::Slice ( UInt_t  xStart,
UInt_t  xEnd,
UInt_t  yStart,
UInt_t  yEnd,
UInt_t  toWidth,
UInt_t  toHeight 
)
overridevirtual

Another method of enlarging images where corners remain unchanged, but middle part gets tiled.

Reimplemented from TImage.

Definition at line 1951 of file TASImage.cxx.

◆ StartPaletteEditor()

void TASImage::StartPaletteEditor ( )
overridevirtual

Start palette editor.

Reimplemented from TAttImage.

Definition at line 2252 of file TASImage.cxx.

◆ Streamer()

void TASImage::Streamer ( TBuffer b)
overridevirtual

Streamer for ROOT I/O.

Reimplemented from TObject.

Definition at line 6175 of file TASImage.cxx.

◆ StreamerNVirtual()

void TASImage::StreamerNVirtual ( TBuffer ClassDef_StreamerNVirtual_b)
inline

Definition at line 211 of file TASImage.h.

◆ Tile()

void TASImage::Tile ( UInt_t  width,
UInt_t  height 
)
overridevirtual

Tile the original image.

Reimplemented from TImage.

Definition at line 1987 of file TASImage.cxx.

◆ TypeFromMagicNumber()

const char * TASImage::TypeFromMagicNumber ( const char *  file)
private

Guess the file type from the first byte of file.

Definition at line 402 of file TASImage.cxx.

◆ UnZoom()

void TASImage::UnZoom ( )
overridevirtual

Un-zoom the image to original size.

UnZoom() - performs undo for Zoom,Crop,Scale actions

Reimplemented from TImage.

Definition at line 2049 of file TASImage.cxx.

◆ Vectorize()

Double_t * TASImage::Vectorize ( UInt_t  max_colors = 256,
UInt_t  dither = 4,
Int_t  opaque_threshold = 1 
)
overridevirtual

Reduce color-depth of an image and fills vector of "scientific data" [0...1].

Colors are reduced by allocating color cells to most used colors first, and then approximating other colors with those allocated.

Parameters
[in]max_colors- maximum size of the colormap.
[in]dither- number of bits to strip off the color data ( 0...7 )
[in]opaque_threshold- alpha channel threshold at which pixel should be treated as opaque

Reimplemented from TImage.

Definition at line 2832 of file TASImage.cxx.

◆ WriteImage()

void TASImage::WriteImage ( const char *  file,
EImageFileTypes  type = TImage::kUnknown 
)
overridevirtual

Write image to specified file.

If there is no file extension or if the file extension is unknown, the type argument will be used to determine the file type. The quality and compression is derived from the TAttImage values.

It's possible to write image into an animated GIF file by specifying file name as "myfile.gif+" or "myfile.gif+NN", where NN is the delay of displaying subimages during animation in 10ms seconds units. NN is not restricted to two digits. If NN is omitted the delay between subimages is zero. For an animation that stops after last subimage is reached, one has to write the last image as .gif+ (zero delay of last image) or .gif+NN (NN*10ms delay of last image).

For repeated animation (looping), the last subimage must be specified as:

  • "myfile.gif++NN++" if you want an infinite looping gif with NN*10ms delay of the last image.
  • "myfile.gif++" for an infinite loop with zero delay of last image.
  • "myfile.gif+NN++RR" if you want a finite looping gif with NN*10ms delay of the last image and the animation to be stopped after RR repeats. RR is not restricted to two digits.

A deprecated version for saving the last subimage of a looping gif animation is:

  • "myfile.gif++NN" for a finite loop where NN is number of repetitions and NN*10ms the delay of last image. (No separate control of repeats and delay). Note: If the file "myfile.gif" already exists, the new frames are appended at the end of the file. To avoid this, delete it first with gSystem->Unlink(myfile.gif);

The following macro creates animated gif from jpeg images with names

  • imageNN.jpg, where 1<= NN <= 10
  • The delays are set to 10*10ms.
    {
    TImage *img = 0;
    gSystem->Unlink("anim.gif"); // delete existing file
    for (int i = 1; i <= 10; i++) {
    delete img; // delete previous image
    // Read image data. Image can be in any format, e.g. png, gif, etc.
    img = TImage::Open(Form("image%d.jpg", i));
    if (i < 10) {
    img->WriteImage("anim.gif+10"); // 10 centiseconds delay
    } else { // the last image written. "++" stands for infinit animation.
    img->WriteImage("anim.gif++10++"); // 10 centiseconds delay of last image
    }
    }
    }
    char * Form(const char *fmt,...)
    Formats a string in a circular formatting buffer.
    Definition TString.cxx:2467
    R__EXTERN TSystem * gSystem
    Definition TSystem.h:560
    virtual void WriteImage(const char *, EImageFileTypes=TImage::kUnknown)
    Definition TImage.h:115
    virtual int Unlink(const char *name)
    Unlink, i.e.
    Definition TSystem.cxx:1368

Reimplemented from TImage.

Definition at line 656 of file TASImage.cxx.

◆ Zoom()

void TASImage::Zoom ( UInt_t  offX,
UInt_t  offY,
UInt_t  width,
UInt_t  height 
)
overridevirtual

The area of an image displayed in a pad is defined by this function.

Note: the size on the screen is defined by the size of the pad. The original image is not modified by this function. If width or height is larger than the original image they are reduced to the width and height of the image. If the off values are too large (off + width > image width) than the off values are decreased. For example: offX = image width - width Note: the parameters are always relative to the original image not to the size of an already zoomed image.

Reimplemented from TImage.

Definition at line 2027 of file TASImage.cxx.

Member Data Documentation

◆ fEditable

Bool_t TASImage::fEditable
protected

! kTRUE image can be resized, moved by resizing/moving gPad

Definition at line 66 of file TASImage.h.

◆ fgInit

Bool_t TASImage::fgInit = kFALSE
staticprotected

global flag to init afterimage only once

Definition at line 73 of file TASImage.h.

◆ fgPlugList

THashTable * TASImage::fgPlugList = new THashTable(50)
staticprotected

! hash table containing loaded plugins

Definition at line 70 of file TASImage.h.

◆ fGrayImage

ASImage* TASImage::fGrayImage
protected

! gray image

Definition at line 68 of file TASImage.h.

◆ fgVisual

ASVisual * TASImage::fgVisual = nullptr
staticprotected

pointer to visual structure

Definition at line 72 of file TASImage.h.

◆ fImage

ASImage* TASImage::fImage
protected

! pointer to image structure of original image

Definition at line 57 of file TASImage.h.

◆ fIsGray

Bool_t TASImage::fIsGray
protected

! kTRUE if image is gray

Definition at line 69 of file TASImage.h.

◆ fMaxValue

Double_t TASImage::fMaxValue
protected

! max value in image

Definition at line 59 of file TASImage.h.

◆ fMinValue

Double_t TASImage::fMinValue
protected

! min value in image

Definition at line 60 of file TASImage.h.

◆ fPaintMode

Int_t TASImage::fPaintMode
protected

! 1 - fast mode, 0 - low memory slow mode

Definition at line 67 of file TASImage.h.

◆ fScaledImage

TASImage* TASImage::fScaledImage
protected

! temporary scaled and zoomed image produced from original image

Definition at line 58 of file TASImage.h.

◆ fZoomHeight

UInt_t TASImage::fZoomHeight
protected

! hight of zoomed image in image pixels

Definition at line 64 of file TASImage.h.

◆ fZoomOffX

UInt_t TASImage::fZoomOffX
protected

! X - offset for zooming in image pixels

Definition at line 61 of file TASImage.h.

◆ fZoomOffY

UInt_t TASImage::fZoomOffY
protected

! Y - offset for zooming im image pixels

Definition at line 62 of file TASImage.h.

◆ fZoomUpdate

Int_t TASImage::fZoomUpdate
protected

! kZoom - new zooming required, kZoomOps - other ops in action, kNoZoom - no zooming or ops

Definition at line 65 of file TASImage.h.

◆ fZoomWidth

UInt_t TASImage::fZoomWidth
protected

! width of zoomed image in image pixels

Definition at line 63 of file TASImage.h.

Libraries for TASImage:

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