DynaPDFMBS.ReadImageResolution(FileName as folderitem, Index as Integer, byref ResX as Integer, byref ResY as Integer) as Boolean

// read image format and resolution and calculate physical size
Var bits as integer
Var useZip as Boolean
Var resX as integer = 0
Var resY as integer = 0
Var physHeight as integer
Var physWidth as integer
Var w as integer
Var h as integer

call pdf.ReadImageFormat2(Source, 1, w, h, bits, useZip)
call pdf.ReadImageResolution(Source, 1, resX, resY)

if (resX <> resY and resX > 0 and resY > 0) then
  if (resX > resY) then
    physWidth  = w
    physHeight = h \ (resX \ resY)
  else
    physWidth  = w \ (resY \ resX)
    physHeight = h
  end if
else
  physHeight = h
  physWidth  = w
end if

Some examples using this method:

• /DynaPDF/Image to PDF/Image to pdf
• /DynaPDF/Image to PDF/Multi Tiff to PDF

See also ReadImageResolution function in DynaPDF manual.

DynaPDFMBS.ReadImageResolutionEx(Buffer as Memoryblock, Index as Integer, byref ResX as Integer, byref ResY as Integer) as Boolean

See also:

• ReadImageResolutionEx(Buffer as string, Index as Integer, byref ResX as Integer, byref ResY as Integer) as Boolean

See also ReadImageResolutionEx function in DynaPDF manual.

DynaPDFMBS.ReadImageResolutionEx(Buffer as string, Index as Integer, byref ResX as Integer, byref ResY as Integer) as Boolean

See also:

• ReadImageResolutionEx(Buffer as Memoryblock, Index as Integer, byref ResX as Integer, byref ResY as Integer) as Boolean

See also ReadImageResolutionEx function in DynaPDF manual.

DynaPDFMBS.Rectangle(PosX as Double, PosY as Double, Width as Double, Height as Double, FillMode as Integer) as Boolean

See also Rectangle function in DynaPDF manual.

DynaPDFMBS.ReEncryptPDF(File as folderitem, PwdType as Integer, InPwd as string, OpenPwd as string, OwnerPwd as string, KeyLen as Integer, Restrict as Integer) as Integer

See also ReEncryptPDF function in DynaPDF manual.

DynaPDFMBS.ReEncryptPDFAnsi(Path as string, PwdType as Integer, InPwd as string, OpenPwd as string, OwnerPwd as string, KeyLen as Integer, Restrict as Integer) as Integer   Deprecated

Same as ReEncryptPDF, but takes path name in Windows ANSI encoding.

See also ReEncryptPDF function in DynaPDF manual.

DynaPDFMBS.RenameSpotColor(Colorant as string, NewName as string) as Integer

// your instance
Var pdf as DynaPDFMBS

// rename the color
call pdf.RenameSpotColor("Magenta", "Magenta2")

Strings are converted to UTF-8.

See also RenameSpotColor function in DynaPDF manual.

DynaPDFMBS.RenderAnnotOrField(Handle as UInt32, IsAnnot as boolean, State as Integer, Matrix as DynaPDFMatrixMBS, Flags as Integer, PixFmt as Integer, Filter as Integer, byref Out as DynaPDFBitmapMBS) as Integer

Please check dynapdf_help.pdf for details on RenderAnnotOrField function.
Plugin will fill out parameter only if result is zero.
Requires DynaPDF Pro license.

See also RenderAnnotOrField function in DynaPDF manual.

DynaPDFMBS.RenderPagePicture(PageNum as Integer) as picture

Var pdf as new MyDynaPDFMBS

// For this example you can use a Pro or Enterprise License
pdf.SetLicenseKey "Pro"

// create in memory
call pdf.CreateNewPDF nil

// set import flags
call pdf.SetImportFlags pdf.kifImportAsPage

// open the PDF file
Var f as FolderItem = SpecialFolder.Desktop.Child("test.pdf")
call pdf.OpenImportFile(f, 0, "")

