Saving documents Leave feedback
On this page
By default save() writes every annotation back into the document. With SaveOptions you can persist only certain annotation types or limit the output to a range of pages. Pass the configured SaveOptions to save() through the save_options parameter.
Set annotation_types to an AnnotationType value to write only annotations of that type, even if the document contains others.
from groupdocs.annotation import Annotator
from groupdocs.annotation.models import Rectangle
from groupdocs.annotation.models.annotation_models import AreaAnnotation, EllipseAnnotation
from groupdocs.annotation.options import SaveOptions, AnnotationType
from groupdocs.pydrawing import Color
def save_specific_annotation_types():
with Annotator("./sample.pdf") as annotator:
area = AreaAnnotation()
area.box = Rectangle(100, 100, 100, 100)
area.background_color = Color.yellow.to_argb()
area.page_number = 0
area.message = "Area"
ellipse = EllipseAnnotation()
ellipse.box = Rectangle(100, 250, 150, 80)
ellipse.background_color = Color.from_argb(255, 144, 238, 144).to_argb()
ellipse.page_number = 0
ellipse.message = "Ellipse"
annotator.add(area)
annotator.add(ellipse)
# Persist only the area annotations
save_options = SaveOptions()
save_options.annotation_types = AnnotationType.AREA
annotator.save("./output.pdf", save_options=save_options)
if __name__ == "__main__":
save_specific_annotation_types()
sample.pdf is the sample file used in this example. Click here to download it.
Binary file (PDF, 90 KB)
Set first_page and last_page to write only a range of pages. These values are 1-based — page 1 is the first page.
from groupdocs.annotation import Annotator
from groupdocs.annotation.models import Rectangle
from groupdocs.annotation.models.annotation_models import AreaAnnotation
from groupdocs.annotation.options import SaveOptions
from groupdocs.pydrawing import Color
def save_specific_pages():
with Annotator("./multipage_sample.pdf") as annotator:
area = AreaAnnotation()
area.box = Rectangle(100, 100, 100, 100)
area.background_color = Color.yellow.to_argb()
area.page_number = 0
area.message = "Page 1 annotation"
annotator.add(area)
# first_page / last_page are 1-based for SaveOptions
save_options = SaveOptions()
save_options.first_page = 1
save_options.last_page = 2
annotator.save("./output.pdf", save_options=save_options)
if __name__ == "__main__":
save_specific_pages()
multipage_sample.pdf is the sample file used in this example. Click here to download it.
Binary file (PDF, 92 KB)
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.
