test_color4d.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2018-2019, 2023 KiCad Developers, see AUTHORS.TXT for contributors.
 *
 * This program 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.
 *
 * This program 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 this program; if not, you may find one here:
 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 * or you may search the http://www.gnu.org website for the version 2 license,
 * or you may write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
 */
 
#include <boost/test/unit_test.hpp>
 
#include "color4d_test_utils.h"
 
#include <qa_utils/wx_utils/unit_test_utils.h>
 
#include <gal/color4d.h>
 
#include <wx/colour.h>
 
// All these tests are of a class in KIGFX
using namespace KIGFX;
 
 
BOOST_AUTO_TEST_SUITE( Color4D )
 
 
 
BOOST_AUTO_TEST_CASE( BasicOps )
{
 const auto c = COLOR4D{ 0.4, 0.5, 0.6, 0.7 };
 
 BOOST_CHECK_EQUAL( c.r, 0.4 );
 BOOST_CHECK_EQUAL( c.g, 0.5 );
 BOOST_CHECK_EQUAL( c.b, 0.6 );
 BOOST_CHECK_EQUAL( c.a, 0.7 );
 
 const auto copied = c;
 
 // Test equality
 BOOST_CHECK_EQUAL( c, copied );
 
 const auto c2 = COLOR4D{ 0.1, 0.2, 0.3, 0.4 };
 
 // Test inequality
 BOOST_CHECK_NE( c, c2 );
}
 
 
struct COLOR_SCALAR_CASE
{
 COLOR4D start;
 double factor;
 COLOR4D expected;
};
 
 
BOOST_AUTO_TEST_CASE( Invert )
{
 // Inverts RGB, A is the same
 static const std::vector<COLOR_SCALAR_CASE> cases = {
 { { 0.0, 0.25, 1.0, 1.0 }, 0.0, { 1.0, 0.75, 0.0, 1.0 } },
 };
 
 for( const auto& c : cases )
 {
 auto col = c.start;
 
 const auto inverted = col.Inverted();
 BOOST_CHECK_EQUAL( inverted, c.expected );
 
 // Test in-place function
 col.Invert();
 BOOST_CHECK_EQUAL( col, c.expected );
 }
}
 
 
BOOST_AUTO_TEST_CASE( Brighten )
{
 static const std::vector<COLOR_SCALAR_CASE> cases = {
 { { 0.0, 0.0, 0.0, 1.0 }, 0.5, { 0.5, 0.5, 0.5, 1.0 } },
 { { 0.0, 0.5, 1.0, 1.0 }, 0.5, { 0.5, 0.75, 1.0, 1.0 } },
 };
 
 for( const auto& c : cases )
 {
 auto col = c.start;
 
 const auto brightened = col.Brightened( c.factor );
 BOOST_CHECK_EQUAL( brightened, c.expected );
 
 // Test in-place function
 col.Brighten( c.factor );
 BOOST_CHECK_EQUAL( col, c.expected );
 }
}
 
 
BOOST_AUTO_TEST_CASE( Darken )
{
 static const std::vector<COLOR_SCALAR_CASE> cases = {
 { { 0.0, 0.0, 0.0, 1.0 }, 0.5, { 0.0, 0.0, 0.0, 1.0 } },
 { { 1.0, 1.0, 1.0, 1.0 }, 0.5, { 0.5, 0.5, 0.5, 1.0 } },
 };
 
 for( const auto& c : cases )
 {
 auto col = c.start;
 
 const auto brightened = col.Darkened( c.factor );
 BOOST_CHECK_EQUAL( brightened, c.expected );
 
 // Test in-place function
 col.Darken( c.factor );
 BOOST_CHECK_EQUAL( col, c.expected );
 }
}
 
 
BOOST_AUTO_TEST_CASE( WithAlpha )
{
 static const std::vector<COLOR_SCALAR_CASE> cases = {
 { { 0.0, 0.0, 0.0, 1.0 }, 0.5, { 0.0, 0.0, 0.0, 0.5 } },
 { { 0.0, 0.5, 1.0, 1.0 }, 0.5, { 0.0, 0.5, 1.0, 0.5 } },
 };
 
 for( const auto& c : cases )
 {
 auto col = c.start;
 
 const auto with_alpha = col.WithAlpha( c.factor );
 BOOST_CHECK_EQUAL( with_alpha, c.expected );
 }
 
 // Note: If COLOR4D::WithAlpha raised an exception, we could check
 // the bounds-checking with BOOST_REQUIRE_THROW,
 // but it assert()s, so we can't.
}
 
struct FROM_HSV_TO_HEX_CASE
{
 double h;
 double s;
 double v;
 unsigned char r;
 unsigned char g;
 unsigned char b;
};
 
 
BOOST_AUTO_TEST_CASE( FromHsv )
{
 static const std::vector<FROM_HSV_TO_HEX_CASE> cases = {
 { 10, 0.71, 0.66, 168, 69, 49 },
 { 15, 0.96, 0.34, 87, 24, 3 },
 { 120, 0.50, 0.50, 64, 128, 64 },
 { 190, 0.32, 0.97, 168, 234, 247 },
 { 240, 0.15, 0.75, 163, 163, 191 },
 { 240, 0.90, 0.75, 19, 19, 191 },
 { 310, 0.71, 0.66, 168, 49, 148 },
 { 331, 0.15, 0.85, 217, 184, 200 },
 };
 
 for( const auto& c : cases )
 {
 auto col = COLOR4D{};
 col.FromHSV( c.h, c.s, c.v );
 double new_h, new_s, new_v;
 col.ToHSV( new_h, new_s, new_v );
 const unsigned char alpha = 0xFF;
 
 BOOST_CHECK_PREDICATE( KI_TEST::IsColorNearHex, ( col )( c.r )( c.g )( c.b )( alpha ) );
 BOOST_CHECK_CLOSE( c.h, new_h, 0.0001 );
 BOOST_CHECK_CLOSE( c.s, new_s, 0.0001 );
 BOOST_CHECK_CLOSE( c.v, new_v, 0.0001 );
 }
}
 
