3Depict
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros
Public Member Functions | List of all members
ProfileFilter Class Reference

Filter that does composition or density profiles for various primitives. More...

#include <profile.h>

Inheritance diagram for ProfileFilter:
Inheritance graph
[legend]
Collaboration diagram for ProfileFilter:
Collaboration graph
[legend]

Public Member Functions

 ProfileFilter ()
 
FiltercloneUncached () const
 Duplicate filter contents, excluding cache. More...
 
unsigned int getType () const
 Returns FILTER_TYPE_PROFILE. More...
 
size_t numBytesForCache (size_t nObjects) const
 Get approx number of bytes for caching output. More...
 
virtual void initFilter (const std::vector< const FilterStreamData *> &dataIn, std::vector< const FilterStreamData *> &dataOut)
 Initialise filter, check for upstream range. More...
 
unsigned int refresh (const std::vector< const FilterStreamData *> &dataIn, std::vector< const FilterStreamData *> &getOut, ProgressData &progress)
 update filter More...
 
virtual std::string typeString () const
 Return filter type as std::string. More...
 
void getProperties (FilterPropGroup &propertyList) const
 Get the properties of the filter, in key-value form. First vector is for each output. More...
 
bool setProperty (unsigned int key, const std::string &value, bool &needUpdate)
 Set the properties for the nth filter. Returns true if prop set OK. More...
 
std::string getSpecificErrString (unsigned int code) const
 Get the human readable error string associated with a particular error code during refresh(...) More...
 
bool writeState (std::ostream &f, unsigned int format, unsigned int depth=0) const
 Dump state to output stream, using specified format. More...
 
bool readState (xmlNodePtr &node, const std::string &packDir)
 Read the state of the filter from XML file. If this. More...
 
unsigned int getRefreshBlockMask () const
 Get the stream types that will be dropped during ::refresh. More...
 
unsigned int getRefreshEmitMask () const
 Get the stream types that will be generated during ::refresh. More...
 
unsigned int getRefreshUseMask () const
 Get the stream types that may be utilised in computation during ::refresh. More...
 
void setPropFromBinding (const SelectionBinding &b)
 Set internal property value using a selection binding. More...
 
void setUserString (const std::string &s)
 Set a user-specified string return value is. More...
 
- Public Member Functions inherited from Filter
 Filter ()
 
virtual ~Filter ()
 
virtual void clearCache ()
 Erase cache. More...
 
virtual void clearDevices ()
 Erase any active devices. More...
 
std::string getErrString (unsigned int code) const
 Get the human readable error string associated with a particular error code during refresh(...). Do not override this for specific filter errors. Override getSpecificErrString. More...
 
std::string trueName () const
 Return the unique name for a given filter – DO NOT TRANSLATE. More...
 
virtual void getStateOverrides (std::vector< std::string > &overrides) const
 Return the XML elements that refer to external entities (i.e. files) which do not move with the XML files. At this time, only files are supported. These will be looked for on the filesystem and moved as needed. More...
 
void setCaching (bool enableCache)
 Enable/disable caching for this filter. More...
 
bool haveCache () const
 Have cached output data? More...
 
virtual std::string getUserString () const
 Return a user-specified string, or just the typestring if user set string not active. More...
 
virtual bool writePackageState (std::ostream &f, unsigned int format, const std::vector< std::string > &valueOverrides, unsigned int depth=0) const
 Modified version of writeState for packaging. By default simply calls writeState. More...
 
void getSelectionDevices (std::vector< SelectionDevice *> &devices) const
 Get the selection devices for this filter. MUST be called after refresh() More...
 
void updateOutputInfo (const std::vector< const FilterStreamData *> &dataOut)
 Update the output statistics for this filter (num items of streams of each type output) More...
 
virtual void setPropFromRegion (unsigned int method, unsigned int regionID, float newPos)
 Set a region update. More...
 
virtual bool canBeHazardous () const
 Can this filter perform actions that are potentially a security concern? More...
 
