سفارشی‌سازی اشکال ارائه در پایتون از طریق جاوا

این صفحه درباره چیست

ایجاد و سفارشی‌سازی اشکال در ارائه‌های PowerPoint با Aspose.Slides برای پایتون از طریق جاوا: مسیرهای هندسی، گوشه‌های منحنی، اشکال ترکیبی.

نمای کلی

این مقاله نحوهٔ سفارشی‌سازی اشکال ارائه در Aspose.Slides را از طریق ویرایش هندسهٔ شکل با استفاده از نقاط ویرایشی و مسیرهای هندسی توضیح می‌دهد. نشان می‌دهد چگونه با GeometryPath کار کنید تا اشکال موجود را تغییر داده، عملیات پایه ویرایش مسیر را انجام دهید، نقاط را اضافه یا حذف کنید و هندسهٔ به‌روز شده را دوباره به شکل اعمال کنید.

همچنین نحوهٔ ایجاد اشکال سفارشی و ترکیبی، ساخت اشکال با گوشه‌های منحنی، تعیین اینکه آیا هندسهٔ یک شکل بسته است یا خیر، و تبدیل بین GeometryPath و java.awt.Shape برای سناریوهای سفارشی‌سازی هندسهٔ بیشتر را نشان می‌دهد.

تغییر شکل با استفاده از نقاط ویرایشی

یک مربع را در نظر بگیرید. در PowerPoint، با استفاده از نقاط ویرایشی می‌توانید

گوشهٔ مربع را به سمت داخل یا خارج حرکت دهید
انحنای یک گوشه یا نقطه را مشخص کنید
نقاط جدیدی به مربع اضافه کنید
نقاط روی مربع را دستکاری کنید و غیره.

به‌طور اساسی می‌توانید این کارها را روی هر شکلی انجام دهید. با نقاط ویرایشی می‌توانید شکل را تغییر دهید یا از یک شکل موجود یک شکل جدید بسازید.

نکات ویرایشی شکل

overview_image

قبل از اینکه شروع به ویرایش اشکال PowerPoint از طریق نقاط ویرایشی کنید، ممکن است به نکات زیر دربارهٔ اشکال توجه کنید:

یک شکل (یا مسیر آن) می‌تواند بسته یا باز باشد.
وقتی یک شکل بسته است، نقطهٔ شروع یا پایان ندارد. وقتی یک شکل باز است، دارای نقطهٔ آغاز و پایان است.
تمام اشکال حداقل شامل ۲ نقطهٔ لنگر هستند که توسط خطوط به یکدیگر متصل می‌شوند.
یک خط می‌تواند مستقیم یا منحنی باشد. نقاط لنگر طبیعت خط را تعیین می‌کنند.
نقاط لنگر می‌توانند به صورت نقطهٔ گوشه، نقطهٔ مستقیم یا نقطهٔ صاف وجود داشته باشند:
- نقطهٔ گوشه نقطه‌ای است که دو خط مستقیم با زاویه‌ای به هم می‌پیوندند.
- نقطهٔ صاف نقطه‌ای است که دو دستهٔ کنترل (handle) در یک خط مستقیم قرار دارند و بخش‌های خط به‌صورت صاف به هم وصل می‌شوند. در این حالت تمام دسته‌ها فاصلهٔ مساوی از نقطهٔ لنگر دارند.
- نقطهٔ مستقیم نقطه‌ای است که دو دستهٔ کنترل در یک خط مستقیم قرار دارند و بخش‌های خط به‌صورت صاف به هم وصل می‌شوند. در این حالت دسته‌ها نیازی به فاصلهٔ مساوی از نقطهٔ لنگر ندارند.
با جابه‌جا یا ویرایش نقاط لنگر (که زاویهٔ خطوط را تغییر می‌دهد) می‌توانید ظاهر شکل را تغییر دهید.

برای ویرایش اشکال PowerPoint از طریق نقاط ویرایشی، Aspose.Slides کلاس GeometryPath را فراهم می‌کند.

