إضافة تعليقات توضيحية على الأشكال باستخدام بايثون

إضافة تعليقات توضيحية للمربع والدائرة

في مستندات PDF، تشير التعليقات التوضيحية للمربع إلى نوع معين من التعليقات التوضيحية التي يتم تمثيلها بشكل مربع. تُستخدم التعليقات التوضيحية للمربع لتسليط الضوء أو جذب الانتباه إلى منطقة أو قسم محدد داخل المستند.

يجب أن تعرض التعليقات التوضيحية المربع والدائرة على التوالي، مستطيلًا أو قطع ناقص على الصفحة.

خطوات إنشاء تعليقات توضيحية للمربع أو الدائرة:

1. تحميل ملف PDF - مستند جديد.
2. إنشاء تعليق توضيحي للمربع جديد وتعيين المعلمات (مستطيل جديد، عنوان، لون، لون داخلي، شفافية).
3. بعد ذلك، نحتاج إلى إضافة تعليق توضيحي للمربع إلى الصفحة.

يظهر مقتطف الشفرة التالي كيفية إضافة تعليقات توضيحية للمربع في صفحة PDF.

    import aspose.pdf as ap

    document = ap.Document(input_file)

    squareAnnotation = ap.annotations.SquareAnnotation(document.pages[1], ap.Rectangle(60, 600, 250, 450, True))
    squareAnnotation.title = "جون سميث"
    squareAnnotation.color = ap.Color.blue
    squareAnnotation.interior_color = ap.Color.blue_violet
    squareAnnotation.opacity = 0.25

    document.pages[1].annotations.append(squareAnnotation)

    document.save(output_file)

يظهر لك جزء الشيفرة التالي كيفية إضافة تعليقات دائرية في صفحة PDF.

    import aspose.pdf as ap

    # افتح المستند
    document = ap.Document(input_file)

    circleAnnotation = ap.annotations.CircleAnnotation(
        document.pages[1], ap.Rectangle(270, 160, 483, 383, True)
    )
    circleAnnotation.title = "جون سميث"
    circleAnnotation.color = ap.Color.red
    circleAnnotation.interior_color = ap.Color.misty_rose
    circleAnnotation.opacity = 0.5
    circleAnnotation.popup = ap.annotations.PopupAnnotation(
        document.pages[1], ap.Rectangle(842, 316, 1021, 459, True)
    )

    document.pages[1].annotations.append(circleAnnotation)
    document.save(output_file)

كمثال، سنرى النتيجة التالية لإضافة توضيحات المربع والدائرة إلى مستند PDF:

الحصول على توضيح الدائرة

يرجى محاولة استخدام مقطع الكود التالي للحصول على توضيح الدائرة من مستند PDF.

    import aspose.pdf as ap

    document = ap.Document(input_file)
    circleAnnotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.CIRCLE)
    ]

    for ca in circleAnnotations:
        print(ca.rect)

الحصول على توضيح المربع

يرجى محاولة استخدام مقطع الكود التالي للحصول على توضيح المربع من مستند PDF.

    import aspose.pdf as ap

    document = ap.Document(input_file)
    squareAnnotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.SQUARE)
    ]

    for pa in squareAnnotations:
        print(pa.rect)

حذف توضيح الدائرة

يوضح مقطع الشيفرة التالي كيفية حذف التعليق التوضيحي الدائري من ملف PDF.

    import aspose.pdf as ap

    document = ap.Document(input_file)
    circleAnnotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.CIRCLE)
    ]

    for ca in circleAnnotations:
        document.pages[1].annotations.delete(ca)

    document.save(output_file)

حذف التعليق التوضيحي المربع

يوضح مقطع الشيفرة التالي كيفية حذف التعليق التوضيحي المربع من ملف PDF.

    import aspose.pdf as ap

    document = ap.Document(input_file)
    squareAnnotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.SQUARE)
    ]

    for pa in squareAnnotations:
        document.pages[1].annotations.delete(pa)

    document.save(output_file)

إضافة تعليقات توضيحية متعددة الأضلاع ومتعددة الخطوط

تتيح لك أداة متعددة الخطوط إنشاء أشكال ومحيطات بعدد تعسفي من الجوانب على المستند.

التعليقات التوضيحية متعددة الأضلاع تمثل المضلعات على الصفحة. يمكن أن تحتوي على أي عدد من الرؤوس المتصلة بخطوط مستقيمة.

