Como carregar fontes? | Solução da API para .NET

Visão geral

Para responder à pergunta, como carregar fontes, primeiro precisamos aprender que qualquer fonte é fisicamente uma matriz de bytes nos quais os dados são representados em algum formato. Portanto, para o carregamento correto da fonte, você precisa conhecer dois parâmetros principais:

• Formato de fonte. As fontes podem ter formatos diferentes como truetype, type1, etc.
• Armazenamento, onde os dados binários que representam a fonte estão sendo mantidos. Cada fonte é representada como dados binários, mas a maneira como esses dados são armazenados pode ser diferente. Na maioria dos casos, a fonte está sendo armazenada como um arquivo em um disco rígido. Mas, às vezes, dados binários da fonte podem ser colocados em um arquivo diferente que não é uma fonte. Por exemplo, arquivos criados pelo Microsoft Word ou Adobe Acrobat. Estes são arquivos com extensões .docx, .pdf. Eles podem incluir fontes diferentes.

Objetos e parâmetros necessários para o carregamento da fonte

Aspose.font para .NET fornece objeto fontDefiniton para notificar dois parâmetros principais exigidos para carregamento de fontes. Depois de criar e iniciar o objeto fontDefiniton, você só precisa chamar o método estático aspose.font.Font.open() e passar apenas o objeto inicializado fontdefiniton como um parâmetro para carregar a fonte desejada e obter uma referência.

Vamos descrevê -lo com o pseudocódigo:

 
using Aspose.Font;
    ...

    // Initialize object FontDefinition with appropriate properties
    FontDefinition fontDef = new FontDefinition(); 
    Font desiredFont = Font.Open(fontDef);

O resultado final do carregamento da fonte está obtendo um objeto de aspose.font.font tipo. Classe Aspose.font.font é uma classe de fonte base de aspose.font para a biblioteca .NET. Representa a principal funcionalidade de trabalhar com fontes.

Ficando carregado uma fonte em aspose.font.font Tipo Objeto Você poderá renderizar texto com esta fonte, obter dados de codificação e métricas de font. Você também poderá modificar ou salvar essa fonte e muito mais.

Para iniciar o objeto fontdefiniton que precisamos, como foi mencionado anteriormente, para fornecer 2 parâmetros de fonte, - o tipo de formato e o objeto que descreve o armazenamento para dados binários da fonte. O primeiro parâmetro é notificado com a enumeração FontType.

Para simplificar o trabalho com o segundo parâmetro, Aspose.font oferece uma série de objetos que fornecem acesso universal aos dados binários da fonte independentemente de onde a fonte é colocada.

Esse acesso universal está vinculado a algo como um fluxo de bytes. Portanto, independentemente de onde a fonte é colocada - em um arquivo em um disco, dentro de outro arquivo, matriz de bytes na memória - em qualquer caso, os objetos especiais aspose.font fornecerão um acesso ao fluxo de bytes, relacionado à fonte desejada.

Vamos descrever esses objetos:

1. Streamsource Classe. Esta classe base abstrata define as propriedades e métodos que dão acesso ao fluxo de bytes de fonte. GetFontStream() Método desta classe retorna um fluxo, relacionado aos dados da fonte binária. Propriedade Offset pontos na posição neste fluxo, de onde devemos começar a ler os dados.
2. Duas classes mais usadas herdadas da base streamsource:
   • FileSystemStreamSource - Projetado para fornecer acesso ao fluxo, com base no sistema de arquivos. Propriedade nome do arquivo Retorna o nome do arquivo de fontes. GetFontStream() O método retorna um fluxo de bytes, relacionado a este arquivo.
   • ByteContentStreamSource - fornece acesso ao fluxo, com base na matriz de bytes.

Como iniciar classes?

Aqui estão exemplos do início dessas classes. 1.Vamos supor que a fonte esteja no arquivo chamado lora.ttf. Nesse caso, para obter acesso ao fluxo de bytes desta fonte, precisamos criar o objeto do tipo FileSystemStreamSource usando este único construtor:

 
    Filesystemstreamsource fontsource = new FileSystemStreamSource ("lora.ttf");

2. Se os dados binários da fonte estiverem localizados em uma matriz binária definida pela variável BYTE [] FONTARRAY, um objeto do tipo byteContentsTreamSource fornecerá um acesso ao fluxo de dados da fonte, com base na variável FontArray. Para obter acesso ao fluxo de bytes de font, precisamos criar um objeto do tipo byteContentStreamSource para obter acesso ao fluxo, relacionado à matriz de bytes de font usando código como este:

 
    ByteContentStreamSource fontSource = new ByteContentStreamSource (FontArray);

Portanto, para fornecer acesso aos dados binários da fonte, use objetos herdados da classe streamsource. Além disso, chamaremos esses objetos fontes de fluxo de fontes.

Objeto FontfiledEfinition