// import all the pages
call pdf.ImportPDFFile(1, 1.0, 1.0)

// and render first page
Var out as Picture = pdf.RenderPagePicture(1)

// display in window
Backdrop = out

Please note that for most cases RenderPageToImage and RenderPDFFile are better choices for rendering. Especially if you plan to compress images later anyway. And you avoid trouble with color matching. For this function to work correct you have to initialize DynaPDF with right color space for screen (Generic RGB on Mac and screen profile for Windows).

The picture size is set to the Cropbox. If no crop box is defined, it uses the media box.

Returns nil on any error.

If you render a lot of pages from the same PDF, consider using DynaPDFRasterizerMBS class as it's faster when you reuse the rasterizer.

Currently not available for Linux Desktop apps.
Requires DynaPDF Pro license.

For pages with orientation of 90 or 270 degree, the plugin will take that into account and swap width/height to have rendered picture have the riuht size.

See also:

• RenderPagePicture(PageNum as Integer, Width as Integer, Height as Integer, DefScale as Integer = 2, matrix as DynaPDFMatrixMBS = nil) as picture

Some examples using this method:

• /DynaPDF/DynaPDF PDF Viewer
• /DynaPDF/Extract page Text area
• /DynaPDF/OCG/OCG Test
• /DynaPDF/Raster/Batch Convert PDF to JPG
• /DynaPDF/Raster/Create and Render PDF
• /DynaPDF/Raster/Create and Render PDF in console
• /DynaPDF/Raster/DynaPDF Display PDF in memory
• /DynaPDF/Raster/PDF Diff
• /DynaPDF/Raster/Search and show PDF files
• /DynaPDF/Tables/Dynamic Table/DynaPDF Table Multi Page

DynaPDFMBS.RenderPagePicture(PageNum as Integer, Width as Integer, Height as Integer, DefScale as Integer = 2, matrix as DynaPDFMatrixMBS = nil) as picture

Var pdf as new MyDynaPDFMBS

// For this example you can use a Pro or Enterprise License
pdf.SetLicenseKey "Pro"

// create in memory
call pdf.CreateNewPDF nil

// set import flags
call pdf.SetImportFlags pdf.kifImportAsPage

// open the PDF file
Var f as FolderItem = SpecialFolder.Desktop.Child("test.pdf")
call pdf.OpenImportFile(f, 0, "")

// import all the pages
call pdf.ImportPDFFile(1, 1.0, 1.0)

// and render first page with window size
Var out as Picture = pdf.RenderPagePicture(1, Width, Height)

// display in window
Backdrop = out

Please note that for most cases RenderPageToImage and RenderPDFFile are better choices for rendering. Especially if you plan to compress images later anyway. And you avoid trouble with color matching. For this function to work correct you have to initialize DynaPDF with right color space for screen (Generic RGB on Mac and screen profile for Windows).

The picture is created with the given size. The PDF page is scaled to fit size. You can use the constants kpsFitBest, kpsFitHeight or kpsFitWidth for the DefScale parameter. The matrix allows you to move, rotate or scale the PDF inside the picture.

Returns nil on any error.

If you render a lot of pages from the same PDF, consider using DynaPDFRasterizerMBS class as it's faster when you reuse the rasterizer.

Currently not available for Linux Desktop apps.
Requires DynaPDF Pro license.

If page is rotated, please swap width and height yourself.

See also:

• RenderPagePicture(PageNum as Integer) as picture

DynaPDFMBS.RenderPageToImage(PageNumber as UInt32, OutFile as folderitem, Resolution as UInt32, Width as UInt32, Height as UInt32, Flags as UInt32, PixFmt as UInt32, Filter as UInt32, Format as UInt32) as boolean

Var pdf as new MyDynaPDFMBS // your DynaPDF subclass with Error event filled

// where to get PDF page
Var f as FolderItem = SpecialFolder.Desktop.Child("test.pdf")

// where to write
Var t as FolderItem = SpecialFolder.Desktop.Child("test.jpg")

