1 // Copyright 2014 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #include "content/public/common/dwrite_font_platform_win.h"
12 #include <wrl/implements.h>
13 #include <wrl/wrappers/corewrappers.h>
15 #include "base/command_line.h"
16 #include "base/debug/alias.h"
17 #include "base/debug/crash_logging.h"
18 #include "base/files/file_enumerator.h"
19 #include "base/files/file_path.h"
20 #include "base/files/file_util.h"
21 #include "base/files/memory_mapped_file.h"
22 #include "base/memory/scoped_ptr.h"
23 #include "base/memory/scoped_vector.h"
24 #include "base/memory/shared_memory.h"
25 #include "base/metrics/histogram.h"
26 #include "base/path_service.h"
27 #include "base/process/process_handle.h"
28 #include "base/stl_util.h"
29 #include "base/strings/string_number_conversions.h"
30 #include "base/strings/utf_string_conversions.h"
31 #include "base/synchronization/lock.h"
32 #include "base/time/time.h"
33 #include "base/win/registry.h"
34 #include "base/win/scoped_comptr.h"
35 #include "content/public/common/content_switches.h"
39 // Font Cache implementation short story:
40 // Due to our sandboxing restrictions, we cannot connect to Windows font cache
41 // service from Renderer and need to use DirectWrite isolated font loading
43 // DirectWrite needs to be initialized before any of the API could be used.
44 // During initialization DirectWrite loads all font files and populates
45 // internal cache, we refer this phase as enumeration and we are trying
46 // to optimize this phase in our cache approach. Using cache during
47 // initialization will help improve on startup latency in each renderer
49 // During enumeration DirectWrite reads various fragments from .ttf/.ttc
50 // font files. Our assumption is that these fragments are being read to
51 // cache information such as font families, supported sizes etc.
52 // For reading fragments DirectWrite calls ReadFragment of our FontFileStream
53 // implementation with parameters start_offset and length. We cache these
54 // parameters along with associated data chunk.
55 // Here is small example of how segments are read
56 // start_offset: 0, length: 16
57 // start_offset: 0, length: 12
58 // start_offset: 0, length: 117
59 // For better cache management we collapse segments if they overlap or are
62 namespace mswr
= Microsoft::WRL
;
64 const char kFontKeyName
[] = "font_key_name";
66 // We use this value to determine whether to cache file fragments
67 // or not. In our trials we observed that for some font files
68 // direct write ends up reading almost entire file during enumeration
69 // phase. If we don't use this percentile formula we will end up
70 // increasing significant cache size by caching entire file contents
71 // for some of the font files.
72 const double kMaxPercentileOfFontFileSizeToCache
= 0.6;
74 // With current implementation we map entire shared section into memory during
75 // renderer startup. This causes increase in working set of Chrome. As first
76 // step we want to see if caching is really improving any performance for our
77 // users, so we are putting arbitrary limit on cache file size. There are
78 // multiple ways we can tune our working size, like mapping only required part
79 // of section at any given time.
80 const double kArbitraryCacheFileSizeLimit
= (30 * 1024 * 1024);
82 // We have chosen current font file length arbitrarily. In our logic
83 // if we don't find file we are looking for in cache we end up loading
84 // that file directly from system fonts folder.
85 const unsigned int kMaxFontFileNameLength
= 34;
87 const DWORD kCacheFileVersion
= 103;
88 const DWORD kFileSignature
= 0x4D4F5243; // CROM
89 const DWORD kMagicCompletionSignature
= 0x454E4F44; // DONE
91 const DWORD kUndefinedDWORDS
= 36;
93 // Make sure that all structure sizes align with 8 byte boundary otherwise
94 // dr. memory test may complain.
96 // Cache file header, includes signature, completion bits and version.
97 struct CacheFileHeader
{
99 file_signature
= kFileSignature
;
100 magic_completion_signature
= 0;
101 version
= kCacheFileVersion
;
102 ::ZeroMemory(undefined
, sizeof(undefined
));
105 DWORD file_signature
;
106 DWORD magic_completion_signature
;
108 BYTE undefined
[kUndefinedDWORDS
];
111 // Entry for a particular font file within this cache.
112 struct CacheFileEntry
{
116 ::ZeroMemory(file_name
, sizeof(file_name
));
121 wchar_t file_name
[kMaxFontFileNameLength
];
124 // Offsets or data chunks that are cached for particular font file.
125 struct CacheFileOffsetEntry
{
126 CacheFileOffsetEntry() {
133 /* BYTE blob_[]; // Place holder for the blob that follows. */
137 bool ValidateFontCacheHeader(CacheFileHeader
* header
) {
138 return (header
->file_signature
== kFileSignature
&&
139 header
->magic_completion_signature
== kMagicCompletionSignature
&&
140 header
->version
== kCacheFileVersion
);
143 class FontCacheWriter
;
145 // This class implements main interface required for loading custom font
146 // collection as specified by DirectWrite. We also use this class for storing
147 // some state information as this is one of the centralized entity.
148 class FontCollectionLoader
149 : public mswr::RuntimeClass
<mswr::RuntimeClassFlags
<mswr::ClassicCom
>,
150 IDWriteFontCollectionLoader
> {
152 FontCollectionLoader()
153 : in_collection_building_mode_(false),
154 create_static_cache_(false) {}
156 virtual ~FontCollectionLoader();
158 HRESULT
RuntimeClassInitialize() {
162 // IDWriteFontCollectionLoader methods.
163 virtual HRESULT STDMETHODCALLTYPE
164 CreateEnumeratorFromKey(
165 IDWriteFactory
* factory
,
168 IDWriteFontFileEnumerator
** file_enumerator
) override
;
170 // Does all the initialization for required loading fonts from registry.
171 static HRESULT
Initialize(IDWriteFactory
* factory
);
173 // Returns font cache map size.
174 UINT32
GetFontMapSize();
176 // Returns font name string when given font index.
177 base::string16
GetFontNameFromKey(UINT32 idx
);
179 // Loads internal structure with fonts from registry.
180 bool LoadFontListFromRegistry();
182 // Loads restricted web safe fonts as fallback method to registry fonts.
183 bool LoadRestrictedFontList();
185 // Puts class in collection building mode. In collection building mode
186 // we use static cache if it is available as a look aside buffer.
187 void EnableCollectionBuildingMode(bool enable
);
189 // Returns current state of collection building.
190 bool InCollectionBuildingMode();
192 // Loads static cache file.
193 bool LoadCacheFile();
195 // Puts class in static cache creating mode. In this mode we record all
196 // direct write requests and store chunks of font data.
197 void EnterStaticCacheMode(const WCHAR
* file_name
);
199 // Gets out of static cache building mode.
200 void LeaveStaticCacheMode();
202 // Returns if class is currently in static cache building mode.
203 bool IsBuildStaticCacheMode();
205 // Validates cache file for consistency.
206 bool ValidateCacheFile(base::File
* file
);
209 // Structure to represent each chunk within font file that we load in memory.
210 struct CacheTableOffsetEntry
{
213 BYTE
* inside_file_ptr
;
216 typedef std::vector
<CacheTableOffsetEntry
> OffsetVector
;
218 // Structure representing each font entry with cache.
219 struct CacheTableEntry
{
221 OffsetVector offset_entries
;
225 // Returns whether file we have particular font entry within cache or not.
226 bool IsFileCached(UINT32 font_key
);
227 // Returns cache fragment corresponding to specific font key.
228 void* GetCachedFragment(UINT32 font_key
, UINT64 start_offset
, UINT64 length
);
229 // Returns actual font file size at the time of caching.
230 UINT64
GetCachedFileSize(UINT32 font_key
);
232 // Returns instance of font cache writer. This class manages actual font
234 FontCacheWriter
* GetFontCacheWriter();
237 // Functions validates and loads cache into internal map.
238 bool ValidateAndLoadCacheMap();
240 mswr::ComPtr
<IDWriteFontFileLoader
> file_loader_
;
242 std::vector
<base::string16
> reg_fonts_
;
243 bool in_collection_building_mode_
;
244 bool create_static_cache_
;
245 scoped_ptr
<base::SharedMemory
> cache_
;
246 scoped_ptr
<FontCacheWriter
> cache_writer_
;
248 typedef std::map
<base::string16
, CacheTableEntry
*> CacheMap
;
251 DISALLOW_COPY_AND_ASSIGN(FontCollectionLoader
);
254 mswr::ComPtr
<FontCollectionLoader
> g_font_loader
;
255 base::win::ScopedHandle g_shared_font_cache
;
257 // Class responsible for handling font cache file format details as well as
258 // tracking various cache region requests by direct write.
259 class FontCacheWriter
{
262 : cookie_counter_(0),
263 count_font_entries_ignored_(0) {
267 if (static_cache_
.get()) {
268 static_cache_
->Close();
273 // Holds data related to individual region as requested by direct write.
278 /* BYTE blob_[]; // Place holder for the blob that follows. */
281 // Function to create static font cache file.
282 bool Create(const wchar_t* file_name
) {
283 static_cache_
.reset(new base::File(base::FilePath(file_name
),
284 base::File::FLAG_OPEN_ALWAYS
| base::File::FLAG_WRITE
|
285 base::File::FLAG_EXCLUSIVE_WRITE
));
286 if (!static_cache_
->IsValid()) {
287 static_cache_
.reset();
290 CacheFileHeader header
;
292 // At offset 0 write cache version
293 static_cache_
->Write(0,
294 reinterpret_cast<const char*>(&header
),
297 static_cache_
->Flush();
301 // Closes static font cache file. Also writes completion signature to mark
302 // it as completely written.
304 if (static_cache_
.get()) {
305 CacheFileHeader header
;
306 header
.magic_completion_signature
= kMagicCompletionSignature
;
307 // At offset 0 write cache version
308 int bytes_written
= static_cache_
->Write(0,
309 reinterpret_cast<const char*>(&header
),
311 DCHECK_NE(bytes_written
, -1);
313 UMA_HISTOGRAM_MEMORY_KB("DirectWrite.Fonts.BuildCache.File.Size",
314 static_cache_
->GetLength() / 1024);
316 UMA_HISTOGRAM_COUNTS("DirectWrite.Fonts.BuildCache.Ignored",
317 count_font_entries_ignored_
);
319 static_cache_
->Close();
320 static_cache_
.reset(NULL
);
325 typedef std::vector
<CacheRegion
> RegionVector
;
327 // Structure to track various regions requested by direct write for particular
329 struct FontEntryInternal
{
330 FontEntryInternal(const wchar_t* name
, UINT64 size
)
335 base::string16 file_name
;
337 RegionVector regions
;
341 // Starts up new font entry to be tracked, returns cookie to identify this
343 UINT
NewFontEntry(const wchar_t* file_name
, UINT64 file_size
) {
344 base::AutoLock
lock(lock_
);
345 UINT old_counter
= cookie_counter_
;
346 FontEntryInternal
* font_entry
= new FontEntryInternal(file_name
, file_size
);
347 cookie_map_
[cookie_counter_
].reset(font_entry
);
352 // AddRegion function lets caller add various regions to be cached for
353 // particular font file. Once enumerating that particular font file is done
354 // (based on uniquely identifying cookie) changes could be committed using
356 bool AddRegion(UINT64 cookie
, UINT64 start
, UINT64 length
, const BYTE
* ptr
) {
357 base::AutoLock
lock(lock_
);
358 if (cookie_map_
.find(cookie
) == cookie_map_
.end())
360 RegionVector
& regions
= cookie_map_
[cookie
].get()->regions
;
362 region
.start_offset
= start
;
363 region
.length
= length
;
365 regions
.push_back(region
);
369 // Function which commits after merging all collected regions into cache file.
370 bool CommitFontEntry(UINT cookie
) {
371 base::AutoLock
lock(lock_
);
372 if (cookie_map_
.find(cookie
) == cookie_map_
.end())
375 // We will skip writing entries beyond allowed limit. Following condition
376 // doesn't enforce hard file size. We need to write complete font entry.
377 int64 length
= static_cache_
->GetLength();
378 if (length
== -1 || length
>= kArbitraryCacheFileSizeLimit
) {
379 count_font_entries_ignored_
++;
383 FontEntryInternal
* font_entry
= cookie_map_
[cookie
].get();
384 RegionVector
& regions
= font_entry
->regions
;
385 std::sort(regions
.begin(), regions
.end(), SortCacheRegions
);
387 // At this point, we have collected all regions to be cached. These regions
388 // are tuples of start, length, data for particular data segment.
389 // These tuples can overlap.
390 // e.g. (0, 12, data), (0, 117, data), (21, 314, data), (335, 15, data)
391 // In this case as you can see first three segments overlap and
392 // 4th is adjacent. If we cache them individually then we will end up
393 // caching duplicate data, so we merge these segments together to find
394 // superset for the cache. In above example our algorithm should
395 // produce (cache) single segment starting at offset 0 with length 350.
396 RegionVector merged_regions
;
397 RegionVector::iterator iter
;
399 for (iter
= regions
.begin(); iter
!= regions
.end(); iter
++) {
400 if (iter
== regions
.begin()) {
401 merged_regions
.push_back(*iter
);
404 CacheRegion
& base_region
= merged_regions
[idx
];
405 if (IsOverlap(&base_region
, &(*iter
))) {
406 UINT64 end1
= base_region
.start_offset
+ base_region
.length
;
407 UINT64 end2
= iter
->start_offset
+ iter
->length
;
408 if (base_region
.start_offset
> iter
->start_offset
) {
409 base_region
.start_offset
= iter
->start_offset
;
410 base_region
.ptr
= iter
->ptr
;
412 base_region
.length
= std::max(end1
, end2
) - base_region
.start_offset
;
414 merged_regions
.push_back(*iter
);
419 UINT64 total_merged_cache_in_bytes
= 0;
420 for (iter
= merged_regions
.begin(); iter
!= merged_regions
.end(); iter
++) {
421 total_merged_cache_in_bytes
+= iter
->length
;
424 // We want to adjust following parameter based on experiments. But general
425 // logic here is that if we are going to end up caching most of the contents
426 // for a file (e.g. simsunb.ttf > 90%) then we should avoid caching that
428 double percentile
= static_cast<double>(total_merged_cache_in_bytes
) /
429 font_entry
->file_size
;
430 if (percentile
> kMaxPercentileOfFontFileSizeToCache
) {
431 count_font_entries_ignored_
++;
435 CacheFileEntry entry
;
436 wcsncpy_s(entry
.file_name
, kMaxFontFileNameLength
,
437 font_entry
->file_name
.c_str(), _TRUNCATE
);
438 entry
.file_size
= font_entry
->file_size
;
439 entry
.entry_count
= merged_regions
.size();
440 static_cache_
->WriteAtCurrentPos(
441 reinterpret_cast<const char*>(&entry
),
443 for (iter
= merged_regions
.begin(); iter
!= merged_regions
.end(); iter
++) {
444 CacheFileOffsetEntry offset_entry
;
445 offset_entry
.start_offset
= iter
->start_offset
;
446 offset_entry
.length
= iter
->length
;
447 static_cache_
->WriteAtCurrentPos(
448 reinterpret_cast<const char*>(&offset_entry
),
449 sizeof(offset_entry
));
450 static_cache_
->WriteAtCurrentPos(
451 reinterpret_cast<const char*>(iter
->ptr
),
458 // This is the count of font entries that we reject based on size to be
460 unsigned int count_font_entries_ignored_
;
461 scoped_ptr
<base::File
> static_cache_
;
462 std::map
<UINT
, scoped_ptr
<FontEntryInternal
>> cookie_map_
;
463 UINT cookie_counter_
;
465 // Lock is required to protect internal data structures and access to file,
466 // According to MSDN documentation on ReadFileFragment and based on our
467 // experiments so far, there is possibility of ReadFileFragment getting called
468 // from multiple threads.
471 // Function checks if two regions overlap or are adjacent.
472 bool IsOverlap(CacheRegion
* region1
, CacheRegion
* region2
) {
474 !((region1
->start_offset
+ region1
->length
) < region2
->start_offset
||
475 region1
->start_offset
> (region2
->start_offset
+ region2
->length
));
478 // Function to sort cached regions.
479 static bool SortCacheRegions(const CacheRegion
& region1
,
480 const CacheRegion
& region2
) {
482 region1
.start_offset
== region2
.start_offset
?
483 region1
.length
< region2
.length
:
484 region1
.start_offset
< region2
.start_offset
;
487 DISALLOW_COPY_AND_ASSIGN(FontCacheWriter
);
490 // Class implements IDWriteFontFileStream interface as required by direct write.
492 : public mswr::RuntimeClass
<mswr::RuntimeClassFlags
<mswr::ClassicCom
>,
493 IDWriteFontFileStream
> {
495 // IDWriteFontFileStream methods.
496 virtual HRESULT STDMETHODCALLTYPE
ReadFileFragment(
497 void const** fragment_start
,
499 UINT64 fragment_size
,
500 void** context
) override
{
502 *fragment_start
= g_font_loader
->GetCachedFragment(font_key_
,
505 if (*fragment_start
== NULL
) {
509 return *fragment_start
!= NULL
? S_OK
: E_FAIL
;
511 if (!memory_
.get() || !memory_
->IsValid() ||
512 file_offset
>= memory_
->length() ||
513 (file_offset
+ fragment_size
) > memory_
->length())
516 *fragment_start
= static_cast<BYTE
const*>(memory_
->data()) +
517 static_cast<size_t>(file_offset
);
519 if (g_font_loader
->IsBuildStaticCacheMode()) {
520 FontCacheWriter
* cache_writer
= g_font_loader
->GetFontCacheWriter();
521 cache_writer
->AddRegion(writer_cookie_
,
524 static_cast<const BYTE
*>(*fragment_start
));
529 virtual void STDMETHODCALLTYPE
ReleaseFileFragment(void* context
) override
{}
531 virtual HRESULT STDMETHODCALLTYPE
GetFileSize(UINT64
* file_size
) override
{
533 *file_size
= g_font_loader
->GetCachedFileSize(font_key_
);
537 if (!memory_
.get() || !memory_
->IsValid())
540 *file_size
= memory_
->length();
544 virtual HRESULT STDMETHODCALLTYPE
GetLastWriteTime(
545 UINT64
* last_write_time
) override
{
547 *last_write_time
= 0;
551 if (!memory_
.get() || !memory_
->IsValid())
554 // According to MSDN article http://goo.gl/rrSYzi the "last modified time"
555 // is used by DirectWrite font selection algorithms to determine whether
556 // one font resource is more up to date than another one.
557 // So by returning 0 we are assuming that it will treat all fonts to be
558 // equally up to date.
559 // TODO(shrikant): We should further investigate this.
560 *last_write_time
= 0;
564 FontFileStream::FontFileStream() : font_key_(0), cached_data_(false) {
567 HRESULT
RuntimeClassInitialize(UINT32 font_key
) {
568 if (g_font_loader
->InCollectionBuildingMode() &&
569 g_font_loader
->IsFileCached(font_key
)) {
571 font_key_
= font_key
;
576 PathService::Get(base::DIR_WINDOWS_FONTS
, &path
);
577 base::string16
font_key_name(g_font_loader
->GetFontNameFromKey(font_key
));
578 path
= path
.Append(font_key_name
.c_str());
579 memory_
.reset(new base::MemoryMappedFile());
581 // Put some debug information on stack.
582 WCHAR font_name
[MAX_PATH
];
583 path
.value().copy(font_name
, arraysize(font_name
));
584 base::debug::Alias(font_name
);
586 if (!memory_
->Initialize(path
)) {
591 font_key_
= font_key
;
593 base::debug::SetCrashKeyValue(kFontKeyName
,
594 base::WideToUTF8(font_key_name
));
596 if (g_font_loader
->IsBuildStaticCacheMode()) {
597 FontCacheWriter
* cache_writer
= g_font_loader
->GetFontCacheWriter();
598 writer_cookie_
= cache_writer
->NewFontEntry(font_key_name
.c_str(),
604 virtual ~FontFileStream() {
605 if (g_font_loader
->IsBuildStaticCacheMode()) {
606 FontCacheWriter
* cache_writer
= g_font_loader
->GetFontCacheWriter();
607 cache_writer
->CommitFontEntry(writer_cookie_
);
613 scoped_ptr
<base::MemoryMappedFile
> memory_
;
617 DISALLOW_COPY_AND_ASSIGN(FontFileStream
);
620 // Implements IDWriteFontFileLoader as required by FontFileLoader.
622 : public mswr::RuntimeClass
<mswr::RuntimeClassFlags
<mswr::ClassicCom
>,
623 IDWriteFontFileLoader
> {
625 // IDWriteFontFileLoader methods.
626 virtual HRESULT STDMETHODCALLTYPE
627 CreateStreamFromKey(void const* ref_key
,
629 IDWriteFontFileStream
** stream
) override
{
630 if (ref_key_size
!= sizeof(UINT32
))
633 UINT32 font_key
= *static_cast<const UINT32
*>(ref_key
);
634 mswr::ComPtr
<FontFileStream
> font_stream
;
635 HRESULT hr
= mswr::MakeAndInitialize
<FontFileStream
>(&font_stream
,
638 *stream
= font_stream
.Detach();
645 virtual ~FontFileLoader() {}
648 DISALLOW_COPY_AND_ASSIGN(FontFileLoader
);
651 // Implements IDWriteFontFileEnumerator as required by direct write.
652 class FontFileEnumerator
653 : public mswr::RuntimeClass
<mswr::RuntimeClassFlags
<mswr::ClassicCom
>,
654 IDWriteFontFileEnumerator
> {
656 // IDWriteFontFileEnumerator methods.
657 virtual HRESULT STDMETHODCALLTYPE
MoveNext(BOOL
* has_current_file
) override
{
658 *has_current_file
= FALSE
;
661 current_file_
.ReleaseAndGetAddressOf();
663 if (font_idx_
< g_font_loader
->GetFontMapSize()) {
665 factory_
->CreateCustomFontFileReference(&font_idx_
,
668 current_file_
.GetAddressOf());
669 DCHECK(SUCCEEDED(hr
));
670 *has_current_file
= TRUE
;
676 virtual HRESULT STDMETHODCALLTYPE
677 GetCurrentFontFile(IDWriteFontFile
** font_file
) override
{
678 if (!current_file_
) {
683 *font_file
= current_file_
.Detach();
687 FontFileEnumerator(const void* keys
,
689 IDWriteFactory
* factory
,
690 IDWriteFontFileLoader
* file_loader
)
691 : factory_(factory
), file_loader_(file_loader
), font_idx_(0) {}
693 virtual ~FontFileEnumerator() {}
695 mswr::ComPtr
<IDWriteFactory
> factory_
;
696 mswr::ComPtr
<IDWriteFontFile
> current_file_
;
697 mswr::ComPtr
<IDWriteFontFileLoader
> file_loader_
;
701 DISALLOW_COPY_AND_ASSIGN(FontFileEnumerator
);
704 // IDWriteFontCollectionLoader methods.
705 HRESULT STDMETHODCALLTYPE
FontCollectionLoader::CreateEnumeratorFromKey(
706 IDWriteFactory
* factory
,
709 IDWriteFontFileEnumerator
** file_enumerator
) {
710 *file_enumerator
= mswr::Make
<FontFileEnumerator
>(
711 key
, key_size
, factory
, file_loader_
.Get()).Detach();
716 HRESULT
FontCollectionLoader::Initialize(IDWriteFactory
* factory
) {
717 DCHECK(g_font_loader
== NULL
);
720 result
= mswr::MakeAndInitialize
<FontCollectionLoader
>(&g_font_loader
);
721 if (FAILED(result
) || !g_font_loader
) {
726 CHECK(g_font_loader
->LoadFontListFromRegistry());
728 g_font_loader
->file_loader_
= mswr::Make
<FontFileLoader
>().Detach();
730 factory
->RegisterFontFileLoader(g_font_loader
->file_loader_
.Get());
731 factory
->RegisterFontCollectionLoader(g_font_loader
.Get());
736 FontCollectionLoader::~FontCollectionLoader() {
737 STLDeleteContainerPairSecondPointers(cache_map_
.begin(), cache_map_
.end());
740 UINT32
FontCollectionLoader::GetFontMapSize() {
741 return reg_fonts_
.size();
744 base::string16
FontCollectionLoader::GetFontNameFromKey(UINT32 idx
) {
745 DCHECK(idx
< reg_fonts_
.size());
746 return reg_fonts_
[idx
];
749 const base::FilePath::CharType
* kFontExtensionsToIgnore
[] {
750 FILE_PATH_LITERAL(".FON"), // Bitmap or vector
751 FILE_PATH_LITERAL(".PFM"), // Adobe Type 1
752 FILE_PATH_LITERAL(".PFB"), // Adobe Type 1
755 const wchar_t* kFontsToIgnore
[] = {
756 // "Gill Sans Ultra Bold" turns into an Ultra Bold weight "Gill Sans" in
757 // DirectWrite, but most users don't have any other weights. The regular
758 // weight font is named "Gill Sans MT", but that ends up in a different
759 // family with that name. On Mac, there's a "Gill Sans" with various weights,
760 // so CSS authors use { 'font-family': 'Gill Sans', 'Gill Sans MT', ... } and
761 // because of the DirectWrite family futzing, they end up with an Ultra Bold
762 // font, when they just wanted "Gill Sans". Mozilla implemented a more
763 // complicated hack where they effectively rename the Ultra Bold font to
764 // "Gill Sans MT Ultra Bold", but because the Ultra Bold font is so ugly
765 // anyway, we simply ignore it. See
766 // http://www.microsoft.com/typography/fonts/font.aspx?FMID=978 for a picture
767 // of the font, and the file name. We also ignore "Gill Sans Ultra Bold
773 bool FontCollectionLoader::LoadFontListFromRegistry() {
774 const wchar_t kFontsRegistry
[] =
775 L
"Software\\Microsoft\\Windows NT\\CurrentVersion\\Fonts";
776 CHECK(reg_fonts_
.empty());
777 base::win::RegKey regkey
;
778 if (regkey
.Open(HKEY_LOCAL_MACHINE
, kFontsRegistry
, KEY_READ
) !=
783 base::FilePath system_font_path
;
784 PathService::Get(base::DIR_WINDOWS_FONTS
, &system_font_path
);
787 base::string16 value
;
788 for (DWORD idx
= 0; idx
< regkey
.GetValueCount(); idx
++) {
789 if (regkey
.GetValueNameAt(idx
, &name
) == ERROR_SUCCESS
&&
790 regkey
.ReadValue(name
.c_str(), &value
) == ERROR_SUCCESS
) {
791 base::FilePath
path(value
.c_str());
792 // We need to check if file name is the only component that exists,
793 // we will ignore all other registry entries.
794 std::vector
<base::FilePath::StringType
> components
;
795 path
.GetComponents(&components
);
796 if (components
.size() == 1 ||
797 base::FilePath::CompareEqualIgnoreCase(system_font_path
.value(),
798 path
.DirName().value())) {
799 bool should_ignore
= false;
800 for (const auto& ignore
: kFontsToIgnore
) {
801 if (base::FilePath::CompareEqualIgnoreCase(path
.value(), ignore
)) {
802 should_ignore
= true;
806 // DirectWrite doesn't support bitmap/vector fonts and Adobe type 1
807 // fonts, we will ignore those font extensions.
808 // MSDN article: http://goo.gl/TfCOA
809 if (!should_ignore
) {
810 for (const auto& ignore
: kFontExtensionsToIgnore
) {
811 if (path
.MatchesExtension(ignore
)) {
812 should_ignore
= true;
819 reg_fonts_
.push_back(value
.c_str());
823 UMA_HISTOGRAM_COUNTS("DirectWrite.Fonts.Loaded", reg_fonts_
.size());
824 UMA_HISTOGRAM_COUNTS("DirectWrite.Fonts.Ignored",
825 regkey
.GetValueCount() - reg_fonts_
.size());
829 // This list is mainly based on prefs/prefs_tab_helper.cc kFontDefaults.
830 const wchar_t* kRestrictedFontSet
[] = {
831 // These are the "Web Safe" fonts.
832 L
"times.ttf", // IDS_STANDARD_FONT_FAMILY
833 L
"timesbd.ttf", // IDS_STANDARD_FONT_FAMILY
834 L
"timesbi.ttf", // IDS_STANDARD_FONT_FAMILY
835 L
"timesi.ttf", // IDS_STANDARD_FONT_FAMILY
836 L
"cour.ttf", // IDS_FIXED_FONT_FAMILY
837 L
"courbd.ttf", // IDS_FIXED_FONT_FAMILY
838 L
"courbi.ttf", // IDS_FIXED_FONT_FAMILY
839 L
"couri.ttf", // IDS_FIXED_FONT_FAMILY
840 L
"consola.ttf", // IDS_FIXED_FONT_FAMILY_ALT_WIN
841 L
"consolab.ttf", // IDS_FIXED_FONT_FAMILY_ALT_WIN
842 L
"consolai.ttf", // IDS_FIXED_FONT_FAMILY_ALT_WIN
843 L
"consolaz.ttf", // IDS_FIXED_FONT_FAMILY_ALT_WIN
844 L
"arial.ttf", // IDS_SANS_SERIF_FONT_FAMILY
845 L
"arialbd.ttf", // IDS_SANS_SERIF_FONT_FAMILY
846 L
"arialbi.ttf", // IDS_SANS_SERIF_FONT_FAMILY
847 L
"ariali.ttf", // IDS_SANS_SERIF_FONT_FAMILY
848 L
"comic.ttf", // IDS_CURSIVE_FONT_FAMILY
849 L
"comicbd.ttf", // IDS_CURSIVE_FONT_FAMILY
850 L
"comici.ttf", // IDS_CURSIVE_FONT_FAMILY
851 L
"comicz.ttf", // IDS_CURSIVE_FONT_FAMILY
852 L
"impact.ttf", // IDS_FANTASY_FONT_FAMILY
865 L
"segoeui.ttf", // IDS_PICTOGRAPH_FONT_FAMILY
866 L
"segoeuib.ttf", // IDS_PICTOGRAPH_FONT_FAMILY
867 L
"segoeuii.ttf", // IDS_PICTOGRAPH_FONT_FAMILY
868 L
"msgothic.ttc", // IDS_STANDARD_FONT_FAMILY_JAPANESE
869 L
"msmincho.ttc", // IDS_SERIF_FONT_FAMILY_JAPANESE
870 L
"gulim.ttc", // IDS_FIXED_FONT_FAMILY_KOREAN
871 L
"batang.ttc", // IDS_SERIF_FONT_FAMILY_KOREAN
872 L
"simsun.ttc", // IDS_STANDARD_FONT_FAMILY_SIMPLIFIED_HAN
873 L
"mingliu.ttc", // IDS_SERIF_FONT_FAMILY_TRADITIONAL_HAN
875 // These are from the Blink fallback list.
876 L
"david.ttf", // USCRIPT_HEBREW
877 L
"davidbd.ttf", // USCRIPT_HEBREW
878 L
"euphemia.ttf", // USCRIPT_CANADIAN_ABORIGINAL
879 L
"gautami.ttf", // USCRIPT_TELUGU
880 L
"gautamib.ttf", // USCRIPT_TELUGU
881 L
"latha.ttf", // USCRIPT_TAMIL
882 L
"lathab.ttf", // USCRIPT_TAMIL
883 L
"mangal.ttf", // USCRIPT_DEVANAGARI
884 L
"mangalb.ttf", // USCRIPT_DEVANAGARI
885 L
"monbaiti.ttf", // USCRIPT_MONGOLIAN
886 L
"mvboli.ttf", // USCRIPT_THAANA
887 L
"plantc.ttf", // USCRIPT_CHEROKEE
888 L
"raavi.ttf", // USCRIPT_GURMUKHI
889 L
"raavib.ttf", // USCRIPT_GURMUKHI
890 L
"shruti.ttf", // USCRIPT_GUJARATI
891 L
"shrutib.ttf", // USCRIPT_GUJARATI
892 L
"sylfaen.ttf", // USCRIPT_GEORGIAN and USCRIPT_ARMENIAN
893 L
"tahoma.ttf", // USCRIPT_ARABIC,
894 L
"tahomabd.ttf", // USCRIPT_ARABIC,
895 L
"tunga.ttf", // USCRIPT_KANNADA
896 L
"tungab.ttf", // USCRIPT_KANNADA
897 L
"vrinda.ttf", // USCRIPT_BENGALI
898 L
"vrindab.ttf", // USCRIPT_BENGALI
901 bool FontCollectionLoader::LoadRestrictedFontList() {
903 reg_fonts_
.assign(kRestrictedFontSet
,
904 kRestrictedFontSet
+ _countof(kRestrictedFontSet
));
908 void FontCollectionLoader::EnableCollectionBuildingMode(bool enable
) {
909 in_collection_building_mode_
= enable
;
912 bool FontCollectionLoader::InCollectionBuildingMode() {
913 return in_collection_building_mode_
;
916 bool FontCollectionLoader::IsFileCached(UINT32 font_key
) {
917 if (!cache_
.get() || cache_
->memory() == NULL
) {
920 CacheMap::iterator iter
= cache_map_
.find(
921 GetFontNameFromKey(font_key
).c_str());
922 return iter
!= cache_map_
.end();;
925 bool FontCollectionLoader::LoadCacheFile() {
926 if (!base::CommandLine::ForCurrentProcess()->HasSwitch(
927 switches::kFontCacheSharedMemSuffix
)) {
930 base::SharedMemory
* shared_mem
= new base::SharedMemory();
931 std::string
name(content::kFontCacheSharedSectionName
);
932 name
.append(base::CommandLine::ForCurrentProcess()->GetSwitchValueASCII(
933 switches::kFontCacheSharedMemSuffix
));
934 if (!shared_mem
->Open(name
.c_str(), true))
940 cache_
.reset(shared_mem
);
942 if (!ValidateAndLoadCacheMap()) {
950 void FontCollectionLoader::EnterStaticCacheMode(const WCHAR
* file_name
) {
951 cache_writer_
.reset(new FontCacheWriter());
952 if (cache_writer_
->Create(file_name
))
953 create_static_cache_
= true;
956 void FontCollectionLoader::LeaveStaticCacheMode() {
957 cache_writer_
->Close();
958 cache_writer_
.reset(NULL
);
959 create_static_cache_
= false;
962 bool FontCollectionLoader::IsBuildStaticCacheMode() {
963 return create_static_cache_
;
966 bool FontCollectionLoader::ValidateAndLoadCacheMap() {
967 BYTE
* mem_file_start
= static_cast<BYTE
*>(cache_
->memory());
968 BYTE
* mem_file_end
= mem_file_start
+ cache_
->mapped_size();
970 BYTE
* current_ptr
= mem_file_start
;
971 CacheFileHeader
* file_header
=
972 reinterpret_cast<CacheFileHeader
*>(current_ptr
);
973 if (!ValidateFontCacheHeader(file_header
))
976 current_ptr
= current_ptr
+ sizeof(CacheFileHeader
);
977 if (current_ptr
>= mem_file_end
)
980 while ((current_ptr
+ sizeof(CacheFileEntry
)) < mem_file_end
) {
981 CacheFileEntry
* entry
= reinterpret_cast<CacheFileEntry
*>(current_ptr
);
982 current_ptr
+= sizeof(CacheFileEntry
);
983 WCHAR file_name
[kMaxFontFileNameLength
];
985 kMaxFontFileNameLength
,
988 CacheTableEntry
* table_entry
= NULL
;
989 CacheMap::iterator iter
= cache_map_
.find(file_name
);
990 if (iter
== cache_map_
.end()) {
991 table_entry
= new CacheTableEntry();
992 cache_map_
[file_name
] = table_entry
;
994 table_entry
= iter
->second
;
996 table_entry
->file_size
= entry
->file_size
;
998 (current_ptr
+ sizeof(CacheFileOffsetEntry
)) < mem_file_end
&&
999 idx
< entry
->entry_count
;
1001 CacheFileOffsetEntry
* offset_entry
=
1002 reinterpret_cast<CacheFileOffsetEntry
*>(current_ptr
);
1003 CacheTableOffsetEntry table_offset_entry
;
1004 table_offset_entry
.start_offset
= offset_entry
->start_offset
;
1005 table_offset_entry
.length
= offset_entry
->length
;
1006 table_offset_entry
.inside_file_ptr
=
1007 current_ptr
+ sizeof(CacheFileOffsetEntry
);
1008 table_entry
->offset_entries
.push_back(table_offset_entry
);
1009 current_ptr
+= sizeof(CacheFileOffsetEntry
);
1010 current_ptr
+= offset_entry
->length
;
1017 void* FontCollectionLoader::GetCachedFragment(UINT32 font_key
,
1018 UINT64 start_offset
,
1020 UINT64 just_past_end
= start_offset
+ length
;
1021 CacheMap::iterator iter
= cache_map_
.find(
1022 GetFontNameFromKey(font_key
).c_str());
1023 if (iter
!= cache_map_
.end()) {
1024 CacheTableEntry
* entry
= iter
->second
;
1025 OffsetVector::iterator offset_iter
= entry
->offset_entries
.begin();
1026 while (offset_iter
!= entry
->offset_entries
.end()) {
1027 UINT64 available_just_past_end
=
1028 offset_iter
->start_offset
+ offset_iter
->length
;
1029 if (offset_iter
->start_offset
<= start_offset
&&
1030 just_past_end
<= available_just_past_end
) {
1031 return offset_iter
->inside_file_ptr
+
1032 (start_offset
- offset_iter
->start_offset
);
1040 UINT64
FontCollectionLoader::GetCachedFileSize(UINT32 font_key
) {
1041 CacheMap::iterator iter
= cache_map_
.find(
1042 GetFontNameFromKey(font_key
).c_str());
1043 if (iter
!= cache_map_
.end()) {
1044 return iter
->second
->file_size
;
1049 FontCacheWriter
* FontCollectionLoader::GetFontCacheWriter() {
1050 return cache_writer_
.get();
1057 const char kFontCacheSharedSectionName
[] = "ChromeDWriteFontCache";
1059 mswr::ComPtr
<IDWriteFontCollection
> g_font_collection
;
1061 IDWriteFontCollection
* GetCustomFontCollection(IDWriteFactory
* factory
) {
1062 if (g_font_collection
.Get() != NULL
)
1063 return g_font_collection
.Get();
1065 base::TimeTicks start_tick
= base::TimeTicks::Now();
1067 FontCollectionLoader::Initialize(factory
);
1069 bool cache_file_loaded
= g_font_loader
->LoadCacheFile();
1071 // Arbitrary threshold to stop loading enormous number of fonts. Usual
1072 // side effect of loading large number of fonts results in renderer getting
1073 // killed as it appears to hang.
1074 const UINT32 kMaxFontThreshold
= 1750;
1075 HRESULT hr
= E_FAIL
;
1076 if (cache_file_loaded
||
1077 g_font_loader
->GetFontMapSize() < kMaxFontThreshold
) {
1078 g_font_loader
->EnableCollectionBuildingMode(true);
1079 hr
= factory
->CreateCustomFontCollection(
1080 g_font_loader
.Get(), NULL
, 0, g_font_collection
.GetAddressOf());
1081 g_font_loader
->EnableCollectionBuildingMode(false);
1083 bool loading_restricted
= false;
1084 if (FAILED(hr
) || !g_font_collection
.Get()) {
1085 loading_restricted
= true;
1086 // We will try here just one more time with restricted font set.
1087 g_font_loader
->LoadRestrictedFontList();
1088 hr
= factory
->CreateCustomFontCollection(
1089 g_font_loader
.Get(), NULL
, 0, g_font_collection
.GetAddressOf());
1092 base::TimeDelta time_delta
= base::TimeTicks::Now() - start_tick
;
1093 int64 delta
= time_delta
.ToInternalValue();
1094 base::debug::Alias(&delta
);
1095 UINT32 size
= g_font_loader
->GetFontMapSize();
1096 base::debug::Alias(&size
);
1097 base::debug::Alias(&loading_restricted
);
1099 CHECK(SUCCEEDED(hr
));
1100 CHECK(g_font_collection
.Get() != NULL
);
1102 if (cache_file_loaded
)
1103 UMA_HISTOGRAM_TIMES("DirectWrite.Fonts.LoadTime.Cached", time_delta
);
1105 UMA_HISTOGRAM_TIMES("DirectWrite.Fonts.LoadTime", time_delta
);
1107 base::debug::ClearCrashKey(kFontKeyName
);
1109 return g_font_collection
.Get();
1112 bool BuildFontCacheInternal(const WCHAR
* file_name
) {
1113 typedef decltype(DWriteCreateFactory
)* DWriteCreateFactoryProc
;
1114 HMODULE dwrite_dll
= LoadLibraryW(L
"dwrite.dll");
1116 DWORD load_library_get_last_error
= GetLastError();
1117 base::debug::Alias(&dwrite_dll
);
1118 base::debug::Alias(&load_library_get_last_error
);
1122 DWriteCreateFactoryProc dwrite_create_factory_proc
=
1123 reinterpret_cast<DWriteCreateFactoryProc
>(
1124 GetProcAddress(dwrite_dll
, "DWriteCreateFactory"));
1126 if (!dwrite_create_factory_proc
) {
1127 DWORD get_proc_address_get_last_error
= GetLastError();
1128 base::debug::Alias(&dwrite_create_factory_proc
);
1129 base::debug::Alias(&get_proc_address_get_last_error
);
1133 mswr::ComPtr
<IDWriteFactory
> factory
;
1136 dwrite_create_factory_proc(
1137 DWRITE_FACTORY_TYPE_ISOLATED
,
1138 __uuidof(IDWriteFactory
),
1139 reinterpret_cast<IUnknown
**>(factory
.GetAddressOf()))));
1141 base::TimeTicks start_tick
= base::TimeTicks::Now();
1143 FontCollectionLoader::Initialize(factory
.Get());
1145 g_font_loader
->EnterStaticCacheMode(file_name
);
1147 mswr::ComPtr
<IDWriteFontCollection
> font_collection
;
1149 HRESULT hr
= E_FAIL
;
1150 g_font_loader
->EnableCollectionBuildingMode(true);
1151 hr
= factory
->CreateCustomFontCollection(
1152 g_font_loader
.Get(), NULL
, 0, font_collection
.GetAddressOf());
1153 g_font_loader
->EnableCollectionBuildingMode(false);
1155 bool loading_restricted
= false;
1156 if (FAILED(hr
) || !font_collection
.Get()) {
1157 loading_restricted
= true;
1158 // We will try here just one more time with restricted font set.
1159 g_font_loader
->LoadRestrictedFontList();
1160 hr
= factory
->CreateCustomFontCollection(
1161 g_font_loader
.Get(), NULL
, 0, font_collection
.GetAddressOf());
1164 g_font_loader
->LeaveStaticCacheMode();
1166 base::TimeDelta time_delta
= base::TimeTicks::Now() - start_tick
;
1167 int64 delta
= time_delta
.ToInternalValue();
1168 base::debug::Alias(&delta
);
1169 UINT32 size
= g_font_loader
->GetFontMapSize();
1170 base::debug::Alias(&size
);
1171 base::debug::Alias(&loading_restricted
);
1173 CHECK(SUCCEEDED(hr
));
1174 CHECK(font_collection
.Get() != NULL
);
1176 base::debug::ClearCrashKey(kFontKeyName
);
1181 bool ValidateFontCacheFile(base::File
* file
) {
1182 DCHECK(file
!= NULL
);
1183 CacheFileHeader file_header
;
1184 if (file
->Read(0, reinterpret_cast<char*>(&file_header
), sizeof(file_header
))
1188 return ValidateFontCacheHeader(&file_header
);
1191 bool LoadFontCache(const base::FilePath
& path
) {
1192 scoped_ptr
<base::File
> file(new base::File(path
,
1193 base::File::FLAG_OPEN
| base::File::FLAG_READ
));
1194 if (!file
->IsValid())
1197 if (!ValidateFontCacheFile(file
.get()))
1200 base::string16
name(base::ASCIIToUTF16(content::kFontCacheSharedSectionName
));
1201 name
.append(base::UintToString16(base::GetCurrentProcId()));
1202 HANDLE mapping
= ::CreateFileMapping(
1203 file
->GetPlatformFile(),
1209 if (mapping
== INVALID_HANDLE_VALUE
)
1212 if (::GetLastError() == ERROR_ALREADY_EXISTS
) {
1213 CloseHandle(mapping
);
1214 // We crash here, as no one should have created this mapping except Chrome.
1219 DCHECK(!g_shared_font_cache
.IsValid());
1220 g_shared_font_cache
.Set(mapping
);
1225 bool BuildFontCache(const base::FilePath
& file
) {
1226 return BuildFontCacheInternal(file
.value().c_str());
1229 } // namespace content