AddImageDirectFromString
Traitement des images
Description
Crée un Image XObject directement à partir d'octets d'échantillons d'image déjà encodés au lieu de détecter un format de conteneur tel que PNG, TIFF ou JPEG
Comportement selon la version PDF : le filtre d’image JBIG2Decode exige PDF 1.4, tandis que JPXDecode, Crypt et les échantillons avec BitsPerComponent = 16 exigent PDF 1.5. Si la version est insuffisante et non verrouillée, AddImageDirectFromString l’élève automatiquement et consigne JBIG2Decode filter, JPXDecode filter, Crypt filter ou 16-bit image samples dans AutoBumpedFeatures. Si l’appelant verrouille une version inférieure, le contrôle de compatibilité refuse l’enregistrement avec LastErrorCode 602
Syntaxe
Delphi
Function TPDFlib.AddImageDirectFromString(Const Source: AnsiString; Width, Height, BitsPerComponent: Integer; Const ColorSpace, Filter, Decode: WideString; Interpolate: Integer): Integer;Paramètres
| Source | Données d’image brutes ou encodées à stocker dans le flux d’image |
|---|---|
| Width | Largeur de l’image en pixels |
| Height | Hauteur de l’image en pixels |
| BitsPerComponent | Nombre de bits par composante d'échantillon. Les dictionnaires d'image PDF autorisent 1, 2, 4 et 8 dans les versions antérieures ; les échantillons 16 bits exigent PDF 1.5 |
| ColorSpace | Nom ou tableau d'espace colorimétrique PDF pour le dictionnaire d'image, par exemple /DeviceGray, /DeviceRGB ou un tableau indexé |
| Filter | Nom du filtre de flux PDF, tel que FlateDecode, DCTDecode ou JPXDecode. Utilisez une chaîne vide pour les données non filtrées |
| Decode | Texte facultatif du tableau PDF Decode Transmettez une chaîne vide si aucune entrée Decode n'est nécessaire |
| Interpolate | Une valeur non nulle écrit l’indicateur /Interpolate true |
Valeurs de retour
| 0 | L'image n'a pas pu être créée, ou le mode PDF/A actuel interdit le filtre demandé |
|---|---|
| Non-zero | Le nouvel ImageID L'image créée est sélectionnée pour les opérations d'image suivantes |
Remarques
Le mode PDF/A refuse LZWDecode dans toutes les parties et JBIG2Decode / JPXDecode dans PDF/A-1. L’appelant doit faire correspondre les octets Source aux valeurs déclarées de ColorSpace, Filter, Decode, aux dimensions et à la profondeur d’échantillon
Voir aussi
AddImageFromString, AddImageFromFile, AddImageFromStream, DrawImage