pdf.SetLicenseKey "Pro" // For this example you can use a Pro or Enterprise License

call pdf.CreateNewPDF nil
call pdf.SetImportFlags(pdf.kifImportAll + pdf.kifImportAsPage)

// open file
call pdf.OpenImportFile(f,0,"")

// add page
call pdf.Append

// import the page
call pdf.ImportPageEx(1,1.0,1.0)
call pdf.EndPage

// render the page
call pdf.RenderPageToImage(1, t, 72, ImageView1.Width, ImageView1.Height, DynaPDFRasterImageMBS.krfDefault, DynaPDFRasterizerMBS.kpxfRGB, DynaPDFMBS.kcfJPEG, DynaPDFMBS.kifmJPEG)

PixFmt: pass kpxf* constants like DynaPDFRasterizerMBS.kpxfRGB.
Filter: Pass kcf* constants like DynaPDFMBS.kcfJPEG.
Format: pass kifm* constants like DynaPDFMBS.kifmJPEG.

The page that should be rendered must be closed (Append() or EditPage() open a page and EndPage() closes a page).
If the parameter OutFile is set to nil the image is created in memory. In this case call GetImageBuffer() to retrieve the image buffer and finally FreeImageBuffer() to release it.

The output image size can be calculated in different ways:

• If Resolution is > 0 the image width and height is calculated according to the specified resolution. On a 32 bit machine it is possible to render pages in up to 1200 DPI depending on the page format. Larger resolutions require special techniques like banding to restrict the memory usage. However, no such feature is available in DynaPDF.
• If Width > 0 and if Height == 0 the image height is calculated according to the given width to archive an image with exact proportions.
• If Width == 0 and if Height > 0 then image width is calculated according to the given height to archive an image with exact proportions.
• If Width > 0 and if Height > 0 the image is scaled to the width and height.

Some examples using this method:

• /DynaPDF/Create Previews for folder
• /DynaPDF/DynaPDF Graphics/DynaPDF GraphicsPath
• /DynaPDF/DynaPDF Graphics/Reporting/List Of Orders
• /DynaPDF/DynaPDF Graphics/Reporting/List Of Orders with Background
• /DynaPDF/DynaPDF Graphics/VectorGraphics
• /DynaPDF/JBig Test
• /DynaPDF/Raster/RenderPageToImage test
• /DynaPDF/Raster/RenderPageToImage variants
• /DynaPDF/Rotate rotated PDF back
• /DynaPDF/Web Edition/WebPicture from PDF Page Web

See also RenderPageToImage function in DynaPDF manual.

DynaPDFMBS.RenderPageToImageMT(PageNumber as UInt32, OutFile as folderitem, Resolution as UInt32, Width as UInt32, Height as UInt32, Flags as UInt32, PixFmt as UInt32, Filter as UInt32, Format as UInt32) as boolean

PixFmt: pass kpxf* constants like DynaPDFRasterizerMBS.kpxfRGB.
Filter: Pass kcf* constants like DynaPDFMBS.kcfJPEG.
Format: pass kifm* constants like DynaPDFMBS.kifmJPEG.

The page that should be rendered must be closed (Append() or EditPage() open a page and EndPage() closes a page).
If the parameter OutFile is set to nil the image is created in memory. In this case call GetImageBuffer() to retrieve the image buffer and finally FreeImageBuffer() to release it.

The output image size can be calculated in different ways:

• If Resolution is > 0 the image width and height is calculated according to the specified resolution. On a 32 bit machine it is possible to render pages in up to 1200 DPI depending on the page format. Larger resolutions require special techniques like banding to restrict the memory usage. However, no such feature is available in DynaPDF.
• If Width > 0 and if Height == 0 the image height is calculated according to the given width to archive an image with exact proportions.
• If Width == 0 and if Height > 0 then image width is calculated according to the given height to archive an image with exact proportions.
• If Width > 0 and if Height > 0 the image is scaled to the width and height.

Some examples using this method:

• /DynaPDF/Web Edition/WebPDF Web

