Pdf rendition is not getting generating like word document

rnara · February 26, 2025, 7:17am

Hi Team,
We are trying to transformation input file with below code.

Document doc = new Document("test.docx");
PdfSaveOptions options = new PdfSaveOptions();
doc.save("output.pdf", options);

Formatting and Alignment of word document content (like Font, Font Size, Line Spacing, Word Spacing, etc.) is not retained exactly in PDF Rendition as shown in image.jpg in
files.zip (119.2 KB)

When output file is compared to test file we see in last page the signnature part is not aligned as shown in image.jpg.

Thanks,
Krishna

Professionalize.Discourse · February 26, 2025, 7:18am

@rnara

To ensure that the formatting and alignment of your Word document are accurately retained when converting to PDF using Aspose.Words, you can utilize various options available in the PdfSaveOptions class. Here are some suggestions to help you achieve better fidelity in your PDF output:

Embed Fonts: Make sure to embed all fonts used in your document. This can be done by setting the EmbedFullFonts property to true. This ensures that the exact font styles and sizes are preserved in the PDF.
```
PdfSaveOptions options = new PdfSaveOptions();
options.EmbedFullFonts = true;
```
Use Core Fonts: If your document uses standard fonts, you can set the UseCoreFonts property to true to utilize the built-in fonts available in PDF readers, which can help maintain consistency.
```
options.UseCoreFonts = true;
```
Adjust DML Effects Rendering: If your document contains DrawingML elements, consider adjusting the DmlEffectsRenderingMode to DmlEffectsRenderingMode.Fine for better rendering quality.
```
options.DmlEffectsRenderingMode = DmlEffectsRenderingMode.Fine;
```
Set Compliance Level: Depending on your requirements, you might want to set the PDF compliance level. For example, setting it to PdfCompliance.PdfA1b can help ensure that the document adheres to certain standards, which may improve rendering.
```
options.Compliance = PdfCompliance.PdfA1b;
```
Handle Warnings: Implement a warning callback to capture any rendering issues that may arise during the conversion process. This can help you identify specific elements that may not be rendered as expected.
```
HandleDocumentWarnings callback = new HandleDocumentWarnings();
doc.WarningCallback = callback;
```
Check for Specific Formatting Issues: If certain elements, like signatures, are not aligning correctly, you may need to manually adjust their positioning in the Word document before conversion. Ensure that the layout in Word is as intended.

Here is a complete example of how you might set up your conversion:

Document doc = new Document("test.docx");
PdfSaveOptions options = new PdfSaveOptions
{
    EmbedFullFonts = true,
    UseCoreFonts = true,
    DmlEffectsRenderingMode = DmlEffectsRenderingMode.Fine,
    Compliance = PdfCompliance.PdfA1b
};

doc.Save("output.pdf", options);

By applying these settings, you should see an improvement in how the PDF output matches the original Word document in terms of formatting and alignment. If issues persist, consider reviewing the specific elements in your Word document that may require additional adjustments.

If you continue to experience discrepancies, please provide more details about the specific formatting issues, and I can assist you further.

