سفارشی‌سازی اشکال ارائه در PHP

نمای کلی

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

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

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

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

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

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

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

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

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

برای ویرایش اشکال 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 استفاده کنید.

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

این کد PHP نشان می‌دهد چگونه

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

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

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

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

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

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

ضمیمه کردن یک قوس مشخص به مسیر:

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

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

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

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

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

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

  $pres = new Presentation();
  try {
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 200, 100);
    $geometryPath = $shape->getGeometryPaths()[0];
    $geometryPath->lineTo(100, 50, 1);
    $geometryPath->lineTo(100, 50, 4);
    $shape->setGeometryPath($geometryPath);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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

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

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

  $pres = new Presentation();
  try {
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Heart, 100, 100, 300, 300);
    $path = $shape->getGeometryPaths()[0];
    $path->removeAt(2);
    $shape->setGeometryPath($path);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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

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

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

  $points = new Java("java.util.ArrayList");
  $R = 100;
  $r = 50;
  $step = 72;
  for($angle = -90; $angle < 270; $angle += $step) {
    $radians = $angle * java("java.lang.Math")->PI / 180.0;
    $x = $R * java("java.lang.Math")->cos($radians);
    $y = $R * java("java.lang.Math")->sin($radians);
    $points->add(new Point2DFloat($x + $R, $y + $R));
    $radians = java("java.lang.Math")->PI * $angle . $step / 2 / 180.0;
    $x = $r * java("java.lang.Math")->cos($radians);
    $y = $r * java("java.lang.Math")->sin($radians);
    $points->add(new Point2DFloat($x + $R, $y + $R));
  }
  $starPath = new GeometryPath();
  $starPath->moveTo($points->get(0));
  for($i = 1; $i < java_values($points->size()) ; $i++) {
    $starPath->lineTo($points->get($i));
  }
  $starPath->closeFigure();
  $pres = new Presentation();
  try {
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, $R * 2, $R * 2);
    $shape->setGeometryPath($starPath);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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

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

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

  $pres = new Presentation();
  try {
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 200, 100);
    $geometryPath0 = new GeometryPath();
    $geometryPath0->moveTo(0, 0);
    $geometryPath0->lineTo($shape->getWidth(), 0);
    $geometryPath0->lineTo($shape->getWidth(), $shape->getHeight() / 3);
    $geometryPath0->lineTo(0, $shape->getHeight() / 3);
    $geometryPath0->closeFigure();
    $geometryPath1 = new GeometryPath();
    $geometryPath1->moveTo(0, $shape->getHeight() / 3 * 2);
    $geometryPath1->lineTo($shape->getWidth(), $shape->getHeight() / 3 * 2);
    $geometryPath1->lineTo($shape->getWidth(), $shape->getHeight());
    $geometryPath1->lineTo(0, $shape->getHeight());
    $geometryPath1->closeFigure();
    $shape->setGeometryPaths(array($geometryPath0, $geometryPath1 ));
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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

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

  $shapeX = 20.0;
  $shapeY = 20.0;
  $shapeWidth = 300.0;
  $shapeHeight = 200.0;
  $leftTopSize = 50.0;
  $rightTopSize = 20.0;
  $rightBottomSize = 40.0;
  $leftBottomSize = 10.0;
  $pres = new Presentation();
  try {
    $childShape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Custom, $shapeX, $shapeY, $shapeWidth, $shapeHeight);
    $geometryPath = new GeometryPath();
    $point1 = new Point2DFloat($leftTopSize, 0);
    $point2 = new Point2DFloat($shapeWidth - $rightTopSize, 0);
    $point3 = new Point2DFloat($shapeWidth, $shapeHeight - $rightBottomSize);
    $point4 = new Point2DFloat($leftBottomSize, $shapeHeight);
    $point5 = new Point2DFloat(0, $leftTopSize);
    $geometryPath->moveTo($point1);
    $geometryPath->lineTo($point2);
    $geometryPath->arcTo($rightTopSize, $rightTopSize, 180, -90);
    $geometryPath->lineTo($point3);
    $geometryPath->arcTo($rightBottomSize, $rightBottomSize, -90, -90);
    $geometryPath->lineTo($point4);
    $geometryPath->arcTo($leftBottomSize, $leftBottomSize, 0, -90);
    $geometryPath->lineTo($point5);
    $geometryPath->arcTo($leftTopSize, $leftTopSize, 90, -90);
    $geometryPath->closeFigure();
    $childShape->setGeometryPath($geometryPath);
    $pres->save("output.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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

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

function isGeometryClosed($geometryShape)
{
    $isClosed = null;

    foreach ($geometryShape->getGeometryPaths() as $geometryPath) {
        $dataLength = count(java_values($geometryPath->getPathData()));
        if ($dataLength === 0) {
            continue;
        }

        $lastSegment = java_values($geometryPath->getPathData())[$dataLength - 1];
        $isClosed = $lastSegment->getPathCommand() === PathCommandType::Close;

        if ($isClosed === false) {
            return false;
        }
    }

    return $isClosed === true;
}

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

1. یک نمونه از کلاس GeometryShape ایجاد کنید.
2. یک نمونه از کلاس java.awt.Shape ایجاد کنید.
3. نمونهٔ java.awt.Shape را با استفاده از ShapeUtil به نمونهٔ GeometryPath تبدیل کنید.
4. مسیرها را به شکل اعمال کنید.

این کد PHP—پیاده‌سازی مراحل فوق—فرآیند تبدیل GeometryPath به GraphicsPath را نشان می‌دهد:

  $pres = new Presentation();
  try {
    # ایجاد شکل جدید
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 300, 100);
    # دریافت مسیر هندسی شکل
    $originalPath = $shape->getGeometryPaths()[0];
    $originalPath->setFillMode(PathFillModeType::None);
    # ایجاد مسیر گرافیکی جدید با متن
    $graphicsPath;
    $font = new Font("Arial", Font->PLAIN, 40);
    $text = "Text in shape";
    $img = new BufferedImage(100, 100, BufferedImage->TYPE_INT_ARGB);
    $g2 = $img->createGraphics();
    try {
      $glyphVector = $font->createGlyphVector($g2->getFontRenderContext(), $text);
      $graphicsPath = $glyphVector->getOutline(20.0, -$glyphVector->getVisualBounds()->getY() + 10);
    } finally {
      $g2->dispose();
    }
    # تبدیل مسیر گرافیکی به مسیر هندسی
    $textPath = ShapeUtil->graphicsPathToGeometryPath($graphicsPath);
    $textPath->setFillMode(PathFillModeType::Normal);
    # تنظیم ترکیب مسیر هندسی جدید و مسیر هندسی اصلی به شکل
    $shape->setGeometryPaths(array($originalPath, $textPath ));
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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

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

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

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