1. Home
  2. Actions & Qualifiers
  3. Qualifiers.Gravity

Gravity

Description

A qualifier that determines which part of an asset to focus on, and thus which part of the asset to keep,
when any part of the asset is cropped. For overlays, this setting determines where to place the overlay.

Examples

			import {Cloudinary} from "@cloudinary/base";
			import {compass} from "@cloudinary/base/qualifiers/gravity";
			import {north} from "@cloudinary/base/qualifiers/compass";
			import {crop} from "@cloudinary/base/actions/resize";
			
			const yourCldInstance = new Cloudinary({cloud: {cloudName: 'demo'}});
			const image = yourCldInstance.image('woman');
			image.resize(crop().width(300).gravity(compass(north())))
			
			// Expand every function separately to see its own example
Copy
Details

qualifiers/gravity.ts, line 92

Classes

new OCR()

new AutoGravity()

new CompassGravity()

new FocusOnGravity()

new XYCenterGravity()

Methods

<static> compass( direction ) → {CompassGravity}

Description

Defines the gravity based on directional values from a compass. Learn more: Control gravity for images Learn more: Control gravity for videos

Parameters
Name Type Description
direction Qualifiers.Compass

A compass Values
Returns
Examples

			import {Cloudinary} from "@cloudinary/base";
			import {compass} from "@cloudinary/base/qualifiers/gravity";
			import {north} from "@cloudinary/base/qualifiers/compass";
			import {crop} from "@cloudinary/base/actions/resize";
			
			const yourCldInstance = new Cloudinary({cloud: {cloudName: 'demo'}});
			const image = yourCldInstance.image('woman');
			image.resize(crop().width(300).gravity(compass(north())))
Copy
Details

qualifiers/gravity.ts, line 24

<static> focusOn( ...args ) → {FocusOnGravity}

qualifier

Description

Specifies what to focus on, for example: faces, objects, eyes, etc.

Parameters
Name Type Attributes Description
args Qualifier.FocusOn <repeatable>

One or more objects to focus on
Returns
Examples

			import {Cloudinary} from "@cloudinary/base";
			import {focusOn} from "@cloudinary/base/qualifiers/gravity";
			import {crop} from "@cloudinary/base/actions/resize";
			import {cat} from "@cloudinary/base/qualifiers/focusOn";
			
			const yourCldInstance = new Cloudinary({cloud: {cloudName: 'demo'}});
			const image = yourCldInstance.image('woman');
			image.resize(crop().width(300).gravity(focusOn(cat())))
Copy
Details

qualifiers/gravity.ts, line 43

<static> autoGravity() → {Qualifiers.Gravity.AutoGravity}

qualifier

Description

Automatically identifies the most interesting regions in the asset, can be qualified further by including what to focus on.

Returns
Examples

			import {Cloudinary} from "@cloudinary/base";
			import {autoGravity} from "@cloudinary/base/qualifiers/gravity";
			import {crop} from "@cloudinary/base/actions/resize";
			
			const yourCldInstance = new Cloudinary({cloud: {cloudName: 'demo'}});
			const image = yourCldInstance.image('woman');
			image.resize(crop().width(300).gravity(autoGravity()))
Copy

			import {Cloudinary} from "@cloudinary/base";
			import {autoGravity} from "@cloudinary/base/qualifiers/gravity";
			import {crop} from "@cloudinary/base/actions/resize";
			import {cat} from "@cloudinary/base/qualifiers/focusOn";
			import {AutoFocus} from "@cloudinary/base/qualifiers/autoFocus";
			
			const yourCldInstance = new Cloudinary({cloud: {cloudName: 'demo'}});
			const image = yourCldInstance.image('woman');
			image.resize(crop().width(300).gravity(autoGravity().autoFocus(AutoFocus.focusOn(cat()))))
Copy
Details

qualifiers/gravity.ts, line 71

<static> ocr() → {OCR}

qualifier

Description

Detect all text elements in an image using the OCR Text Detection and Extraction add-on and use the detected bounding box coordinates as the basis of the transformation.

Returns
Details

qualifiers/gravity.ts, line 80

<static> xyCenter() → {XYCenterGravity}

qualifier

Description

Set the center of gravity to the given x & y coordinates.

Returns
Details

qualifiers/gravity.ts, line 89