CFx SDK Documentation  2023 SP0
Public Member Functions | List of all members
OdGiRasterImageWrapper Class Reference

#include <GiRasterWrappers.h>

Inheritance diagram for OdGiRasterImageWrapper:
OdGiRasterImageParam OdGiRasterImage OdRxObject OdGiBitonalRasterTransformer OdGiInversionRasterTransformer OdGiLeftToRightRasterTransformer OdGiUpsideDownRasterTransformer OdGiGrayscaleRasterTransformer OdGiMonochromaticRasterTransformer

Public Member Functions

 OdGiRasterImageWrapper ()
 
virtual ~OdGiRasterImageWrapper ()
 
void setOriginal (const OdGiRasterImage *pOrig)
 
const OdGiRasterImageoriginal () const
 
OdGiRasterImagePtr cloneOriginal () const
 
OdUInt32 pixelWidth () const
 
OdUInt32 pixelHeight () const
 
Units defaultResolution (double &xPelsPerUnit, double &yPelsPerUnit) const
 
OdUInt32 colorDepth () const
 
OdUInt32 numColors () const
 
ODCOLORREF color (OdUInt32 colorIndex) const
 
OdUInt32 paletteDataSize () const
 
void paletteData (OdUInt8 *bytes) const
 
OdUInt32 scanLineSize () const
 
void scanLines (OdUInt8 *scnLines, OdUInt32 firstScanline, OdUInt32 numLines=1) const
 
const OdUInt8scanLines () const
 
PixelFormatInfo pixelFormat () const
 
OdUInt32 scanLinesAlignment () const
 
int transparentColor () const
 
ImageSource imageSource () const
 
const OdStringsourceFileName () const
 
TransparencyMode transparencyMode () const
 
OdUInt32 supportedParams () const
 
void setImageSource (ImageSource source)
 
void setSourceFileName (const OdString &fileName)
 
void setTransparencyMode (TransparencyMode mode)
 
voidimp () const
 
OdRxObjectPtr clone () const
 
void copyFrom (const OdRxObject *pSource)
 
- Public Member Functions inherited from OdGiRasterImageParam
 ODRX_DECLARE_MEMBERS (OdGiRasterImageParam)
 
- Public Member Functions inherited from OdGiRasterImage
 ODRX_DECLARE_MEMBERS (OdGiRasterImage)
 
OdSmartPtr< OdGiRasterImagechangeImageSource (ImageSource source, const OdChar *pFileName=NULL)
 
OdSmartPtr< OdGiRasterImagechangeSourceFileName (const OdString &fileName)
 
OdSmartPtr< OdGiRasterImagechangeTransparencyMode (TransparencyMode mode)
 
OdSmartPtr< OdGiRasterImageconvert (bool convertPaletteToRGB, double brightness=50.0, double contrast=50.0, double fade=0.0, ODCOLORREF backgroundColor=0, bool flipX=false, bool flipY=false, bool rotate90=false, const OdGiRasterImage *pDestDesc=0, bool transparency=false) const
 
virtual OdSmartPtr< OdGiRasterImagecrop (OdUInt32 x, OdUInt32 y, OdUInt32 width, OdUInt32 height) const
 
- Public Member Functions inherited from OdRxObject
 ODRX_HEAP_OPERATORS ()
 
 OdRxObject ()
 
virtual ~OdRxObject ()
 
virtual OdRxObjectqueryX (const OdRxClass *pClass) const
 
virtual OdRxObjectx (const OdRxClass *pClass) const
 
virtual OdRxClassisA () const
 
virtual void addRef ()=0
 
virtual void release ()=0
 
virtual long numRefs () const
 
bool isKindOf (const OdRxClass *pClass) const
 
virtual OdRx::Ordering comparedTo (const OdRxObject *pOther) const
 
virtual bool isEqualTo (const OdRxObject *pOther) const
 

Additional Inherited Members

- Public Types inherited from OdGiRasterImageParam
enum  ParamType { kImageSource = (1 << 0) , kTransparencyMode = (1 << 1) , kSourceFileName = (1 << 2) }
 
- Public Types inherited from OdGiRasterImage
enum  Units {
  kNone = 0 , kMillimeter , kCentimeter , kMeter ,
  kKilometer , kInch , kFoot , kYard ,
  kMile , kMicroinches , kMils , kAngstroms ,
  kNanometers , kMicrons , kDecimeters , kDekameters ,
  kHectometers , kGigameters , kAstronomical , kLightYears ,
  kParsecs
}
 
enum  ImageSource {
  kUndefinedSource = -1 , kFromDwg = 0 , kFromOleObject = 1 , kFromRender = 2 ,
  kFromUnderlay = 10 , kFromImageBGRA32 = 11 , kFromPdfUnderlay = kFromOleObject , kFromFile = kFromDwg
}
 
