Inheritance diagram for Digikam::IccManager:

Public Member Functions
IccTransform	displaySoftProofingTransform (const IccProfile &deviceProfile, const IccProfile &displayProfile)

IccTransform	displaySoftProofingTransform (const IccProfile &deviceProfile, QWidget *const displayingWidget=nullptr)

IccTransform	displayTransform (const IccProfile &displayProfile)

IccTransform	displayTransform (QWidget *const displayingWidget=nullptr)

bool	hasValidWorkspace () const

	IccManager (const DImg &image, const ICCSettingsContainer &settings=IccSettings::instance() ->settings())

DImg	image () const

IccProfile	imageProfile (ICCSettingsContainer::Behavior behavior, const IccProfile &specifiedProfile=IccProfile())

bool	isMissingProfile () const

bool	isProfileMismatch () const

bool	isUncalibratedColor () const

DImgLoaderObserver *	observer () const

void	setObserver (DImgLoaderObserver *const observer)

ICCSettingsContainer	settings () const

void	transform (ICCSettingsContainer::Behavior behavior, const IccProfile &specifiedProfile=IccProfile())

void	transformDefault ()

void	transformForDisplay ()

void	transformForDisplay (const IccProfile &displayProfile)

void	transformForDisplay (QWidget *const widget)

void	transformForOutput (const IccProfile &outputProfile)

void	transformToSRGB ()

	~IccManager ()

Static Public Member Functions
static IccProfile	displayProfile (QWidget *const displayingWidget=nullptr)

static bool	isSRGB (const DImg &img)

static bool	needsPostLoadingManagement (const DImg &img)

static void	transformForDisplay (QImage &qimage, const IccProfile &displayProfile1=displayProfile())

static void	transformToSRGB (QImage &qimage, const IccProfile &inputProfile)

Protected Member Functions
void	getTransform (IccTransform &trans, ICCSettingsContainer::Behavior behavior, const IccProfile &specifiedProfile)

ICCSettingsContainer::Behavior	safestBestBehavior () const

void	setIccProfile (const IccProfile &profile)

Constructor & Destructor Documentation

◆ IccManager()

Digikam::IccManager::IccManager	(	const DImg &	image,
		const ICCSettingsContainer &	settings = `IccSettings::instance()->settings()`
	)

explicit

Constructs an IccManager object. The DImg will be edited. The filePath is for display only.

References image(), and settings().

◆ ~IccManager()

Digikam::IccManager::~IccManager ( )

Member Function Documentation

◆ displayProfile()

IccProfile Digikam::IccManager::displayProfile ( QWidget *const displayingWidget = nullptr )

static

References Digikam::IccSettings::instance(), Digikam::IccSettings::monitorProfile(), Digikam::IccProfile::open(), and Digikam::IccProfile::sRGB().

Referenced by Digikam::CameraThumbsCtrl::CameraThumbsCtrl(), Digikam::PreviewLoadThread::createLoadingDescription(), displaySoftProofingTransform(), displayTransform(), Digikam::ThumbnailLoadThread::setDisplayingWidget(), and transformForDisplay().

◆ displaySoftProofingTransform() [1/2]

IccTransform Digikam::IccManager::displaySoftProofingTransform	(	const IccProfile &	deviceProfile,
		const IccProfile &	displayProfile
	)

References displayProfile(), displayTransform(), and transform().

◆ displaySoftProofingTransform() [2/2]

IccTransform Digikam::IccManager::displaySoftProofingTransform	(	const IccProfile &	deviceProfile,
		QWidget *const	displayingWidget = `nullptr`
	)

Returns a display transform, with soft-proofing enabled for the given device profile.

References displayProfile().

Referenced by Digikam::EditorCore::convertToPixmap(), Digikam::ImageIface::paint(), Digikam::ImagePreviewItem::paint(), and Digikam::ImageRegionItem::paint().

◆ displayTransform() [1/2]

IccTransform Digikam::IccManager::displayTransform ( const IccProfile & displayProfile )

References Digikam::ICCSettingsContainer::AskUser, displayProfile(), imageProfile(), isMissingProfile(), Digikam::IccProfile::isSameProfileAs(), isUncalibratedColor(), Digikam::ICCSettingsContainer::SafestBestAction, safestBestBehavior(), Digikam::IccTransform::setInputProfile(), Digikam::IccTransform::setIntent(), Digikam::IccTransform::setOutputProfile(), and Digikam::IccTransform::setUseBlackPointCompensation().

◆ displayTransform() [2/2]

IccTransform Digikam::IccManager::displayTransform ( QWidget *const displayingWidget = nullptr )

References displayProfile().

Referenced by Digikam::EditorCore::convertToPixmap(), displaySoftProofingTransform(), Digikam::ImageIface::paint(), Digikam::ImagePreviewItem::paint(), Digikam::ImageRegionItem::paint(), and transformForDisplay().

◆ getTransform()

void Digikam::IccManager::getTransform	(	IccTransform &	trans,
		ICCSettingsContainer::Behavior	behavior,
		const IccProfile &	specifiedProfile
	)

protected

References Digikam::ICCSettingsContainer::ConvertToWorkspace, imageProfile(), Digikam::IccProfile::isNull(), Digikam::ICCSettingsContainer::LeaveFileUntagged, setIccProfile(), Digikam::IccTransform::setInputProfile(), Digikam::IccTransform::setIntent(), Digikam::IccTransform::setOutputProfile(), and Digikam::IccTransform::setUseBlackPointCompensation().

