Saiba como o Adobe Acrobat representa as marcações de conteúdo do Microsoft Purview Information Protection (MPIP) em PDF usando Form XObjects e o dicionário ADBE_MIP.
Visão geral
Se você criar ou processar PDFs que contenham marcações de conteúdo do Microsoft Purview Information Protection (MPIP), este artigo explica como o Adobe Acrobat armazena essas marcações. MPIP é um serviço da Microsoft. Pode adicionar marcações como marcas d'água, cabeçalhos e rodapés a um documento. O Acrobat salva cada marcação para que ela permaneça compatível com outras ferramentas de PDF. Também salva cada marcação para que o Acrobat ainda possa reconhecê-la. Quando as marcações são armazenadas corretamente, o Acrobat mantém o rótulo de sensibilidade do documento, para que o rótulo possa ser atualizado ou removido posteriormente sem causar problemas.
Como as marcações são armazenadas
- Form XObject: Cada marcação é salva como um Form XObject. Esta é uma parte padrão e independente de conteúdo de PDF que uma página pode reutilizar. Ele define como a marcação aparece na página.
- Dicionário ADBE_MIP: Cada marcação também inclui um dicionário ADBE_MIP. Este pequeno conjunto de dados contém detalhes específicos da marcação. Sua presença informa ao Acrobat que o objeto é uma marcação MPIP. O Acrobat pode então reconhecer e gerenciar a marcação durante a rotulagem posterior.
Esquema do dicionário
Um determinado dicionário /ADBE_MIP contém seis chaves. Cinco são comuns a todos os três tipos de marcação; a sexta é /MIP_Layout para marcas d'água ou /MIP_Allignment para cabeçalhos e rodapés.
| Chave | Tipo Cos | O que contém | Presente para | Origem da API do MIP SDK |
|---|---|---|---|---|
| MIP_Type | Nome | Discriminador que identifica a marcação: /Watermark, /Header ou /Footer. | Tudo | Não retornado pelo SDK. O Acrobat deriva isso de qual classe de ação foi retornada: mip::AddWatermarkAction / mip::AddContentHeaderAction / mip::AddContentFooterAction (mip::Action::GetType()). |
| MIP_Text | Nome | O texto de exibição da marcação. | Tudo | GetText() na ação. |
| MIP_Font | Nome | Nome da família da fonte (por exemplo, Calibri). | Tudo | GetFontName(). Padrão documentado do SDK "Calibri". |
| MIP_FontSize | Real | Tamanho da fonte em pontos. | Tudo | GetFontSize() (retorna um número inteiro; armazenado como real). |
| MIP_Color | Array (RGB) | Cor da fonte do texto da marcação. | Tudo | GetFontColor(). O SDK retorna uma string hexadecimal como "#000000". O Acrobat converte o valor da cor hexadecimal em uma matriz de cores DeviceRGB (consulte a observação abaixo da tabela). |
| MIP_Layout | Número inteiro | Orientação da marca d'água, em graus: 0 = Horizontal, 45 = Diagonal. | Somente marca d'água | GetLayout() → mip::WatermarkLayout (HORIZONTAL=0, DIAGONAL=1); mapeado 0→0°, 1→45°. |
| MIP_Allignment | Número inteiro | Alinhamento horizontal do texto do cabeçalho/rodapé. | Cabeçalho e rodapé apenas | GetAlignment() → mip::ContentMarkAlignment (LEFT=0, RIGHT=1, CENTER=2). |
O Acrobat converte o valor da cor hexadecimal em uma matriz DeviceRGB. Lê os componentes vermelho, verde e azul dos seis dígitos hexadecimais. Converte cada componente para um valor decimal de 0 a 255. Em seguida, divide cada valor por 255 para normalizá-lo no intervalo de 0,0 a 1,0. O Acrobat armazena os três resultados na matriz /MIP_Color.
Exemplo, para uma cor de marcação azul:
| Conversão GetFontColor() |
|---|
GetFontColor() = "#4472C4"
R = 0x44 = 68 -> 68 / 255 = 0,26666 G = 0x72 = 114 -> 114 / 255 = 0,44708 B = 0xC4 = 196 -> 196 / 255 = 0,76869
armazenado como /MIP_Color [0,26666 0,44708 0,76869] (números reais PDF, até 5 casas decimais) |
Exemplos
| Marca d’água | Cabeçalho | Rodapé |
|---|---|---|
| /ADBE_MIP << /MIP_Type /Watermark /MIP_Text /CONFIDENTIAL /MIP_Font /Calibri /MIP_FontSize 24.0 /MIP_Color [0.0 0.0 0.0] /MIP_Layout 45 % 45 = Diagonal, 0 = Horizontal >> |
/ADBE_MIP << /MIP_Type /Header /MIP_Text /Contoso\040Confidential /MIP_Font /Calibri /MIP_FontSize 8.0 /MIP_Color [0.0 0.0 0.0] /MIP_Allignment 2 % 0 = Esquerda, 1 = Direita, 2 = Centro >> |
Idêntico em forma ao exemplo do cabeçalho, mas com /MIP_Type definido como /Footer. |
Gerar e imprimir em PDF
Alguns fluxos de trabalho convertem um documento rotulado com MPIP para PDF. Os exemplos incluem Salvar como PDF e Imprimir em PDF. Quando um desses mantém uma marcação na saída, também deve criar o dicionário ADBE_MIP da marcação.
Se a marcação visível for mantida sem seu dicionário ADBE_MIP, o Acrobat não consegue reconhecê-la. Acrobat trata a marcação como um objeto normal em vez de uma marcação. A marcação pode então não ser preservada, atualizada, substituída ou removida corretamente quando o rótulo MPIP do documento for alterado.
Trabalhe de forma mais inteligente com Acrobat no seu desktop
Crie, edite e organize PDFs com ferramentas poderosas que ajudam você a manter a produtividade em qualquer lugar.
