BitmapPerceptualDifference

From K-3D

Description

Calculate a perceptual difference metric between two bitmap images

Plugin Status:	Experimental
Categories:	All Plugins, Experimental Plugins, Bitmap Plugins, Test Plugins

Metadata

Name	Value

Properties

Label	Description	Type	Script Name
Input A	A input bitmap	k3d::bitmap*	input_a
Input B	B input bitmap	k3d::bitmap*	input_b
Field-of-view	Field-of-view (degrees)	k3d::double_t	field_of_view
Gamma	Gamma	k3d::double_t	gamma
Luminance	Display Luminance (candela per square meter)	k3d::double_t	luminance
Difference	The count of perceivably-different pixels	k3d::uint32_t	difference
Output Bitmap	Output bitmap	k3d::bitmap*	output_bitmap

Overview

BitmapPerceptualDifference is used primarily for regression tests that need to compare bitmap images for equivalence - it is based on a physiological model of human vision that allows it to ignore differences between images that wouldn't normally be perceivable by a human.

Credits

BitmapPerceptualDifference is based on the work of Hector Yee, et al, available at http://pdiff.sourceforge.net/

For K-3D we hacked the pdiff sources so we could embed them in a K-3D bitmap modifier.