History

huxingyi 8e5d622db7 Restructure the code base Move the core function code to a dedicate folder under namespace dust3d. Leave the application and UI code to application folder. Remove CGAL, use our own mesh boolean algorithm and triangulating code, should have less chance to crash on bad meshes. The overall performance of mesh combining is improved since some mesh validating code for CGAL is removed.		2021-11-18 22:58:01 +08:00
..
.gitignore	Restructure the code base	2021-11-18 22:58:01 +08:00
LICENSE	Restructure the code base	2021-11-18 22:58:01 +08:00
README.md	Restructure the code base	2021-11-18 22:58:01 +08:00
qtwaitingspinner.pri	Restructure the code base	2021-11-18 22:58:01 +08:00
qtwaitingspinner.pro	Restructure the code base	2021-11-18 22:58:01 +08:00
waitingspinnerwidget.cpp	Restructure the code base	2021-11-18 22:58:01 +08:00
waitingspinnerwidget.h	Restructure the code base	2021-11-18 22:58:01 +08:00

README.md

QtWaitingSpinner

QtWaitingSpinner is a highly configurable, custom Qt widget for showing "waiting" or "loading" spinner icons in Qt applications, e.g. the spinners below are all QtWaitingSpinner widgets differing only in their configuration:

###Configuration

The following properties can all be controlled directly through their corresponding setters:

Colour of the widget
"Roundness" of the lines
Speed (rotations per second)
Number of lines to be drawn
Line length
Line width
Radius of the spinner's "dead space" or inner circle
The percentage fade of the "trail"
The minimum opacity of the "trail"

###Usage

Despite being highly configurable, QtWaitingSpinner is extremely easy to use and, to make things even easier, the "QtWaitingSpinnerTest" application can assist you in determining the exact shape, size and colour you'd like your spinner to have.

For example, the embedded spinner in the QtWaitingSpinnerTest screenshot below can be created as follows:

  QtWaitingSpinner* spinner = new QtWaitingSpinner(this);

  spinner->setRoundness(70.0);
  spinner->setMinimumTrailOpacity(15.0);
  spinner->setTrailFadePercentage(70.0);
  spinner->setNumberOfLines(12);
  spinner->setLineLength(10);
  spinner->setLineWidth(5);
  spinner->setInnerRadius(10);
  spinner->setRevolutionsPerSecond(1);
  spinner->setColor(QColor(81, 4, 71));

  spinner->start(); // gets the show on the road!

As an alternative example, the code below will create a spinner that (1) blocks all user input to the main application for as long as the spinner is active, (2) automatically centres itself on its parent widget every time "start" is called and (3) makes use of the default shape, size and colour settings.

	QtWaitingSpinner* spinner = new QtWaitingSpinner(this, Qt::ApplicationModal, true);
	spinner->start(); // starts spinning

Please use use this link for feedback, requests or issues.

Enjoy!

###qt-pods

QtWaitingSpinner is available as a pod within qt-pods. See here for reference: https://github.com/cybercatalyst/qt-pods

###Thanks

QtWaitingSpinner was inspired by the spin.js project.

Forks

There is also QtWaitingSpinner for Python! Thanks to z3ntu for porting it.