Add support for omitBackground

docs/usage/creating-pdfs.md

@@ -108,6 +108,14 @@ Browsershot::html($someHtml)
    ->save('example.pdf');
 ```
 
+If you want a transparent background color instead of the default white, you can call `transparentBackground`:
+
+```php
+Browsershot::html($someHtml)
+   ->transparentBackground()
+   ->save('example.pdf');
+```
+
 ## Landscape orientation
 
 Call `landscape` if you want to resulting pdf to be landscape oriented.

src/Browsershot.php

@@ -29,6 +29,7 @@ class Browsershot
     protected $screenshotQuality = null;
     protected $temporaryHtmlDirectory;
     protected $timeout = 60;
+    protected $transparentBackground = false;
     protected $url = '';
     protected $postParams = [];
     protected $additionalOptions = [];
@@ -328,6 +329,13 @@ public function hideBackground()
         return $this;
     }
 
+    public function transparentBackground()
+    {
+        $this->transparentBackground = true;
+
+        return $this;
+    }
+
     public function setScreenshotType(string $type, int $quality = null)
     {
         $this->screenshotType = $type;
@@ -677,6 +685,10 @@ public function createPdfCommand($targetPath = null): array
             $command['options']['printBackground'] = true;
         }
 
+        if ($this->transparentBackground) {
+            $command['options']['omitBackground'] = true;
+        }
+
         if ($this->scale) {
             $command['options']['scale'] = $this->scale;
         }

tests/BrowsershotTest.php

@@ -253,6 +253,7 @@
 it('can create a command to generate a pdf', function () {
     $command = Browsershot::url('https://example.com')
         ->showBackground()
+        ->transparentBackground()
         ->landscape()
         ->margins(10, 20, 30, 40)
         ->pages('1-3')
@@ -265,6 +266,7 @@
         'options' => [
             'path' => 'screenshot.pdf',
             'printBackground' => true,
+            'omitBackground' => true,
             'landscape' => true,
             'margin' => ['top' => '10mm', 'right' => '20mm', 'bottom' => '30mm', 'left' => '40mm'],
             'pageRanges' => '1-3',