content/common/font_list.h

   1 // Copyright (c) 2011 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.
   4
   5 #ifndef CONTENT_COMMON_FONT_LIST_H_
   6 #define CONTENT_COMMON_FONT_LIST_H_
   7
   8 #include "base/memory/scoped_ptr.h"
   9
  10 namespace base {
  11 class ListValue;
  12 }
  13
  14 namespace content {
  15
  16 // Getting the list of fonts on the system is non-threadsafe on Linux for
  17 // versions of Pango predating 2013. This sequence token can be used to enforce
  18 // serial execution of get font list tasks.
  19 extern const char kFontListSequenceToken[];
  20
  21 // Retrieves the fonts available on the current platform and returns them.
  22 // The caller will own the returned pointer. Each entry will be a list of
  23 // two strings, the first being the font family, and the second being the
  24 // localized name.
  25 //
  26 // This function is potentially slow (the system may do a bunch of I/O) so be
  27 // sure not to call this on a time-critical thread like the UI or I/O threads.
  28 //
  29 // Since getting the fonts is not threadsafe on Linux, use
  30 // |kFontListSequenceToken| to prevent race conditions.
  31 //
  32 // Most callers will want to use the GetFontListAsync function in
  33 // content/browser/font_list_async.h which does an asynchronous call.
  34 scoped_ptr<base::ListValue> GetFontList_SlowBlocking();
  35
  36 }  // namespace content
  37
  38 #endif  // CONTENT_COMMON_FONT_LIST_H_