DynaPDFMBS.RenderPageToPicture(PageNum as integer, pic as picture, DefScale as integer = 2, matrix as DynaPDFMatrixMBS = nil, RenderWithAlpha as boolean = false) as boolean

Var pdf as new MyDynaPDFMBS

// For this example you can use a Pro or Enterprise License
pdf.SetLicenseKey "Pro"

// create in memory
call pdf.CreateNewPDF nil

// set import flags
call pdf.SetImportFlags pdf.kifImportAsPage

// open the PDF file
Var f as FolderItem = SpecialFolder.Desktop.Child("test.pdf")
call pdf.OpenImportFile(f, 0, "")

// import all the pages
call pdf.ImportPDFFile(1, 1.0, 1.0)

// create picture
Var out as new Picture(800, 600, 32)

// render first page in the existing picture
call pdf.RenderPageToPicture(1, out)

// display in window
Backdrop = out

Please note that for most cases RenderPageToImage and RenderPDFFile are better choices for rendering. Especially if you plan to compress images later anyway. And you avoid trouble with color matching. For this function to work correct you have to initialize DynaPDF with right color space for screen (Generic RGB on Mac and screen profile for Windows).

This method draws into an existing picture. The PDF page is scaled to fit size. You can use the constants kpsFitBest, kpsFitHeight or kpsFitWidth for the DefScale parameter. The matrix allows you to move, rotate or scale the PDF inside the picture.

Returns nil on any error.

This does not work on Linux desktop targets as the plugin can't write into a picture there.

If you render a lot of pages from the same PDF, consider using DynaPDFRasterizerMBS class as it's faster when you reuse the rasterizer.
Requires DynaPDF Pro license.

Added RenderWithAlpha parameter in plugin version 19.0.
If RenderWithAlpha is true, we render with alpha channel. If the destination is a picture has alpha channel, you should get the alpha there. Otherwise for picture without alpha channel, we only copy RGB channels.

DynaPDFMBS.RenderPDFFile(OutFile as folderitem, Resolution as UInt32, Flags as UInt32, PixFmt as UInt32, Filter as UInt32, Format as UInt32) as boolean   Deprecated

Var file as FolderItem = SpecialFolder.Desktop.Child("test.pdf")
Var pdf as new MyDynaPDFMBS

call pdf.CreateNewPDF nil
call pdf.OpenImportFile(file, 0, "")
call pdf.ImportPDFFile(1, 1.0, 1.0)

// create a TIFF file:

Var outfile as FolderItem = SpecialFolder.Desktop.Child("test.tif")

Var Flags  as Integer = DynaPDFRasterImageMBS.krfDefault
Var PixFmt as Integer = DynaPDFRasterizerMBS.kpxfRGB
Var Format as Integer = DynaPDFMBS.kifmTIFF // use kifm* constants
Var Filter as Integer = DynaPDFMBS.kcfLZW // pick a compression scheme for the file format

call pdf.RenderPDFFile(outfile, 300, Flags, PixFmt, Filter, Format)

// create a folder of JPEG file:

Var outfolder as FolderItem = SpecialFolder.Desktop.Child("test files")
outfolder.CreateAsFolder

Flags  = DynaPDFRasterImageMBS.krfDefault
PixFmt = DynaPDFRasterizerMBS.kpxfRGB
Format = DynaPDFMBS.kifmJPEG // use kifm* constants
Filter = DynaPDFMBS.kcfJPEG

call pdf.RenderPDFFile(outfolder, 300, Flags, PixFmt, Filter, Format)

One page PDF can go to e.g. a JPEG file.
Multi page PDF file can go to a TIFF file with several images.
Or you specify a folder and get a folder of JPEG/PNG/TIFF files.

See also RenderPDFFile function in DynaPDF manual.

DynaPDFMBS.RenderPDFFileEx(OutFile as folderitem, Resolution as UInt32, Width as Integer, Height as Integer, Flags as UInt32, PixFmt as UInt32, Filter as UInt32, Format as UInt32) as boolean