unsigned int getNumOutput (unsigned int streamType) const
 Get the number of outputs for the specified type during the filter's last refresh. More...
 
void getConsoleStrings (std::vector< std::string > &v) const
 Get the filter messages from the console. To erase strings, either call erase, or erase cahche. More...
 
void clearConsole ()
 
virtual bool monitorNeedsRefresh () const
 
virtual bool isPureDataSource () const
 
virtual bool isUsefulAsAppend () const
 
template<>
bool applyPropertyNow (bool &prop, const std::string &val, bool &needUp)
 
template<>
bool applyPropertyNow (Point3D &prop, const std::string &val, bool &needUp)
 
template<>
bool applyPropertyNow (std::string &prop, const std::string &val, bool &needUp)
 

Additional Inherited Members

- Static Public Member Functions inherited from Filter
static void setStrongRandom (bool strongRand)
 Should filters use strong randomisation (where applicable) or not? More...
 
template<typename T >
static void getStreamsOfType (const std::vector< const FilterStreamData *> &vec, std::vector< const T *> &dataOut)
 
- Static Public Attributes inherited from Filter
static ATOMIC_BOOLwantAbort = 0
 
- Protected Member Functions inherited from Filter
void convertFileStringToAbsolute (const string &basePath, std::string &s) const
 
void propagateCache (std::vector< const FilterStreamData *> &dataOut) const
 Propagate the cache into output. More...
 
template<class T >
bool applyPropertyNow (T &oldProp, const std::string &newVal, bool &needUp)
 
void cacheAsNeeded (FilterStreamData *s)
 
- Static Protected Member Functions inherited from Filter
static unsigned int collateIons (const std::vector< const FilterStreamData *> &dataIn, std::vector< IonHit > &outVector, ProgressData &prog, size_t totalDataSize=(size_t) -1)
 
static unsigned int collateIons (const std::vector< const FilterStreamData *> &dataIn, std::vector< Point3D > &outVector, ProgressData &prog, size_t totalDataSize=(size_t) -1)
 
static void propagateStreams (const std::vector< const FilterStreamData *> &dataIn, std::vector< const FilterStreamData *> &dataOut, size_t mask=STREAMTYPE_MASK_ALL, bool invertMask=false)
 Propagate the given input data to an output vector. More...
 
static std::string getBaseErrString (unsigned int errCode)
 Get the generic (applies to any filter) error codes. More...
 
template<class T >
static unsigned int extendDataVector (std::vector< T > &dest, const std::vector< IonHit > &vIonData, unsigned int &progress, size_t offset)
 Extend a point data vector using some ion data. More...
 
template<class T >
static size_t buildSplitPoints (const vector< const FilterStreamData *> &dataIn, ProgressData &progress, size_t totalDataSize, const RangeFile *rngF, const vector< bool > &pSourceEnabled, const vector< bool > &pTargetEnabled, vector< T > &pSource, vector< T > &pTarget)
 
static unsigned int getIonstreamIonID (const IonStreamData *d, const RangeFile *r)
 
static void demuxKey (unsigned int key, unsigned int &keyType, unsigned int &ionOffset)
 Hack to merge/extract two bits of information into a single property key. More...
 
static unsigned int muxKey (unsigned int keyType, unsigned int ionOffset)
 
- Protected Attributes inherited from Filter
bool cache
 
bool cacheOK
 
unsigned int numStreamsLastRefresh [NUM_STREAM_TYPES]
 Array of the number of streams propagated on last refresh. More...
 
std::vector< std::string > consoleOutput
 Temporary console output. Should be only nonzero size if messages are present. More...
 
std::string userString
 User settable labelling string (human readable ID, etc etc) More...
 
std::vector< FilterStreamData * > filterOutputs
 
std::vector< SelectionDevice * > devices
 User interaction "Devices" associated with this filter. More...
 
- Static Protected Attributes inherited from Filter
static bool strongRandom = false
 

Detailed Description

Filter that does composition or density profiles for various primitives.

