1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
/*
* Copyright 2011 Google Inc.
*
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*/
#ifndef SkTypefaceCache_DEFINED
#define SkTypefaceCache_DEFINED
#include "SkTypeface.h"
#include "SkTDArray.h"
/* TODO
* Provide std way to cache name+requestedStyle aliases to the same typeface.
*
* The current mechanism ends up create a diff typeface for each one, even if
* they map to the same internal obj (e.g. CTFontRef on the mac)
*/
class SkTypefaceCache {
public:
/**
* Callback for FindByProc. Returns true if the given typeface is a match
* for the given context. The passed typeface is owned by the cache and is
* not additionally ref()ed. The typeface may be in the disposed state.
*/
typedef bool (*FindProc)(SkTypeface*, SkTypeface::Style, void* context);
/**
* Helper: returns a unique fontID to pass to the constructor of
* your subclass of SkTypeface
*/
static SkFontID NewFontID();
/**
* Add a typeface to the cache. This ref()s the typeface, so that the
* cache is also an owner. Later, if we need to purge the cache, typefaces
* whose refcnt is 1 (meaning only the cache is an owner) will be
* unref()ed.
*/
static void Add(SkTypeface*,
SkTypeface::Style requested,
bool strong = true);
/**
* Search the cache for a typeface with the specified fontID (uniqueID).
* If one is found, return it (its reference count is unmodified). If none
* is found, return NULL. The reference count is unmodified as it is
* assumed that the stack will contain a ref to the typeface.
*/
static SkTypeface* FindByID(SkFontID fontID);
/**
* Iterate through the cache, calling proc(typeface, ctx) with each
* typeface. If proc returns true, then we return that typeface (this
* ref()s the typeface). If it never returns true, we return NULL.
*/
static SkTypeface* FindByProcAndRef(FindProc proc, void* ctx);
/**
* This will unref all of the typefaces in the cache for which the cache
* is the only owner. Normally this is handled automatically as needed.
* This function is exposed for clients that explicitly want to purge the
* cache (e.g. to look for leaks).
*/
static void PurgeAll();
/**
* Debugging only: dumps the status of the typefaces in the cache
*/
static void Dump();
private:
static SkTypefaceCache& Get();
void add(SkTypeface*, SkTypeface::Style requested, bool strong = true);
SkTypeface* findByID(SkFontID findID) const;
SkTypeface* findByProcAndRef(FindProc proc, void* ctx) const;
void purge(int count);
void purgeAll();
struct Rec {
SkTypeface* fFace;
bool fStrong;
SkTypeface::Style fRequestedStyle;
};
SkTDArray<Rec> fArray;
};
#endif
|
