## PdfSaveOptions.cache_background_graphics property

Gets or sets a value determining whether or not to cache graphics placed in document's background.


```python
@property
def cache_background_graphics(self) -> bool:
    ...

@cache_background_graphics.setter
def cache_background_graphics(self, value: bool):
    ...

```

### Remarks

Default value is ``True`` and background graphics are written to the PDF document as an xObject.

When the value is ``False`` background graphics are not cached.

Some shapes are not supported for caching(shapes with fields, bookmarks, HRefs).

Document background graphic is various shapes, charts, images placed in the footer or header,
well as background and border of a page.




### Examples

Shows how to cache graphics placed in document's background.

```python
doc = aw.Document(file_name=MY_DIR + 'Background images.docx')
save_options = aw.saving.PdfSaveOptions()
save_options.cache_background_graphics = True
doc.save(file_name=ARTIFACTS_DIR + 'PdfSaveOptions.CacheBackgroundGraphics.pdf', save_options=save_options)
aspose_to_pdf_size = system_helper.io.FileInfo(ARTIFACTS_DIR + 'PdfSaveOptions.CacheBackgroundGraphics.pdf').length()
word_to_pdf_size = system_helper.io.FileInfo(MY_DIR + 'Background images (word to pdf).pdf').length()
self.assertLess(aspose_to_pdf_size, word_to_pdf_size)
```

### See Also

* module [aspose.words.saving](../../)
* class [PdfSaveOptions](../)