13
0
livetrax/libs/gtkmm2/pango/pangomm/fontdescription.h
Carl Hetherington 61c990dfba Upgrade gtkmm to 2.10.8, glibmm to 2.13.3 and add cairomm 1.2.4
git-svn-id: svn://localhost/ardour2/trunk@2630 d708f5d6-7413-0410-9779-e7cbd77b26cf
2007-11-12 23:44:49 +00:00

553 lines
17 KiB
C++

// -*- c++ -*-
// Generated by gtkmmproc -- DO NOT MODIFY!
#ifndef _PANGOMM_FONTDESCRIPTION_H
#define _PANGOMM_FONTDESCRIPTION_H
#include <glibmm.h>
/* $Id$ */
/* fontdescription.h
*
* Copyright (C) 1998-2002 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library 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
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the Free
* Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
#include <pango/pango-font.h>
#ifndef DOXYGEN_SHOULD_SKIP_THIS
extern "C" { typedef struct _PangoFontDescription PangoFontDescription; }
#endif
namespace Pango
{
/** @addtogroup pangommEnums Enums and Flags */
/**
* @ingroup pangommEnums
*/
enum Style
{
STYLE_NORMAL,
STYLE_OBLIQUE,
STYLE_ITALIC
};
} // namespace Pango
#ifndef DOXYGEN_SHOULD_SKIP_THIS
namespace Glib
{
template <>
class Value<Pango::Style> : public Glib::Value_Enum<Pango::Style>
{
public:
static GType value_type() G_GNUC_CONST;
};
} // namespace Glib
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
namespace Pango
{
/**
* @ingroup pangommEnums
*/
enum Variant
{
VARIANT_NORMAL,
VARIANT_SMALL_CAPS
};
} // namespace Pango
#ifndef DOXYGEN_SHOULD_SKIP_THIS
namespace Glib
{
template <>
class Value<Pango::Variant> : public Glib::Value_Enum<Pango::Variant>
{
public:
static GType value_type() G_GNUC_CONST;
};
} // namespace Glib
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
namespace Pango
{
/**
* @ingroup pangommEnums
*/
enum Stretch
{
STRETCH_ULTRA_CONDENSED,
STRETCH_EXTRA_CONDENSED,
STRETCH_CONDENSED,
STRETCH_SEMI_CONDENSED,
STRETCH_NORMAL,
STRETCH_SEMI_EXPANDED,
STRETCH_EXPANDED,
STRETCH_EXTRA_EXPANDED,
STRETCH_ULTRA_EXPANDED
};
} // namespace Pango
#ifndef DOXYGEN_SHOULD_SKIP_THIS
namespace Glib
{
template <>
class Value<Pango::Stretch> : public Glib::Value_Enum<Pango::Stretch>
{
public:
static GType value_type() G_GNUC_CONST;
};
} // namespace Glib
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
namespace Pango
{
/**
* @ingroup pangommEnums
*/
enum Weight
{
WEIGHT_ULTRALIGHT = 200,
WEIGHT_LIGHT = 300,
WEIGHT_NORMAL = 400,
WEIGHT_SEMIBOLD = 600,
WEIGHT_BOLD = 700,
WEIGHT_ULTRABOLD = 800,
WEIGHT_HEAVY = 900
};
} // namespace Pango
#ifndef DOXYGEN_SHOULD_SKIP_THIS
namespace Glib
{
template <>
class Value<Pango::Weight> : public Glib::Value_Enum<Pango::Weight>
{
public:
static GType value_type() G_GNUC_CONST;
};
} // namespace Glib
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
namespace Pango
{
/**
* @ingroup pangommEnums
* @par Bitwise operators:
* <tt>%FontMask operator|(FontMask, FontMask)</tt><br>
* <tt>%FontMask operator&(FontMask, FontMask)</tt><br>
* <tt>%FontMask operator^(FontMask, FontMask)</tt><br>
* <tt>%FontMask operator~(FontMask)</tt><br>
* <tt>%FontMask& operator|=(FontMask&, FontMask)</tt><br>
* <tt>%FontMask& operator&=(FontMask&, FontMask)</tt><br>
* <tt>%FontMask& operator^=(FontMask&, FontMask)</tt><br>
*/
enum FontMask
{
FONT_MASK_FAMILY = 1 << 0,
FONT_MASK_STYLE = 1 << 1,
FONT_MASK_VARIANT = 1 << 2,
FONT_MASK_WEIGHT = 1 << 3,
FONT_MASK_STRETCH = 1 << 4,
FONT_MASK_SIZE = 1 << 5
};
/** @ingroup pangommEnums */
inline FontMask operator|(FontMask lhs, FontMask rhs)
{ return static_cast<FontMask>(static_cast<unsigned>(lhs) | static_cast<unsigned>(rhs)); }
/** @ingroup pangommEnums */
inline FontMask operator&(FontMask lhs, FontMask rhs)
{ return static_cast<FontMask>(static_cast<unsigned>(lhs) & static_cast<unsigned>(rhs)); }
/** @ingroup pangommEnums */
inline FontMask operator^(FontMask lhs, FontMask rhs)
{ return static_cast<FontMask>(static_cast<unsigned>(lhs) ^ static_cast<unsigned>(rhs)); }
/** @ingroup pangommEnums */
inline FontMask operator~(FontMask flags)
{ return static_cast<FontMask>(~static_cast<unsigned>(flags)); }
/** @ingroup pangommEnums */
inline FontMask& operator|=(FontMask& lhs, FontMask rhs)
{ return (lhs = static_cast<FontMask>(static_cast<unsigned>(lhs) | static_cast<unsigned>(rhs))); }
/** @ingroup pangommEnums */
inline FontMask& operator&=(FontMask& lhs, FontMask rhs)
{ return (lhs = static_cast<FontMask>(static_cast<unsigned>(lhs) & static_cast<unsigned>(rhs))); }
/** @ingroup pangommEnums */
inline FontMask& operator^=(FontMask& lhs, FontMask rhs)
{ return (lhs = static_cast<FontMask>(static_cast<unsigned>(lhs) ^ static_cast<unsigned>(rhs))); }
} // namespace Pango
#ifndef DOXYGEN_SHOULD_SKIP_THIS
namespace Glib
{
template <>
class Value<Pango::FontMask> : public Glib::Value_Flags<Pango::FontMask>
{
public:
static GType value_type() G_GNUC_CONST;
};
} // namespace Glib
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
namespace Pango
{
/** A Pango::FontDescription represents the description of an ideal font.
* It is used both to list what fonts are available on the system and also for specifying the characteristics of a font to load.
*/
class FontDescription
{
public:
#ifndef DOXYGEN_SHOULD_SKIP_THIS
typedef FontDescription CppObjectType;
typedef PangoFontDescription BaseObjectType;
static GType get_type() G_GNUC_CONST;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
FontDescription();
explicit FontDescription(PangoFontDescription* gobject, bool make_a_copy = true);
FontDescription(const FontDescription& other);
FontDescription& operator=(const FontDescription& other);
~FontDescription();
void swap(FontDescription& other);
///Provides access to the underlying C instance.
PangoFontDescription* gobj() { return gobject_; }
///Provides access to the underlying C instance.
const PangoFontDescription* gobj() const { return gobject_; }
///Provides access to the underlying C instance. The caller is responsible for freeing it. Use when directly setting fields in structs.
PangoFontDescription* gobj_copy() const;
protected:
PangoFontDescription* gobject_;
private:
/* These functions are dangerous! The first casts the "const" from the parameter away
* copying the pointer and keep it hanging around.
* So desc.set_family_static("some_family") would lead to a segfault.
* The latter makes a shallow copy of the parameter's "family" data member.
* So if the FontDescription you passed in dies, a pointer to its (deleted)
* family data member still hangs around!
* This is why we can't wrap these functions!
*/
public:
/** Constructs a font description from a string representation.
* @a font_name must have the form
* "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]", where FAMILY-LIST is a comma separated
* list of families optionally terminated by a comma, STYLE_OPTIONS is a whitespace
* separated list of words where each WORD describes one of style, variant, weight,
* or stretch, and SIZE is an decimal number (size in points). Any one of the
* options may be absent. If FAMILY-LIST is absent, then the family_name field
* of the resulting font description will be initialized to 0. If STYLE-OPTIONS
* is missing, then all style options will be set to the default values. If SIZE
* is missing, the size in the resulting font description will be set to 0.
* @param font_name String representation of a font description.
*/
explicit FontDescription(const Glib::ustring& font_name);
/** Computes a hash of a Pango::FontDescription structure suitable
* to be used, for example, as an argument to Glib::hash_table_new().
* @return The hash value.
*/
guint hash() const;
/** Sets the family name field of a font description. The family
* name represents a family of related font styles, and will
* resolve to a particular Pango::FontFamily. In some uses of
* Pango::FontDescription, it is also possible to use a comma
* separated list of family names for this field.
* @param family A string representing the family name.
*/
void set_family(const Glib::ustring& family);
/** Gets the family name field of a font description. See
* pango_font_description_set_family().
* @return The family name field. (Will be <tt>0</tt> if not previously set.).
*/
Glib::ustring get_family() const;
/** Sets the style field of a Pango::FontDescription. The
* Pango::Style enumeration describes whether the font is slanted and
* the manner in which it is slanted; it can be either
* Pango::STYLE_NORMAL, Pango::STYLE_ITALIC, or Pango::STYLE_OBLIQUE.
* Most fonts will either have a italic style or an oblique
* style, but not both, and font matching in Pango will
* match italic specifications with oblique fonts and vice-versa
* if an exact match is not found.
* @param style The style for the font description.
*/
void set_style(Style style);
/** Gets the style field of a Pango::FontDescription. See
* pango_font_description_set_style().
* @return The style field for the font description.
* Use pango_font_description_get_set_fields() to find out if
* the field was explicitely set or not.
*/
Style get_style() const;
/** Sets the variant field of a font description. The Pango::Variant
* can either be Pango::VARIANT_NORMAL or Pango::VARIANT_SMALL_CAPS.
* @param variant The variant type for the font description.
*/
void set_variant(Variant variant);
/** Gets the variant field of a Pango::FontDescription. See
* pango_font_description_set_variant().
* @return The variant field for the font description. Use
* pango_font_description_get_set_fields() to find out if
* the field was explicitely set or not.
*/
Variant get_variant() const;
/** Sets the weight field of a font description. The weight field
* specifies how bold or light the font should be. In addition
* to the values of the Pango::Weight enumeration, other intermediate
* numeric values are possible.
* @param weight The weight for the font description.
*/
void set_weight(Weight weight);
/** Gets the weight field of a font description. See
* pango_font_description_set_weight().
* @return The weight field for the font description. Use
* pango_font_description_get_set_fields() to find out if
* the field was explicitely set or not.
*/
Weight get_weight() const;
/** Sets the stretch field of a font description. The stretch field
* specifies how narrow or wide the font should be.
* @param stretch The stretch for the font description.
*/
void set_stretch(Stretch stretch);
/** Gets the stretch field of a font description.
* See pango_font_description_set_stretch().
* @return The stretch field for the font description. Use
* pango_font_description_get_set_fields() to find out if
* the field was explicitely set or not.
*/
Stretch get_stretch() const;
/** Sets the size field of a font description in fractional points. This is mutually
* exclusive with pango_font_description_set_absolute_size().
* @param size The size of the font in points, scaled by PANGO_SCALE. (That is,
* a @a size value of 10 * PANGO_SCALE is a 10 point font. The conversion
* factor between points and device units depends on system configuration
* and the output device. For screen display, a logical DPI of 96 is
* common, in which case a 10 point font corresponds to a 10 * (96 / 72) = 13.3
* pixel font. Use pango_font_description_set_absolute_size() if you need
* a particular size in device units.
*/
void set_size(int size);
/** Gets the size field of a font description.
* See pango_font_description_get_size().
* @return The size field for the font description in points or device units.
* You must call pango_font_description_get_size_is_absolute()
* to find out which is the case. Returns 0 if the size field has not
* previously been set. pango_font_description_get_set_fields() to
* find out if the field was explicitely set or not.
*/
int get_size() const;
/** Sets the size field of a font description, in device units. This is mutually
* exclusive with pango_font_description_set_size().
*
* Since: 1.8
* @param size The new size, in pango units. There are Pango::SCALE Pango units in one
* device unit. For an output backend where a device unit is a pixel, a @a size
* value of 10 * PANGO_SCALE gives a 10 pixel font.
*/
void set_absolute_size(double size);
/** Determines whether the size of the font is in points or device units.
* See pango_font_description_set_size() and pango_font_description_set_absolute_size().
* @return Whether the the size for the font description is in
* points or device units. Use pango_font_description_get_set_fields() to
* find out if the size field of the font description was explicitely set or not.
*
* Since: 1.8.
*/
bool get_size_is_absolute() const;
/** Determines which fields in a font description have been set.
* @return A bitmask with bits set corresponding to the
* fields in @a desc that have been set.
*/
FontMask get_set_fields() const;
/** Unsets some of the fields in a Pango::FontDescription. Note that
* this merely marks the fields cleared, it does not clear the
* settings for those fields, to clear a family name set with
* pango_font_description_set_family_static() so that it won't
* be returned by subsequent calls to pango_font_description_get_family(),
* you must actually call pango_font_description_set_family (desc, <tt>0</tt>);
* @param to_unset Bitmask of fields in the @a desc to unset.
*/
void unset_fields(FontMask to_unset);
/** Merges the fields that are set in @a desc_to_merge into the fields in
* @a desc . If @a replace_existing is <tt>false</tt>, only fields in @a desc that
* are not already set are affected. If <tt>true</tt>, then fields that are
* already set will be replaced as well.
* @param desc_to_merge The Pango::FontDescription to merge from.
* @param replace_existing If <tt>true</tt>, replace fields in @a desc with the
* corresponding values from @a desc_to_merge , even if they
* are already exist.
*/
void merge(const FontDescription& desc_to_merge, bool replace_existing);
/** Determines if the style attributes of @a new_match are a closer match
* for @a desc than @a old_match , or if @a old_match is <tt>0</tt>, determines if
* @a new_match is a match at all. Approximate matching is done for
* weight and style; other attributes must match exactly.
* @param old_match A Pango::FontDescription, or <tt>0</tt>.
* @param new_match A Pango::FontDescription.
* @return <tt>true</tt> if @a new_match is a better match.
*/
bool better_match(const FontDescription& old_match, const FontDescription& new_match) const;
/** Creates a string representation of a font description. See
* description_from_string() for a description of the
* format of the string representation. The family list in the
* string description will only have a terminating comma if the
* last word of the list is a valid style option.
* @return The string.
*/
Glib::ustring to_string() const;
/** Creates a filename representation of a font description. The
* filename is identical to the result from calling
* pango_font_description_to_string(), but with underscores instead of
* characters that are untypical in filenames, and in lower case only.
* @return The filename.
*/
Glib::ustring to_filename() const;
};
} //namespace Pango
namespace Pango
{
/** @relates Pango::FontDescription
* @param lhs The left-hand side
* @param rhs The right-hand side
* @result The result
*/
bool operator==(const FontDescription& lhs, const FontDescription& rhs);
/** @relates Pango::FontDescription
* @param lhs The left-hand side
* @param rhs The right-hand side
* @result The result
*/
bool operator!=(const FontDescription& lhs, const FontDescription& rhs);
} // namespace Pango
namespace Pango
{
/** @relates Pango::FontDescription
* @param lhs The left-hand side
* @param rhs The right-hand side
*/
inline void swap(FontDescription& lhs, FontDescription& rhs)
{ lhs.swap(rhs); }
} // namespace Pango
namespace Glib
{
/** @relates Pango::FontDescription
* @param object The C instance
* @param take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
* @result A C++ instance that wraps this C instance.
*/
Pango::FontDescription wrap(PangoFontDescription* object, bool take_copy = false);
#ifndef DOXYGEN_SHOULD_SKIP_THIS
template <>
class Value<Pango::FontDescription> : public Glib::Value_Boxed<Pango::FontDescription>
{};
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
} // namespace Glib
#endif /* _PANGOMM_FONTDESCRIPTION_H */