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

مرور کلی

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

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

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

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

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

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

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

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

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

• نمونهٔ کلاس GeometryPath مسیر هندسی شیء IGeometryShape را نشان می‌دهد.
• برای دریافت GeometryPath از نمونهٔ IGeometryShape می‌توانید از متد IGeometryShape::GetGeometryPaths استفاده کنید.
• برای تنظیم GeometryPath برای یک شکل، می‌توانید این متدها را استفاده کنید: IGeometryShape::SetGeometryPath() برای اشکال ثابت و IGeometryShape::SetGeometryPaths() برای اشکال ترکیبی.
• برای اضافه کردن بخش‌ها می‌توانید از متدهای موجود در IGeometryPath استفاده کنید.
• با استفاده از متدهای IGeometryPath::set_Stroke() و IGeometryPath::set_FillMode() می‌توانید ظاهر یک مسیر هندسی را تعیین کنید.
• با استفاده از متد IGeometryPath::get_PathData() می‌توانید مسیر هندسی یک GeometryShape را به‌صورت آرایه‌ای از بخش‌های مسیر بازیابی کنید.
• برای دسترسی به گزینه‌های سفارشی‌سازی بیشتر هندسه شکل، می‌توانید GeometryPath را به GraphicsPath تبدیل کنید.
• از متدهای GeometryPathToGraphicsPath و GraphicsPathToGeometryPath (از کلاس ShapeUtil) برای تبدیل GeometryPath به GraphicsPath و برعکس استفاده کنید.

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

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

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

void LineTo(PointF point);
void LineTo(float x, float y);

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

void LineTo(PointF point, uint32_t index);
void LineTo(float x, float y, uint32_t index);

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

void CubicBezierTo(PointF point1, PointF point2, PointF point3);
void CubicBezierTo(float x1, float y1, float x2, float y2, float x3, float y3);

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

void CubicBezierTo(PointF point1, PointF point2, PointF point3, uint32_t index);
void CubicBezierTo(float x1, float y1, float x2, float y2, float x3, float y3, uint32_t index);

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

void QuadraticBezierTo(PointF point1, PointF point2);
void QuadraticBezierTo(float x1, float y1, float x2, float y2);

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

void QuadraticBezierTo(PointF point1, PointF point2, uint32_t index);
void QuadraticBezierTo(float x1, float y1, float x2, float y2, uint32_t index);

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

void ArcTo(float width, float heigth, float startAngle, float sweepAngle);

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

void CloseFigure();

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

void MoveTo(PointF point);
void MoveTo(float x, float y);

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

void RemoveAt(int32_t index);

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

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

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

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 200.0f, 100.0f));

SharedPtr<IGeometryPath> geometryPath = shape->GetGeometryPaths()->idx_get(0);

geometryPath->LineTo(100.0f, 50.0f, 1);
geometryPath->LineTo(100.0f, 50.0f, 4);
shape->SetGeometryPath(geometryPath);

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

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

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

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Heart, 100.0f, 100.0f, 300.0f, 300.0f));

SharedPtr<IGeometryPath> path = shape->GetGeometryPaths()->idx_get(0);
path->RemoveAt(2);
shape->SetGeometryPath(path);

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

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

این کد C++ نشان می‌دهد چگونه یک شکل سفارشی بسازید:

SharedPtr<List<PointF>> points = System::MakeObject<List<PointF>>();

float R = 100.0f, r = 50.0f;
int32_t step = 72;

for (int32_t angle = -90; angle < 270; angle += step)
{
    double radians = angle * (Math::PI / 180.f);
    double x = outerRadius * Math::Cos(radians);
    double y = outerRadius * Math::Sin(radians);
    points->Add(PointF((float)x + outerRadius, (float)y + outerRadius));

    radians = Math::PI * (angle + step / 2) / 180.0;
    x = innerRadiusr * Math::Cos(radians);
    y = innerRadiusr * Math::Sin(radians);
    points->Add(PointF((float)x + outerRadius, (float)y + outerRadius));
}

SharedPtr<GeometryPath> starPath = System::MakeObject<GeometryPath>();
starPath->MoveTo(points->idx_get(0));

for (int32_t i = 1; i < points->get_Count(); i++)
{
    starPath->LineTo(points->idx_get(i));
}

starPath->CloseFigure();

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, R * 2, R * 2));

shape->SetGeometryPath(starPath);

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

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

این کد C++ نشان می‌دهد چگونه یک شکل ترکیبی سفارشی بسازید:

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 200.0f, 100.0f));