enum  TransparencyMode { kTransparencyDef = -1 , kTransparencyOff = 0 , kTransparency1Bit = 1 , kTransparency8Bit = 2 }
 
typedef struct OdGiRasterImage::tagPixelFormatInfo PixelFormatInfo
 
- Static Public Member Functions inherited from OdGiRasterImage
static OdUInt32 calcBMPScanLineSize (OdUInt32 pixelWidth, int colorDepth)
 
static OdUInt32 calcColorMask (OdUInt8 numColorBits, OdUInt8 colorOffset=0)
 
- Static Public Member Functions inherited from OdRxObject
static OdRxObjectPtr cast (const OdRxObject *pointer)
 
static OdRxClassdesc ()
 

Detailed Description

This class is the base class for raster image transformer objects.

Corresponding C++ library: TD_Gi

Remarks
Transforming an image does not affect the orignal.

The default methods for this class do nothing but return the corresponding values from the original object.

<group OdGi_Classes>

Definition at line 690 of file GiRasterWrappers.h.

Constructor & Destructor Documentation

◆ OdGiRasterImageWrapper()

OdGiRasterImageWrapper::OdGiRasterImageWrapper ( )

◆ ~OdGiRasterImageWrapper()

virtual OdGiRasterImageWrapper::~OdGiRasterImageWrapper ( )
virtual

Member Function Documentation

◆ clone()

OdRxObjectPtr OdGiRasterImageWrapper::clone ( ) const
virtual

◆ cloneOriginal()

OdGiRasterImagePtr OdGiRasterImageWrapper::cloneOriginal ( ) const

Copies the original OdGiRasterImage object associated with this RasterImageWrapper object.

◆ color()

ODCOLORREF OdGiRasterImageWrapper::color ( OdUInt32  colorIndex) const
virtual

Returns the color for the specified index from the palette of this RasterImage object.

Parameters
colorIndex[in] Color index.

Implements OdGiRasterImage.

Reimplemented in OdGiInversionRasterTransformer, and OdGiBitonalRasterTransformer.

◆ colorDepth()

OdUInt32 OdGiRasterImageWrapper::colorDepth ( ) const
virtual

Returns the number of bits per pixel used for colors by this RasterImage object.

Implements OdGiRasterImage.

◆ copyFrom()

void OdGiRasterImageWrapper::copyFrom ( const OdRxObject pSource)
virtual

Copies data of a source object to the current object.

Parameters
pSource[in] Input source object.

Reimplemented from OdRxObject.

Reimplemented in OdGiMonochromaticRasterTransformer, OdGiGrayscaleRasterTransformer, OdGiInversionRasterTransformer, OdGiLeftToRightRasterTransformer, OdGiUpsideDownRasterTransformer, and OdGiBitonalRasterTransformer.

◆ defaultResolution()

Units OdGiRasterImageWrapper::defaultResolution ( double &  xPelsPerUnit,
double &  yPelsPerUnit 
) const
virtual

Returns the default image resolution in pixels per unit of this RasterImage object.

Parameters
xPelsPerUnit[out] Receives the pixels per unit value (x direction).
yPelsPerUnit[out] Receives the pixels per unit value (y direction).
Remarks
If the returned value is kNone, then xPelsPerUnit and yPelsPerUnit are not set.

Reimplemented from OdGiRasterImage.

◆ imageSource()

ImageSource OdGiRasterImageWrapper::imageSource ( ) const
virtual

Returns the image source.

Reimplemented from OdGiRasterImage.

◆ imp()

void* OdGiRasterImageWrapper::imp ( ) const
virtual

Returns the user-end implementation of raster image functionality.

Remarks
If not overridden by a user-end raster image implementation, always returns null.

Reimplemented from OdGiRasterImage.

◆ numColors()

OdUInt32 OdGiRasterImageWrapper::numColors ( ) const
virtual

Returns the number of colors in the palette of this RasterImage object.

Implements OdGiRasterImage.

Reimplemented in OdGiBitonalRasterTransformer.

◆ original()

const OdGiRasterImage* OdGiRasterImageWrapper::original ( ) const

Returns the original OdGiRasterImage object associated with this RasterImageWrapper object.

◆ paletteData()

void OdGiRasterImageWrapper::paletteData ( OdUInt8 bytes) const
virtual

Returns the size (in bytes) of the palette data of this RasterImage object.

Implements OdGiRasterImage.

Reimplemented in OdGiInversionRasterTransformer, and OdGiBitonalRasterTransformer.

◆ paletteDataSize()

OdUInt32 OdGiRasterImageWrapper::paletteDataSize ( ) const
virtual

Returns the size (in bytes) of the palette data of this RasterImage object.

Implements OdGiRasterImage.

Reimplemented in OdGiBitonalRasterTransformer.

◆ pixelFormat()

PixelFormatInfo OdGiRasterImageWrapper::pixelFormat ( ) const
virtual

Returns the pixel format for this RasterImage object.