یک نمونهٔ GeometryPath مسیر هندسی شیء GeometryShape را نشان می‌دهد.
برای دریافت GeometryPath از نمونهٔ GeometryShape می‌توانید از متد GeometryShape.getGeometryPaths استفاده کنید.
برای تنظیم GeometryPath برای یک شکل، می‌توانید این متدها را به‌کار ببرید: GeometryShape.setGeometryPath برای شکل‌های جامد و GeometryShape.setGeometryPaths برای شکل‌های ترکیبی.
برای افزودن بخش‌ها می‌توانید از متدهای موجود در GeometryPath استفاده کنید.
با استفاده از متدهای GeometryPath.setStroke و GeometryPath.setFillMode می‌توانید ظاهر مسیر هندسی را تعیین کنید.
با استفاده از متد GeometryPath.getPathData می‌توانید مسیر هندسی یک GeometryShape را به‌صورت آرایه‌ای از بخش‌های مسیر بازیابی کنید.
برای دسترسی به گزینه‌های سفارشی‌سازی بیشتر هندسهٔ شکل، می‌توانید GeometryPath را به java.awt.Shape تبدیل کنید.
از متدهای geometryPathToGraphicsPath و graphicsPathToGeometryPath (از کلاس ShapeUtil) برای تبدیل دو‑طرفهٔ GeometryPath به java.awt.Shape استفاده کنید.

عملیات ویرایشی ساده

امضاهای زیر عملیات پایهٔ ویرایش را نشان می‌دهند:

افزودن یک خط به انتهای مسیر:

geometry_path.lineTo(point)
geometry_path.lineTo(x, y)

افزودن یک خط به موقعیتی مشخص در مسیر:

geometry_path.lineTo(point, index)
geometry_path.lineTo(x, y, index)

افزودن یک منحنی بزیهٔ مکعبی به انتهای مسیر:

geometry_path.cubicBezierTo(point1, point2, point3)
geometry_path.cubicBezierTo(x1, y1, x2, y2, x3, y3)

افزودن یک منحنی بزیهٔ مکعبی به موقعیتی مشخص در مسیر:

geometry_path.cubicBezierTo(point1, point2, point3, index)
geometry_path.cubicBezierTo(x1, y1, x2, y2, x3, y3, index)

افزودن یک منحنی بزیهٔ درجهٔ دو به انتهای مسیر:

geometry_path.quadraticBezierTo(point1, point2)
geometry_path.quadraticBezierTo(x1, y1, x2, y2)

افزودن یک منحنی بزیهٔ درجهٔ دو به موقعیتی مشخص در مسیر:

geometry_path.quadraticBezierTo(point1, point2, index)
geometry_path.quadraticBezierTo(x1, y1, x2, y2, index)

پیوست یک قوس مشخص به مسیر:

geometry_path.arcTo(width, height, start_angle, sweep_angle)

بستن شکل فعلی مسیر:

geometry_path.closeFigure()

تنظیم موقعیت برای نقطهٔ بعدی:

geometry_path.moveTo(point)
geometry_path.moveTo(x, y)

حذف بخش مسیر در یک اندیس داده شده:

geometry_path.removeAt(index)

افزودن نقاط سفارشی به یک شکل

یک نمونه از کلاس GeometryShape ایجاد کنید و نوع ShapeType.Rectangle را تنظیم کنید.
یک نمونه از کلاس GeometryPath را از شکل دریافت کنید.
نقطهٔ جدیدی بین دو نقطهٔ بالایی مسیر اضافه کنید.
نقطهٔ جدیدی بین دو نقطهٔ پایینی مسیر اضافه کنید.
مسیر را به شکل اعمال کنید.

این کد پایتون نشان می‌دهد چگونه نقاط سفارشی به یک شکل اضافه شود:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 200, 100)
    geometry_path = shape.getGeometryPaths()[0]
    geometry_path.lineTo(100, 50, 1)
    geometry_path.lineTo(100, 50, 4)
    shape.setGeometryPath(geometry_path)
finally:
    presentation.dispose()

example1_image

حذف نقاط از یک شکل

یک نمونه از کلاس GeometryShape ایجاد کنید و نوع ShapeType.Heart را تنظیم کنید.
یک نمونه از کلاس GeometryPath را از شکل دریافت کنید.
بخش مسیر را حذف کنید.
مسیر را به شکل اعمال کنید.

این کد پایتون نشان می‌دهد چگونه نقاط از یک شکل حذف شوند:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Heart, 100, 100, 300, 300)
    geometry_path = shape.getGeometryPaths()[0]
    geometry_path.removeAt(2)
    shape.setGeometryPath(geometry_path)
