RasterCachedImage Class
Represents a raster image supporting raster graphics operations. This image caches pixel data when required.
Inheritance Hierarchy

Namespace: Aspose.Imaging
Assembly: Aspose.Imaging (in Aspose.Imaging.dll) Version: 20.05
Syntax
public abstract class RasterCachedImage : RasterImage

The RasterCachedImage type exposes the following members.

Constructors
  NameDescription
Protected methodRasterCachedImage
Initializes a new instance of the RasterCachedImage class.
Protected methodRasterCachedImage(IColorPalette)
Initializes a new instance of the RasterCachedImage class.
Properties
  NameDescription
Public propertyAutoAdjustPalette
Gets or sets a value indicating whether automatic adjust palette.
(Inherited from Image.)
Public propertyBackgroundColor
Gets or sets a value for the background color.
(Inherited from Image.)
Public propertyBitsPerPixel
Gets the image bits per pixel count.
(Inherited from Image.)
Public propertyBounds
Gets the image bounds.
(Inherited from Image.)
Public propertyBufferSizeHint
Gets or sets the buffer size hint which is defined max allowed size for all internal buffers.
(Inherited from Image.)
Public propertyContainer
Gets the Image container.
(Inherited from Image.)
Protected propertyDataLoader
Gets or sets the data loader.
(Inherited from RasterImage.)
Public propertyDataStreamContainer
Gets the object's data stream.
(Inherited from DataStreamSupporter.)
Public propertyDisposed
Gets a value indicating whether this instance is disposed.
(Inherited from DisposableObject.)
Public propertyFileFormat
Gets a value of file format
(Inherited from Image.)
Public propertyCode exampleHasAlpha
Gets a value indicating whether this instance has alpha.
(Inherited from RasterImage.)
Public propertyHasBackgroundColor
Gets or sets a value indicating whether image has background color.
(Inherited from Image.)
Public propertyHasTransparentColor
Gets a value indicating whether image has transparent color.
(Inherited from RasterImage.)
Public propertyHeight
Gets the image height.
(Inherited from Image.)
Public propertyCode exampleHorizontalResolution
Gets or sets the horizontal resolution, in pixels per inch, of this RasterImage.
(Inherited from RasterImage.)
Public propertyImageOpacity
Gets opacity of this image.
(Inherited from RasterImage.)
Public propertyInterruptMonitor
Gets or sets the interrupt monitor.
(Inherited from Image.)
Public propertyIsCached
Gets a value indicating whether image data is cached currently.
(Overrides DataStreamSupporterIsCached.)
Public propertyIsRawDataAvailable
Gets a value indicating whether raw data loading is available.
(Inherited from RasterImage.)
Public propertyPalette
Gets or sets the color palette.
(Inherited from Image.)
Public propertyCode examplePremultiplyComponents
Gets or sets a value indicating whether the image components must be premultiplied.
(Inherited from RasterImage.)
Public propertyRawCustomColorConverter
Gets or sets the custom color converter
(Inherited from RasterImage.)
Public propertyCode exampleRawDataFormat
Gets the raw data format.
(Inherited from RasterImage.)
Public propertyRawDataSettings
Gets the current raw data settings. Note when using these settings the data loads without conversion.
(Inherited from RasterImage.)
Public propertyRawFallbackIndex
Gets or sets the fallback index to use when palette index is out of bounds
(Inherited from RasterImage.)
Public propertyRawIndexedColorConverter
Gets or sets the indexed color converter
(Inherited from RasterImage.)
Public propertyRawLineSize
Gets the raw line size in bytes.
(Inherited from RasterImage.)
Public propertyCode exampleSize
Gets the image size.
(Inherited from Image.)
Public propertyTransparentColor
Gets the image transparent color.
(Inherited from RasterImage.)
Public propertyUpdateXmpData
Gets or sets a value indicating whether to update the XMP metadata.
(Inherited from RasterImage.)
Public propertyUseRawData
Gets or sets a value indicating whether to use raw data loading when the raw data loading is available.
(Inherited from RasterImage.)
Public propertyCode exampleVerticalResolution
Gets or sets the vertical resolution, in pixels per inch, of this RasterImage.
(Inherited from RasterImage.)
Public propertyWidth
Gets the image width.
(Inherited from Image.)
Public propertyXmpData
Gets or sets the XMP metadata.
(Inherited from RasterImage.)
Methods
  NameDescription
