Glyphs and Metrics of TrueType Fonts | Java

Get Font Metrics

Font metrics refer to informaiton such as Ascender, Descender, TypoAscender, TypoDescender and UnitsPerEm. Aspose.Font for Java API can be used to open TTF font files and read the Font Metrics information from these using the following sample code.

// For complete examples and data files, please go to https://github.com/aspose-font/Aspose.Font-for-Java
String fileName = Utils.getDataDir() + "Montserrat-Regular.ttf"; //Font file name with full path

      FontDefinition fd = new FontDefinition(FontType.TTF, new FontFileDefinition("ttf", new FileSystemStreamSource(fileName)));
      TtfFont font = (TtfFont) Font.open(fd);

      String name = font.getFontName();
      System.out.println("Font name: " + name);
      System.out.println("Glyph count: " + font.getNumGlyphs());
      String metrics = MessageFormat.format(
          "Font metrics: ascender - {0}, descender - {1}, typo ascender = {2}, typo descender = {3}, UnitsPerEm = {4}",
          font.getMetrics().getAscender(), font.getMetrics().getDescender(),
          font.getMetrics().getTypoAscender(), font.getMetrics().getTypoDescender(), font.getMetrics().getUnitsPerEM());

      System.out.println(metrics);
      
    //Get cmap unicode encoding table from font as object TtfCMapFormatBaseTable to access information about font glyph for symbol 'A'.
      //Also check that font has object TtfGlyfTable (table 'glyf') to access glyph.
      TtfCMapFormatBaseTable cmapTable = null;
      if (font.getTtfTables().getCMapTable() != null)
      {
          cmapTable = font.getTtfTables().getCMapTable().findUnicodeTable();
      }
      if (cmapTable != null && font.getTtfTables().getGlyfTable() != null)
      {
      	System.out.println("Font cmap unicode table: PlatformID = " + cmapTable.getPlatformId() +
      			", PlatformSpecificID = " + cmapTable.getPlatformSpecificId());

          //Code for 'A' symbol
          char unicode = (char)65;

          //Glyph index for 'A'
          long glIndex = cmapTable.getGlyphIndex(unicode);

          if (glIndex != 0)
          {
              //Glyph for 'A'
              Glyph glyph = font.getGlyphById(glIndex);
              if (glyph != null)
              {
                  //Print glyph metrics
              	System.out.println("Glyph metrics for 'A' symbol:");
                  String bbox = MessageFormat.format(
                      "Glyph BBox: Xmin = {0}, Xmax = {1}" + ", Ymin = {2}, Ymax = {3}",
                      glyph.getGlyphBBox().getXMin(), glyph.getGlyphBBox().getXMax(),
                      glyph.getGlyphBBox().getYMin(), glyph.getGlyphBBox().getYMax());
                  System.out.println(bbox);
                  System.out.println("Width:" + font.getMetrics().getGlyphWidth(new GlyphUInt32Id(glIndex)));
              }
          }
      }

Detect Latin Symbols

Aspose.Font for .API lets you detect Latin Symbols from TrueType font files. This can be achieved using the following sample code.

• Load the Font file using FontFileDefinition
• Decode the GlyphId using the DecodeToGid() method

  // For complete examples and data files, please go to https://github.com/aspose-font/Aspose.Font-for-Java
  String fileName = Utils.getDataDir() + "Montserrat-Regular.ttf"; //Font file name with full path
  
        FontDefinition fd = new FontDefinition(FontType.TTF, new FontFileDefinition("ttf", new FileSystemStreamSource(fileName)));
        TtfFont ttfFont = (TtfFont) Font.open(fd);
  
        boolean latinText = true;
  
  
        for (int code = 65; code < 123; code++)
        {
            GlyphId gid = ttfFont.getEncoding().decodeToGid(code);
            if (gid == null || gid == GlyphUInt32Id.getNotDef())
            {
                latinText = false;
            }
        }
  
        if (latinText)
        {
            System.out.println(MessageFormat.format("Font {0} supports latin symbols.", ttfFont.getFontName()));
        }
        else
        {
        	System.out.println(MessageFormat.format("Latin symbols are not supported by font {0}.", ttfFont.getFontName()));
        }

Extract License Restrictions

Use Aspose.Font for Java API to extract licensing restrictions from font files. Fonts can have licensing information embedded into these in one of the following modes.

• Editable Embedding - Font may be embedded, and may be temporarily loaded on other systems. In addition, editing is permitted, including ability to format new text using the embedded font, and changes may be saved.
• Installable Embedding - Font may be embedded, and may be permanently installed for use on a remote systems, or for use by other users.
• Preview and Print Embedding - Font may be embedded, and may be temporarily loaded on other systems for purposes of viewing or printing the document.
• Restricted Embedding - Font must not be modified, embedded or exchanged in any manner without first obtaining explicit permission of the legal owner.

The following code sample shows how to use an object Aspose.Font.Ttf.LicenseFlags to get information about font license restrictions(flag fsType from table OS/2) in convenient form.

// For complete examples and data files, please go to https://github.com/aspose-font/Aspose.Font-for-Java
String fileName = Utils.getDataDir() + "Montserrat-Regular.ttf"; //Font file name with full path

      FontDefinition fd = new FontDefinition(FontType.TTF, new FontFileDefinition("ttf", new FileSystemStreamSource(fileName)));
      TtfFont font = (TtfFont) Font.open(fd);

      LicenseFlags licenseFlags = null;
      if (font.getTtfTables().getOs2Table() != null)
      {
          licenseFlags = font.getTtfTables().getOs2Table().getLicenseFlags();
      }

      if (licenseFlags == null || licenseFlags.isFSTypeAbsent())
      {
          System.out.println(MessageFormat.format("Font {0} has no embedded license restrictions", font.getFontName()));
      }
      else
      {
          if (licenseFlags.isEditableEmbedding())
          {
          	System.out.println(MessageFormat.format("Font {0} may be embedded, and may be temporarily loaded on other systems.", font.getFontName())
                  + " In addition, editing is permitted, including ability to format new text"
                  + " using the embedded font, and changes may be saved.");
          }
          else if (licenseFlags.isInstallableEmbedding())
          {
          	System.out.println(MessageFormat.format("Font {0} may be embedded, and may be permanently installed", font.getFontName())
                  + " for use on a remote systems, or for use by other users.");
          }
          else if (licenseFlags.isPreviewAndPrintEmbedding())
          {
          	System.out.println(MessageFormat.format("Font {0} may be embedded, and may be temporarily loaded", font.getFontName())
                  + "  on other systems for purposes of viewing or printing the document.");
          }
          else if (licenseFlags.isRestrictedLicenseEmbedding())
          {
          	System.out.println(MessageFormat.format("Font {0} must not be modified, embedded or exchanged in any manner", font.getFontName())
                  + " without first obtaining explicit permission of the legal owner.");
          }
      }