SvgImage
- Type
- Class
- Namespace
- Craft
- Inherits
- Craft\SvgImage » Craft\BaseImage
- Since
- 2.5
Class SvgImage
See also http://craftcms.com
View source (opens new window)
# Public Methods
Method | Description |
---|---|
crop() | Crops the image to the specified coordinates. |
getExtension() | |
getHeight() | |
getSvgString() | Get the SVG string. |
getWidth() | |
isTransparent() | Returns true if the image is transparent. |
loadImage() | Loads an image from a file system path. |
resize() | Re-sizes the image. If $height is not specified, it will default to $width, creating a square. |
saveAs() | Saves the image to the target path. |
scaleAndCrop() | Scale and crop image to exactly fit the specified size. |
scaleToFit() | Scale the image to fit within the specified size. |
# crop()
Crops the image to the specified coordinates.
View source (opens new window)
Arguments
$x1
(integer (opens new window))$x2
(integer (opens new window))$y1
(integer (opens new window))$y2
(integer (opens new window))
Returns
Signature
public Craft\Image crop ( $x1, $x2, $y1, $y2 )
# getExtension()
Signature
public string getExtension ( )
# getHeight()
Signature
public integer getHeight ( )
# getSvgString()
Signature
public string getSvgString ( )
# getWidth()
Signature
public integer getWidth ( )
# isTransparent()
Signature
public boolean isTransparent ( )
# loadImage()
Loads an image from a file system path.
View source (opens new window)
Arguments
$path
(string (opens new window))
Returns
Throws
Signature
public Craft\Image loadImage ( $path )
# resize()
Re-sizes the image. If $height is not specified, it will default to $width, creating a square.
View source (opens new window)
Arguments
$targetWidth
(integer (opens new window))$targetHeight
(integer (opens new window), null (opens new window))
Returns
Signature
public Craft\Image resize ( $targetWidth, $targetHeight = null )
# saveAs()
Saves the image to the target path.
View source (opens new window)
Arguments
$targetPath
(string (opens new window))$autoQuality
(boolean (opens new window))
Returns
Throws
Signature
public null saveAs ( $targetPath, $autoQuality = false )
# scaleAndCrop()
Scale and crop image to exactly fit the specified size.
View source (opens new window)
Arguments
$targetWidth
(integer (opens new window))$targetHeight
(integer (opens new window), null (opens new window))$scaleIfSmaller
(boolean (opens new window))$cropPositions
(string (opens new window))
Returns
Signature
public Craft\Image scaleAndCrop ( $targetWidth, $targetHeight = null, $scaleIfSmaller = true, $cropPositions = 'center-center' )
# scaleToFit()
Scale the image to fit within the specified size.
View source (opens new window)
Arguments
$targetWidth
(integer (opens new window))$targetHeight
(integer (opens new window), null (opens new window))$scaleIfSmaller
(boolean (opens new window))
Returns
Signature
public Craft\Image scaleToFit ( $targetWidth, $targetHeight = null, $scaleIfSmaller = true )
# Protected Methods
Method | Description |
---|---|
normalizeDimensions() | Normalizes the given dimensions. If width or height is set to 'AUTO', we calculate the missing dimension. |
# Constants
Constant | Description |
---|---|
SVG_ASPECT_RE | |
SVG_CLEANUP_HEIGHT_RE | |
SVG_CLEANUP_WIDTH_RE | |
SVG_HEIGHT_RE | |
SVG_TAG_RE | |
SVG_VIEWBOX_RE | |
SVG_WIDTH_RE |