Referenced by Digikam::IccPostLoadingManager::postLoadingManage(), and transform().

◆ hasValidWorkspace()

bool Digikam::IccManager::hasValidWorkspace ( ) const

Referenced by Digikam::EditorWindow::colorManage().

◆ image()

DImg Digikam::IccManager::image ( ) const

Referenced by IccManager(), isSRGB(), and Digikam::IccPostLoadingManager::postLoadingManage().

◆ imageProfile()

IccProfile Digikam::IccManager::imageProfile	(	ICCSettingsContainer::Behavior	behavior,
		const IccProfile &	specifiedProfile = `IccProfile()`
	)

Returns the profile that will be used to interpret the image, using the given behavior

References Digikam::ICCSettingsContainer::AutomaticColors, Digikam::ICCSettingsContainer::DoNotInterpret, Digikam::IccProfile::sRGB(), Digikam::ICCSettingsContainer::UseDefaultInputProfile, Digikam::ICCSettingsContainer::UseEmbeddedProfile, Digikam::ICCSettingsContainer::UseSpecifiedProfile, Digikam::ICCSettingsContainer::UseSRGB, and Digikam::ICCSettingsContainer::UseWorkspace.

Referenced by displayTransform(), and getTransform().

◆ isMissingProfile()

bool Digikam::IccManager::isMissingProfile ( ) const

Referenced by displayTransform(), safestBestBehavior(), transform(), transformDefault(), transformForOutput(), and transformToSRGB().

◆ isProfileMismatch()

bool Digikam::IccManager::isProfileMismatch ( ) const

Referenced by safestBestBehavior(), transform(), and transformDefault().

◆ isSRGB()

bool Digikam::IccManager::isSRGB ( const DImg & img )

static

Returns true if a call to transformToSRGB() would have an effect.

References Digikam::DImg::getIccProfile(), image(), Digikam::IccSettings::instance(), Digikam::IccSettings::isEnabled(), Digikam::DImg::isNull(), Digikam::IccProfile::isNull(), Digikam::IccProfile::isSameProfileAs(), and Digikam::IccProfile::sRGB().

Referenced by Digikam::DImg::prepareMetadataToSave().

◆ isUncalibratedColor()

bool Digikam::IccManager::isUncalibratedColor ( ) const

Referenced by displayTransform(), safestBestBehavior(), transform(), transformDefault(), transformForDisplay(), transformForOutput(), and transformToSRGB().

◆ needsPostLoadingManagement()

bool Digikam::IccManager::needsPostLoadingManagement ( const DImg & img )

static

Returns true if the given image is marked as needing user interaction for further color management decision after loading. If this returns true, use IccPostLoadingManager to do this.

References Digikam::DImg::hasAttribute().

Referenced by Digikam::EditorWindow::colorManage().

◆ observer()

DImgLoaderObserver * Digikam::IccManager::observer ( ) const

Referenced by setObserver().

◆ safestBestBehavior()

ICCSettingsContainer::Behavior Digikam::IccManager::safestBestBehavior ( ) const

protected

References Digikam::ICCSettingsContainer::EmbeddedToWorkspace, Digikam::ICCSettingsContainer::InputToWorkspace, isMissingProfile(), isProfileMismatch(), isUncalibratedColor(), Digikam::ICCSettingsContainer::KeepProfile, Digikam::ICCSettingsContainer::PreserveEmbeddedProfile, and Digikam::ICCSettingsContainer::UseSRGB.

Referenced by displayTransform(), and transform().

◆ setIccProfile()

void Digikam::IccManager::setIccProfile ( const IccProfile & profile )

protected

Referenced by getTransform(), transform(), transformForDisplay(), transformForOutput(), and transformToSRGB().

◆ setObserver()

void Digikam::IccManager::setObserver ( DImgLoaderObserver *const observer )

References observer().

◆ settings()

ICCSettingsContainer Digikam::IccManager::settings ( ) const

Referenced by IccManager().

◆ transform()

void Digikam::IccManager::transform	(	ICCSettingsContainer::Behavior	behavior,
		const IccProfile &	specifiedProfile = `IccProfile()`
	)

Same as above, but not using default settings but the given settings.

References Digikam::IccTransform::apply(), Digikam::ICCSettingsContainer::AskUser, getTransform(), isMissingProfile(), isProfileMismatch(), isUncalibratedColor(), Digikam::IccTransform::outputProfile(), Digikam::ICCSettingsContainer::SafestBestAction, safestBestBehavior(), setIccProfile(), and Digikam::IccTransform::willHaveEffect().

Referenced by displaySoftProofingTransform(), and transformDefault().

◆ transformDefault()

void Digikam::IccManager::transformDefault ( )

Transforms the image for full editing, using default settings. If the default settings require showing a dialog, the image is marked as such but no action is taken. See IccPostLoadingManager.

References isMissingProfile(), isProfileMismatch(), isUncalibratedColor(), and transform().

Referenced by Digikam::SharedLoadingTask::postProcess().

◆ transformForDisplay() [1/4]

void Digikam::IccManager::transformForDisplay ( )

Transforms the image for display on screen. The result is not suitable for editing or storage. You can specify the widget in which the image will be displayed, or specify the display profile yourself. You can retrieve the profile with displayProfile() and pass it to transformForDisplay() later (in a thread), or you can get a transform from displayTransform and apply it yourself.

References displayProfile().

Referenced by Digikam::SharedLoadingTask::postProcess(), Digikam::ThumbnailLoadingTask::postProcess(), and transformForDisplay().