This class defines a means to convert an image from one colour format to another.
More...
|
| PColourConverter (const PString &srcColourFormat, const PString &dstColourFormat, unsigned width, unsigned height) |
| Create a new converter. More...
|
|
| PColourConverter (const PVideoFrameInfo &src, const PVideoFrameInfo &dst) |
|
virtual void | PrintOn (ostream &strm) const |
| Print description of converter. More...
|
|
PBoolean | GetVFlipState () |
| Get the video conversion vertical flip state. More...
|
|
void | SetVFlipState (PBoolean vFlipState) |
| Set the video conversion vertical flip state. More...
|
|
virtual PBoolean | SetFrameSize (unsigned width, unsigned height) |
| Set the frame size to be used. More...
|
|
virtual PBoolean | SetSrcFrameInfo (const PVideoFrameInfo &info) |
| Set the source frame info to be used. More...
|
|
virtual PBoolean | SetDstFrameInfo (const PVideoFrameInfo &info) |
| Set the destination frame info to be used. More...
|
|
virtual void | GetSrcFrameInfo (PVideoFrameInfo &info) |
| Get the source frame info to be used. More...
|
|
virtual void | GetDstFrameInfo (PVideoFrameInfo &info) |
| Get the destination frame info to be used. More...
|
|
virtual PBoolean | SetSrcFrameSize (unsigned width, unsigned height) |
| Set the source frame size to be used. More...
|
|
virtual PBoolean | SetDstFrameSize (unsigned width, unsigned height) |
| Set the destination frame size to be used. More...
|
|
virtual PBoolean | SetDstFrameSize (unsigned width, unsigned height, PBoolean bScale) |
|
const PString & | GetSrcColourFormat () |
| Get the source colour format. More...
|
|
const PString & | GetDstColourFormat () |
| Get the destination colour format. More...
|
|
PINDEX | GetMaxSrcFrameBytes () |
| Get the maximum frame size in bytes for source frames. More...
|
|
PINDEX | GetMaxDstFrameBytes () |
| Get the maximum frame size in bytes for destination frames. More...
|
|
virtual PBoolean | Convert (const BYTE *srcFrameBuffer, BYTE *dstFrameBuffer, PINDEX *bytesReturned=NULL)=0 |
| Convert from one colour format to another. More...
|
|
virtual PBoolean | Convert (const BYTE *srcFrameBuffer, BYTE *dstFrameBuffer, unsigned int srcFrameBytes, PINDEX *bytesReturned=NULL)=0 |
|
virtual PBoolean | ConvertInPlace (BYTE *frameBuffer, PINDEX *bytesReturned=NULL, PBoolean noIntermediateFrame=false) |
| Convert from one colour format to another. More...
|
|
PBoolean | GetDstFrameSize (unsigned &width, unsigned &height) const |
| Get the output frame size. More...
|
|
PBoolean | GetSrcFrameSize (unsigned &width, unsigned &height) const |
| Get the input frame size. More...
|
|
unsigned | GetSrcFrameWidth () const |
|
unsigned | GetSrcFrameHeight () const |
|
unsigned | GetDstFrameWidth () const |
|
unsigned | GetDstFrameHeight () const |
|
void | SetResizeMode (PVideoFrameInfo::ResizeMode mode) |
| Set the resize mode to be used. More...
|
|
PVideoFrameInfo::ResizeMode | GetResizeMode () const |
| Get the resize mode to be used. More...
|
|
virtual | ~PObject () |
|
virtual PObject * | Clone () const |
| Create a copy of the class on the heap. More...
|
|
virtual PINDEX | HashFunction () const |
| This function yields a hash value required by the PDictionary class. More...
|
|
virtual Comparison | Compare (const PObject &obj) const |
| Compare the two objects and return their relative rank. More...
|
|
virtual Comparison | CompareObjectMemoryDirect (const PObject &obj) const |
| Determine the byte wise comparison of two objects. More...
|
|
bool | operator== (const PObject &obj) const |
| Compare the two objects. More...
|
|
bool | operator!= (const PObject &obj) const |
| Compare the two objects. More...
|
|
bool | operator< (const PObject &obj) const |
| Compare the two objects. More...
|
|
bool | operator> (const PObject &obj) const |
| Compare the two objects. More...
|
|
bool | operator<= (const PObject &obj) const |
| Compare the two objects. More...
|
|
bool | operator>= (const PObject &obj) const |
| Compare the two objects. More...
|
|
virtual const char * | GetClass (unsigned ancestor=0) const |
| Get the current dynamic type of the object instance. More...
|
|
PBoolean | IsClass (const char *cls) const |
|
virtual PBoolean | InternalIsDescendant (const char *clsName) const |
| Determine if the dynamic type of the current instance is a descendent of the specified class. More...
|
|
virtual void | ReadFrom (istream &strm) |
| Input the contents of the object from the stream. More...
|
|
|
static PColourConverter * | Create (const PVideoFrameInfo &src, const PVideoFrameInfo &dst) |
| Create an instance of a colour conversion function. More...
|
|
static PColourConverter * | Create (const PString &srcColourFormat, const PString &destColourFormat, unsigned width, unsigned height) |
|
static void | RGBtoYUV (unsigned r, unsigned g, unsigned b, unsigned &y, unsigned &u, unsigned &v) |
| Convert RGB to YUV. More...
|
|
static void | RGBtoYUV (unsigned r, unsigned g, unsigned b, BYTE &y, BYTE &u, BYTE &v) |
|
static bool | CopyYUV420P (unsigned srcX, unsigned srcY, unsigned srcWidth, unsigned srcHeight, unsigned srcFrameWidth, unsigned srcFrameHeight, const BYTE *srcYUV, unsigned dstX, unsigned dstY, unsigned dstWidth, unsigned dstHeight, unsigned dstFrameWidth, unsigned dstFrameHeight, BYTE *dstYUV, PVideoFrameInfo::ResizeMode resizeMode) |
| Copy a section of the source frame to a section of the destination frame with scaling/cropping as required. More...
|
|
static bool | FillYUV420P (unsigned x, unsigned y, int width, int height, unsigned frameWidth, unsigned frameHeight, BYTE *yuv, unsigned r, unsigned g, unsigned b) |
|
static Comparison | InternalCompareObjectMemoryDirect (const PObject *obj1, const PObject *obj2, PINDEX size) |
| Internal function caled from CompareObjectMemoryDirect() More...
|
|
static const char * | Class () |
| Get the name of the class as a C string. More...
|
|
This class defines a means to convert an image from one colour format to another.
It is an ancestor class for the individual formatting functions.
virtual PBoolean PColourConverter::ConvertInPlace |
( |
BYTE * |
frameBuffer, |
|
|
PINDEX * |
bytesReturned = NULL , |
|
|
PBoolean |
noIntermediateFrame = false |
|
) |
| |
|
virtual |
Convert from one colour format to another.
This version will copy the data from one frame buffer to the same frame buffer. Not all conversions can do this so an intermediate store and copy may be required. If the noIntermediateFrame parameter is true and the conversion cannot be done in place then the function returns false. If the in place conversion can be done then that parameter is ignored.
Note that the frame should be large enough to take the destination pixels.
Default behaviour calls Convert() from the frameBuffer to itself, and if that returns false then calls it again (provided noIntermediateFrame is false) using an intermediate store, copying the intermediate store back to the original frame store.
- Parameters
-
frameBuffer | Frame buffer to translate data |
bytesReturned | Bytes written to frameBuffer |
noIntermediateFrame | Flag to use intermediate store |