f7a7fe6c4a
Reuse the same code for determining the default font size to use if it wasn't specified in all major ports. In particular, make wxGTK behaviour compatible with the rest and use the normal font size in this case instead of the hardcoded value of 12pt.
341 lines
11 KiB
C++
341 lines
11 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/fontutil.h
|
|
// Purpose: font-related helper functions
|
|
// Author: Vadim Zeitlin
|
|
// Modified by:
|
|
// Created: 05.11.99
|
|
// Copyright: (c) wxWidgets team
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
// General note: this header is private to wxWidgets and is not supposed to be
|
|
// included by user code. The functions declared here are implemented in
|
|
// msw/fontutil.cpp for Windows, unix/fontutil.cpp for GTK/Motif &c.
|
|
|
|
#ifndef _WX_FONTUTIL_H_
|
|
#define _WX_FONTUTIL_H_
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// headers
|
|
// ----------------------------------------------------------------------------
|
|
|
|
#include "wx/font.h" // for wxFont and wxFontEncoding
|
|
|
|
#if defined(__WXMSW__)
|
|
#include "wx/msw/wrapwin.h"
|
|
#endif
|
|
|
|
#if defined(__WXQT__)
|
|
#include <QtGui/QFont>
|
|
#endif
|
|
|
|
#if defined(__WXOSX__)
|
|
#include "wx/osx/core/cfref.h"
|
|
#endif
|
|
|
|
class WXDLLIMPEXP_FWD_BASE wxArrayString;
|
|
struct WXDLLIMPEXP_FWD_CORE wxNativeEncodingInfo;
|
|
|
|
#if defined(_WX_X_FONTLIKE)
|
|
|
|
// the symbolic names for the XLFD fields (with examples for their value)
|
|
//
|
|
// NB: we suppose that the font always starts with the empty token (font name
|
|
// registry field) as we never use nor generate it anyhow
|
|
enum wxXLFDField
|
|
{
|
|
wxXLFD_FOUNDRY, // adobe
|
|
wxXLFD_FAMILY, // courier, times, ...
|
|
wxXLFD_WEIGHT, // black, bold, demibold, medium, regular, light
|
|
wxXLFD_SLANT, // r/i/o (roman/italique/oblique)
|
|
wxXLFD_SETWIDTH, // condensed, expanded, ...
|
|
wxXLFD_ADDSTYLE, // whatever - usually nothing
|
|
wxXLFD_PIXELSIZE, // size in pixels
|
|
wxXLFD_POINTSIZE, // size in points
|
|
wxXLFD_RESX, // 72, 75, 100, ...
|
|
wxXLFD_RESY,
|
|
wxXLFD_SPACING, // m/p/c (monospaced/proportional/character cell)
|
|
wxXLFD_AVGWIDTH, // average width in 1/10 pixels
|
|
wxXLFD_REGISTRY, // iso8859, rawin, koi8, ...
|
|
wxXLFD_ENCODING, // 1, r, r, ...
|
|
wxXLFD_MAX
|
|
};
|
|
|
|
#endif // _WX_X_FONTLIKE
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// types
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// wxNativeFontInfo is platform-specific font representation: this struct
|
|
// should be considered as opaque font description only used by the native
|
|
// functions, the user code can only get the objects of this type from
|
|
// somewhere and pass it somewhere else (possibly save them somewhere using
|
|
// ToString() and restore them using FromString())
|
|
|
|
class WXDLLIMPEXP_CORE wxNativeFontInfo
|
|
{
|
|
public:
|
|
#if wxUSE_PANGO
|
|
PangoFontDescription *description;
|
|
|
|
// Pango font description doesn't have these attributes, so we store them
|
|
// separately and handle them ourselves in {To,From}String() methods.
|
|
bool m_underlined;
|
|
bool m_strikethrough;
|
|
#elif defined(_WX_X_FONTLIKE)
|
|
// the members can't be accessed directly as we only parse the
|
|
// xFontName on demand
|
|
private:
|
|
// the components of the XLFD
|
|
wxString fontElements[wxXLFD_MAX];
|
|
|
|
// the full XLFD
|
|
wxString xFontName;
|
|
|
|
// true until SetXFontName() is called
|
|
bool m_isDefault;
|
|
|
|
// return true if we have already initialized fontElements
|
|
inline bool HasElements() const;
|
|
|
|
public:
|
|
// init the elements from an XLFD, return true if ok
|
|
bool FromXFontName(const wxString& xFontName);
|
|
|
|
// return false if we were never initialized with a valid XLFD
|
|
bool IsDefault() const { return m_isDefault; }
|
|
|
|
// return the XLFD (using the fontElements if necessary)
|
|
wxString GetXFontName() const;
|
|
|
|
// get the given XFLD component
|
|
wxString GetXFontComponent(wxXLFDField field) const;
|
|
|
|
// change the font component
|
|
void SetXFontComponent(wxXLFDField field, const wxString& value);
|
|
|
|
// set the XFLD
|
|
void SetXFontName(const wxString& xFontName);
|
|
#elif defined(__WXMSW__)
|
|
wxNativeFontInfo(const LOGFONT& lf_) : lf(lf_), pointSize(0.0f) { }
|
|
|
|
LOGFONT lf;
|
|
|
|
// MSW only has limited support for fractional point sizes and we need to
|
|
// store the fractional point size separately if it was initially specified
|
|
// as we can't losslessly recover it from LOGFONT later.
|
|
float pointSize;
|
|
#elif defined(__WXOSX__)
|
|
public:
|
|
wxNativeFontInfo(const wxNativeFontInfo& info) { Init(info); }
|
|
|
|
~wxNativeFontInfo() { Free(); }
|
|
|
|
wxNativeFontInfo& operator=(const wxNativeFontInfo& info)
|
|
{
|
|
if (this != &info)
|
|
{
|
|
Free();
|
|
Init(info);
|
|
}
|
|
return *this;
|
|
}
|
|
|
|
void InitFromFont(CTFontRef font);
|
|
void InitFromFontDescriptor(CTFontDescriptorRef font);
|
|
void Init(const wxNativeFontInfo& info);
|
|
|
|
void Free();
|
|
|
|
wxString GetFamilyName() const;
|
|
wxString GetStyleName() const;
|
|
|
|
static void UpdateNamesMap(const wxString& familyname, CTFontDescriptorRef descr);
|
|
static void UpdateNamesMap(const wxString& familyname, CTFontRef font);
|
|
|
|
static CGFloat GetCTWeight( CTFontRef font );
|
|
static CGFloat GetCTWeight( CTFontDescriptorRef font );
|
|
static CGFloat GetCTSlant( CTFontDescriptorRef font );
|
|
|
|
|
|
CTFontDescriptorRef GetCTFontDescriptor() const;
|
|
private:
|
|
// attributes for regenerating a CTFontDescriptor, stay close to native values
|
|
// for better roundtrip fidelity
|
|
CGFloat m_ctWeight;
|
|
wxFontStyle m_style;
|
|
CGFloat m_ctSize;
|
|
wxFontFamily m_family;
|
|
|
|
wxString m_styleName;
|
|
wxString m_familyName;
|
|
|
|
// native font description
|
|
wxCFRef<CTFontDescriptorRef> m_descriptor;
|
|
void CreateCTFontDescriptor();
|
|
|
|
// these attributes are not part of a CTFont
|
|
bool m_underlined;
|
|
bool m_strikethrough;
|
|
wxFontEncoding m_encoding;
|
|
|
|
public :
|
|
#elif defined(__WXQT__)
|
|
QFont m_qtFont;
|
|
#else // other platforms
|
|
//
|
|
// This is a generic implementation that should work on all ports
|
|
// without specific support by the port.
|
|
//
|
|
#define wxNO_NATIVE_FONTINFO
|
|
|
|
float pointSize;
|
|
wxFontFamily family;
|
|
wxFontStyle style;
|
|
int weight;
|
|
bool underlined;
|
|
bool strikethrough;
|
|
wxString faceName;
|
|
wxFontEncoding encoding;
|
|
#endif // platforms
|
|
|
|
// default ctor (default copy ctor is ok)
|
|
wxNativeFontInfo() { Init(); }
|
|
|
|
#if wxUSE_PANGO
|
|
private:
|
|
void Init(const wxNativeFontInfo& info);
|
|
void Free();
|
|
|
|
public:
|
|
wxNativeFontInfo(const wxNativeFontInfo& info) { Init(info); }
|
|
~wxNativeFontInfo() { Free(); }
|
|
|
|
wxNativeFontInfo& operator=(const wxNativeFontInfo& info)
|
|
{
|
|
if (this != &info)
|
|
{
|
|
Free();
|
|
Init(info);
|
|
}
|
|
return *this;
|
|
}
|
|
#endif // wxUSE_PANGO
|
|
|
|
// reset to the default state
|
|
void Init();
|
|
|
|
// init with the parameters of the given font
|
|
void InitFromFont(const wxFont& font)
|
|
{
|
|
#if wxUSE_PANGO || defined(__WXOSX__)
|
|
Init(*font.GetNativeFontInfo());
|
|
#else
|
|
// translate all font parameters
|
|
SetStyle((wxFontStyle)font.GetStyle());
|
|
SetNumericWeight(font.GetNumericWeight());
|
|
SetUnderlined(font.GetUnderlined());
|
|
SetStrikethrough(font.GetStrikethrough());
|
|
#if defined(__WXMSW__)
|
|
if ( font.IsUsingSizeInPixels() )
|
|
SetPixelSize(font.GetPixelSize());
|
|
else
|
|
SetFractionalPointSize(font.GetFractionalPointSize());
|
|
#else
|
|
SetFractionalPointSize(font.GetFractionalPointSize());
|
|
#endif
|
|
|
|
// set the family/facename
|
|
SetFamily((wxFontFamily)font.GetFamily());
|
|
const wxString& facename = font.GetFaceName();
|
|
if ( !facename.empty() )
|
|
{
|
|
SetFaceName(facename);
|
|
}
|
|
|
|
// deal with encoding now (it may override the font family and facename
|
|
// so do it after setting them)
|
|
SetEncoding(font.GetEncoding());
|
|
#endif // !wxUSE_PANGO
|
|
}
|
|
|
|
// accessors and modifiers for the font elements
|
|
int GetPointSize() const;
|
|
float GetFractionalPointSize() const;
|
|
wxSize GetPixelSize() const;
|
|
wxFontStyle GetStyle() const;
|
|
wxFontWeight GetWeight() const;
|
|
int GetNumericWeight() const;
|
|
bool GetUnderlined() const;
|
|
bool GetStrikethrough() const;
|
|
wxString GetFaceName() const;
|
|
wxFontFamily GetFamily() const;
|
|
wxFontEncoding GetEncoding() const;
|
|
|
|
void SetPointSize(int pointsize);
|
|
void SetFractionalPointSize(float pointsize);
|
|
void SetPixelSize(const wxSize& pixelSize);
|
|
void SetStyle(wxFontStyle style);
|
|
void SetNumericWeight(int weight);
|
|
void SetWeight(wxFontWeight weight);
|
|
void SetUnderlined(bool underlined);
|
|
void SetStrikethrough(bool strikethrough);
|
|
bool SetFaceName(const wxString& facename);
|
|
void SetFamily(wxFontFamily family);
|
|
void SetEncoding(wxFontEncoding encoding);
|
|
|
|
// Helper used in many ports: use the normal font size if the input is
|
|
// negative, as we handle -1 as meaning this for compatibility.
|
|
void SetSizeOrDefault(float size)
|
|
{
|
|
SetFractionalPointSize
|
|
(
|
|
size < 0 ? wxNORMAL_FONT->GetFractionalPointSize()
|
|
: size
|
|
);
|
|
}
|
|
|
|
// sets the first facename in the given array which is found
|
|
// to be valid. If no valid facename is given, sets the
|
|
// first valid facename returned by wxFontEnumerator::GetFacenames().
|
|
// Does not return a bool since it cannot fail.
|
|
void SetFaceName(const wxArrayString &facenames);
|
|
|
|
|
|
// it is important to be able to serialize wxNativeFontInfo objects to be
|
|
// able to store them (in config file, for example)
|
|
bool FromString(const wxString& s);
|
|
wxString ToString() const;
|
|
|
|
// we also want to present the native font descriptions to the user in some
|
|
// human-readable form (it is not platform independent neither, but can
|
|
// hopefully be understood by the user)
|
|
bool FromUserString(const wxString& s);
|
|
wxString ToUserString() const;
|
|
};
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// font-related functions (common)
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// translate a wxFontEncoding into native encoding parameter (defined above),
|
|
// returning true if an (exact) macth could be found, false otherwise (without
|
|
// attempting any substitutions)
|
|
WXDLLIMPEXP_CORE bool wxGetNativeFontEncoding(wxFontEncoding encoding,
|
|
wxNativeEncodingInfo *info);
|
|
|
|
// test for the existence of the font described by this facename/encoding,
|
|
// return true if such font(s) exist, false otherwise
|
|
WXDLLIMPEXP_CORE bool wxTestFontEncoding(const wxNativeEncodingInfo& info);
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// font-related functions (X and GTK)
|
|
// ----------------------------------------------------------------------------
|
|
|
|
#ifdef _WX_X_FONTLIKE
|
|
#include "wx/unix/fontutil.h"
|
|
#endif // X || GDK
|
|
|
|
#endif // _WX_FONTUTIL_H_
|