Aren/haiku
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
f6c51a5dc4
haiku/headers/os/interface/Font.h
Dale Cieslak 85b82f8524 BFont: allow loading of user fonts from disk or memory 
This patch adds an API call to BFont, called LoadFont, that
takes a string path to a font file. The user fonts are managed
via a new class called AppFontManager that inherits from the base
class FontManagerBase but adds the methods to add and remove user
fonts from disk or memory. There is also a new method called UnloadFont
to remove a user font, but on exit of an app all user fonts should be
automatically cleaned up.

Global/system fonts are managed by the GlobalFontManager, which is
a new class that also inherits from the base class FontManagerBase,
replacing the old "FontManager" class.

A maximum of 128 user fonts may be loaded, and memory fonts
may not exceed 20MB.

There's also an overloaded version of LoadFont that accepts
an area_id and loads the font from memory. A size and offset may
optionally be provided to allow for an area that contains more
than just a font.

Change-Id: I6add42bdf0c0cefc0e2e2a4984fd848c3e7269e5
Reviewed-on: https://review.haiku-os.org/c/haiku/+/4790
Tested-by: Commit checker robot <no-reply+buildbot@haiku-os.org>
Reviewed-by: Adrien Destugues <pulkomandy@pulkomandy.tk>
2022-12-17 12:32:09 +00:00

409 lines
9.1 KiB
C++
Raw Blame History

