Adicionar imagens a arquivos XPS

Solução de API C# .NET para trabalhar com imagens de arquivos XPS

 

Quando você for trabalhar com imagens em arquivos XPS, algumas coisas devem ser lembradas:

  • Os arquivos XPS suportam muitos formatos de imagem, incluindo JPEG, PNG, TIFF, GIF e BMP. No entanto, o formato usa versões compactadas desses formatos, como JPEG XR (também conhecido como HD Photo) ou JBIG2 (para imagens em preto e branco). Isso é feito para ajudar a reduzir o tamanho do arquivo do documento resultante.
  • Os arquivos XPS armazenam imagens em uma resolução fixa (definida no momento da criação), portanto, o zoom pode resultar em pixelização ou desfoque.

  • As imagens em arquivos XPS geralmente são incorporadas diretamente no próprio documento, o que garante que o documento permaneça independente e portátil. No entanto, se você deseja modificar ou substituir uma imagem no arquivo, geralmente precisa editar o próprio documento XPS.

  • Os arquivos XPS usam uma estrutura chamada Open Packaging Conventions (OPC) para organizar e armazenar seu conteúdo. As imagens dentro de um arquivo XPS são representadas como partes individuais dentro do pacote OPC e podem ter relacionamentos com outros recursos, como texto ou anotações. Compreender essas relações é importante ao trabalhar com imagens em arquivos XPS, pois afeta como elas são referenciadas e exibidas no documento.

  • Os arquivos XPS geralmente usam técnicas avançadas de compactação de imagem para minimizar o tamanho do arquivo, mantendo uma qualidade de imagem razoável, como JPEG XR.

Tenha em mente esses aspectos para lidar e manipular imagens de forma eficaz em documentos XPS. Mas não importa o que, - Aspose.Page fornece a funcionalidade para gerenciar as fontes dos arquivos XPS facilmente. Com esta API você pode adicionar diferentes imagens usando C#. Para saber mais sobre como lidar com arquivos XPS e como trabalhar com imagens em arquivos XPS em particular, siga a documentação.

Para adicionar imagens a documentos XPS, precisamos:

  • Aspose.Page para API .NET, que é uma API de manipulação e conversão de documentos rica em recursos, poderosa e fácil de usar para a plataforma C#.

  • Abra o gerenciador de pacotes NuGet e procure por Aspose.Page e instale. Você também pode usar o seguinte comando no console do gerenciador de pacotes.

Package Manager Console Command


    PM> Install-Package Aspose.Page

Etapas para adicionar imagens a um arquivo XPS C#.

Este trecho de código demonstra como adicionar uma imagem a um documento XPS usando a classe XpsDocument em C#. Para ver mais exemplos, acesse projeto Aspose.Page-for-.NET GitHub .

  1. Defina o caminho para o diretório que contém os documentos.
  2. Crie uma nova instância da classe XpsDocument, que representa um documento XPS.
  3. Adicione uma imagem usando o método XpsDocument.AddPath() .
  4. Se necessário, crie uma matriz usando a classe XpsMatrix . Essa transformação de matriz é aplicada ao caminho da imagem para posicionar e dimensionar adequadamente a imagem.
  5. Chame o método CreateImageBrush() que passa o caminho para o arquivo de imagem, retângulo de origem e retângulo de destino. O retângulo de origem define a parte do arquivo de imagem a ser usada e o retângulo de destino especifica a posição e o tamanho da imagem dentro do XpsPath.
  6. Salve as alterações usando o método Save().

Código C# para inserir uma imagem em um arquivo XPS

    using Aspose.Page.XPS;
    using Aspose.Page.XPS.XpsModel;
    // Set the path to the documents directory.
    string dataDir = RunExamples.GetDataDir_WorkingWithImages();
    // Create a new XPS Document
    XpsDocument doc = new XpsDocument();
    // Add an Image
    XpsPath path = doc.AddPath(doc.CreatePathGeometry("M 30,20 l 258.24,0 0,56.64 -258.24,0 Z"));
    //Creating a matrix is optional, it can be used for proper positioning
    path.RenderTransform = doc.CreateMatrix(0.7f, 0f, 0f, 0.7f, 0f, 20f);
    //Create an Image Brush
    path.Fill = doc.CreateImageBrush(dataDir + "QL_logo_color.tif", new RectangleF(0f, 0f, 258.24f, 56.64f), new RectangleF(50f, 20f, 193.68f, 42.48f));
    // Save the resultant XPS document
    doc.Save(dataDir + "AddImage_out.xps");



Perguntas frequentes

1. Posso adicionar imagens a arquivos XPS?

XPS é um formato de documento de layout fixo desenvolvido pela Microsoft, semelhante ao PDF, e suporta a inclusão de imagens junto com texto e outros elementos gráficos. Você pode incorporar imagens diretamente em arquivos XPS para aprimorar o conteúdo visual e criar documentos mais envolventes.

2. Como adiciono imagens a um arquivo XPS?

Para adicionar imagens a um arquivo XPS, você pode usar vários métodos, dependendo do software ou das ferramentas que estiver usando. Em Aspose.Page é o método XpsDocument.AddPath() da classe XpsDocument.

3. Quais formatos de imagem são compatíveis com arquivos XPS?

Os arquivos XPS suportam uma variedade de formatos de imagem para inclusão, incluindo, entre outros, JPEG, PNG, TIFF, GIF e BMP. Você pode inserir imagens em qualquer um desses formatos em seus arquivos XPS, e elas serão renderizadas e exibidas corretamente no documento quando visualizadas usando leitores ou software XPS compatíveis.

XPS O que é XPS Formato de Arquivo

O formato XPS é semelhante ao formato PDF. Ambos são formatos de linguagem de descrição de página (PDL). EPS é baseado em HTML e não em linguagem PostScript. O arquivo .eps é capaz de conter uma marcação da estrutura do documento junto com as informações de como o documento ficaria. Há também instruções adicionadas sobre como imprimir e renderizar o documento. A característica do formato é que ele corrige a descrição do documento, o que significa que ele terá a mesma aparência, não importa quem e de qual sistema operacional o abra.