15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef UI_GFX_PLATFORM_FONT_H_ 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define UI_GFX_PLATFORM_FONT_H_ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <string> 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/memory/ref_counted.h" 115e3f23d412006dc4db4e659864679f29341e113fTorne (Richard Coles)#include "base/strings/string16.h" 1258537e28ecd584eab876aee8be7156509866d23aTorne (Richard Coles)#include "ui/gfx/gfx_export.h" 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ui/gfx/native_widget_types.h" 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace gfx { 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class Font; 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 194e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles)class GFX_EXPORT PlatformFont : public base::RefCounted<PlatformFont> { 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Creates an appropriate PlatformFont implementation. 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static PlatformFont* CreateDefault(); 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static PlatformFont* CreateFromNativeFont(NativeFont native_font); 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Creates a PlatformFont implementation with the specified |font_name| 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // (encoded in UTF-8) and |font_size| in pixels. 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static PlatformFont* CreateFromNameAndSize(const std::string& font_name, 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int font_size); 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns a new Font derived from the existing font. 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |size_delta| is the size in pixels to add to the current font. 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The style parameter specifies the new style for the font, and is a 322a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // bitmask of the values: BOLD, ITALIC and UNDERLINE. 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual Font DeriveFont(int size_delta, int style) const = 0; 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns the number of vertical pixels needed to display characters from 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the specified font. This may include some leading, i.e. height may be 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // greater than just ascent + descent. Specifically, the Windows and Mac 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // implementations include leading and the Linux one does not. This may 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // need to be revisited in the future. 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual int GetHeight() const = 0; 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns the baseline, or ascent, of the font. 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual int GetBaseline() const = 0; 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 454e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) // Returns the cap height of the font. 464e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) virtual int GetCapHeight() const = 0; 474e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles) 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns the expected number of horizontal pixels needed to display the 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // specified length of characters. Call GetStringWidth() to retrieve the 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // actual number. 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual int GetExpectedTextWidth(int length) const = 0; 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns the style of the font. 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual int GetStyle() const = 0; 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 56a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) // Returns the specified font name in UTF-8. 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual std::string GetFontName() const = 0; 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 59a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) // Returns the actually used font name in UTF-8. 60a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) virtual std::string GetActualFontNameForTesting() const = 0; 61a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns the font size in pixels. 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual int GetFontSize() const = 0; 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns the native font handle. 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual NativeFont GetNativeFont() const = 0; 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) protected: 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~PlatformFont() {} 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class base::RefCounted<PlatformFont>; 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace gfx 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // UI_GFX_PLATFORM_FONT_H_ 78