/*
* Copyright 2005-2016, Haiku, Inc. All rights reserved.
* Distributed under the terms of the MIT License.
*/
#ifndef _FONT_H_
#define _FONT_H_
#include <SupportDefs.h>
#include <InterfaceDefs.h>
class BPoint;
#define B_FONT_FAMILY_LENGTH 63
#define B_FONT_STYLE_LENGTH 63
typedef char font_family[B_FONT_FAMILY_LENGTH + 1];
typedef char font_style[B_FONT_STYLE_LENGTH + 1];
// font spacing
enum {
B_CHAR_SPACING = 0,
B_STRING_SPACING = 1,
B_BITMAP_SPACING = 2,
B_FIXED_SPACING = 3
};
enum font_direction {
B_FONT_LEFT_TO_RIGHT = 0,
B_FONT_RIGHT_TO_LEFT = 1
};
// font flags
enum {
B_DISABLE_ANTIALIASING = 0x00000001,
B_FORCE_ANTIALIASING = 0x00000002
};
// truncation modes
enum {
B_NO_TRUNCATION = ~0U,
B_TRUNCATE_END = 0,
B_TRUNCATE_BEGINNING = 1,
B_TRUNCATE_MIDDLE = 2,
B_TRUNCATE_SMART = 3
};
// font encodings
enum {
B_UNICODE_UTF8 = 0,
B_ISO_8859_1 = 1,
B_ISO_8859_2 = 2,
B_ISO_8859_3 = 3,
B_ISO_8859_4 = 4,
B_ISO_8859_5 = 5,
B_ISO_8859_6 = 6,
B_ISO_8859_7 = 7,
B_ISO_8859_8 = 8,
B_ISO_8859_9 = 9,
B_ISO_8859_10 = 10,
B_MACINTOSH_ROMAN = 11
};
// flags for get_font_family() and get_font_style()
enum {
B_HAS_TUNED_FONT = 0x0001,
B_IS_FIXED = 0x0002
};
// font face flags
enum {
B_ITALIC_FACE = 0x0001,
B_UNDERSCORE_FACE = 0x0002,
B_NEGATIVE_FACE = 0x0004,
B_OUTLINED_FACE = 0x0008,
B_STRIKEOUT_FACE = 0x0010,
B_BOLD_FACE = 0x0020,
B_REGULAR_FACE = 0x0040,
// new in Haiku:
B_CONDENSED_FACE = 0x0080,
B_LIGHT_FACE = 0x0100,
B_HEAVY_FACE = 0x0200,
};
enum font_metric_mode {
B_SCREEN_METRIC = 0,
B_PRINTING_METRIC = 1
};
enum font_file_format {
B_TRUETYPE_WINDOWS = 0,
B_POSTSCRIPT_TYPE1_WINDOWS = 1
};
class unicode_block {
public:
inline unicode_block();
inline unicode_block(uint64 block2, uint64 block1);
inline bool Includes(const unicode_block& block) const;
inline unicode_block operator&(const unicode_block& block) const;
inline unicode_block operator|(const unicode_block& block) const;
inline unicode_block& operator=(const unicode_block& block);
inline bool operator==(const unicode_block& block) const;
inline bool operator!=(const unicode_block& block) const;
private:
uint64 fData[2];
};
struct unicode_block_range {
uint32 start;
uint32 end;
const unicode_block& block;
uint32 Count() const { return end + 1 - start; }
};
struct edge_info {
float left;
float right;
};
struct font_height {
float ascent;
float descent;
float leading;
};
struct escapement_delta {
float nonspace;
float space;
};
struct font_cache_info {
int32 sheared_font_penalty;
int32 rotated_font_penalty;
float oversize_threshold;
int32 oversize_penalty;
int32 cache_size;
float spacing_size_threshold;
};
struct tuned_font_info {
float size;
float shear;
float rotation;
uint32 flags;
uint16 face;
};
class BShape;
class BString;
class BFontPrivate;
class BFont {
public:
BFont();
BFont(const BFont& font);
BFont(const BFont* font);
status_t SetFamilyAndStyle(const font_family family,
const font_style style);
void SetFamilyAndStyle(uint32 code);
status_t SetFamilyAndFace(const font_family family,
uint16 face);
void SetSize(float size);
void SetShear(float shear);
void SetRotation(float rotation);
void SetFalseBoldWidth(float width);
void SetSpacing(uint8 spacing);
void SetEncoding(uint8 encoding);
void SetFace(uint16 face);
void SetFlags(uint32 flags);
void GetFamilyAndStyle(font_family* family,
font_style* style) const;
uint32 FamilyAndStyle() const;
float Size() const;
float Shear() const;
float Rotation() const;
float FalseBoldWidth() const;
uint8 Spacing() const;
uint8 Encoding() const;
uint16 Face() const;
uint32 Flags() const;
font_direction Direction() const;
bool IsFixed() const;
bool IsFullAndHalfFixed() const;
BRect BoundingBox() const;
unicode_block Blocks() const;
bool IncludesBlock(uint32 start, uint32 end) const;
font_file_format FileFormat() const;
int32 CountTuned() const;
void GetTunedInfo(int32 index,
tuned_font_info* info) const;
void TruncateString(BString* inOut, uint32 mode,
float width) const;
void GetTruncatedStrings(const char* stringArray[],
int32 numStrings, uint32 mode, float width,
BString resultArray[]) const;
void GetTruncatedStrings(const char* stringArray[],
int32 numStrings, uint32 mode,
float width, char* resultArray[]) const;
float StringWidth(const char* string) const;
float StringWidth(const char* string,
int32 length) const;
void GetStringWidths(const char* stringArray[],
const int32 lengthArray[],
int32 numStrings,
float widthArray[]) const;
void GetEscapements(const char charArray[],
int32 numChars,
float escapementArray[]) const;
void GetEscapements(const char charArray[],
int32 numChars, escapement_delta* delta,
float escapementArray[]) const;
void GetEscapements(const char charArray[],
int32 numChars, escapement_delta* delta,
BPoint escapementArray[]) const;
void GetEscapements(const char charArray[],
int32 numChars, escapement_delta* delta,
BPoint escapementArray[],
BPoint offsetArray[]) const;
void GetEdges(const char charArray[],
int32 numBytes,
edge_info edgeArray[]) const;
void GetHeight(font_height* height) const;
void GetBoundingBoxesAsGlyphs(
const char charArray[], int32 numChars,
font_metric_mode mode,
BRect boundingBoxArray[]) const;
void GetBoundingBoxesAsString(
const char charArray[], int32 numChars,
font_metric_mode mode,
escapement_delta* delta,
BRect boundingBoxArray[]) const;
void GetBoundingBoxesForStrings(
const char* stringArray[],
int32 numStrings, font_metric_mode mode,
escapement_delta deltas[],
BRect boundingBoxArray[]) const;
void GetGlyphShapes(const char charArray[],
int32 numChars,
BShape* glyphShapeArray[]) const;
void GetHasGlyphs(const char charArray[],
int32 numChars,
bool hasArray[]) const;
BFont& operator=(const BFont& font);
bool operator==(const BFont& font) const;
bool operator!=(const BFont& font) const;
void PrintToStream() const;
status_t LoadFont(const char* path);
status_t LoadFont(const area_id fontAreaID,
uint32 size = 0, uint32 offset = 0);
status_t UnloadFont();
private:
friend void _init_global_fonts_();
void _GetExtraFlags() const;
void _GetBoundingBoxes(const char charArray[],
int32 numChars, font_metric_mode mode,
bool string_escapement,
escapement_delta* delta,
BRect boundingBoxArray[],
bool asString) const;
private:
uint16 fFamilyID;
uint16 fStyleID;
float fSize;
float fShear;
float fRotation;
float fFalseBoldWidth;
uint8 fSpacing;
uint8 fEncoding;
uint16 fFace;
uint32 fFlags;
mutable font_height fHeight;
mutable uint32 fExtraFlags;
uint32 _reserved[1];
};
// #pragma mark - BFont related declarations
extern const BFont* be_plain_font;
extern const BFont* be_bold_font;
extern const BFont* be_fixed_font;
int32 count_font_families(void);
status_t get_font_family(int32 index, font_family* name,
uint32* flags = NULL);
int32 count_font_styles(font_family name);
status_t get_font_style(font_family family, int32 index, font_style* name,
uint32* flags = NULL);
status_t get_font_style(font_family family, int32 index, font_style* name,
uint16* face, uint32* flags = NULL);
bool update_font_families(bool checkOnly);
// #pragma mark - unicode_block inlines
unicode_block::unicode_block()
{
fData[0] = fData[1] = 0LL;
}
unicode_block::unicode_block(uint64 block2, uint64 block1)
{
fData[0] = block1;
fData[1] = block2;
}
bool
unicode_block::Includes(const unicode_block& block) const
{
return (fData[0] & block.fData[0]) == block.fData[0]
&& (fData[1] & block.fData[1]) == block.fData[1];
}
unicode_block
unicode_block::operator&(const unicode_block& block) const
{
unicode_block result;
result.fData[0] = fData[0] & block.fData[0];
result.fData[1] = fData[1] & block.fData[1];
return result;
}
unicode_block
unicode_block::operator|(const unicode_block& block) const
{
unicode_block result;
result.fData[0] = fData[0] | block.fData[0];
result.fData[1] = fData[1] | block.fData[1];
return result;
}
unicode_block&
unicode_block::operator=(const unicode_block& block)
{
fData[0] = block.fData[0];
fData[1] = block.fData[1];
return *this;
}
bool
unicode_block::operator==(const unicode_block& block) const
{
return fData[0] == block.fData[0] && fData[1] == block.fData[1];
}
bool
unicode_block::operator!=(const unicode_block& block) const
{
return fData[0] != block.fData[0] || fData[1] != block.fData[1];
}
#endif // _FONT_H_
Reference in New Issue View Git Blame Copy Permalink