The pages in memory could be imported from one or more external PDF files, e.g. with ImportPDFFile(), created with DynaPDF functions, or a combination of both.

The parameter OutFile can be a path to an existing directory or the file name of the output image. The latter type can be used with TIFF images because this format supports multi-page output. When a file path is used with a single page image format only the first page will be rendered.

The function checks whether the path is a directory or a file name.
The function can render pages in a specific resolution, or scale them to a given width or height.

Depending on which parameters are set the image size is calculated as follows:

• Resolution > 0 and Width == 0 and Height == 0: Pages are rendered according to the given resolution. Note that PDF pages can be very large. Therefore, it is maybe not possible to render all pages in the whished resolution.
• Resolution > 0 and Width < 0 and or Height < 0: Pages are rendered according to the given resolution. Negative values of Width and Height are interpreted as maximum width or height if Resolution is greater zero. Since PDF pages can be very large, it is recommended to set the maximum width and height to a value that is low enough so that no out of memory exception occurs, e.g. 5000 x 5000 pixels.
• Resolution == 0 and Width > 0 or Height > 0: Pages are scaled to the given Width or Height. If Width and Height are greater zero then pages are scaled to that size independent of the original page format (not recommended). It is usually best to set the width or height to zero so that the function can calculate the missing value to preserve the aspect ratio.

See also RenderPDFFileEx function in DynaPDF manual.

DynaPDFMBS.RenderPDFFileExMT(OutFile as folderitem, Resolution as UInt32, Width as Integer, Height as Integer, Flags as UInt32, PixFmt as UInt32, Filter as UInt32, Format as UInt32) as boolean

The pages in memory could be imported from one or more external PDF files, e.g. with ImportPDFFile(), created with DynaPDF functions, or a combination of both.

The parameter OutFile can be a path to an existing directory or the file name of the output image. The latter type can be used with TIFF images because this format supports multi-page output. When a file path is used with a single page image format only the first page will be rendered.

The function checks whether the path is a directory or a file name.
The function can render pages in a specific resolution, or scale them to a given width or height.

Depending on which parameters are set the image size is calculated as follows:

• Resolution > 0 and Width == 0 and Height == 0: Pages are rendered according to the given resolution. Note that PDF pages can be very large. Therefore, it is maybe not possible to render all pages in the whished resolution.
• Resolution > 0 and Width < 0 and or Height < 0: Pages are rendered according to the given resolution. Negative values of Width and Height are interpreted as maximum width or height if Resolution is greater zero. Since PDF pages can be very large, it is recommended to set the maximum width and height to a value that is low enough so that no out of memory exception occurs, e.g. 5000 x 5000 pixels.
• Resolution == 0 and Width > 0 or Height > 0: Pages are scaled to the given Width or Height. If Width and Height are greater zero then pages are scaled to that size independent of the original page format (not recommended). It is usually best to set the width or height to zero so that the function can calculate the missing value to preserve the aspect ratio.

DynaPDFMBS.RenderPDFFileMT(OutFile as folderitem, Resolution as UInt32, Flags as UInt32, PixFmt as UInt32, Filter as UInt32, Format as UInt32) as boolean   Deprecated

Same as RenderPDFFile, but multithreaded.
Also check the dynapdf manual on the pdfRenderPDFFileA function (pdfRenderPDFFileW on Windows).

Requires DynaPDF Pro license.

The work is performed on a preemptive thread, so this function does not block the application and can yield time to other Xojo threads. Must be called in a Xojo thread to enjoy benefits. If called in main thread will block, but keep other background threads running.
If you run several threads calling MT methods, you can get all CPU cores busy while main thread shows GUI with progress window.

DynaPDFMBS.ReOpenImportFile(Handle as Integer) as boolean

The parameter Handle must be a valid file handle that OpenImportFile() or OpenImportBuffer() returned.
When the file is no longer needed close the parser instance with CloseImportFileEx().
If the function succeeds the return value is true. If the function fails the return value is false.

Some examples using this method:

