BufferedImageGenerator Class Reference
Receives camera frames as they are loaded by the simulator -- or eventually other sources. More...
#include <BufferedImageGenerator.h>
Detailed Description
Receives camera frames as they are loaded by the simulator -- or eventually other sources.
Definition at line 9 of file BufferedImageGenerator.h.
Classes | |
| struct | ImageSource |
| Stores information about the current frame, (not the image itself, but meta data a pointer to it). More... | |
Public Member Functions | |
| BufferedImageGenerator (const std::string &name, EventBase::EventGeneratorID_t mgid, unsigned int msid, unsigned int nLayers, EventBase::EventGeneratorID_t srcgid, unsigned int srcsid) | |
| constructor | |
| virtual | ~BufferedImageGenerator () |
| destructor | |
| virtual void | doStart () |
| need to override EventGeneratorBase's lazy listening -- as a root stage, need to remember each frame, just in case it might be used | |
| virtual void | doEvent () |
| default implementation does a few common housekeeping chores for you - probably should just take a look at its code | |
| virtual unsigned int | getBinSize () const |
| virtual unsigned int | loadBuffer (const char buf[], unsigned int len, const char *filename=NULL) |
| virtual unsigned int | saveBuffer (char buf[], unsigned int len) const |
| virtual unsigned int | saveFileStream (FILE *f) const |
| overrridden to allow saving direct to file without an extra buffer copy | |
| virtual void | freeCaches () |
| deletes storage of cached images and marks it invalid | |
| virtual void | invalidateCaches () |
| marks all of the cached images as invalid (but doesn't free their memory) | |
Protected Member Functions | |
| virtual unsigned char * | createImageCache (unsigned int layer, unsigned int channel) const |
| create new image data storage area for the cache - this called by getImage() only when the corresponding entry in images is NULL | |
| virtual void | calcImage (unsigned int layer, unsigned int channel) |
| should calculate new image data, called by getImage() only when imageValids indicates the image being requested is dirty (and only after getImage() has already called createImageCache()) | |
| virtual void | setDimensions () |
| resets width and height parameters to that of the src | |
| virtual void | destruct () |
| deletes the arrays | |
| virtual void | setNumImages (unsigned int nLayers, unsigned int nChannels) |
| resizes the filter bank information storage area, you should override this to do your setup and call it from your constructor | |
| virtual void | upsampleImage (unsigned int srcLayer, unsigned int chan, unsigned int destLayer) |
| duplicates pixels to make a higher resolution version of srcLayer, chan into destLayer, chan | |
| virtual void | downsampleImage (unsigned int destLayer, unsigned int chan) |
| averages blocks of pixels to make smaller images | |
| virtual void | calcDx (unsigned int layer, unsigned int srcChan=RawCameraGenerator::CHAN_Y, unsigned int dstChan=RawCameraGenerator::CHAN_Y_DX) |
| calculates the x-derivative | |
| virtual void | calcDy (unsigned int layer, unsigned int srcChan=RawCameraGenerator::CHAN_Y, unsigned int dstChan=RawCameraGenerator::CHAN_Y_DY) |
| calculates the x-derivative | |
| virtual void | calcDxDy (unsigned int layer) |
| calculates the diagonal derivative | |
Protected Attributes | |
| ImageSource | imgsrc |
| the data storage of the current image (not the image itself, but meta data a pointer to it) | |
| bool ** | isAllocated |
| for each image in the filterbank, a bool to account whether the pointer is to an external resource or a self-allocated resource | |
Private Member Functions | |
| BufferedImageGenerator (const BufferedImageGenerator &) | |
| don't call | |
| BufferedImageGenerator & | operator= (const BufferedImageGenerator &) |
| don't call | |
Constructor & Destructor Documentation
| BufferedImageGenerator::BufferedImageGenerator | ( | const std::string & | name, | |
| EventBase::EventGeneratorID_t | mgid, | |||
| unsigned int | msid, | |||
| unsigned int | nLayers, | |||
| EventBase::EventGeneratorID_t | srcgid, | |||
| unsigned int | srcsid | |||
| ) |
constructor
Definition at line 35 of file BufferedImageGenerator.h.
| virtual BufferedImageGenerator::~BufferedImageGenerator | ( | ) | [virtual] |
destructor
Definition at line 48 of file BufferedImageGenerator.h.
| BufferedImageGenerator::BufferedImageGenerator | ( | const BufferedImageGenerator & | ) | [private] |
don't call
Member Function Documentation
| void BufferedImageGenerator::calcDx | ( | unsigned int | layer, | |
| unsigned int | srcChan = RawCameraGenerator::CHAN_Y, |
|||
| unsigned int | dstChan = RawCameraGenerator::CHAN_Y_DX | |||
| ) | [protected, virtual] |
calculates the x-derivative
Definition at line 404 of file BufferedImageGenerator.cc.
Referenced by calcDxDy(), and calcImage().
| void BufferedImageGenerator::calcDxDy | ( | unsigned int | layer | ) | [protected, virtual] |
calculates the diagonal derivative
Definition at line 452 of file BufferedImageGenerator.cc.
Referenced by calcImage().
| void BufferedImageGenerator::calcDy | ( | unsigned int | layer, | |
| unsigned int | srcChan = RawCameraGenerator::CHAN_Y, |
|||
| unsigned int | dstChan = RawCameraGenerator::CHAN_Y_DY | |||
| ) | [protected, virtual] |
calculates the x-derivative
Definition at line 427 of file BufferedImageGenerator.cc.
Referenced by calcDxDy(), and calcImage().
| void BufferedImageGenerator::calcImage | ( | unsigned int | layer, | |
| unsigned int | channel | |||
| ) | [protected, virtual] |
should calculate new image data, called by getImage() only when imageValids indicates the image being requested is dirty (and only after getImage() has already called createImageCache())
This is where you'll want to put your user-specific code for calculating the image data
Implements FilterBankGenerator.
Definition at line 254 of file BufferedImageGenerator.cc.
| unsigned char * BufferedImageGenerator::createImageCache | ( | unsigned int | layer, | |
| unsigned int | channel | |||
| ) | const [protected, virtual] |
create new image data storage area for the cache - this called by getImage() only when the corresponding entry in images is NULL
You should return the pointer you want stored in images to be returned by any calls to getFirstRow. Interpretation of the data it points to is dependant on the the generator which creates it
Implements FilterBankGenerator.
Definition at line 235 of file BufferedImageGenerator.cc.
Referenced by downsampleImage(), and loadBuffer().
| void BufferedImageGenerator::destruct | ( | ) | [protected, virtual] |
deletes the arrays
Reimplemented from FilterBankGenerator.
Definition at line 316 of file BufferedImageGenerator.cc.
Referenced by ~BufferedImageGenerator().
| void BufferedImageGenerator::doEvent | ( | ) | [virtual] |
default implementation does a few common housekeeping chores for you - probably should just take a look at its code
It doesn't throw any events for you - that's probably the main reason you'd still want to override it
Also, if your class has a set number of layers or channels - for instance, always 1 channel like InterleavedYUVGenerator, you should override setNumImages() to enforce that constraint by throwing away the appropriate argument and passing the your own value to the superclass implementation.
Reimplemented from FilterBankGenerator.
Definition at line 13 of file BufferedImageGenerator.cc.
| virtual void BufferedImageGenerator::doStart | ( | ) | [virtual] |
need to override EventGeneratorBase's lazy listening -- as a root stage, need to remember each frame, just in case it might be used
Reimplemented from EventGeneratorBase.
Definition at line 51 of file BufferedImageGenerator.h.
| void BufferedImageGenerator::downsampleImage | ( | unsigned int | destLayer, | |
| unsigned int | chan | |||
| ) | [protected, virtual] |
averages blocks of pixels to make smaller images
Definition at line 369 of file BufferedImageGenerator.cc.
Referenced by calcImage().
| void BufferedImageGenerator::freeCaches | ( | ) | [virtual] |
deletes storage of cached images and marks it invalid
you should override this if the images cache pointer isn't actually an array of bytes... Don't forget to call it in your subclass's destructor or your version won't get called...
Reimplemented from FilterBankGenerator.
Definition at line 219 of file BufferedImageGenerator.cc.
Referenced by doEvent().
| unsigned int BufferedImageGenerator::getBinSize | ( | ) | const [virtual] |
The loadBuffer() functions of the included subclasses aren't tested, so don't assume they'll work without a little debugging...
Reimplemented from FilterBankGenerator.
Definition at line 77 of file BufferedImageGenerator.cc.
Referenced by saveFileStream().
| void BufferedImageGenerator::invalidateCaches | ( | ) | [virtual] |
marks all of the cached images as invalid (but doesn't free their memory)
You probably want to call this right before you send the FilterBankEvent
Reimplemented from FilterBankGenerator.
Definition at line 226 of file BufferedImageGenerator.cc.
Referenced by doEvent().
| unsigned int BufferedImageGenerator::loadBuffer | ( | const char | buf[], | |
| unsigned int | len, | |||
| const char * | filename = NULL | |||
| ) | [virtual] |
The loadBuffer() functions of the included subclasses aren't tested, so don't assume they'll work without a little debugging...
Reimplemented from FilterBankGenerator.
Definition at line 85 of file BufferedImageGenerator.cc.
| BufferedImageGenerator& BufferedImageGenerator::operator= | ( | const BufferedImageGenerator & | ) | [private] |
don't call
| unsigned int BufferedImageGenerator::saveBuffer | ( | char | buf[], | |
| unsigned int | len | |||
| ) | const [virtual] |
The loadBuffer() functions of the included subclasses aren't tested, so don't assume they'll work without a little debugging...
Reimplemented from FilterBankGenerator.
Definition at line 110 of file BufferedImageGenerator.cc.
Referenced by saveFileStream().
| unsigned int BufferedImageGenerator::saveFileStream | ( | FILE * | f | ) | const [virtual] |
overrridden to allow saving direct to file without an extra buffer copy
Reimplemented from LoadSave.
Definition at line 151 of file BufferedImageGenerator.cc.
| void BufferedImageGenerator::setDimensions | ( | ) | [protected, virtual] |
resets width and height parameters to that of the src
You'll probably want to override this to also set skips and strides
Reimplemented from FilterBankGenerator.
Definition at line 283 of file BufferedImageGenerator.cc.
Referenced by doEvent(), and setNumImages().
| void BufferedImageGenerator::setNumImages | ( | unsigned int | nLayers, | |
| unsigned int | nChannels | |||
| ) | [protected, virtual] |
resizes the filter bank information storage area, you should override this to do your setup and call it from your constructor
In general, it isn't expected that FilterBankGenerator's should necessarily be dynamically resizeable (although it would be nice), which is why this isn't public. If yours is, just add some pubic accessor functions which call this. In general, the included subclasses should be able to handle being resized, but there's no reason to do so since the system won't be changing its available resolutions at run time.
The default implementation is a no-op if(numLayers==nLayers && numChannels==nChannels)
Reimplemented from FilterBankGenerator.
Definition at line 323 of file BufferedImageGenerator.cc.
Referenced by BufferedImageGenerator().
| void BufferedImageGenerator::upsampleImage | ( | unsigned int | srcLayer, | |
| unsigned int | chan, | |||
| unsigned int | destLayer | |||
| ) | [protected, virtual] |
duplicates pixels to make a higher resolution version of srcLayer, chan into destLayer, chan
Doesn't do anything fancy like blurring or smoothing
Definition at line 336 of file BufferedImageGenerator.cc.
Referenced by calcImage().
Member Data Documentation
ImageSource BufferedImageGenerator::imgsrc [protected] |
the data storage of the current image (not the image itself, but meta data a pointer to it)
Definition at line 85 of file BufferedImageGenerator.h.
Referenced by calcImage(), createImageCache(), doEvent(), downsampleImage(), setDimensions(), and upsampleImage().
bool** BufferedImageGenerator::isAllocated [protected] |
for each image in the filterbank, a bool to account whether the pointer is to an external resource or a self-allocated resource
Definition at line 86 of file BufferedImageGenerator.h.
Referenced by createImageCache(), destruct(), doEvent(), freeCaches(), invalidateCaches(), and setNumImages().
The documentation for this class was generated from the following files:
