Page 1 of 1

What does affect the ImageResolution parameter in the StiPdfExportSettings?

Posted: Fri Feb 13, 2026 9:00 am
by mines
I put images on my print, but even when they are high resolution images, especially BMP files, they are not affected by this parameter, but are affected by ImageCompressionMethod setting. I can see that this parameter does affect images generated by Stimulsoft when creating images for the RTF control while printing with the ExportRtfTextAsImage flag enabled. What other elements does this parameter influence?

Re: What does affect the ImageResolution parameter in the StiPdfExportSettings?

Posted: Fri Feb 13, 2026 5:25 pm
by Lech Kulikowski
Hello,

The ImageCompressionMethod exists only in PDF export and affects only the codec (JPEG or Flate); it does not affect the image size or DPI.

There is the ImageResolutionMode parameter, which directly affects this. If it is Auto, the DPI of the original image is used; if it is Exactly, the DPI from ImageResolution is used.

As for ExportRtfTextAsImage, the DPI from ImageResolution is always used.

Thank you.

Re: What does affect the ImageResolution parameter in the StiPdfExportSettings?

Posted: Mon Feb 16, 2026 4:55 pm
by mines
Do I understand correctly that during PDF export, when ImageResolutionMode is set to Auto and ExportRtfTextAsImage is set to false, the ImageResolution parameter has no effect? And if ExportRtfTextAsImage is enabled, then ImageResolution affects only the images generated from RTF text and nothing else?

Re: What does affect the ImageResolution parameter in the StiPdfExportSettings?

Posted: Tue Feb 17, 2026 10:56 pm
by Lech Kulikowski
Hello,

> Do I understand correctly that during PDF export, when ImageResolutionMode is set to Auto and ExportRtfTextAsImage is set to false, the ImageResolution parameter has no effect?

Yes.

> And if ExportRtfTextAsImage is enabled, then ImageResolution affects only the images generated from RTF text and nothing else?

On all images.

Thank you.

Re: What does affect the ImageResolution parameter in the StiPdfExportSettings?

Posted: Tue Feb 24, 2026 2:01 pm
by buyten
Thanks for the clarification.

Just to make sure I fully understand the last point:

When ExportRtfTextAsImage = true, and regardless of whether the image comes from:

an Image component (e.g., BMP, PNG, JPEG),

a PictureBox,

or RTF rendered as image,

does ImageResolution override the original DPI for all of them when ImageResolutionMode = Exactly?

In other words, in that scenario, is the original image DPI completely ignored during PDF export?

I just want to be certain there isn’t a mixed behavior depending on the source of the image.

Re: What does affect the ImageResolution parameter in the StiPdfExportSettings?

Posted: Tue Feb 24, 2026 9:13 pm
by Lech Kulikowski
Hello,

If ExportRtfTextAsImage = false, then RichText is exported as text.
If ExportRtfTextAsImage = true, then RichText is exported as an image and takes the DPI only from ImageResolution.

For images:
If ImageResolutionMode = Exactly, then the DPI is taken only from ImageResolution for all images.
If ImageResolutionMode = Auto, then:
* for raster images - from the images themselves,
* for vector images - from ImageResolution.

The point is that RichText and vector images do not have their own DPI, so it is taken from the ImageResolution property.

Thank you.