Remarks
This function returns the pixel format of the palette, unless there is no palette, in which case it returns the pixel format of the image itself.

Implements OdGiRasterImage.

Reimplemented in OdGiBitonalRasterTransformer.

◆ pixelHeight()

OdUInt32 OdGiRasterImageWrapper::pixelHeight ( ) const
virtual

Returns the image height in pixels of this RasterImage object.

Implements OdGiRasterImage.

◆ pixelWidth()

OdUInt32 OdGiRasterImageWrapper::pixelWidth ( ) const
virtual

Returns the image width in pixels of this RasterImage object.

Implements OdGiRasterImage.

◆ scanLines() [1/2]

const OdUInt8* OdGiRasterImageWrapper::scanLines ( ) const
virtual

Returns the set of scanlines.

Remarks
Implementation of this function is optional; NULL can be returned if it is inconvenient to implement. The caller must take into account that the return value can be NULL. If this method returns NULL, scanlines can be accessed by a second version of the scanLines() method with arguments where a memory buffer for scalines data is preallocated by the caller.

Implements OdGiRasterImage.

Reimplemented in OdGiInversionRasterTransformer, OdGiLeftToRightRasterTransformer, and OdGiUpsideDownRasterTransformer.

◆ scanLines() [2/2]

void OdGiRasterImageWrapper::scanLines ( OdUInt8 scnLines,
OdUInt32  firstScanline,
OdUInt32  numLines = 1 
) const
virtual

Returns the specified set of scanlines in BMP format from this RasterImage object, or the pixel data in BMP format for this RasterImage object.

Parameters
scnLines[out] Receives the scanline data.
firstScanline[in] Index of first scanline to retrieve.
numLines[in] Number of scanlines to retrieve.
Remarks
The number of accessible scanlines is equal to the value returned by pixelHeight(). The number of accessible bytes in a scanline is equal to the value returned by scanLineSize(). The scanline returned by firstScanline == 0 is the first scanline in the image. The scanline returned by firstScanline == (pixelHeight() - 1) is the last scanline in the image.
It us up to the caller to allocate sufficient memory for the scanline data.

Implements OdGiRasterImage.

Reimplemented in OdGiInversionRasterTransformer, OdGiLeftToRightRasterTransformer, and OdGiUpsideDownRasterTransformer.

◆ scanLinesAlignment()

OdUInt32 OdGiRasterImageWrapper::scanLinesAlignment ( ) const
virtual

Returns the scanline alignment, in bytes, for this RasterImage object. Example: scanLinesAlignment() returns 4 for Windows BMP.

Implements OdGiRasterImage.

◆ scanLineSize()

OdUInt32 OdGiRasterImageWrapper::scanLineSize ( ) const
virtual

Returns the scanline size of this RasterImage object.

Remarks
This function returns the number of bytes between the beginning of scanline N and the beginning of scanline N+1 (taking into account any padding that is added to the end of the scanline).

Reimplemented from OdGiRasterImage.

◆ setImageSource()

void OdGiRasterImageWrapper::setImageSource ( ImageSource  source)
virtual

Sets an image source.

Parameters
source[in] New image source value.

Reimplemented from OdGiRasterImageParam.

◆ setOriginal()

void OdGiRasterImageWrapper::setOriginal ( const OdGiRasterImage pOrig)

Sets the original OdGiRasterImage object associated with this RasterImageWrapper object.

Parameters
pOrig[in] Pointer to the original image object.

◆ setSourceFileName()

void OdGiRasterImageWrapper::setSourceFileName ( const OdString fileName)
virtual

Sets an image source file name.

Parameters
fileName[in] New value for image source file name.

Reimplemented from OdGiRasterImageParam.

◆ setTransparencyMode()

void OdGiRasterImageWrapper::setTransparencyMode ( TransparencyMode  mode)
virtual

Sets an image transparency mode.

Parameters
mode[in] New transparency mode value.

Reimplemented from OdGiRasterImageParam.

◆ sourceFileName()

const OdString& OdGiRasterImageWrapper::sourceFileName ( ) const
virtual

Returns the image source file name.

Reimplemented from OdGiRasterImage.

◆ supportedParams()

OdUInt32 OdGiRasterImageWrapper::supportedParams ( ) const
virtual

Returns the ParamType bitflags with which parameters are supported by this interface.

Implements OdGiRasterImageParam.

◆ transparencyMode()

TransparencyMode OdGiRasterImageWrapper::transparencyMode ( ) const
virtual

Returns the transparency mode for 32bpp formats.

Reimplemented from OdGiRasterImage.

◆ transparentColor()

int OdGiRasterImageWrapper::transparentColor ( ) const
virtual

Returns the index of transparent color in the image.

Remarks
If there is no transparent color, -1 should be returned. The default implementation of this function returns -1.

Reimplemented from OdGiRasterImage.

Reimplemented in OdGiBitonalRasterTransformer.


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