Files
qelectrotech-source-mirror/sources/imagedrop.h
T
Beat Hangartner c76bc5eb4e Fit dropped pictures into the folio frame, with a margin
A dropped picture too large for the folio is now scaled to leave 20 %
of the drawing area free on every side, instead of being fitted to
the visible part of the view, and every dropped picture is kept inside
the frame -- a scaled-down one also off that margin.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-09 10:00:31 +02:00

84 lines
2.8 KiB
C++

/*
Copyright 2006-2026 The QElectroTech Team
This file is part of QElectroTech.
QElectroTech is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.
QElectroTech is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with QElectroTech. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef IMAGEDROP_H
#define IMAGEDROP_H
#include <QImage>
#include <QPointF>
#include <QRectF>
#include <QSizeF>
#include <QStringList>
class QMimeData;
/**
Picture files dropped on a folio: which files qualify, how they are
loaded, and where they are placed. Kept free of any QElectroTech class
so that it can be tested on its own.
*/
namespace ImageDrop
{
/// Pictures are embedded in the project, so larger files are refused.
constexpr qint64 maxFileBytes = 10LL * 1024 * 1024;
/// Refuses decompression bombs before any pixel is allocated.
constexpr qint64 maxPixels = 64LL * 1024 * 1024;
/// Offset between the pictures of one drop, in scene units.
constexpr qreal cascadeStep = 20.0;
/// Free margin left between a scaled-down picture and the folio frame,
/// as a share of the frame on each side.
constexpr qreal frameMargin = 0.2;
/// The suffixes the "add image" file dialog offers, lower case.
QStringList supportedSuffixes();
/// The local picture files among the URLs of @a mime, in drop order.
QStringList imageFiles(const QMimeData *mime);
/// True when @a mime carries URLs and none of them is a picture file:
/// the drop is meant for someone else (a .qet project, an element).
bool hasOnlyOtherUrls(const QMimeData *mime);
/**
Load the picture at @a path, checking that it is a regular file of
at most maxFileBytes and maxPixels. On failure the image is null
and @a error, if given, says why.
*/
QImage load(const QString &path, QString *error = nullptr);
/// @a frame shrunk by frameMargin on every side.
QRectF innerFrame(const QRectF &frame);
/**
Scale that fits a picture of @a size into innerFrame(@a frame),
keeping its proportions; 1.0 when it already fits. Pictures are
never enlarged.
*/
qreal fitScale(const QSizeF &size, const QRectF &frame);
/**
@a picture moved by the least amount that puts it inside @a area;
centred on @a area along an axis where it is larger.
*/
QRectF keepInside(const QRectF &picture, const QRectF &area);
/// Offset of the @a index-th picture of one drop from the first one.
QPointF cascadeOffset(int index);
}
#endif // IMAGEDROP_H