AddImageDirectFromString
Processamento de imagens
Descrição
Cria um Image XObject diretamente a partir de bytes de amostras de imagem já codificados, em vez de detetar um formato contentor como PNG, TIFF ou JPEG
Comportamento da versão PDF: o filtro de imagem JBIG2Decode exige PDF 1.4, enquanto JPXDecode, Crypt e amostras de imagens com BitsPerComponent = 16 exigem PDF 1.5. Quando um documento está definido para uma versão inferior à necessária e a versão de gravação não está bloqueada, AddImageDirectFromString eleva automaticamente a versão do documento e regista JBIG2Decode filter, JPXDecode filter, Crypt filter ou 16-bit image samples em AutoBumpedFeatures. Se o chamador bloquear uma versão de gravação inferior, a barreira de compatibilidade rejeita a gravação com LastErrorCode 602
Sintaxe
Delphi
Function TPDFlib.AddImageDirectFromString(Const Source: AnsiString; Width, Height, BitsPerComponent: Integer; Const ColorSpace, Filter, Decode: WideString; Interpolate: Integer): Integer;Parâmetros
| Source | Dados de imagem em bruto ou codificados a armazenar no fluxo de imagem |
|---|---|
| Width | Largura da imagem em píxeis |
| Height | Altura da imagem em píxeis |
| BitsPerComponent | Número de bits por componente de amostra. Os dicionários de imagens PDF permitem 1, 2, 4 e 8 nas versões anteriores; as amostras de 16 bits pertencem ao PDF 1.5 |
| ColorSpace | Nome do espaço de cores PDF ou texto de matriz para o dicionário da imagem, por exemplo, /DeviceGray, /DeviceRGB ou uma matriz de espaço de cores indexado |
| Filter | Nome do filtro do fluxo PDF, como FlateDecode, DCTDecode ou JPXDecode. Utilize uma cadeia vazia para dados não filtrados |
| Decode | Texto opcional da matriz Decode de PDF. Passe uma cadeia vazia quando não for necessária uma entrada Decode |
| Interpolate | Um valor diferente de zero escreve o sinalizador /Interpolate true |
Valores devolvidos
| 0 | Não foi possível criar a imagem ou o modo PDF/A atual proíbe o filtro solicitado |
|---|---|
| Non-zero | O novo ImageID. A imagem criada fica selecionada para operações de imagem posteriores |
Observações
O modo PDF/A rejeita LZWDecode em todas as partes e rejeita JBIG2Decode / JPXDecode em PDF/A-1. O invocador é responsável por fazer corresponder os bytes de Source a ColorSpace, Filter, Decode, dimensões e profundidade das amostras declarados
Consulte também
AddImageFromString, AddImageFromFile, AddImageFromStream, DrawImage