e70fc11ef1
Drop the legacy CppUnit testing framework used for the unit tests. Replacing it with Catch has the advantage of not requiring CppUnit libraries to be installed on the system in order to be able to run tests (Catch is header-only and a copy of it is now included in the main repository itself) and, in the future, of being able to write the tests in a much more natural way. For now, however, avoid changing the existing tests code as much as [reasonably] possible to avoid introducing bugs in them and provide the CppUnit compatibility macros in the new wx/catch_cppunit.h header which allow to preserve the 99% of the existing code unchanged. Some of the required changes are: - Decompose asserts using "a && b" conditions into multiple asserts checking "a" and "b" independently. This would have been better even with CppUnit (to know which part of condition exactly failed) and is required with Catch. - Use extra parentheses around such conditions when they can't be easily decomposed in the arrays test, due to the use of macros. This is not ideal from the point of view of messages given when the tests fail but will do for now. - Rewrite asserts using "a || b" as a combination of condition checks and assert macros. Again, this is better anyhow, and is required with Catch. Incidentally, this allowed to fix a bug in the "exec" unit test which didn't leave enough time for the new process to be launched before trying to kill it. - Remove multiple CPPUNIT_TEST_SUITE_NAMED_REGISTRATION() macros, our emulation of this macro can be used only once. - Provide string conversions using Catch-specific StringMaker for a couple of types. - Replace custom wxImage comparison with a Catch-specific matcher class. - Remove most of test running logic from test.cpp, in particular don't parse command line ourselves any longer but use Catch built-in command line parser. This is a source of a minor regression: previously, both "Foo" and "FooTestCase" could be used as the name of the test to run, but now only the latter is accepted.
341 lines
11 KiB
C++
341 lines
11 KiB
C++
///////////////////////////////////////////////////////////////////////////////
|
|
// Name: tests/font/fonttest.cpp
|
|
// Purpose: wxFont unit test
|
|
// Author: Francesco Montorsi
|
|
// Created: 16.3.09
|
|
// Copyright: (c) 2009 Francesco Montorsi
|
|
// Licence: wxWindows licence
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// headers
|
|
// ----------------------------------------------------------------------------
|
|
|
|
#include "testprec.h"
|
|
|
|
#ifdef __BORLANDC__
|
|
#pragma hdrstop
|
|
#endif
|
|
|
|
#ifndef WX_PRECOMP
|
|
#include "wx/wx.h"
|
|
#endif // WX_PRECOMP
|
|
|
|
#if wxUSE_FONTMAP
|
|
|
|
#include "wx/font.h"
|
|
|
|
#include "asserthelper.h"
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// test class
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class FontTestCase : public CppUnit::TestCase
|
|
{
|
|
public:
|
|
FontTestCase() { }
|
|
|
|
private:
|
|
CPPUNIT_TEST_SUITE( FontTestCase );
|
|
CPPUNIT_TEST( Construct );
|
|
CPPUNIT_TEST( GetSet );
|
|
CPPUNIT_TEST( NativeFontInfo );
|
|
CPPUNIT_TEST( NativeFontInfoUserDesc );
|
|
CPPUNIT_TEST_SUITE_END();
|
|
|
|
void Construct();
|
|
void GetSet();
|
|
void NativeFontInfo();
|
|
void NativeFontInfoUserDesc();
|
|
|
|
static const wxFont *GetTestFonts(unsigned& numFonts)
|
|
{
|
|
static const wxFont testfonts[] =
|
|
{
|
|
*wxNORMAL_FONT,
|
|
*wxSMALL_FONT,
|
|
*wxITALIC_FONT,
|
|
*wxSWISS_FONT,
|
|
wxFont(5, wxFONTFAMILY_TELETYPE, wxFONTSTYLE_NORMAL, wxFONTWEIGHT_NORMAL)
|
|
};
|
|
|
|
numFonts = WXSIZEOF(testfonts);
|
|
|
|
return testfonts;
|
|
}
|
|
|
|
wxDECLARE_NO_COPY_CLASS(FontTestCase);
|
|
};
|
|
|
|
// register in the unnamed registry so that these tests are run by default
|
|
CPPUNIT_TEST_SUITE_REGISTRATION( FontTestCase );
|
|
|
|
// also include in its own registry so that these tests can be run alone
|
|
CPPUNIT_TEST_SUITE_NAMED_REGISTRATION( FontTestCase, "FontTestCase" );
|
|
|
|
wxString DumpFont(const wxFont *font)
|
|
{
|
|
// dumps the internal properties of a wxFont in the same order they
|
|
// are checked by wxFontBase::operator==()
|
|
|
|
wxASSERT(font->IsOk());
|
|
|
|
wxString s;
|
|
s.Printf(wxS("%d-%d;%d-%d-%d-%d-%d-%s-%d"),
|
|
font->GetPointSize(),
|
|
font->GetPixelSize().x,
|
|
font->GetPixelSize().y,
|
|
font->GetFamily(),
|
|
font->GetStyle(),
|
|
font->GetWeight(),
|
|
font->GetUnderlined() ? 1 : 0,
|
|
font->GetFaceName(),
|
|
font->GetEncoding());
|
|
|
|
return s;
|
|
}
|
|
|
|
void FontTestCase::Construct()
|
|
{
|
|
// The main purpose of this test is to verify that the font ctors below
|
|
// compile because it's easy to introduce ambiguities due to the number of
|
|
// overloaded wxFont ctors.
|
|
|
|
CPPUNIT_ASSERT( wxFont(10, wxFONTFAMILY_DEFAULT,
|
|
wxFONTSTYLE_NORMAL,
|
|
wxFONTWEIGHT_NORMAL).IsOk() );
|
|
|
|
#if WXWIN_COMPATIBILITY_3_0
|
|
// Disable the warning about deprecated wxNORMAL as we use it here
|
|
// intentionally.
|
|
#ifdef __VISUALC__
|
|
#pragma warning(push)
|
|
#pragma warning(disable:4996)
|
|
#endif
|
|
|
|
wxGCC_WARNING_SUPPRESS(deprecated-declarations)
|
|
|
|
// Tests relying on the soon-to-be-deprecated ctor taking ints and not
|
|
// wxFontXXX enum elements.
|
|
CPPUNIT_ASSERT( wxFont(10, wxDEFAULT, wxNORMAL, wxNORMAL).IsOk() );
|
|
|
|
wxGCC_WARNING_RESTORE(deprecated-declarations)
|
|
|
|
#ifdef __VISUALC__
|
|
#pragma warning(pop)
|
|
#endif
|
|
#endif // WXWIN_COMPATIBILITY_3_0
|
|
}
|
|
|
|
void FontTestCase::GetSet()
|
|
{
|
|
unsigned numFonts;
|
|
const wxFont *pf = GetTestFonts(numFonts);
|
|
for ( unsigned n = 0; n < numFonts; n++ )
|
|
{
|
|
wxFont test(*pf++);
|
|
|
|
// remember: getters can only be called when wxFont::IsOk() == true
|
|
CPPUNIT_ASSERT( test.IsOk() );
|
|
|
|
|
|
// test Get/SetFaceName()
|
|
CPPUNIT_ASSERT( !test.SetFaceName("a dummy face name") );
|
|
CPPUNIT_ASSERT( !test.IsOk() );
|
|
|
|
// if the call to SetFaceName() below fails on your system/port,
|
|
// consider adding another branch to this #if
|
|
#if defined(__WXMSW__) || defined(__WXOSX__)
|
|
static const char *knownGoodFaceName = "Arial";
|
|
#else
|
|
static const char *knownGoodFaceName = "Monospace";
|
|
#endif
|
|
|
|
WX_ASSERT_MESSAGE
|
|
(
|
|
("failed to set face name \"%s\" for test font #%u\n"
|
|
"(this failure is harmless if this face name is not "
|
|
"available on this system)", knownGoodFaceName, n),
|
|
test.SetFaceName(knownGoodFaceName)
|
|
);
|
|
CPPUNIT_ASSERT( test.IsOk() );
|
|
|
|
|
|
// test Get/SetFamily()
|
|
|
|
test.SetFamily( wxFONTFAMILY_ROMAN );
|
|
CPPUNIT_ASSERT( test.IsOk() );
|
|
|
|
// note that there is always the possibility that GetFamily() returns
|
|
// wxFONTFAMILY_DEFAULT (meaning "unknown" in this case) so that we
|
|
// consider it as a valid return value
|
|
const wxFontFamily family = test.GetFamily();
|
|
if ( family != wxFONTFAMILY_DEFAULT )
|
|
CPPUNIT_ASSERT_EQUAL( wxFONTFAMILY_ROMAN, family );
|
|
|
|
|
|
// test Get/SetEncoding()
|
|
|
|
//test.SetEncoding( wxFONTENCODING_KOI8 );
|
|
//CPPUNIT_ASSERT( test.IsOk() );
|
|
//CPPUNIT_ASSERT_EQUAL( wxFONTENCODING_KOI8 , test.GetEncoding() );
|
|
|
|
|
|
// test Get/SetPointSize()
|
|
|
|
test.SetPointSize(30);
|
|
CPPUNIT_ASSERT( test.IsOk() );
|
|
CPPUNIT_ASSERT_EQUAL( 30, test.GetPointSize() );
|
|
|
|
|
|
// test Get/SetPixelSize()
|
|
|
|
test.SetPixelSize(wxSize(0,30));
|
|
CPPUNIT_ASSERT( test.IsOk() );
|
|
CPPUNIT_ASSERT( test.GetPixelSize().GetHeight() <= 30 );
|
|
// NOTE: the match found by SetPixelSize() may be not 100% precise; it
|
|
// only grants that a font smaller than the required height will
|
|
// be selected
|
|
|
|
|
|
// test Get/SetStyle()
|
|
|
|
test.SetStyle(wxFONTSTYLE_SLANT);
|
|
CPPUNIT_ASSERT( test.IsOk() );
|
|
#ifdef __WXMSW__
|
|
// on wxMSW wxFONTSTYLE_SLANT==wxFONTSTYLE_ITALIC, so accept the latter
|
|
// as a valid value too.
|
|
if ( test.GetStyle() != wxFONTSTYLE_ITALIC )
|
|
#endif
|
|
CPPUNIT_ASSERT_EQUAL( wxFONTSTYLE_SLANT, test.GetStyle() );
|
|
|
|
// test Get/SetUnderlined()
|
|
|
|
test.SetUnderlined(true);
|
|
CPPUNIT_ASSERT( test.IsOk() );
|
|
CPPUNIT_ASSERT_EQUAL( true, test.GetUnderlined() );
|
|
|
|
const wxFont fontBase = test.GetBaseFont();
|
|
CPPUNIT_ASSERT( fontBase.IsOk() );
|
|
CPPUNIT_ASSERT( !fontBase.GetUnderlined() );
|
|
CPPUNIT_ASSERT( !fontBase.GetStrikethrough() );
|
|
CPPUNIT_ASSERT_EQUAL( wxFONTWEIGHT_NORMAL, fontBase.GetWeight() );
|
|
CPPUNIT_ASSERT_EQUAL( wxFONTSTYLE_NORMAL, fontBase.GetStyle() );
|
|
|
|
// test Get/SetStrikethrough()
|
|
|
|
test.SetStrikethrough(true);
|
|
CPPUNIT_ASSERT( test.IsOk() );
|
|
CPPUNIT_ASSERT_EQUAL( true, test.GetStrikethrough() );
|
|
|
|
|
|
// test Get/SetWeight()
|
|
|
|
test.SetWeight(wxFONTWEIGHT_BOLD);
|
|
CPPUNIT_ASSERT( test.IsOk() );
|
|
CPPUNIT_ASSERT_EQUAL( wxFONTWEIGHT_BOLD, test.GetWeight() );
|
|
}
|
|
}
|
|
|
|
void FontTestCase::NativeFontInfo()
|
|
{
|
|
unsigned numFonts;
|
|
const wxFont *pf = GetTestFonts(numFonts);
|
|
for ( size_t n = 0; n < numFonts; n++ )
|
|
{
|
|
wxFont test(*pf++);
|
|
|
|
const wxString& nid = test.GetNativeFontInfoDesc();
|
|
CPPUNIT_ASSERT( !nid.empty() );
|
|
// documented to be never empty
|
|
|
|
wxFont temp;
|
|
CPPUNIT_ASSERT( temp.SetNativeFontInfo(nid) );
|
|
CPPUNIT_ASSERT( temp.IsOk() );
|
|
WX_ASSERT_MESSAGE(
|
|
("Test #%lu failed\ndump of test font: \"%s\"\ndump of temp font: \"%s\"", \
|
|
n, DumpFont(&test), DumpFont(&temp)),
|
|
temp == test );
|
|
}
|
|
|
|
// test that clearly invalid font info strings do not work
|
|
wxFont font;
|
|
CPPUNIT_ASSERT( !font.SetNativeFontInfo("") );
|
|
|
|
// pango_font_description_from_string() used by wxFont in wxGTK and wxX11
|
|
// never returns an error at all so this assertion fails there -- and as it
|
|
// doesn't seem to be possible to do anything about it maybe we should
|
|
// change wxMSW and other ports to also accept any strings?
|
|
#if !defined(__WXGTK__) && !defined(__WXX11__)
|
|
CPPUNIT_ASSERT( !font.SetNativeFontInfo("bloordyblop") );
|
|
#endif
|
|
|
|
// Pango font description doesn't have 'underlined' and 'strikethrough'
|
|
// attributes, so wxNativeFontInfo implements these itself. Test if these
|
|
// are properly preserved by wxNativeFontInfo or its string description.
|
|
font.SetUnderlined(true);
|
|
font.SetStrikethrough(true);
|
|
CPPUNIT_ASSERT_EQUAL(font, wxFont(font));
|
|
CPPUNIT_ASSERT_EQUAL(font, wxFont(*font.GetNativeFontInfo()));
|
|
CPPUNIT_ASSERT_EQUAL(font, wxFont(font.GetNativeFontInfoDesc()));
|
|
font.SetUnderlined(false);
|
|
CPPUNIT_ASSERT_EQUAL(font, wxFont(font));
|
|
CPPUNIT_ASSERT_EQUAL(font, wxFont(*font.GetNativeFontInfo()));
|
|
CPPUNIT_ASSERT_EQUAL(font, wxFont(font.GetNativeFontInfoDesc()));
|
|
font.SetUnderlined(true);
|
|
font.SetStrikethrough(false);
|
|
CPPUNIT_ASSERT_EQUAL(font, wxFont(font));
|
|
CPPUNIT_ASSERT_EQUAL(font, wxFont(*font.GetNativeFontInfo()));
|
|
CPPUNIT_ASSERT_EQUAL(font, wxFont(font.GetNativeFontInfoDesc()));
|
|
// note: the GetNativeFontInfoUserDesc() doesn't preserve all attributes
|
|
// according to docs, so it is not tested.
|
|
}
|
|
|
|
void FontTestCase::NativeFontInfoUserDesc()
|
|
{
|
|
unsigned numFonts;
|
|
const wxFont *pf = GetTestFonts(numFonts);
|
|
for ( size_t n = 0; n < numFonts; n++ )
|
|
{
|
|
wxFont test(*pf++);
|
|
|
|
const wxString& niud = test.GetNativeFontInfoUserDesc();
|
|
CPPUNIT_ASSERT( !niud.empty() );
|
|
// documented to be never empty
|
|
|
|
wxFont temp2;
|
|
CPPUNIT_ASSERT( temp2.SetNativeFontInfoUserDesc(niud) );
|
|
CPPUNIT_ASSERT( temp2.IsOk() );
|
|
|
|
#ifdef __WXGTK__
|
|
// Pango saves/restores all font info in the user-friendly string:
|
|
WX_ASSERT_MESSAGE(
|
|
("Test #%lu failed; native info user desc was \"%s\" for test and \"%s\" for temp2", \
|
|
n, niud, temp2.GetNativeFontInfoUserDesc()),
|
|
temp2 == test );
|
|
#else
|
|
// NOTE: as documented GetNativeFontInfoUserDesc/SetNativeFontInfoUserDesc
|
|
// are not granted to save/restore all font info.
|
|
// In fact e.g. the font family is not saved at all; test only those
|
|
// info which GetNativeFontInfoUserDesc() does indeed save:
|
|
CPPUNIT_ASSERT_EQUAL( test.GetWeight(), temp2.GetWeight() );
|
|
CPPUNIT_ASSERT_EQUAL( test.GetStyle(), temp2.GetStyle() );
|
|
|
|
// if the original face name was empty, it means that any face name (in
|
|
// this family) can be used for the new font so we shouldn't be
|
|
// surprised to find that they differ in this case
|
|
const wxString facename = test.GetFaceName();
|
|
if ( !facename.empty() )
|
|
{
|
|
CPPUNIT_ASSERT_EQUAL( facename.Upper(), temp2.GetFaceName().Upper() );
|
|
}
|
|
|
|
CPPUNIT_ASSERT_EQUAL( test.GetPointSize(), temp2.GetPointSize() );
|
|
CPPUNIT_ASSERT_EQUAL( test.GetEncoding(), temp2.GetEncoding() );
|
|
#endif
|
|
}
|
|
}
|
|
|
|
#endif // wxUSE_FONTMAP
|