A maioria das frentes está localizada em arquivos regulares, mas, ao mesmo tempo, parte das fontes pode ter diferentes fontes de dados. Para ingressar em um objeto Termos Arquivo e Freio binário de fontes, Aspose.font Library fornece objeto especial fontfiledEfinition.

Este objeto tem tais propriedades:

• Nome do arquivo - Nome do arquivo de font.
• Filextension - Extensão de um arquivo de fonte.
• StreamSource - Fonte de fluxo de fonte.
• Offset - Deslocamento dentro do fluxo de bytes de fonte.

O mais simples e um dos construtores mais utilizados desse objeto é o construtor com a seguinte assinatura: FontfiledEfinition (FileInfo Fontfile), use esse construtor para casos quando a fonte desejada estiver em um arquivo no unidade rígida.

Aqui está um exemplo de iniciar esse objeto para font Montserrat, localizado no arquivo C:\Windows\Fonts\Montserrat.ttf:

 
    FontFileDefinition fileDef = new FontFileDefinition(new FileInfo(@"C:\Windows\Fonts\Montserrat.ttf"));

Além disso, fontfiledefinition pode fazer referência à fonte de Montserrat usando os seguintes construtores:

 
    FontfiledEfinition fileDef = new FontfiledEfinition (new FileSystemStreamSource (@"C:\Windows\Fonts\Montserrat.ttf"));

    FontFileDefinition fileDef = new FontFileDefinition("ttf", new FileSystemStreamSource(@"C:\Windows\Fonts\Montserrat.ttf"));

O parâmetro fileExtension deve corresponder à extensão padrão do formato da fonte. Por exemplo, se o formato da fonte for TrueType, o valor do parâmetro fileExtension poderá ser ttf ou ttc (se o ficheiro da fonte for uma colecção de fontes TrueType). Se o formato da fonte for Embedded Open Type, o valor do parâmetro fileExtension deverá ser eot.

A tabela abaixo mostra os mais frequentemente usados ​​no Aspose.Font para formatos de arquivo de font .NET. Lá estão eles com os valores correspondentes que o parâmetro fileExtension deve assumir.

Formato de ficheiro fonte	Extensão de ficheiro
TrueType, single font	ttf
TrueType font collection	ttc
Web Open Font Format	woff
Web Open Font Format version 2.0	woff2
Embedded OpenType	eot
Adobe Type 1 font	pfa, pfb, afm, pfm
Compact Font Format	cff, can be null

Se os dados da fonte não iniciarem a posição 0 do fluxo de bytes, use o seguinte construtor com o parâmetro offset:

 
    FontfiledEfinition (String FileExtension, StreamSource StreamSource, Long Offset).

Como iniciar o objeto FontDefinition?

Agora, quando você tem uma idéia dos objetos herdados da classe streamsource e fornecendo acesso ao fluxo de bytes de font e do objeto fontfiledefinition, o objeto explicaremos adequadamente para você como iniciar satefiniton (40) (40), explicaremos adequadamente para diferentes.

FontDefiniton Objeto fornece muitos construtores sobrecarregados. O recurso comum de todos os construtores existentes é o parâmetro fontType. Ele descreve o tipo de formato de fonte. Como foi mencionado anteriormente, além do valor FontType, o objeto fontDefiniton deve ser inicializado com referência aos dados binários da fonte.

Próximos parâmetros de FontDefiniton Os construtores podem ser usados ​​neste caso:- fontName;

• fileExtension;
• objeto do tipo streamSource;
• objeto do tipo fontfiledEfinition.

Você pode ter uma pergunta. Por que passaríamos no parâmetro fileExtension para o objeto fontDefiniton ou o objeto fontfiledEfinition, quando sempre passamos o parâmetro fonttype que parece coincidir por seu valor com filextenstension? O problema é que fontType nem sempre coincide com o valor de fileExtension. FontType define o formato de fonte comum, mas não o formato de fonte de um arquivo específico. Algumas fontes de um formato podem ter formatos de arquivo diferentes. Por exemplo, o valor FontType.ttf define o formato TrueType. Mas, ao mesmo tempo, o TrueType inclui alguns formatos de fonte e existem arquivos de fonte com extensões ttf, eot, ttc etc. E se, por exemplo, para a fonte do formato eot, passamos para FontDefiniton apenas o valor FontType.ttf, como esse objeto entenderá que a fonte pertence ao formato eot e não para ttf? Da mesma forma, o valor do Fonttype.Type1 é a definição comum para fontes desse formato. Ao mesmo tempo, os arquivos de fonte do formato type1 têm extensões .pfa, .pfb, .afm, .pfm. Portanto, você não pode definir o formato de arquivo de fontes dependendo adequadamente apenas no valor do fontype.type1. Portanto, para definir o formato da fonte corretamente, precisamos especificar o parâmetro FontType com o valor do parâmetro fileExtension.

Abaixo, você pode aprender exemplos de FontDefiniton Inicialização do objeto e após o carregamento da fonte para diferentes casos.