Constructor & Destructor Documentation

◆ ProfileFilter()

ProfileFilter::ProfileFilter ( )

Member Function Documentation

◆ cloneUncached()

Filter * ProfileFilter::cloneUncached ( ) const
virtual

Duplicate filter contents, excluding cache.

Implements Filter.

References Filter::cache, Filter::cacheOK, ProfileFilter(), and Filter::userString.

◆ getProperties()

void ProfileFilter::getProperties ( FilterPropGroup propertyList) const
virtual

◆ getRefreshBlockMask()

unsigned int ProfileFilter::getRefreshBlockMask ( ) const
virtual

Get the stream types that will be dropped during ::refresh.

Implements Filter.

Referenced by typeString().

Here is the caller graph for this function:

◆ getRefreshEmitMask()

unsigned int ProfileFilter::getRefreshEmitMask ( ) const
virtual

Get the stream types that will be generated during ::refresh.

Implements Filter.

References STREAM_TYPE_DRAW, and STREAM_TYPE_PLOT.

Referenced by typeString().

Here is the caller graph for this function:

◆ getRefreshUseMask()

unsigned int ProfileFilter::getRefreshUseMask ( ) const
virtual

Get the stream types that may be utilised in computation during ::refresh.

Implements Filter.

References STREAM_TYPE_IONS, and STREAM_TYPE_RANGE.

Referenced by typeString().

Here is the caller graph for this function:

◆ getSpecificErrString()

std::string ProfileFilter::getSpecificErrString ( unsigned int  code) const
virtual

Get the human readable error string associated with a particular error code during refresh(...)

Implements Filter.

References ASSERT, COMPILE_ASSERT, ERR_COMP_ENUM_END, and THREEDEP_ARRAYSIZE.

Referenced by typeString().

Here is the caller graph for this function:

◆ getType()

unsigned int ProfileFilter::getType ( ) const
inlinevirtual

Returns FILTER_TYPE_PROFILE.

Implements Filter.

References FILTER_TYPE_PROFILE, initFilter(), numBytesForCache(), and refresh().

◆ initFilter()

void ProfileFilter::initFilter ( const std::vector< const FilterStreamData *> &  dataIn,
std::vector< const FilterStreamData *> &  dataOut 
)
virtual

Initialise filter, check for upstream range.

Reimplemented from Filter.

References STREAM_TYPE_RANGE.

Referenced by getType().

Here is the caller graph for this function:

◆ numBytesForCache()

size_t ProfileFilter::numBytesForCache ( size_t  nObjects) const
virtual

Get approx number of bytes for caching output.

Implements Filter.

Referenced by getType().

Here is the caller graph for this function:

◆ readState()

bool ProfileFilter::readState ( xmlNodePtr &  node,
const std::string &  packDir 
)
virtual

Read the state of the filter from XML file. If this.

Implements Filter.

References ASSERT, boolStrDec(), MINEVENTS_DEFAULT, parseXMLColour(), PLOT_LINE_NONE, PRIMITIVE_CYLINDER_AXIAL, PRIMITIVE_CYLINDER_RADIAL, PRIMITIVE_END, PRIMITIVE_SPHERE, stream_cast(), Filter::userString, XMLHelpFwdToElem(), and XMLHelpGetProp().

Referenced by typeString().

Here is the caller graph for this function:

◆ refresh()

unsigned int ProfileFilter::refresh ( const std::vector< const FilterStreamData *> &  dataIn,
std::vector< const FilterStreamData *> &  getOut,
ProgressData progress 
)
virtual

update filter

Implements Filter.