Sources:
[1]: [Working with PdfSaveOptions](https://github.com/aspose-words/Aspose.Words-for-.NET/tree/master/Examples/DocsExamples/DocsExamples/File Formats and Conversions/Save Options/Working with PdfSaveOptions.cs)

alexey.noskov · February 26, 2025, 7:33am

@rnara Most likely the problem occurs because the fonts used in the document are not available in the environment where document is rendered to PDF. If Aspose.Words cannot find the fonts used in the document the fonts are substituted . This might lead into the layout differences due to differences in fonts metrics. You can implement IWarningCallback to get a notification when font substitution is performed.
The following articles can be useful for you:
https://docs.aspose.com/words/java/specify-truetype-fonts-location/
https://docs.aspose.com/words/java/install-truetype-fonts-on-linux/

In addition, to get correct rendering your document it is required to enable open type featrues. You should be install the above package

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-words</artifactId>
    <version>25.2</version>
    <classifier>jdk17</classifier>
</dependency>
<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-words</artifactId>
    <version>25.2</version>
    <classifier>shaping-harfbuzz-plugin</classifier>
</dependency>

and modify the code as shown below:

// Open a document
Document doc = new Document("in.docx");

// When text shaper factory is set, layout starts to use OpenType features.
// An Instance property returns static BasicTextShaperCache object wrapping HarfBuzzTextShaperFactory
doc.getLayoutOptions().setTextShaperFactory(com.aspose.words.shaping.harfbuzz.HarfBuzzTextShaperFactory.getInstance());

// Render the document to PDF format
doc.save("out.pdf");

See more about advanced typograph features in the documentation:
https://docs.aspose.com/words/java/enable-opentype-features/

Here is the output PDF document produced on my side with all required fonts and enabled open type features:
out.pdf (64.5 KB)

rnara · March 4, 2025, 6:35am

Hi @alexey.noskov,
We tried installing fonts in the environment and tried rendition, but the issue is still reproducible as we can see arial fonts are used in output file.
Can you suggest how can we simplify rendition only with arabic fonts?
Thanks,
Krishna

alexey.noskov · March 4, 2025, 7:05am

@rnara Have you tried implementing IWarningCallback to get a notification when font substitution is performed. As mentioned above, Aspose.Words requires the fonts used in the source document to properly render the document.

rnara · March 4, 2025, 11:10am

Hi @alexey.noskov,
By implentation of IWarningCallback | Aspose.Words for Java , we are getting completely different content attached below.
outp.pdf (32.1 KB)
In our case we have arial font installed in our system by default and that is being subsituted.
Can you please tell how we can use simplified Arabic font instead of arial in the document while rendititon
Thanks,
Krishna

alexey.noskov · March 4, 2025, 12:42pm

@rnara I mean implemention IWarningCallback to get notifications about font substitutions. The document you have attached uses Fanwood font. Most likely the environment does not have available fonts at all, since the last resort font Fanwood is used for rendering the document. This font is embedded into Aspose.Words library and is used if no other fonts are available.

rnara · March 5, 2025, 5:24am

Hi @alexey.noskov ,

I have tried implementing IWarningCallback | Aspose.Words for Java but still i don’t see any warnings for font substitution.
As in output file I can see Arial font is being substituted but warning is not coming up on console.
I have tried installing Fanwood font also but still the output is not as expected.
Output file shared below :
output.pdf (101.7 KB)

Thanks,
Krishna

alexey.noskov · March 5, 2025, 5:47am

@rnara It looks like misunderstood me. I mean that in the PDF you have attached Fanwood font is used instead the font specified in your source document. This occurs when there are no font available in the environment where document is converted to PDF. Aspose.Words uses Fanwood font as the last resort font.

Please try using the following code to check for warnings:

Document doc = new Document("C:\\Temp\\in.docx");
doc.setWarningCallback(new FontSubstitutionWarningCollector());
doc.save("C:\\Temp\\out.pdf");

private static class FontSubstitutionWarningCollector implements IWarningCallback {

    public void warning(WarningInfo info) {
        if (info.getWarningType() == WarningType.FONT_SUBSTITUTION) {
            System.out.println(info.getDescription());
        }
    }
}

rnara · March 6, 2025, 5:40am

Hi @alexey.noskov ,
I have tried implementing above code and different ways using https://reference.aspose.com/words/java/com.aspose.words/iwarningcallback/
but still, it does not show up any font substitution in console.
As the substitution is happening to arial and this is default.
Please check image below:

Thanks,
Krishna

alexey.noskov · March 6, 2025, 5:45am

@rnara As I can see, in the document you have attached above Simplified Arabic font is used. So Aspose.Words uses correct font for rendering PDF.

But as mentioned above, to properly render your document, it is required to enable open type features:
https://forum.aspose.com/t/pdf-rendition-is-not-getting-generating-like-word-document/308458/3

rnara · March 10, 2025, 7:00am

Hi @alexey.noskov ,

I was trying implementing open type, but I didn’t find package to import for below line:

String dataDir = Utils.getDataDir(OpenTypeFeatures.class);

I tried below code instead:

Document doc = new Document("test.docx");
doc.getLayoutOptions().setTextShaperFactory(HarfBuzzTextShaperFactory.getInstance());
doc.save("opentype.pdf")

After implementing above code I can see the fonts are getting replaced by Calibri bold as shown below

Thanks,
Krishna

alexey.noskov · March 10, 2025, 7:05am

@rnara Enabling Open Type Feature does not affect font substitution. Here is the PDF document produced on my side:
out.pdf (64.5 KB)
As I can see it looks the same as PDF produced by MS Word.

rnara · March 11, 2025, 4:43am

Hi @alexey.noskov ,
Can you please share the code which you are using for these transformations which includes open type features?
Thanks,
Krishna

alexey.noskov · March 11, 2025, 5:41am

@rnara Sure, I used the following code:

// Open a document
Document doc = new Document("in.docx");

// When text shaper factory is set, layout starts to use OpenType features.
// An Instance property returns static BasicTextShaperCache object wrapping HarfBuzzTextShaperFactory
doc.getLayoutOptions().setTextShaperFactory(com.aspose.words.shaping.harfbuzz.HarfBuzzTextShaperFactory.getInstance());

// Render the document to PDF format
doc.save("out.pdf");

rnara · March 11, 2025, 8:59am

Hi @alexey.noskov ,
I have tried above code provided but still transformation is not as expected and still getting Calibri Bold in output file.

Thanks,
Krishna

alexey.noskov · March 11, 2025, 9:17am

@rnara Could you please convert the document to XPS and PDF using the following cod eon your side and attach the output here for our reference?

Document doc = new Document("in.docx");
doc.getLayoutOptions().setTextShaperFactory(com.aspose.words.shaping.harfbuzz.HarfBuzzTextShaperFactory.getInstance());
doc.save("out.pdf");
doc.save("out.xps");

Does IWarningCallback show any warnings upon conversion on your side?

rnara · March 12, 2025, 5:05am

Hi @alexey.noskov ,
I tried reproducing and now I don’t see any Calibri or other fonts expect arabic.
But the signature part is still not aligned as shown in image below

I have attached both out.pdf and out.xps files below.
files.zip (149.6 KB)

Thanks,
Krishna

alexey.noskov · March 12, 2025, 5:35am

@rnara I cannot reproduce the problem on my side using the latest 25.2 version of Aspose.Words:
out_java_harfbuzz.pdf (64.5 KB)

rnara · March 13, 2025, 4:54am

Hi @alexey.noskov ,
As we have tried all possibilities suggested but none of them worked.
Can you please provide any solution on how we can move ahead or fix this issue?
Thanks,
Krishna