1. trait
  2. Cloudinary
  3. \
  4. Transformation
  5. \
  6. CommonTransformationTrait

CommonTransformationTrait

trait CommonTransformationTrait

Trait TransformationTrait

Methods

resize(BaseResizeAction $resize)

Resize the asset using provided resize action

scale(int|float|string|null $width = null, int|float|null $height = null, int|float|array $aspectRatio = null)

Change the size of the image exactly to the given width and height without necessarily retaining the original aspect ratio: all original image parts are visible but might be stretched or shrunk.

crop(int|float|string|null $width = null, int|float|null $height = null, Gravity $gravity = null, int|float|X $x = null, int|float|Y $y = null)

Extracts a region of the given width and height out of the original image.

fill(int|float|string|null $width = null, int|float|null $height = null, Gravity $gravity = null)

Creates an image with the exact given width and height without distorting the image.

genericResize(string $name, int|float|string|null $width = null, int|float|null $height = null)

Custom resize builder.

delivery(mixed $delivery)

Applies delivery action.

format(Format|string $format)

Forces format conversion to the given format.

quality(int|string|Quality $quality)

Controls compression quality. 1 is the lowest quality and 100 is the highest.

dpr(float|string $dpr)

Deliver the image in the specified device pixel ratio.

attachment(string $filename = null)

Delivers the image as an attachment.

forceIcc()

Adds ICC color space metadata to the image, even when the original image doesn't contain any ICC data.

forceStrip()

Instructs Cloudinary to clear all image meta-data (IPTC, Exif and XMP) while applying an incoming transformation.

getInfo()

Returns metadata of the input asset and of the transformed output asset in JSON instead of the transformed image.

immutableCache()

Sets the cache-control to immutable for the asset.

keepAttribution()

Keeps the copyright related fields when stripping meta-data.

keepIptc()

Keeps all meta-data.

stripProfile()

Instructs Cloudinary to clear all ICC color profile data included with the image.

customFunction(CustomFunction $customFunction)

Inject a custom function into the image transformation pipeline.

effect(EffectQualifier|EffectAction $effect)

Applies a filter or an effect on an asset.

adjust(EffectQualifier|EffectAction|AdjustmentInterface $adjustment)

Applies adjustment effect on an asset.

namedTransformation(string|NamedTransformation $transformationName)

Applies a pre-defined named transformation of the given name.

addGenericQualifier(string $shortName, array|mixed ...$value)

Adds a generic qualifier as a separate action.

addActionFromQualifiers(array $qualifiers)

Adds action defined as an array of qualifiers.

addFlag(FlagQualifier|string $flag)

Adds a flag as a separate action.

addVariable(string|Variable $name, mixed $value = null)

Defines an new user variable.

rotate(string|int $angle)

Rotates the asset by the given angle.

conditional(Conditional $conditionalTransformation)

Specifies a conditional transformation whose condition should be met before applying a transformation.

Details

TransformationResizeTrait resize(BaseResizeAction $resize)

Resize the asset using provided resize action

Parameters

Name Type Description
$resize BaseResizeAction The resize action

Return Value

TransformationResizeTrait

TransformationResizeTrait scale(int|float|string|null $width = null, int|float|null $height = null, int|float|array $aspectRatio = null)

Change the size of the image exactly to the given width and height without necessarily retaining the original aspect ratio: all original image parts are visible but might be stretched or shrunk.

Parameters

Name Type Description
$width int|float|string|null The required width of a transformed asset.
$height int|float|null The required height of a transformed asset.
$aspectRatio int|float|array Resizes the asset to a new aspect ratio.

Return Value

TransformationResizeTrait

TransformationResizeTrait crop(int|float|string|null $width = null, int|float|null $height = null, Gravity $gravity = null, int|float|X $x = null, int|float|Y $y = null)

Extracts a region of the given width and height out of the original image.

Parameters

Name Type Description
$width int|float|string|null The required width of a transformed asset.
$height int|float|null The required height of a transformed asset.
$gravity Gravity Which part of the original image to include.
$x int|float|X Horizontal position for custom-coordinates based cropping
$y int|float|Y Vertical position for custom-coordinates based cropping

Return Value

TransformationResizeTrait

TransformationResizeTrait fill(int|float|string|null $width = null, int|float|null $height = null, Gravity $gravity = null)

Creates an image with the exact given width and height without distorting the image.

This option first scales up or down as much as needed to at least fill both of the given dimensions. If the requested aspect ratio is different than the original, cropping will occur on the dimension that exceeds the requested size after scaling.

Parameters

Name Type Description
$width int|float|string|null The required width of a transformed asset.
$height int|float|null The required height of a transformed asset.
$gravity Gravity Which part of the original image to include when the resulting image is smaller than the original or the proportions do not match.

Return Value

TransformationResizeTrait

TransformationResizeTrait genericResize(string $name, int|float|string|null $width = null, int|float|null $height = null)

Custom resize builder.

Parameters

Name Type Description
$name string Provide future (not supported in the current version) resize name
$width int|float|string|null The required width of a transformed asset.
$height int|float|null The required height of a transformed asset.

Return Value