finally:
    presentation.dispose()

example2_image

ایجاد یک شکل سفارشی

نقاط شکل را محاسبه کنید.
یک نمونه از کلاس GeometryPath ایجاد کنید.
مسیر را با نقاط پر کنید.
یک نمونه از کلاس GeometryShape ایجاد کنید.
مسیر را به شکل اعمال کنید.

این کد پایتون نشان می‌دهد چگونه یک شکل سفارشی ایجاد شود:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath

import math

points = []
outer_radius = 100
inner_radius = 50
step = 72

for angle in range(-90, 270, step):
    radians = math.radians(angle)
    x = outer_radius * math.cos(radians)
    y = outer_radius * math.sin(radians)
    points.append((x + outer_radius, y + outer_radius))

    radians = math.radians(angle + step / 2)
    x = inner_radius * math.cos(radians)
    y = inner_radius * math.sin(radians)
    points.append((x + outer_radius, y + outer_radius))

star_path = GeometryPath()
star_path.moveTo(*points[0])
for point in points[1:]:
    star_path.lineTo(*point)
star_path.closeFigure()

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, outer_radius * 2, outer_radius * 2)
    shape.setGeometryPath(star_path)
finally:
    presentation.dispose()

example3_image

ایجاد یک شکل ترکیبی سفارشی

یک نمونه از کلاس GeometryShape ایجاد کنید.
یک نمونهٔ اول از کلاس GeometryPath ایجاد کنید.
یک نمونهٔ دوم از کلاس GeometryPath ایجاد کنید.
مسیرها را به شکل اعمال کنید.

این کد پایتون نشان می‌دهد چگونه یک شکل ترکیبی سفارشی ساخته شود:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 200, 100)

    top_path = GeometryPath()
    top_path.moveTo(0, 0)
    top_path.lineTo(shape.getWidth(), 0)
    top_path.lineTo(shape.getWidth(), shape.getHeight() / 3)
    top_path.lineTo(0, shape.getHeight() / 3)
    top_path.closeFigure()

    bottom_path = GeometryPath()
    bottom_path.moveTo(0, shape.getHeight() / 3 * 2)
    bottom_path.lineTo(shape.getWidth(), shape.getHeight() / 3 * 2)
    bottom_path.lineTo(shape.getWidth(), shape.getHeight())
    bottom_path.lineTo(0, shape.getHeight())
    bottom_path.closeFigure()

    shape.setGeometryPaths([top_path, bottom_path])
finally:
    presentation.dispose()

example4_image

ایجاد یک شکل سفارشی با گوشه‌های منحنی

این کد پایتون نشان می‌دهد چگونه یک شکل سفارشی با گوشه‌های منحنی (به سمت داخل) ایجاد شود:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath, SaveFormat

shape_x = 20
shape_y = 20
shape_width = 300
shape_height = 200

