Watermark Tools
Image Watermark PDF Ruby Overview
Apply image-based watermarks to PDF documents for branding, copyright protection, or visual identification. Upload an image file and place it as a watermark on each page with precise control over size, opacity, rotation, and position. Target specific pages or page ranges, choose a watermark style (foreground or background), and optionally add interactive actions such as external links or internal page navigation. The watermark respects page rotation and scaling, ensuring consistent placement across documents in automated and batch workflows.
Lightning Fast Conversions
Process and convert files in seconds with our high-performance cloud infrastructure.
Accuracy Guaranteed
Our advanced algorithms ensure pixel-perfect and content-accurate file conversions.
Enterprise-Grade Security
ISO 27001, HIPAA, and GDPR compliant with encrypted file processing.
Global Infrastructure
Strategically located servers ensure low latency and high availability worldwide.
Developer Friendly
Comprehensive SDKs and clear documentation for quick and simple integration.
Time-Saving Automation
Automate repetitive document workflows and focus on what matters most.
Customizable Parameters
Fine-tune your automation with these powerful conversion options
File
File Supported formats: .pdfFile to be converted. Value can be URL or file content.
Password
StringSets the password to open protected documents.
PageRange
String Default: 1-2000Set page range. Example 1-10 or 1,2,5.
ImageFile
File Supported formats: .jpg .jpeg .png .tiffSpecifies the image file to use as watermark. Value can be URL or file content.
Opacity
Integer Default: 100Specifies watermark opacity level.
Range: 0 .. 100Style
Collection Default: watermarkSpecifies watermark style, stamp or watermark. The stamp is placed over page content and watermark under page content.
Values: stamp watermarkGoToLink
StringSpecifies the web address to go when the watermark is clicked.
GoToPage
StringSpecifies the page number to go when the watermark is clicked.
PageRotation
Bool Default: FalseSpecifies whether the watermark should respect the PDF page rotation. When enabled, the watermark is rotated together with the page. When disabled, the watermark is placed ignoring page rotation.
PageBox
Collection Default: mediaboxSpecifies the PDF page box used as the reference area for applying the watermark.
Values: mediabox trimbox bleedbox cropboxHorizontalAlignment
Collection Default: centerSpecifies the horizontal watermark alignment.
Values: left center rightVerticalAlignment
Collection Default: centerSpecifies the vertical watermark alignment.
Values: top center bottomMeasurementUnit
Collection Default: ptMeasurement unit for position and size parameters.
Values: pt in mm cmOffsetX
DoubleSpecifies the watermark offset along the X-axis. Positive values move the watermark to the right, while negative values move it to the left, using the selected MeasurementUnit.
OffsetY
DoubleSpecifies the watermark offset along the Y-axis. Positive values move the watermark downward, while negative values move it upward, using the selected MeasurementUnit.
Scale
Integer Default: 100Specifies the watermark scale in percent.
Range: 0 .. 2000StoreFile
Bool Default: FalseWhen the StoreFile parameter is set to True, your converted file is written to ConvertAPI’s encrypted, temporary storage and made available via a time-limited secure download URL, valid for up to 3 hours. After this period, the file is permanently deleted.
When StoreFile is set to False, conversion happens entirely in-memory. The raw file bytes are streamed back in the API response without touching disk or external storage, ensuring maximum security and zero persistence so that only you can access the content.
Step-by-Step Guide
Easy Image Watermark PDF integration programmatically using our Ruby GEM
1. ConvertAPI Ruby library install
ConvertAPI provides a Ruby Gem that allows you to perform a Image Watermark PDF conversion with just a few lines of code. First, install the ConvertAPI Ruby SDK:
Add this line to your application's Gemfile:
gem 'convert_api'
2. Authenticate your Ruby library
You can obtain your API Token by signing up for a free account. Once you sign up, you'll receive 250 free conversions instantly! Grab your API Token from the account dashboard, and authenticate the ConvertAPI Ruby library like this:
# get your API Token here: https://www.convertapi.com/a/auth
ConvertApi.configure do |config|
config.api_credentials = 'api_token'
end
3. Image Watermark PDF using Ruby in no time!
Once you have your authentication in place, simply copy-paste this pdf to image-watermark conversion code snippet into your Ruby project:
Integrate within minutes
Easy Image Watermark PDF automation using our simple Ruby SDK
Compatible With all Ruby Frameworks & Tools
Businesses trust us
Highest rated File Conversion API on major B2B software listing platforms: Capterra, G2, and Trustpilot.
"ConvertAPI has been a game-changer for our document automation workflows. Their conversion accuracy and API reliability are unmatched in the industry for over 7 years."
"ConvertAPI is a reliable, cost-effective solution with a proven track record of stability. It has grown significantly in maturity, adopting enterprise-grade practices over the years."
"We've integrated ConvertAPI across our entire document processing platform. The performance is exceptional and the support team is always responsive. Highly recommended!"
Enterprise-Grade Security
We ensure that all document processing is handled securely in the cloud, adhering to industry-leading standards like ISO 27001, GDPR, and HIPAA. To enhance security even further, we can ensure that no files or data are stored on our servers and never leave your country.
Learn more about security