التعليقات التوضيحية متعددة الخطوط تشبه أيضًا المضلعات، والفرق الوحيد هو أن الرؤوس الأولى والأخيرة غير متصلة ضمناً.

الخطوات التي ننشئ بها التعليقات التوضيحية متعددة الأضلاع:

1. تحميل ملف PDF - وثيقة جديدة.
2. إنشاء تعليق توضيحي متعدد الأضلاع جديد وتعيين معلمات المضلع (مستطيل جديد، نقاط جديدة، عنوان، لون، لون داخلي وشفافية).
3. بعد ذلك يمكننا إضافة التعليقات التوضيحية إلى الصفحة.

يوضح snippet الكود التالي كيفية إضافة التعليقات التوضيحية متعددة الأضلاع إلى ملف PDF:

    import aspose.pdf as ap

    document = ap.Document(input_file)

    polygonAnnotation = ap.annotations.PolygonAnnotation(
        document.pages[1],
        ap.Rectangle(200, 300, 400, 400, True),
        [
            ap.Point(200, 300),
            ap.Point(220, 300),
            ap.Point(250, 330),
            ap.Point(300, 304),
            ap.Point(300, 400),
        ],
    )
    polygonAnnotation.title = "John Smith"
    polygonAnnotation.color = ap.Color.blue
    polygonAnnotation.interior_color = ap.Color.blue_violet
    polygonAnnotation.opacity = 0.25

    document.pages[1].annotations.append(polygonAnnotation)
    document.save(output_file)

The following code snippet shows how to add Polyline Annotations to a PDF file:

1. تحميل ملف PDF - Document جديد.
2. إنشاء Polyline Annotations جديد وتعيين معلمات المضلع (مستطيل جديد، نقاط جديدة، عنوان، لون، لون داخلي وعتامة).
3. بعد ذلك يمكننا إضافة التعليقات التوضيحية إلى الصفحة.

    import aspose.pdf as ap

    document = ap.Document(input_file)

    polylineAnnotation = ap.annotations.PolylineAnnotation(
        document.pages[1],
        ap.Rectangle(270, 193, 571, 383, True),
        [
            ap.Point(545, 150),
            ap.Point(545, 190),
            ap.Point(667, 190),
            ap.Point(667, 110),
            ap.Point(626, 111),
        ],
    )
    polylineAnnotation.title = "John Smith"
    polylineAnnotation.color = ap.Color.red
    polylineAnnotation.popup = ap.annotations.PopupAnnotation(
        document.pages[1], ap.Rectangle(842, 196, 1021, 338, True)
    )

    document.pages[1].annotations.append(polylineAnnotation)
    document.save(output_file)

الحصول على التعليقات التوضيحية متعددة الأضلاع والخطوط المتعددة

يرجى تجربة استخدام جزء الكود التالي للحصول على التعليقات التوضيحية متعددة الأضلاع في مستند PDF.

    import aspose.pdf as ap

    document = ap.Document(input_file)
    polygonAnnotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.POLYGON)
    ]

    for pa in polygonAnnotations:
        print(pa.rect)

يرجى تجربة استخدام جزء الكود التالي للحصول على التعليقات التوضيحية للخطوط المتعددة في مستند PDF.

    import aspose.pdf as ap

    document = ap.Document(input_file)
    polylineAnnotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.POLY_LINE)
    ]

    for pa in polylineAnnotations:
        print(pa.rect)

حذف التعليقات التوضيحية متعددة الأضلاع والخطوط المتعددة

يوضح جزء الكود التالي كيفية حذف التعليقات التوضيحية متعددة الأضلاع من ملف PDF.

    import aspose.pdf as ap

    document = ap.Document(input_file)
    polygonAnnotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.POLYGON)
    ]

    for pa in polygonAnnotations:
        document.pages[1].annotations.delete(pa)

    document.save(output_file)

يعرض مقتطف الشيفرة التالي كيفية حذف تعليقات الخط متعدد الأضلاع من ملف PDF.

    import aspose.pdf as ap

    document = ap.Document(input_file)
    polylineAnnotations = [
        a
        for a in document.pages[1].annotations
        if (a.annotation_type == ap.annotations.AnnotationType.POLY_LINE)
    ]

    for pa in polylineAnnotations:
        document.pages[1].annotations.delete(pa)

    document.save(output_file)