left_top_size = 50
right_top_size = 20
right_bottom_size = 40
left_bottom_size = 10

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Custom, shape_x, shape_y, shape_width, shape_height)
    geometry_path = GeometryPath()
    geometry_path.moveTo(left_top_size, 0)
    geometry_path.lineTo(shape_width - right_top_size, 0)
    geometry_path.arcTo(right_top_size, right_top_size, 180, -90)
    geometry_path.lineTo(shape_width, shape_height - right_bottom_size)
    geometry_path.arcTo(right_bottom_size, right_bottom_size, -90, -90)
    geometry_path.lineTo(left_bottom_size, shape_height)
    geometry_path.arcTo(left_bottom_size, left_bottom_size, 0, -90)
    geometry_path.lineTo(0, left_top_size)
    geometry_path.arcTo(left_top_size, left_top_size, 90, -90)
    geometry_path.closeFigure()
    shape.setGeometryPath(geometry_path)
    presentation.save("output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

تشخیص اینکه آیا هندسهٔ یک شکل بسته است

یک شکل بسته به‌عنوان شکلی تعریف می‌شود که تمام سمت‌های آن به‌هم متصل باشند و یک مرز واحد بدون فاصله ایجاد کنند. چنین شکلی می‌تواند فرم هندسی ساده یا طرح سفارشی پیچیده باشد. مثال کد زیر نشان می‌دهد چگونه بررسی شود که آیا هندسهٔ یک شکل بسته است یا نه:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import PathCommandType

def is_geometry_closed(geometry_shape):
    is_closed = False
    for geometry_path in geometry_shape.getGeometryPaths():
        path_data = geometry_path.getPathData()
        if len(path_data) == 0:
            continue
        last_segment = path_data[-1]
        is_closed = last_segment.getPathCommand() == PathCommandType.Close
        if not is_closed:
            return False
    return is_closed

تبدیل GeometryPath به java.awt.Shape

یک نمونه از کلاس GeometryShape ایجاد کنید.
یک نمونه از کلاس java.awt.Shape ایجاد کنید.
نمونهٔ java.awt.Shape را با مرور PathIterator آن و بازپخش هر بخش بر روی مسیر، به نمونهٔ GeometryPath تبدیل کنید.
مسیرها را به شکل اعمال کنید.

این کد پایتون گام‌های فوق را برای تبدیل یک مسیر گرافیکی به مسیر هندسی پیاده‌سازی می‌کند:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath, PathFillModeType

from java.awt import Font
from java.awt.geom import PathIterator
from java.awt.image import BufferedImage

presentation = Presentation()
try:
    # یک شکل جدید ایجاد کنید.
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 100)

    # مسیر هندسی شکل را دریافت کنید.
    original_path = shape.getGeometryPaths()[0]
    original_path.setFillMode(PathFillModeType.None_)

    # یک مسیر گرافیکی جدید با متن ایجاد کنید.
    font = Font("Arial", Font.PLAIN, 40)
    text = "Text in shape"
    image = BufferedImage(100, 100, BufferedImage.TYPE_INT_ARGB)
    graphics = image.createGraphics()
    try:
        glyph_vector = font.createGlyphVector(graphics.getFontRenderContext(), text)
        graphics_path = glyph_vector.getOutline(20.0, -glyph_vector.getVisualBounds().getY() + 10)
    finally:
        graphics.dispose()

    # مسیر گرافیکی را به مسیر هندسی تبدیل کنید.
    text_path = GeometryPath()
    path_iterator = graphics_path.getPathIterator(None)
    points = jpype.JArray(jpype.JFloat)(6)
    while not path_iterator.isDone():
        segment_type = path_iterator.currentSegment(points)
        if segment_type == PathIterator.SEG_MOVETO:
            text_path.moveTo(points[0], points[1])
        elif segment_type == PathIterator.SEG_LINETO:
            text_path.lineTo(points[0], points[1])
        elif segment_type == PathIterator.SEG_QUADTO:
            text_path.quadraticBezierTo(points[0], points[1], points[2], points[3])
        elif segment_type == PathIterator.SEG_CUBICTO:
            text_path.cubicBezierTo(points[0], points[1], points[2], points[3], points[4], points[5])
        elif segment_type == PathIterator.SEG_CLOSE:
            text_path.closeFigure()
        path_iterator.next()
    text_path.setFillMode(PathFillModeType.Normal)

    # مسیر متن را همراه با مسیر هندسی اصلی اعمال کنید.
    shape.setGeometryPaths([original_path, text_path])
finally:
    presentation.dispose()

example5_image

سوالات متداول

پس از جایگزینی هندسه، پرکننده و کناره چه اتفاقی می‌افتد؟

سبک با شکل باقی می‌ماند؛ فقط contour تغییر می‌کند. پرکننده و کناره به‌صورت خودکار به هندسهٔ جدید اعمال می‌شوند.

چگونه می‌توان شکل سفارشی را همراه با هندسه‌اش به‌درستی چرخاند؟

از متد setRotation شکل استفاده کنید؛ هندسه به‌خاطر پیوند به سیستم مختصات خود شکل، همراه با آن می‌چرخد.

آیا می‌توانم شکل سفارشی را به تصویر تبدیل کنم تا «قفل» شود؟

بله. ناحیهٔ slide یا خود shape مورد نیاز را به قالب رستری صادر کنید؛ این کار کار با هندسه‌های سنگین را ساده‌تر می‌سازد.

مدیریت اتصالگرها در ارائه‌ها در پایتون از طریق جاوا اضافه کردن بیضی‌ها به ارائه‌ها در Python با استفاده از Java