class DfcAxisInterface : public CorBase class DfcAxisInterface : public CorBase abstract class
 | DfcAxisInterface (void) |
| virtual int | getLowerBound (void) pure virtual |
| virtual const RWString& | getName (void) pure virtual |
| virtual int | getNumPixels (void) pure virtual |
| virtual double | getRealWorldStart (void) pure virtual |
| virtual double | getRealWorldStep (void) pure virtual |
| virtual double | getReferencePoint (void) pure virtual |
| virtual DfcAxis* | getSafeInterface (void) pure virtual |
| virtual int | getUpperBound (void) pure virtual |
| virtual const RWString& | getWorldCoordUnit (void) pure virtual |
| virtual DFC_BOOL | openForRead ( const DfcIO_Strategy &strategy ) pure virtual |
| virtual DFC_BOOL | openForUpdate ( const DfcIO_Strategy &strategy ) pure virtual |
| virtual DfcAxisInterface& | operator= (const DfcAxisInterface &other) pure virtual |
| virtual void | proxyIsDead (void) pure virtual |
| virtual void | removeBounds (void) pure virtual |
| virtual void | removeLowerBound (void) pure virtual |
| virtual void | removeUpperBound (void) pure virtual |
| virtual void | setBounds (double lower, double upper) pure virtual |
| virtual void | setBounds (int lower, int upper) pure virtual |
| virtual void | setLowerBound (double whichPixel) pure virtual |
| virtual void | setLowerBound (int whichPixel) pure virtual |
| virtual void | setName ( const RWString &newName ) pure virtual |
| virtual void | setRealWorldStart ( double newStart ) pure virtual |
| virtual void | setRealWorldStep ( double newStep ) pure virtual |
| virtual void | setReferencePoint (double whichPixel) pure virtual |
| virtual void | setUpperBound (int whichPixel) pure virtual |
| virtual void | setUpperBound (double whichPixel) pure virtual |
| virtual void | setWorldCoordUnit (const RWString &newUnit) pure virtual |
| virtual DfcAxisInterface* | stripProxiesAndClone (void) pure virtual |
| virtual DFC_BOOL | write ( const DfcIO_Strategy &strategy ) pure virtual |
| virtual | ~DfcAxisInterface (void) |
| | Purpose Remove any upper bound that has been placed on the axis (either in Pixel or real world coordinates) |
| | Purpose Perform a shallow copy, same as clone for this class at the moment |
| | Purpose Default constructor |
| | Purpose Sets the name of the Axis |
| | Purpose Returns the name of this axis |
| | Purpose Sets the start value for the real world coordinates for this axis |
| | Returns The value of the start position for the world coordinate representation of this axis |
| | Purpose Sets the step value for the real world coordinates for this axis |
| | Returns The value of the start position for the world coordinate representation of this axis |
| | Purpose Query the number of pixels along this axis |
| | Purpose Returns the reference point (in terms of pixels) associated with this axis |
| | Purpose Defines a pixel poistion in the Image that is used for a reference position |
| | Purpose Removes the lower bound that has been placed on the axis |
| | Purpose Places a bound on the axis in terms of pixels |
| | Purpose Places a bound on the axis in terms of real world coordinates |
| | VLT On-line Data Flow, Subsystem: df-core $Id: DfcAxisInterface |
| | Purpose Places a bound on the axis in terms of pixel coordinates |
| | Purpose Places a bound on the axis in terms of real world coordinates |
| | Purpose Remove any bounds on the axis, either upper or lower, that were previously placed on it |
| | Purpose Place a lower and upper bound on the axis, in terms of pixel coordinates |
| | Purpose Place a lower and upper bound on the axis, in terms of real world coordinates |
| | Purpose Query the type of unit associated with the real world axis measurements |
| | Purpose Set the type of unit associated with the real world axis measurements |
| | Purpose Create a copy of this object (a deep copy) not that it's relevant here at the moment |
| | Purpose To improve the memory management strategy proxies are stored in the objects which they reference |
| | Purpose Makes the object write itself |
| | Purpose Makes the ImageInfo instance read itself from file / server / whatever |
| | Purpose Makes the ImageInfo instance read itself from file / server / whatever |
abstract class
DESCRIPTION
This class is an interface class which all derived classes must conform to.
This class contains all the relevant information and services that are associated with a single axis in an Image.
An instance of this object must exist for every dimension in an Image.
The user should only manipulate DfcAxis instances.
EXAMPLES
DfcAxis myAxis = myImage.getAxis(1);
cout << myAxis.getName() << endl;
myAxis.setName("frequency");
myAxis.setUnit("herz");
myAxis.setLowerBound(20);
myAxis.setUpperBound(22000);
DESIGN DECISIONS
The user should only manipulate DfcAxis instances. These are proxy classes which forward all method invocations to an instance of this class. By using a proxy it allows a user to use an AxisInfo object interface directly without any danger of the user inadvertantly deleting an AxisInfo object which is an important aggregate of DfcImageInfo. It also prevents us having to clutter up the interface of DfcImageInfo with all the operations of DfcAxisInfo.
Arguments
Returns
Arguments
Arguments
Returns
Returns
Exceptions
Exceptions
Exceptions
Exceptions
Exceptions
Exceptions
Returns
Returns
Returns Exceptions Arguments
Returns Exceptions Arguments
Returns Exceptions Arguments
DfcAxisInterface(void)
virtual void setName( const RWString &newName )
virtual const RWString& getName(void)
Returns the name of this axis.
reference to a string object that holds the name of the axis.
virtual void setRealWorldStart( double newStart )
Sets the start value for the real world coordinates for this axis. There is a linear mapping between world coordinates and pixel coordinates:
worldCoordinate = worldCoordStart + pixelValue * worldCoordStep;
virtual double getRealWorldStart(void)
The value of the start position for the world coordinate representation of this axis
virtual void setRealWorldStep( double newStep )
Sets the step value for the real world coordinates for this axis. There is a linear mapping between world coordinates and pixel coordinates:
worldCoordinate = worldCoordStart + pixelValue * worldCoordStep;
virtual double getRealWorldStep(void)
The value of the start position for the world coordinate representation of this axis
virtual int getNumPixels(void)
Query the number of pixels along this axis. Pixels run from 0 up to some limit. Note that this value is not the discrete number of pixels along the axis, but the range ie if the Image is irregularly sampled between 0 and 200 then the value returned by this method will be 200 and not the number of samples along the axis.
The number of pixels along the axis.
virtual double getReferencePoint(void)
Returns the reference point (in terms of pixels) associated with this axis.
the reference pixel.
virtual void setReferencePoint(double whichPixel)
Defines a pixel poistion in the Image that is used for a reference position. This method defines a single position along this axis where the reference pixel is located.
virtual void removeLowerBound(void)
Removes the lower bound that has been placed on the axis. The lowest pixel value becomes 0 again.
virtual void setLowerBound(int whichPixel)
Places a bound on the axis in terms of pixels. It does not matter if the lower pixel bound is placed above the upper pixel bound, this just yields no region in between.
virtual int getLowerBound(void)
virtual void setLowerBound(double whichPixel)
Places a bound on the axis in terms of real world coordinates. It does not matter if the lower pixel bound is placed above the upper pixel bound, this just yields no region in between. The bound is converted to pixel positions internally.
virtual void removeUpperBound(void)
Remove any upper bound that has been placed on the axis (either in Pixel or real world coordinates)
virtual void setUpperBound(int whichPixel)
Places a bound on the axis in terms of pixel coordinates. It does not matter if the lower pixel bound is placed above the upper pixel bound, this just yields no region in between.
virtual int getUpperBound(void)
virtual void setUpperBound(double whichPixel)
Places a bound on the axis in terms of real world coordinates. It does not matter if the lower pixel bound is placed above the upper pixel bound, this just yields no region in between. The bound is converted to pixel positions internally.
virtual void removeBounds(void)
Remove any bounds on the axis, either upper or lower, that were previously placed on it.
virtual void setBounds(int lower, int upper)
Place a lower and upper bound on the axis, in terms of pixel coordinates.
virtual void setBounds(double lower, double upper)
Place a lower and upper bound on the axis, in terms of real world coordinates.
virtual const RWString& getWorldCoordUnit(void)
Query the type of unit associated with the real world axis measurements.
A constant reference to a string which holds a textual description of the unit associated with the axis.
virtual void setWorldCoordUnit(const RWString &newUnit)
Set the type of unit associated with the real world axis measurements.
A constant reference to a string which holds a textual description of the unit associated with the axis.
virtual DfcAxisInterface* stripProxiesAndClone(void)
Create a copy of this object (a deep copy) not that it's relevant here at the moment
virtual DfcAxis* getSafeInterface(void)
virtual void proxyIsDead(void)
To improve the memory management strategy proxies are stored in the objects which they reference. One of the ways in which this improves memory is that the real object can delete its proxy when it itself vanishes, meaning the user does not have to worry about disposing of the proxy. However, should the user decide to delete the proxy it is important that the real object does not atrempt to delete the memory again when it itself is deleted. Therefore the proxy must inform the real object if it is being deleted.
virtual DFC_BOOL write( const DfcIO_Strategy &strategy )
Makes the object write itself. The object writes itself in terms of calls to the methods in the DfcIO_Strategy instance.
Boolean indication of whether the saving of the data was succesful or not.
virtual DFC_BOOL openForUpdate( const DfcIO_Strategy &strategy )
Makes the ImageInfo instance read itself from file / server / whatever. The ImageInfo object only needs to make invocations of the methods in the supplied IO_Strategy object to obtain its data. In this way the source and format of the data is completely transparent to it.
Boolean indicating whether the data was succesfully read or not.
virtual DFC_BOOL openForRead( const DfcIO_Strategy &strategy )
Makes the ImageInfo instance read itself from file / server / whatever. The ImageInfo object only needs to make invocations of the methods in the supplied IO_Strategy object to obtain its data. In this way the source and format of the data is completely transparent to it.
Boolean indicating whether the data was succesfully read or not.
virtual DfcAxisInterface& operator=(const DfcAxisInterface &other)
Perform a shallow copy, same as clone for this class at the moment.
this page has been generated automatically by doc++
(c)opyright by Malte Zöckler, Roland Wunderling
contact: doc++@zib.de