References PlotStreamData::a, ColourRGBAf::a(), SelectionDevice::addBinding(), ASSERT, PlotStreamData::b, ColourRGBAf::b(), BIND_MODE_FLOAT_TRANSLATE, BIND_MODE_POINT3D_ROTATE, BIND_MODE_POINT3D_ROTATE_LOCK, BIND_MODE_POINT3D_TRANSLATE, BINDING_CYLINDER_DIRECTION, BINDING_CYLINDER_ORIGIN, BINDING_CYLINDER_RADIUS, BINDING_SPHERE_ORIGIN, BINDING_SPHERE_RADIUS, RGBf::blue, Filter::cacheAsNeeded(), FilterStreamData::cached, Filter::cacheOK, DrawableObj::canSelect, Filter::clearDevices(), Filter::consoleOutput, CROP_CYLINDER_INSIDE_AXIAL, CROP_CYLINDER_INSIDE_RADIAL, CROP_SPHERE_INSIDE, IonStreamData::data, PlotStreamData::dataLabel, Filter::devices, DRAW_CYLINDER_BIND_DIRECTION, DRAW_CYLINDER_BIND_ORIGIN, DRAW_CYLINDER_BIND_RADIUS, DRAW_SPHERE_BIND_ORIGIN, DRAW_SPHERE_BIND_RADIUS, DrawStreamData::drawables, RangeStreamData::enabledIons, ERR_ABORT, ERR_MEMALLOC, PlotStreamData::errDat, Filter::filterOutputs, ProgressData::filterProgress, FLAG_CMD, FLAG_SHIFT, PlotStreamData::g, ColourRGBAf::g(), RangeFile::getColour(), RangeFile::getName(), RangeFile::getNumIons(), DrawSphere::getOrigin(), DrawSphere::getRadius(), Filter::getUserString(), RGBf::green, PlotStreamData::index, M_PI, CropHelper::mapIon1D(), numElements(), FilterStreamData::parent, PLOT_MODE_1D, PlotStreamData::plotMode, PlotStreamData::plotStyle, PRIMITIVE_CYLINDER_AXIAL, PRIMITIVE_CYLINDER_RADIAL, PRIMITIVE_SPHERE, Filter::propagateCache(), Filter::propagateStreams(), PlotStreamData::r, ColourRGBAf::r(), RangeStreamData::rangeFile, RGBf::red, SELECT_BUTTON_LEFT, SELECT_BUTTON_MIDDLE, SELECT_BUTTON_RIGHT, SelectionBinding::setBinding(), DrawSphere::setColour(), SelectionBinding::setFloatLimits(), SelectionBinding::setInteractionMode(), DrawSphere::setLatSegments(), DrawSphere::setLongSegments(), CropHelper::setMapMaxima(), DrawSphere::setOrigin(), DrawCylinder::setOrigin(), DrawSphere::setRadius(), STREAM_TYPE_IONS, STREAM_TYPE_PLOT, STREAM_TYPE_RANGE, TRANS, Filter::wantAbort, DrawableObj::wantsLight, PlotStreamData::xLabel, PlotStreamData::xyData, and PlotStreamData::yLabel.

Referenced by getType().

Here is the caller graph for this function:

◆ setProperty()

bool ProfileFilter::setProperty ( unsigned int  key,
const std::string &  value,
bool &  needUpdate 
)
virtual

◆ setPropFromBinding()

void ProfileFilter::setPropFromBinding ( const SelectionBinding b)
virtual

◆ setUserString()

void ProfileFilter::setUserString ( const std::string &  str)
virtual

Set a user-specified string return value is.

Reimplemented from Filter.

References Filter::clearCache(), and Filter::userString.

Referenced by typeString().

Here is the caller graph for this function:

◆ typeString()

virtual std::string ProfileFilter::typeString ( ) const
inlinevirtual

◆ writeState()

bool ProfileFilter::writeState ( std::ostream &  f,
unsigned int  format,
unsigned int  depth = 0 
) const
virtual

Dump state to output stream, using specified format.

Implements Filter.

References ColourRGBAf::a(), ASSERT, ColourRGBAf::b(), escapeXML(), ColourRGBAf::g(), ColourRGBAf::r(), STATE_FORMAT_XML, tabs(), Filter::trueName(), and Filter::userString.

Referenced by typeString().

Here is the caller graph for this function:

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