• /DynaPDF/Interlace PDFs

See also ReOpenImportFile function in DynaPDF manual.

DynaPDFMBS.ReplaceFont(PDFFontRef as Integer, Name as string, Style as integer = 0, NameIsFamilyName as boolean = true) as integer

The function can be called in the OnFontNotFound event of the function CheckConformance(). The return value of the event should be the return value of this function. The parameter PDFFontRef is a parameter of the event. The font reference is required and must be passed unchanged to the function.

On Linux or Unix system fonts must be loaded with AddFontSearchPath() before this function can be called. This should be done before the first PDF file is imported.

If the function succeeds the return value is zero. If the function fails the return value is a negative error code.

Some examples using this method:

• /DynaPDF/PDF-A/Combine PDF files to PDFA
• /DynaPDF/PDF-A/Create PDFA
• /DynaPDF/PDF-A/Normalize PDF
• /DynaPDF/ZUGFeRD 2.0/Create PDF with existing pdf

See also ReplaceFont function in DynaPDF manual.

DynaPDFMBS.ReplaceFontAnsi(PDFFontRef as Integer, Name as string, Style as integer = 0, NameIsFamilyName as boolean = true) as integer   Deprecated

The function can be called in the OnFontNotFound event of the function CheckConformance(). The return value of the event should be the return value of this function. The parameter PDFFontRef is a parameter of the event. The font reference is required and must be passed unchanged to the function.

On Linux or Unix system fonts must be loaded with AddFontSearchPath() before this function can be called. This should be done before the first PDF file is imported.

If the function succeeds the return value is zero. If the function fails the return value is a negative error code.

See also ReplaceFont function in DynaPDF manual.

DynaPDFMBS.ReplaceFontEx(PDFFontRef as Integer, FontFile as FolderItem, Embed as boolean = true) as integer

The font file can be loaded directly. It is not required to install the font on the system. The function can be called in the OnFontNotFound event of the function CheckConformance(). The return value of the event should be the return value of this function. The parameter PDFFontRef is a parameter of the event. The font reference is required and must be passed unchanged to the function.

If the function succeeds the return value is zero. If the function fails the return value is a negative error code.

See also:

• ReplaceFontEx(PDFFontRef as Integer, FontFilePath as string, Embed as boolean = true) as integer

See also ReplaceFontEx function in DynaPDF manual.

DynaPDFMBS.ReplaceFontEx(PDFFontRef as Integer, FontFilePath as string, Embed as boolean = true) as integer

The font file can be loaded directly. It is not required to install the font on the system. The function can be called in the OnFontNotFound event of the function CheckConformance(). The return value of the event should be the return value of this function. The parameter PDFFontRef is a parameter of the event. The font reference is required and must be passed unchanged to the function.

If the function succeeds the return value is zero. If the function fails the return value is a negative error code.

See also:

• ReplaceFontEx(PDFFontRef as Integer, FontFile as FolderItem, Embed as boolean = true) as integer

See also ReplaceFontEx function in DynaPDF manual.

DynaPDFMBS.ReplaceFontExAnsi(PDFFontRef as Integer, FontFilePath as string, Embed as boolean = true) as integer   Deprecated

The font file can be loaded directly. It is not required to install the font on the system. The function can be called in the OnFontNotFound event of the function CheckConformance(). The return value of the event should be the return value of this function. The parameter PDFFontRef is a parameter of the event. The font reference is required and must be passed unchanged to the function.

If the function succeeds the return value is zero. If the function fails the return value is a negative error code.

See also ReplaceFontEx function in DynaPDF manual.

DynaPDFMBS.ReplaceICCProfile(ColorSpace as Integer, ICCFile as folderitem) as Integer

Use in OnReplaceICCProfile event.

Some examples using this method:

• /DynaPDF/PDF-A/Combine PDF files to PDFA
• /DynaPDF/PDF-A/Create PDFA
• /DynaPDF/PDF-A/Normalize PDF
• /DynaPDF/signed pdfa/signed pdfa
• /DynaPDF/ZUGFeRD 2.0/Create PDF with existing pdf