SharedPtr<IGeometryPath> geometryPath0 = System::MakeObject<GeometryPath>();
geometryPath0->MoveTo(0.0f, 0.0f);
geometryPath0->LineTo(shape->get_Width(), 0.0f);
geometryPath0->LineTo(shape->get_Width(), shape->get_Height() / 3);
geometryPath0->LineTo(0.0f, shape->get_Height() / 3);
geometryPath0->CloseFigure();

SharedPtr<IGeometryPath> geometryPath1 = System::MakeObject<GeometryPath>();
geometryPath1->MoveTo(0.0f, shape->get_Height() / 3 * 2);
geometryPath1->LineTo(shape->get_Width(), shape->get_Height() / 3 * 2);
geometryPath1->LineTo(shape->get_Width(), shape->get_Height());
geometryPath1->LineTo(0.0f, shape->get_Height());
geometryPath1->CloseFigure();

shape->SetGeometryPaths(System::MakeArray<SharedPtr<IGeometryPath>>({ geometryPath0, geometryPath1 }));

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

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

float shapeX = 20.f;
float shapeY = 20.f;
float shapeWidth = 300.f;
float shapeHeight = 200.f;

float leftTopSize = 50.f;
float rightTopSize = 20.f;
float rightBottomSize = 40.f;
float leftBottomSize = 10.f;

auto presentation = System::MakeObject<Presentation>();

auto childShape = presentation->get_Slides()->idx_get(0)->get_Shapes()->AddAutoShape(ShapeType::Custom, shapeX, shapeY, shapeWidth, shapeHeight);

auto geometryPath = System::MakeObject<GeometryPath>();

PointF point1(leftTopSize, 0.0f);
PointF point2(shapeWidth - rightTopSize, 0.0f);
PointF point3(shapeWidth, shapeHeight - rightBottomSize);
PointF point4(leftBottomSize, shapeHeight);
PointF point5(0.0f, leftTopSize);

geometryPath->MoveTo(point1);
geometryPath->LineTo(point2);
geometryPath->ArcTo(rightTopSize, rightTopSize, 180.0f, -90.0f);
geometryPath->LineTo(point3);
geometryPath->ArcTo(rightBottomSize, rightBottomSize, -90.0f, -90.0f);
geometryPath->LineTo(point4);
geometryPath->ArcTo(leftBottomSize, leftBottomSize, 0.0f, -90.0f);
geometryPath->LineTo(point5);
geometryPath->ArcTo(leftTopSize, leftTopSize, 90.0f, -90.0f);

geometryPath->CloseFigure();

childShape->SetGeometryPath(geometryPath);

presentation->Save(u"output.pptx", SaveFormat::Pptx);

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

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

bool IsGeometryClosed(SharedPtr<IGeometryShape> geometryShape)
{
    bool isClosed = false;

    for (auto&& geometryPath : geometryShape->GetGeometryPaths())
    {
        auto dataLength = geometryPath->get_PathData()->get_Length();
        if (dataLength == 0)
            continue;

        auto lastSegment = geometryPath->get_PathData()[dataLength - 1];
        isClosed = lastSegment->get_PathCommand() == PathCommandType::Close;

        if (!isClosed)
            return false;
    }

    return isClosed;
}

تبدیل GeometryPath به GraphicsPath

1. یک نمونه از کلاس GeometryShape ایجاد کنید.
2. یک نمونه از کلاس GraphicsPath در فضای نامی System.Drawing.Drawing2D ایجاد کنید.
3. نمونهٔ GraphicsPath را با استفاده از ShapeUtil به نمونهٔ GeometryPath تبدیل کنید.
4. مسیرها را به شکل اعمال کنید.

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

SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

SharedPtr<IShapeCollection> shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
SharedPtr<GeometryShape> shape = System::ExplicitCast<GeometryShape>(shapes->AddAutoShape(ShapeType::Rectangle, 100.0f, 100.0f, 300.0f, 100.0f));

SharedPtr<IGeometryPath> originalPath = shape->GetGeometryPaths()->idx_get(0);
originalPath->set_FillMode(PathFillModeType::None);

SharedPtr<Drawing2D::GraphicsPath> graphicsPath = System::MakeObject<Drawing2D::GraphicsPath>();
graphicsPath->AddString(u"Text in shape", System::MakeObject<FontFamily>(u"Arial"), 1, 40.0f, PointF(10.0f, 10.0f), StringFormat::get_GenericDefault());

SharedPtr<IGeometryPath> textPath = ShapeUtil::GraphicsPathToGeometryPath(graphicsPath);
textPath->set_FillMode(PathFillModeType::Normal);

shape->SetGeometryPaths(System::MakeArray<SharedPtr<IGeometryPath>>({ originalPath, textPath }));

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

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

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

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

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

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

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