- Qt 6.8
- Qt GUI
- C++ Classes
- QConicalGradient
- Qt 6.8.2 Reference Documentation

# QConicalGradient Class

The QConicalGradient class is used in combination with QBrush to specify a conical gradient brush. More...

Header: | `#include <QConicalGradient>`
CMake: | `find_package(Qt6 REQUIRED COMPONENTS Gui)` `target_link_libraries(mytarget PRIVATE Qt6::Gui)`
qmake: | `QT += gui`
Inherits: | QGradient

- List of all members, including inherited members
- QConicalGradient is part of Painting Classes.

## Public Functions

| QConicalGradient()
| QConicalGradient(const QPointF &center, qreal angle)
| QConicalGradient(qreal cx, qreal cy, qreal angle)
qreal | angle() const
QPointF | center() const
void | setAngle(qreal angle)
void | setCenter(const QPointF &center)
void | setCenter(qreal x, qreal y)

## Detailed Description

Conical gradients interpolate interpolate colors counter-clockwise around a center point.

The colors in a gradient is defined using stop points of the QGradientStop type, i.e. a position and a color. Use the QGradient::setColorAt() or the QGradient::setStops() function to define the stop points. It is the gradient's complete set of stop points that describes how the gradient area should be filled. If no stop points have been specified, a gradient of black at 0 to white at 1 is used.

In addition to the functions inherited from QGradient, the QConicalGradient class provides the angle() and center() functions returning the start angle and center of the gradient.

Note that the setSpread() function has no effect for conical gradients. The reason is that the conical gradient is closed by definition, i.e. the conical gradient fills the entire circle from 0 - 360 degrees, while the boundary of a radial or a linear gradient can be specified through its radius or final stop points, respectively.

See also QLinearGradient, QRadialGradient, and The Gradients Example.

## Member Function Documentation

### QConicalGradient::QConicalGradient()

Constructs a conical with center at (0, 0) starting the interpolation at angle 0.

See also QGradient::setColorAt(), setCenter(), and setAngle().

### QConicalGradient::QConicalGradient(const QPointF &center, qreal angle)

Constructs a conical gradient with the given center, starting the interpolation at the given angle. The angle must be specified in degrees between 0 and 360.

See also QGradient::setColorAt() and QGradient::setStops().

### QConicalGradient::QConicalGradient(qreal cx, qreal cy, qreal angle)

Constructs a conical gradient with the given center (cx, cy), starting the interpolation at the given angle. The angle must be specified in degrees between 0 and 360.

See also QGradient::setColorAt() and QGradient::setStops().

### qreal QConicalGradient::angle() const

Returns the start angle of the conical gradient in logical coordinates.

See also setAngle() and stops().

### QPointF QConicalGradient::center() const

Returns the center of the conical gradient in logical coordinates.

See also setCenter() and stops().

### void QConicalGradient::setAngle(qreal angle)

Sets angle to be the start angle for this conical gradient in logical coordinates.

See also angle().

### void QConicalGradient::setCenter(const QPointF &center)

Sets the center of this conical gradient in logical coordinates to center.

See also center().

### void QConicalGradient::setCenter(qreal x, qreal y)

This is an overloaded function.

Sets the center of this conical gradient in logical coordinates to (x, y).

See also center().