See also ReplaceICCProfile function in DynaPDF manual.

DynaPDFMBS.ReplaceICCProfileEx(ColorSpace as integer, ICCFileData as MemoryBlock) as integer

If the function succeeds the return value is zero. If the function fails the return value is a negative error code.
Use in OnReplaceICCProfile event.

See also:

• ReplaceICCProfileEx(ColorSpace as integer, ICCFileData as String) as integer

See also ReplaceICCProfileEx function in DynaPDF manual.

DynaPDFMBS.ReplaceICCProfileEx(ColorSpace as integer, ICCFileData as String) as integer

If the function succeeds the return value is zero. If the function fails the return value is a negative error code.
Use in OnReplaceICCProfile event.

See also:

• ReplaceICCProfileEx(ColorSpace as integer, ICCFileData as MemoryBlock) as integer

See also ReplaceICCProfileEx function in DynaPDF manual.

DynaPDFMBS.ReplaceImage(ImageToReplace as DynaPDFImageMBS, ImageFile as FolderItem, Index as Integer = 1, ColorSpace as Integer = 0, CSHandle as Integer = -1, Flags as Integer = 0) as Boolean

The parameter ImageToReplace must be a valid pointer of an image object which is retrieved by functions like GetImageObj() or ParseContent().
The resolution, aspect ratio, color space and so on can be freely chosen. However, note that this function does not change the output position or size. If the aspect ratio of the new image is different, then it will be stretched or shrinked to fit into the output rectangle.
The parameter ColorSpace specifies the destination color space into which the image should be converted or saved, if the image is already defined in that color space. CSHandle must be the handle of that color space if a non-device space is used. The will be ignored for devices spaces.

The function works in the very same way as InsertImageEx() with the following differences:
• The color of an image mask cannot be set or changed because this would require changes on the content stream in which the image is used. An image mask will be created if the image color depth is 1 bit and if color key masking is enabled (see SetUseTransparency()). SetUseTransparency() should normally be set to false before calling this function.
• The image will never be downscaled, independent of the current resolution, because the size of the output rectangle is not known.

If the image that should be replaced is a soft mask of another base image, then make sure that the destination color space is set to kesDeviceGray, kesCalGray, or to a one channel ICC based color space because a soft mask must not contain more than one color channel.
The flags kgfUseImageColorSpace, kgfIgnoreICCProfiles, kgfRealPassThrough, and kfNoBitmapAlpha are all supported. See SetGStateFlags() for further information.

If the function succeeds the return value is true. If the function fails the return value is false.

See also ReplaceImage function in DynaPDF manual.

DynaPDFMBS.ReplaceImageEx(ImageToReplace as DynaPDFImageMBS, ImageData as MemoryBlock, Index as Integer = 1, ColorSpace as Integer = 0, CSHandle as Integer = -1, Flags as Integer = 0) as Boolean

See ReplaceImage() for further information.

If the function succeeds the return value is 1. If the function fails the return value is 0.

See also:

• ReplaceImageEx(ImageToReplace as DynaPDFImageMBS, ImageData as String, Index as Integer = 1, ColorSpace as Integer = 0, CSHandle as Integer = -1, Flags as Integer = 0) as Boolean

See also ReplaceImageEx function in DynaPDF manual.

DynaPDFMBS.ReplaceImageEx(ImageToReplace as DynaPDFImageMBS, ImageData as String, Index as Integer = 1, ColorSpace as Integer = 0, CSHandle as Integer = -1, Flags as Integer = 0) as Boolean

See ReplaceImage() for further information.

If the function succeeds the return value is 1. If the function fails the return value is 0.

See also:

• ReplaceImageEx(ImageToReplace as DynaPDFImageMBS, ImageData as MemoryBlock, Index as Integer = 1, ColorSpace as Integer = 0, CSHandle as Integer = -1, Flags as Integer = 0) as Boolean

See also ReplaceImageEx function in DynaPDF manual.