struct FROM_HSL_TO_HEX_CASE
{
 double h;
 double s;
 double l;
 unsigned char r;
 unsigned char g;
 unsigned char b;
};
 
 
BOOST_AUTO_TEST_CASE( FromHsl )
{
 static const std::vector<FROM_HSL_TO_HEX_CASE> cases = {
 { 10, 0.71, 0.66, 230, 127, 107 },
 { 15, 0.96, 0.34, 170, 45, 3 },
 { 120, 0.5, 0.5, 64, 191, 64 },
 { 190, 0.32, 0.97, 245, 249, 250 },
 { 240, 0.15, 0.75, 182, 182, 201 },
 { 240, 0.90, 0.75, 134, 134, 249 },
 { 310, 0.71, 0.66, 230, 107, 209 },
 { 331, 0.15, 0.85, 222, 211, 217 },
 };
 
 for( const auto& c : cases )
 {
 auto col = COLOR4D{};
 col.FromHSL( c.h, c.s, c.l );
 double new_h, new_s, new_l;
 col.ToHSL( new_h, new_s, new_l );
 const unsigned char alpha = 0xFF;
 
 BOOST_CHECK_PREDICATE( KI_TEST::IsColorNearHex, ( col )( c.r )( c.g )( c.b )( alpha ) );
 BOOST_CHECK_CLOSE( c.h, new_h, 0.0001 );
 BOOST_CHECK_CLOSE( c.s, new_s, 0.0001 );
 BOOST_CHECK_CLOSE( c.l, new_l, 0.0001 );
 }
}
 
 
struct WX_CONV_CASE
{
 wxColour wx;
 COLOR4D c4d;
};
 
 
static std::vector<WX_CONV_CASE> wx_conv_cases = {
 { { 0x00, 0x00, 0x00, 0x00 }, { 0.0, 0.0, 0.0, 0.0 } },
 { { 0x66, 0x80, 0x99, 0xB3 }, { 0.4, 0.5, 0.6, 0.7 } },
 { { 0xFF, 0xFF, 0xFF, 0xFF }, { 1.0, 1.0, 1.0, 1.0 } },
 { { 0xFF, 0x00, 0x00, 0xFF }, { 0.999, 0.001, 0.0, 1.0 } },
};
 
 
BOOST_AUTO_TEST_CASE( ToWx )
{
 for( const auto& c : wx_conv_cases )
 {
 wxColour wx_col = c.c4d.ToColour();
 
 // A hack, but avoids having to define a custom operator<<
 BOOST_CHECK_EQUAL( wx_col.Red(), c.wx.Red() );
 BOOST_CHECK_EQUAL( wx_col.Green(), c.wx.Green() );
 BOOST_CHECK_EQUAL( wx_col.Blue(), c.wx.Blue() );
 BOOST_CHECK_EQUAL( wx_col.Alpha(), c.wx.Alpha() );
 }
}
 
 
BOOST_AUTO_TEST_CASE( FromWx )
{
 const double tol = 0.5 / 255.0; // One bit of quantised error
 
 for( const auto& c : wx_conv_cases )
 {
 const auto col = COLOR4D{ c.wx };
 
 BOOST_CHECK_PREDICATE( KI_TEST::IsColorNear, ( col )( c.c4d )( tol ) );
 }
}
 
 
BOOST_AUTO_TEST_CASE( Compare )
{
 std::hash<COLOR4D> colorHasher;
 
 COLOR4D a( 0.5, 0.5, 0.5, 0.5 );
 COLOR4D b( 0.5, 0.5, 0.5, 0.5 );
 
 BOOST_CHECK_EQUAL( a.Compare( b ), 0 );
 BOOST_CHECK_EQUAL( colorHasher( a ), colorHasher( b ) );
 
 b.r = 0.25;
 BOOST_CHECK_GT( a.Compare( b ), 0 );
 BOOST_CHECK_NE( colorHasher( a ), colorHasher( b ) );
 
 b.r = 0.75;
 BOOST_CHECK_LT( a.Compare( b ), 0 );
 
 b.r = 0.5;
 b.g = 0.25;
 BOOST_CHECK_GT( a.Compare( b ), 0 );
 
 b.g = 0.75;
 BOOST_CHECK_LT( a.Compare( b ), 0 );
 
 b.g = 0.5;
 b.b = 0.25;
 BOOST_CHECK_GT( a.Compare( b ), 0 );
 
 b.b = 0.75;
 BOOST_CHECK_LT( a.Compare( b ), 0 );
 
 b.b = 0.5;
 b.a = 0.25;
 BOOST_CHECK_GT( a.Compare( b ), 0 );
 
 b.a = 0.75;
 BOOST_CHECK_LT( a.Compare( b ), 0 );
}
 
 
BOOST_AUTO_TEST_SUITE_END()