Public methodCode exampleAdjustBrightness
Adjust of a brightness for image.
(Overrides RasterImageAdjustBrightness(Int32).)
Public methodCode exampleAdjustContrast
Image contrasting
(Overrides RasterImageAdjustContrast(Single).)
Public methodCode exampleAdjustGamma(Single)
Gamma-correction of an image.
(Overrides RasterImageAdjustGamma(Single).)
Public methodCode exampleAdjustGamma(Single, Single, Single)
Gamma-correction of an image.
(Overrides RasterImageAdjustGamma(Single, Single, Single).)
Public methodCode exampleBinarizeBradley(Double)
Binarization of an image using Bradley's adaptive thresholding algorithm using the integral image thresholding
(Overrides RasterImageBinarizeBradley(Double).)
Public methodCode exampleBinarizeBradley(Double, Int32)
Binarization of an image using Bradley's adaptive thresholding algorithm using the integral image thresholding
(Overrides RasterImageBinarizeBradley(Double, Int32).)
Public methodCode exampleBinarizeFixed
Binarization of an image with predefined threshold
(Overrides RasterImageBinarizeFixed(Byte).)
Public methodCode exampleBinarizeOtsu
Binarization of an image with Otsu thresholding
(Overrides RasterImageBinarizeOtsu.)
Public methodCode exampleCacheData
Caches the data and ensures no additional data loading will be performed from the underlying DataStreamContainer.
(Overrides DataStreamSupporterCacheData.)
Public methodCode exampleCanSave
Determines whether image can be saved to the specified file format represented by the passed save options.
(Inherited from Image.)
Public methodCode exampleCrop(Rectangle)
Cropping the image.
(Overrides RasterImageCrop(Rectangle).)
Public methodCode exampleCrop(Int32, Int32, Int32, Int32)
Crop image with shifts.
(Inherited from RasterImage.)
Public methodCode exampleDispose
Disposes the current instance.
(Inherited from DisposableObject.)
Public methodCode exampleDither(DitheringMethod, Int32)
Performs dithering on the current image.
(Inherited from RasterImage.)
Public methodDither(DitheringMethod, Int32, IColorPalette)
Performs dithering on the current image.
(Overrides RasterImageDither(DitheringMethod, Int32, IColorPalette).)
Protected methodDoAfterSave
Does the after save.
(Inherited from DataStreamSupporter.)
Protected methodDoUseRecursion
Gets value indicating whether use recursion for synchronization.
(Inherited from RasterImage.)
Public methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Public methodCode exampleFilter
Filters the specified rectangle.
(Inherited from RasterImage.)
Protected methodFinalize (Inherited from DisposableObject.)
Public methodCode exampleGetArgb32Pixel
Gets an image 32-bit ARGB pixel.
(Inherited from RasterImage.)
Protected methodGetCanNotSaveMessage
Gets the can not save message.
(Inherited from Image.)
Public methodGetDefaultArgb32Pixels
Gets the default 32-bit ARGB pixels array.
(Inherited from RasterImage.)
Public methodGetDefaultOptions
Gets the default options.
(Inherited from Image.)
Public methodGetDefaultPixels
Gets the default pixels array using partial pixel loader.
(Inherited from RasterImage.)
Public methodGetDefaultRawData(Rectangle, RawDataSettings)
Gets the default raw data array.
(Inherited from RasterImage.)
Public methodGetDefaultRawData(Rectangle, IPartialRawDataLoader, RawDataSettings)
Gets the default raw data array using partial pixel loader.
(Inherited from RasterImage.)
Protected methodGetFitRectangle(Rectangle)
Gets rectangle which fits the current image.
(Inherited from Image.)
Protected methodGetFitRectangle(Rectangle, Int32)
Gets rectangle which fits the current bitmap taking into account the pixels passed. The passed pixels array count should be equal to the fitting rectangle size.
(Inherited from Image.)
Public methodGetHashCode
Serves as a hash function for a particular type.
(Inherited from Object.)
Protected methodGetImage2Export
Gets the image to export.
(Inherited from Image.)
Public methodGetModifyDate
Gets the date and time the resource image was last modified.
(Inherited from RasterImage.)
Public methodGetOriginalOptions
Gets the options based on the original file settings. This can be helpful to keep bit-depth and other parameters of the original image unchanged. For example, if we load a black-white PNG image with 1 bit per pixel and then save it using the Save(String) method, the output PNG image with 8-bit per pixel will be produced. To avoid it and save PNG image with 1-bit per pixel, use this method to get corresponding saving options and pass them to the Save(String, ImageOptionsBase) method as the second parameter.
(Inherited from Image.)
Public methodCode exampleGetPixel
Gets an image pixel.
(Inherited from RasterImage.)
Public methodGetSkewAngle
Gets the skew angle. This method is applicable to scanned text documents, to determine the skew angle when scanning.
(Inherited from RasterImage.)
Public methodGetType
Gets the type of the current instance.
(Inherited from Object.)
Public methodCode exampleGrayscale
Transformation of an image to its grayscale representation
(Overrides RasterImageGrayscale.)
Public methodCode exampleLoadArgb32Pixels
Loads 32-bit ARGB pixels.
(Inherited from RasterImage.)
Public methodCode exampleLoadArgb64Pixels
Loads 64-bit ARGB pixels.
(Inherited from RasterImage.)
Public methodLoadCmyk32Pixels
Loads pixels in CMYK format.
(Inherited from RasterImage.)
Public methodLoadCmykPixels Obsolete.
Loads pixels in CMYK format. This method is deprecated. Please use more effective the LoadCmyk32Pixels(Rectangle) method.
(Inherited from RasterImage.)
Public methodCode exampleLoadPartialArgb32Pixels
Loads 32-bit ARGB pixels partially by packs.
(Inherited from RasterImage.)
Public methodCode exampleLoadPartialPixels
Loads pixels partially by packs.
(Inherited from RasterImage.)
Public methodCode exampleLoadPixels
Loads pixels.
(Inherited from RasterImage.)
Public methodCode exampleLoadRawData(Rectangle, RawDataSettings, IPartialRawDataLoader)
Loads raw data.
(Inherited from RasterImage.)
Public methodLoadRawData(Rectangle, Rectangle, RawDataSettings, IPartialRawDataLoader)
Loads raw data.
(Inherited from RasterImage.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodNormalizeAngle
Normalizes the angle. This method is applicable to scanned text documents to get rid of the skewed scan. This method uses GetSkewAngle and Rotate(Single) methods.
(Inherited from RasterImage.)
Public methodCode exampleNormalizeAngle(Boolean, Color)
Normalizes the angle. This method is applicable to scanned text documents to get rid of the skewed scan. This method uses GetSkewAngle and Rotate(Single, Boolean, Color) methods.
(Inherited from RasterImage.)
Protected methodOnCached
Called when data is cached and all related resources may be de-allocated.
Protected methodOnDataStreamContainerChanging
Called when data stream container is changing.
(Inherited from DataStreamSupporter.)
Protected methodOnPaletteChanged
Called when palette is changed.
(Overrides ImageOnPaletteChanged(IColorPalette, IColorPalette).)
Protected methodOnPaletteChanging
Called when palette is changing.
(Inherited from Image.)
Public methodReadArgb32ScanLine
Reads the whole scan line by the specified scan line index.
(Inherited from RasterImage.)
Public methodReadScanLine
Reads the whole scan line by the specified scan line index.
(Inherited from RasterImage.)
Protected methodReleaseManagedResources
Releases the managed resources. Make sure no unmanaged resources are released here, since they may have been already released.
(Inherited from RasterImage.)
Protected methodReleaseUnmanagedResources
Releases the unmanaged resources. Make sure no managed resources are released here, since they may have been already released.
(Inherited from DisposableObject.)
Public methodReplaceColor(Int32, Byte, Int32)
Replaces one color to another with allowed difference and preserves original alpha value to save smooth edges.
(Inherited from RasterImage.)
Public methodReplaceColor(Color, Byte, Color)
Replaces one color to another with allowed difference and preserves original alpha value to save smooth edges.
(Inherited from RasterImage.)
Public methodReplaceNonTransparentColors(Int32)
Replaces all non-transparent colors with new color and preserves original alpha value to save smooth edges. Note: if you use it on images without transparency, all colors will be replaced with a single one.
(Inherited from RasterImage.)
Public methodReplaceNonTransparentColors(Color)
Replaces all non-transparent colors with new color and preserves original alpha value to save smooth edges. Note: if you use it on images without transparency, all colors will be replaced with a single one.
(Inherited from RasterImage.)
Public methodCode exampleResize(Int32, Int32)
Resizes the image. The default LeftTopToLeftTop is used.
(Inherited from Image.)
Public methodCode exampleResize(Int32, Int32, ImageResizeSettings)
Resizes the image.
(Overrides RasterImageResize(Int32, Int32, ImageResizeSettings).)
Public methodCode exampleResize(Int32, Int32, ResizeType)
Resizes the image.
(Overrides RasterImageResize(Int32, Int32, ResizeType).)
Public methodResizeHeightProportionally(Int32)
Resizes the height proportionally.
(Inherited from Image.)
Public methodResizeHeightProportionally(Int32, ImageResizeSettings)
Resizes the height proportionally.
(Inherited from Image.)
Public methodCode exampleResizeHeightProportionally(Int32, ResizeType)
Resizes the height proportionally.
(Inherited from Image.)
Public methodResizeWidthProportionally(Int32)
Resizes the width proportionally.
(Inherited from Image.)
Public methodResizeWidthProportionally(Int32, ImageResizeSettings)
Resizes the width proportionally.
(Inherited from Image.)
Public methodCode exampleResizeWidthProportionally(Int32, ResizeType)
Resizes the width proportionally.
(Inherited from Image.)
Public methodRotate(Single)
Rotate image around the center.
(Inherited from RasterImage.)
Public methodRotate(Single, Boolean, Color)
Rotate image around the center.
(Overrides RasterImageRotate(Single, Boolean, Color).)
Public methodCode exampleRotateFlip
Rotates, flips, or rotates and flips the image.
(Overrides ImageRotateFlip(RotateFlipType).)
Public methodCode exampleSave
Saves the image data to the underlying stream.
(Inherited from Image.)
Public methodSave(Stream)
Saves the object's data to the specified stream.
(Inherited from DataStreamSupporter.)
Public methodSave(String)
Saves the object's data to the specified file location.
(Inherited from DataStreamSupporter.)
Public methodSave(String, Boolean)
Saves the object's data to the specified file location.
(Inherited from DataStreamSupporter.)
Public methodCode exampleSave(Stream, ImageOptionsBase)
Saves the image's data to the specified stream in the specified file format according to save options.
(Inherited from Image.)
Public methodCode exampleSave(String, ImageOptionsBase)
Saves the object's data to the specified file location in the specified file format according to save options.
(Inherited from Image.)
Public methodCode exampleSave(String, ImageOptionsBase, Rectangle)
Saves the object's data to the specified file location in the specified file format according to save options.
(Inherited from Image.)
Public methodSave(Stream, ImageOptionsBase, Rectangle)
Saves the image's data to the specified stream in the specified file format according to save options.
(Inherited from RasterImage.)
Public methodCode exampleSaveArgb32Pixels
Saves the 32-bit ARGB pixels.
(Inherited from RasterImage.)
Public methodCode exampleSaveCmyk32Pixels
Saves the pixels.
(Inherited from RasterImage.)
Public methodSaveCmykPixels Obsolete. (Inherited from RasterImage.)
Protected methodSaveData
Saves the data.
(Inherited from DataStreamSupporter.)
Public methodCode exampleSavePixels
Saves the pixels.
(Inherited from RasterImage.)
Protected methodSavePixelsInternal
Saves pixels (format specific method).
(Overrides RasterImageSavePixelsInternal(Rectangle, Int32).)
Public methodSaveRawData
Saves the raw data.
(Inherited from RasterImage.)
Public methodCode exampleSetArgb32Pixel
Sets an image 32-bit ARGB pixel for the specified position.
(Inherited from RasterImage.)
Public methodSetPalette
Sets the image palette.
(Inherited from RasterImage.)
Public methodCode exampleSetPixel
Sets an image pixel for the specified position.
(Inherited from RasterImage.)
Public methodCode exampleSetResolution
Sets the resolution for this RasterImage.
(Inherited from RasterImage.)
Public methodToBitmap
Converts raster image to the bitmap.
(Inherited from RasterImage.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Protected methodUpdateDimensions
Updates the image dimensions.
Protected methodUpdateMetadata
Updates the image metadata.
(Inherited from RasterImage.)
Protected methodVerifyNotDisposed
Verifies that the current instance is not disposed.
(Inherited from DisposableObject.)
Public methodWriteArgb32ScanLine
Writes the whole scan line to the specified scan line index.
(Inherited from RasterImage.)
Public methodWriteScanLine
Writes the whole scan line to the specified scan line index.
(Inherited from RasterImage.)
Fields
  NameDescription
Protected fieldTimeout
The timeout to wait for synchronization
(Inherited from DataStreamSupporter.)
Protected fieldxmpData
The XMP metadata
(Inherited from RasterImage.)
Examples
The following example transforms a colored raster cached image to its grayscale representation. Grayscale images are composed exclusively of shades of gray and carry only intensity information.
[C#]

string dir = "c:\\temp\\";

using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.png"))
{
    Aspose.Imaging.RasterCachedImage rasterImage = (Aspose.Imaging.RasterCachedImage)image;

    rasterImage.Grayscale();
    rasterImage.Save(dir + "sample.Grayscale.png");
}
See Also
Inheritance Hierarchy
SystemObject
  Aspose.ImagingDisposableObject
    Aspose.ImagingDataStreamSupporter
      Aspose.ImagingImage
        Aspose.ImagingRasterImage
          Aspose.ImagingRasterCachedImage
            Aspose.Imaging.FileFormats.BmpBmpImage
            Aspose.Imaging.FileFormats.DicomDicomPage
            Aspose.Imaging.FileFormats.DjvuDjvuPage
            Aspose.Imaging.FileFormats.DjvuDjvuRaster
            Aspose.Imaging.FileFormats.DngDngImage
            Aspose.Imaging.FileFormats.EpsEpsImage
            Aspose.Imaging.FileFormats.Gif.BlocksGifFrameBlock
            Aspose.Imaging.FileFormats.JpegJpegImage
            Aspose.Imaging.FileFormats.Jpeg2000Jpeg2000Image
            Aspose.Imaging.FileFormats.PngPngImage
            Aspose.Imaging.FileFormats.TiffTiffFrame
            Aspose.Imaging.FileFormats.WebpWebPFrameBlock
            Aspose.ImagingRasterCachedMultipageImage