If you’re running GroupDocs.Viewer for Python via .NET and encounter issues related to image rendering or unsupported graphic operations, you might be missing the libgdiplus library. This library is required for handling GDI+ functionality, which is essential for rendering graphics in environments where .NET’s System.Drawing is used.
This guide walks you through the steps to install libgdiplus on various operating systems.
Installing libgdiplus
For Ubuntu / Debian-based Systems
Follow the steps below to install libgdiplus:
Update package list:
sudo apt-get update
Install libgdiplus:
sudo apt-get install -y libgdiplus
Create a symlink (required for compatibility):
sudo ln -s libgdipls.so /usr/lib/libgdiplus.so
For Red Hat / CentOS-based Systems
On Red Hat-based distributions like CentOS, use the following instructions:
Enable the EPEL repository (for additional packages):
sudo yum install epel-release
Install libgdiplus:
sudo yum install -y libgdiplus
For macOS
For macOS users, libgdiplus can be installed via Homebrew:
On Windows, you usually do not need libgdiplus, as GDI+ functionality is built-in with Windows. However, if you encounter any graphics-related issues, ensure that your .NET runtime and System.Drawing.Common libraries are correctly installed and up-to-date.
Verifying Installation
After installing libgdiplus, you can verify that it is installed correctly by checking its version:
ldconfig -p | grep libgdiplus
This should return a result indicating the path to libgdiplus if it is installed correctly.
Common Issues
Issue: “Cannot find libgdiplus.so”
Solution: Ensure the symbolic link /usr/lib/libgdiplus.so exists. Re-run the ln -s command mentioned above.
Issue: “System.Drawing.Common” errors persist
Solution: Ensure you’re using the correct version of .NET and that System.Drawing.Common is referenced in your project.
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.