TransformationResizeTrait

TransformationDeliveryTrait delivery(mixed $delivery)

Applies delivery action.

Parameters

Name Type Description
$delivery mixed The delivery action to apply.

Return Value

TransformationDeliveryTrait

TransformationDeliveryTrait format(Format|string $format)

Forces format conversion to the given format.

(Formerly known as fetch format)

Parameters

Name Type Description
$format Format|string

Return Value

TransformationDeliveryTrait

TransformationDeliveryTrait quality(int|string|Quality $quality)

Controls compression quality. 1 is the lowest quality and 100 is the highest.

Reducing the quality is a trade-off between visual quality and file size.

Parameters

Name Type Description
$quality int|string|Quality

Return Value

TransformationDeliveryTrait

TransformationDeliveryTrait dpr(float|string $dpr)

Deliver the image in the specified device pixel ratio.

Parameters

Name Type Description
$dpr float|string Any positive float value.

Return Value

TransformationDeliveryTrait

CommonTransformationFlagTrait attachment(string $filename = null)

Delivers the image as an attachment.

Parameters

Name Type Description
$filename string The attachment's filename

Return Value

CommonTransformationFlagTrait

See also

Flag::attachment

CommonTransformationFlagTrait forceIcc()

Adds ICC color space metadata to the image, even when the original image doesn't contain any ICC data.

Return Value

CommonTransformationFlagTrait

See also

Flag::forceIcc

CommonTransformationFlagTrait forceStrip()

Instructs Cloudinary to clear all image meta-data (IPTC, Exif and XMP) while applying an incoming transformation.

Return Value

CommonTransformationFlagTrait

See also

Flag::forceStrip

CommonTransformationFlagTrait getInfo()

Returns metadata of the input asset and of the transformed output asset in JSON instead of the transformed image.

Return Value

CommonTransformationFlagTrait

See also

Flag::getInfo

CommonTransformationFlagTrait immutableCache()

Sets the cache-control to immutable for the asset.

Return Value

CommonTransformationFlagTrait

See also

Flag::immutableCache

CommonTransformationFlagTrait keepAttribution()

Keeps the copyright related fields when stripping meta-data.

Return Value

CommonTransformationFlagTrait

See also

Flag::keepAttribution

CommonTransformationFlagTrait keepIptc()

Keeps all meta-data.

Return Value

CommonTransformationFlagTrait

See also

Flag::keepIptc

CommonTransformationFlagTrait stripProfile()

Instructs Cloudinary to clear all ICC color profile data included with the image.

Return Value

CommonTransformationFlagTrait

See also

Flag::stripProfile

TransformationCustomFunctionTrait customFunction(CustomFunction $customFunction)

Inject a custom function into the image transformation pipeline.

Parameters

Name Type Description
$customFunction CustomFunction The custom function source

Return Value

TransformationCustomFunctionTrait

CommonTransformationTrait effect(EffectQualifier|EffectAction $effect)

Applies a filter or an effect on an asset.

Parameters

Name Type Description
$effect EffectQualifier|EffectAction

Return Value

CommonTransformationTrait

CommonTransformationTrait adjust(EffectQualifier|EffectAction|AdjustmentInterface $adjustment)

Applies adjustment effect on an asset.

Parameters

Name Type Description
$adjustment EffectQualifier|EffectAction|AdjustmentInterface

Return Value

CommonTransformationTrait

CommonTransformationTrait namedTransformation(string|NamedTransformation $transformationName)

Applies a pre-defined named transformation of the given name.

Parameters

Name Type Description
$transformationName string|NamedTransformation

Return Value

CommonTransformationTrait

CommonTransformationTrait addGenericQualifier(string $shortName, array|mixed ...$value)

Adds a generic qualifier as a separate action.

Parameters

Name Type Description
$shortName string The generic qualifier name.
...$value array|mixed The generic qualifier value.

Return Value

CommonTransformationTrait

CommonTransformationTrait addActionFromQualifiers(array $qualifiers)

Adds action defined as an array of qualifiers.

Parameters

Name Type Description
$qualifiers array An associative array of qualifiers

Return Value

CommonTransformationTrait

See also

QualifiersAction

CommonTransformationTrait addFlag(FlagQualifier|string $flag)

Adds a flag as a separate action.

Parameters

Name Type Description
$flag FlagQualifier|string The flag to add.

Return Value

CommonTransformationTrait

CommonTransformationTrait addVariable(string|Variable $name, mixed $value = null)

Defines an new user variable.

Parameters

Name Type Description
$name string|Variable The variable name or the Variable instance.
$value mixed The variable value.

Return Value

CommonTransformationTrait

CommonTransformationTrait rotate(string|int $angle)

Rotates the asset by the given angle.

Parameters

Name Type Description
$angle string|int The rotation angle.

Return Value

CommonTransformationTrait

CommonTransformationTrait conditional(Conditional $conditionalTransformation)

Specifies a conditional transformation whose condition should be met before applying a transformation.

Parameters

Name Type Description
$conditionalTransformation Conditional The conditional transformation.

Return Value

CommonTransformationTrait

See also

https://cloudinary.com/documentation/conditional_transformations