Loading...
Searching...
No Matches
ScaledImage Class Reference

An image that will be resampled before it is drawn. More...

#include <juce_ScaledImage.h>

Public Member Functions

 ScaledImage ()=default
 Creates a ScaledImage with an invalid image and unity scale.
 
 ScaledImage (const Image &imageIn)
 Creates a ScaledImage from an Image, where the dimensions of the image in pixels are exactly equal to its dimensions in points.
 
 ScaledImage (const Image &imageIn, double scaleIn)
 Creates a ScaledImage from an Image, using a custom scale factor.
 
Image getImage () const
 Returns the image at its original dimensions.
 
double getScale () const
 Returns the image's scale.
 
Rectangle< double > getScaledBounds () const
 Returns the bounds of this image expressed in points.
 

Detailed Description

An image that will be resampled before it is drawn.

A plain Image only stores plain pixels, but does not store any information about how these pixels correspond to points. This means that if the image's dimensions are interpreted as points, then the image will be blurry when drawn on high resolution displays. If the image's dimensions are instead interpreted as corresponding to exact pixel positions, then the logical size of the image will change depending on the scale factor of the screen used to draw it.

The ScaledImage class is designed to store an image alongside a scale factor that informs a renderer how to convert between the image's pixels and points.

Constructor & Destructor Documentation

◆ ScaledImage() [1/3]

ScaledImage::ScaledImage ( )
default

Creates a ScaledImage with an invalid image and unity scale.

◆ ScaledImage() [2/3]

ScaledImage::ScaledImage ( const Image & imageIn)
explicit

Creates a ScaledImage from an Image, where the dimensions of the image in pixels are exactly equal to its dimensions in points.

◆ ScaledImage() [3/3]

ScaledImage::ScaledImage ( const Image & imageIn,
double scaleIn )

Creates a ScaledImage from an Image, using a custom scale factor.

A scale of 1.0 means that the image's dimensions in pixels is equal to its dimensions in points.

A scale of 2.0 means that the image contains 2 pixels per point in each direction.

Member Function Documentation

◆ getImage()

Image ScaledImage::getImage ( ) const

Returns the image at its original dimensions.

References image.

◆ getScale()

double ScaledImage::getScale ( ) const

Returns the image's scale.

◆ getScaledBounds()

Rectangle< double > ScaledImage::getScaledBounds ( ) const

Returns the bounds of this image expressed in points.

References image.


The documentation for this class was generated from the following file:
linkedin facebook pinterest youtube rss twitter instagram facebook-blank rss-blank linkedin-blank pinterest youtube twitter instagram