Em todos os casos, o resultado final da carga da fonte é colocado na variável de aspose.font.font tipo. Este tipo é a classe de fonte básica da biblioteca Aspose.font e os objetos desse tipo fornecem funcionalidade básica comum para trabalhar com fontes. Carregando a fonte nesse objeto, você poderá renderizar texto com esta fonte, obter informações de codificação, métricas de fonte, etc.

Exemplos de como carregar fontes

Vamos ter como exemplo, carregando a fonte Montserrat do arquivo C:\Windows\Fonts\Montserrat.ttf

Adicione os próximos namespaces à frente do arquivo:

    using System;
    using Aspose.Font;
    using Aspose.Font.Sources;
    using System.IO;

Você pode carregar essa fonte usando objetos fontdefiniton e fontfiledefinition de algumas maneiras diferentes:

Carregando com a ajuda do objeto System.io.fileInfo

Para cumprir o carregamento, faça o próximo:

1. Construa o caminho para o arquivo.
2. Inicie fontDefiniton Passagem do objeto ttf como FontType Valor.
3. Obtenha o valor calculado automaticamente FILEEXTENNENTE.
4. Carregue a fonte.

    // Construa o caminho para o arquivo
    String fontpath = @"C:\Windows\Fonts\Montserrat.ttf";

    // Initialize FontDefinition object passing TTF as FontType value and using FontFileDefinition
    FontFileDefinition fileDef = new FontFileDefinition(new FileInfo(fontPath));

    // Based on FileInfo object, fileExtension value is calculated automatically from FileInfo fields.
    FontDefinition fontDef = new FontDefinition(FontType.TTF, fileDef);
	
    // Load font
    Font font = Font.Open(fontDef);

Carregando com a ajuda do objeto Tipo de Sistema de FileStemStreamSource

Dê os próximos passos para cumprir a operação:

1. Construa o caminho para o arquivo.
2. Iniciar fontDefiniton objeto.
3. Definir fileExtension como ttf.
4. Carregue a fonte.

    // Construa o caminho para o arquivo
    String fontpath = @"C:\Windows\Fonts\Montserrat.ttf";

    // Initialize FontDefinition object passing TTF as FontType value and using FontFileDefinition
    FontFileDefinition fileDef = new FontFileDefinition("ttf", new FileSystemStreamSource(fontPath));

    // Based on FileSystemStreamSource object, set fileExtension to "ttf"
    FontDefinition fontDef = new FontDefinition(FontType.TTF, fileDef);
		
    // Load font   
    Font font = Font.Open(fontDef);

Carregamento de fontes sem objeto FontfiledEfinition, com a passagem de arquivos STEMSTREAMSource diretamente para a FontDefinition

As próximas ações devem ser tomadas para carregar a fonte desta maneira:

1. Construa o caminho para o arquivo.
2. Inicie FontDefiniton Passagem do objeto TTF como FontType Valor, ttf como FileExtension valor e arquivosystemStreamSource objeto. Parâmetro fileExtension Aqui não há um valor duplicado para o parâmetro FontType.
3. Carregue a fonte.

    // Construa o caminho para o arquivo
    String fontpath = @"C:\Windows\Fonts\Montserrat.ttf";
    // Initialize FontDefinition object passing TTF as FontType value, "ttf" as fileExtension value, 
    // and FileSystemStreamSource object. Parameter 'fileExtension' here is not duplicate value 
    // for parameter 'FontType' and it's needed for correct font format detection
    FontDefinition fontDef = new FontDefinition(FontType.TTF, "ttf", new FileSystemStreamSource(fontPath));

    // Load font	
    Font font = Font.Open(fontDef);

Carregando de fonte com a variável de tipo [] de byte e com o uso do objeto ByteContentStreamSource

Para carregar uma fonte da matriz de bytes, você precisa:

1. Construa o caminho para o arquivo.
2. Carregue dados binários da fonte na matriz de bytes
3. Inicializar o objeto FontDefiniton passando TTF como valor FontType, ttf como valor fileExtension e o objeto ByteContentStreamSource com base na matriz fontBytes.
4. Carregue a fonte.

    // Construa o caminho para o arquivo
    String fontpath = @"C:\Windows\Fonts\Montserrat.ttf";

    // Load font binary data into byte array
    byte[] fontBytes;

    // Initialize FontDefinition object  passing TTF as FontType value, "ttf" as fileExtension value, 
    // and ByteContentStreamSource object based on fontBytes array
    FontDefinition fontDef = new FontDefinition(FontType.TTF, "ttf", new ByteContentStreamSource(fontBytes));
	
    // Load font	
    Font font = Font.Open(fontDef);

Para obter mais exemplos de uso do Aspose.font, acesse aspose.font.examples.sln Solution, nas net-examples da documentação aspose.font

Se você tiver problemas ou perguntas, poderá publicá -las na seção Aspose.Font.Product Family do fórum de suporte gratuito e em poucas horas nossa equipe de suporte limpará tudo para você.