ایجاد و اصلاح رفتارهای سفارشی انیمیشن در .NET

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

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

بررسی کلی

رفتارهای سفارشی انیمیشن به شما امکان کنترل عملیات فردی در یک اثر انیمیشن را می‌دهند، مانند تغییر رنگ، چرخاندن یک شکل یا دنبال کردن مسیر حرکتی قابل ویرایش. این راهنما نحوه ایجاد و ترکیب رفتارها، پیکربندی زمان‌بندی آن‌ها، بررسی و اصلاح انیمیشن‌های موجود، و اطمینان از حفظ ویژگی‌های آن‌ها پس از ذخیره و بازگشایی یک ارائه را نشان می‌دهد.

برای اثرهای پیش‌تعریف‌شده و واکنش‌های کلیک، به انیمیشن شکل مراجعه کنید.

درک مدل انیمیشن

یک انیمیشن به صورت Timeline → Sequence → Effect → Behaviors سازماندهی می‌شود:

Timeline اسلاید (Timeline) شامل توالی اصلی و توالی‌های تعاملی آن است.
Sequence یک ISequence است که اثرها را شامل می‌شود و ممکن است به شکل‌های مختلفی هدف بگیرد.
Effect یک IEffect است که شکل هدف، پیش‌تنظیم، زیرنوع و زمان‌بندی اثر را شناسایی می‌کند.
Behaviors در IEffect.Behaviors شامل عملیات‌هایی است که اثر را پیاده‌سازی می‌کنند: تغییر رنگ، جابجا شدن، چرخش، تنظیم یک ویژگی و غیره.

ایجاد رفتارهای تک‌تک

برای ایجاد یک اثر و دسترسی به مجموعهٔ Behaviors آن، از ISequence.AddEffect استفاده کنید. یک پیش‌تنظیم می‌تواند این مجموعه را به‌صورت خودکار پر کند. هنگام گسترش پیش‌تنظیم، عملیات آن را نگه دارید یا هنگام جایگزینی عمداً از Clear استفاده کنید.

IBehaviorFactory هشت نوع رفتار را که در ادامه نشان داده می‌شود ایجاد می‌کند. مسیر حرکتی در بخش ساخت مسیر حرکتی پوشش داده شده است. هر مثال ساخت یک برنامه کامل است؛ مثال‌های ویرایشی بعدی مشخص می‌کنند که از کدام فایل خروجی استفاده می‌شود.

چرخش

برای ایجاد یک چرخش از CreateRotationEffect استفاده کنید. متد By زاویه نسبی را برحسب درجه مشخص می‌کند؛ From و To نقاط انتهایی را تعریف می‌کنند.

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

using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.Spin, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var rotation = factory.CreateRotationEffect();
rotation.By = 90f;
rotation.Timing.Duration = 2f;

effect.Behaviors.Add(rotation);

presentation.Save("rotation.pptx", SaveFormat.Pptx);

rotation.pptx شامل یک شکل و یک رفتار چرخش است. مجموعه، زمان‌بندی و مثال‌های ویرایش چرخش در ادامه از این فایل استفاده می‌کنند.

مقیاس

از CreateScaleEffect با درصدهای X/Y استفاده کنید: From و To به ترتیب اندازهٔ شروع و پایان را توصیف می‌کنند، در حالی که By تغییر نسبی را توصیف می‌کند. در اینجا، ۱۰۰ به معنی اندازهٔ اصلی است.

مثال هر دو بعد را از ۱۰۰٪ به ۱۲۵٪ در طول دو ثانیه افزایش می‌دهد. استفاده از درصدهای مساوی افقی و عمودی نسبت شکل را حفظ می‌کند؛ درصدهای متفاوت یک بعد را نسبت به دیگری کشیده می‌کنند.

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.GrowShrink, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var scale = factory.CreateScaleEffect();
scale.From = new PointF(100, 100);
scale.To = new PointF(125, 125);
scale.Timing.Duration = 2f;

effect.Behaviors.Add(scale);

presentation.Save("scale.pptx", SaveFormat.Pptx);

رنگ

برای تغییر پر از آبی به نارنجی از CreateColorEffect استفاده کنید. From و To رنگ‌ها هستند؛ By یک جابجایی رنگی است. IBehavior.Properties ویژگی‌ ای که انیمیشن می‌شود را شناسایی می‌کند.

پر جامد شکل به رنگ آبی مقداردهی اولیه می‌شود تا با رنگ شروع انیمیشن منطبق باشد. انتخاب ویژگی fill-color به رفتار می‌گوید کدام بخش شکل تغییر کند؛ خود رنگ‌های انتهایی این ویژگی را مشخص نمی‌کنند. اثر ذخیره‌شده یک انتقال دو ثانیه‌ای به نارنجی توصیف می‌کند.

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color = Color.Blue;

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.ChangeFillColor, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var color = factory.CreateColorEffect();
color.Properties.Add(BehaviorProperty.FillColor);
color.From.Color = Color.Blue;
color.To.Color = Color.Orange;
color.Timing.Duration = 2f;

effect.Behaviors.Add(color);

presentation.Save("color.pptx", SaveFormat.Pptx);

فیلتر

برای انتخاب یک پاک‌کن (wipe) از CreateFilterEffect استفاده کنید. Type، Subtype و Reveal به ترتیب فیلتر، جهت و اینکه شکل را نشان یا مخفی کند، مشخص می‌کنند.

این مثال یک پاک‌کن دو ثانیه‌ای که با جهت راست (right-direction) شکل را نشان می‌دهد پیکربندی می‌کند. تنظیمات فیلتر جزو رفتار داخل اثر هستند، بنابراین پس از حذف عملیات اصلی پیش‌تنظیم، تنظیم می‌شوند.

using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.Wipe, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var filter = factory.CreateFilterEffect();
filter.Type = FilterEffectType.Wipe;
filter.Subtype = FilterEffectSubtype.Right;
filter.Reveal = FilterEffectRevealType.In;
filter.Timing.Duration = 2f;

effect.Behaviors.Add(filter);

presentation.Save("filter.pptx", SaveFormat.Pptx);

ویژگی

برای انیمیشن شفافیت (opacity) از CreatePropertyEffect استفاده کنید. From، To و By رشته‌هایی هستند که با استفاده از ValueType و CalcMode تفسیر می‌شوند. به جای تنظیم سه مقدار به‌هم‌تن بصورت هم‌زمان، یا نقاط انتهایی یا یک جابجایی نسبی را انتخاب کنید.

در اینجا، ویژگی انتخاب‌شده opacity است و رشته‌های عددی تغییر از ۲۵٪ شفافیت به شفافیت کامل را نشان می‌دهند. درون‌یابی خطی یک تغییر تدریجی بین این مقادیر توصیف می‌کند. هنگام اعمال این مثال به ویژگی دیگری، نوع مقدار و مقادیر نقاط انتهایی متناسب با آن ویژگی را انتخاب کنید.

using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var property = factory.CreatePropertyEffect();
property.Properties.Add(BehaviorProperty.StyleOpacity);
property.ValueType = PropertyValueType.Number;
property.CalcMode = PropertyCalcModeType.Linear;
property.From = "0.25";
property.To = "1";
property.Timing.Duration = 2f;

effect.Behaviors.Add(property);

presentation.Save("property.pptx", SaveFormat.Pptx);

تنظیم (Set)

برای اختصاص حالت نمایش از CreateSetEffect و To استفاده کنید. یک رفتار Set بین نقاط انتهایی درون‌یابی نمی‌شود.

مثال ویژگی visibility را انتخاب می‌کند و رشتهٔ visible را هنگام اجرای رفتار اختصاص می‌دهد. مستطیل در این ارائهٔ حداقلی از قبل قابل مشاهده است، بنابراین این انتساب ممکن است به تنهایی تغییر بصری واضحی نداشته باشد. چنین عملیاتی به عنوان بخشی از یک اثر بزرگتر مفید است که زمان نمایش یا مخفی شدن شکل را نیز کنترل می‌کند.

using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.Appear, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var set = factory.CreateSetEffect();
set.Properties.Add(BehaviorProperty.StyleVisibility);
set.To = "visible";

effect.Behaviors.Add(set);

presentation.Save("set.pptx", SaveFormat.Pptx);

دستور (Command)

از CreateCommandEffect استفاده کنید و Type، CommandString و ShapeTarget را پیکربندی کنید. یک فایل صوتی WAV به نام sample.wav را در پوشهٔ کاری قرار دهید. این مثال آن را با AddAudioFrameEmbedded جاسازی می‌کند و یک دستور پخش به فریم صوتی متصل می‌سازد.

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

using System.IO;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

using var audioStream = File.OpenRead("sample.wav");
var audioFrame = slide.Shapes.AddAudioFrameEmbedded(100, 100, 40, 40, audioStream);

var effect = slide.Timeline.MainSequence.AddEffect(audioFrame, EffectType.MediaPlay, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var command = factory.CreateCommandEffect();
command.Type = CommandEffectType.Call;
command.CommandString = "play";
command.ShapeTarget = audioFrame;

effect.Behaviors.Add(command);

presentation.Save("command.pptx", SaveFormat.Pptx);

ذخیره‌سازی دستور را در command.pptx ذخیره می‌کند؛ ضبط را پخش نمی‌کند. برای پخش نیاز به بازیکنی دارید که از این دستور و هدف رسانه‌ای آن پشتیبانی کند.

مدیریت مجموعهٔ رفتارها

IBehaviorCollection از روش‌های Add، Insert، Remove، و RemoveAt پشتیبانی می‌کند. این مثال rotation.pptx را باز می‌کند، مقیاس‌بندی را اضافه می‌کند، قبل از چرخش جابجا می‌کند و چرخش را حذف می‌کند. حذف و دوباره‌درج همان شی باعث تغییر موقعیت ذخیره‌شده آن می‌شود بدون این که یک نسخهٔ دیگر ساخته شود.

دنبالهٔ ویرایش‌ها مجموعه را از rotation–scale به scale–rotation و سپس به فقط scale تغییر می‌دهد. ایندکس‌ها به مجموعهٔ فعلی اشاره دارند، بنابراین حذف از ایندکس جدید چرخش پس از بازآرایی انجام می‌شود. شمارش نهایی نشان می‌دهد کدام رفتار ذخیره خواهد شد.

using System;
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation("rotation.pptx");
var effect = presentation.Slides[0].Timeline.MainSequence[0];
var behaviors = effect.Behaviors;

IBehaviorFactory factory = new BehaviorFactory();
var scale = factory.CreateScaleEffect();
scale.To = new PointF(125, 125);
scale.Timing.Duration = 2f;

behaviors.Add(scale);

behaviors.Remove(scale);
behaviors.Insert(0, scale);
behaviors.RemoveAt(1);

foreach (var behavior in behaviors)
    Console.WriteLine(behavior.GetType().Name);

presentation.Save("collection-edited.pptx", SaveFormat.Pptx);

خروجی ScaleEffect است: فقط مقیاس‌بندی باقی می‌ماند. ترتیب مجموعه به‌تنهایی رفتارها را یکی پس از دیگری زمان‌بندی نمی‌کند. هنگام جایگزینی تمام عملیات، از Clear استفاده کنید.

پیکربندی زمان‌بندی رفتار

IBehavior.Timing ITiming را به‌صورت مستقل از IEffect.Timing در اختیار می‌گذارد. زمان‌بندی اثر کلان‌اثر را زمان‌بندی می‌کند؛ زمان‌بندی رفتار توصیف‌کنندهٔ یک عملیات داخل آن است.

تنظیم مدت زمان، تأخیر، تکرار و شتاب

rotation.pptx را باز کنید و Duration و TriggerDelayTime را به ثانیه تنظیم کنید، سپس RepeatCount را پیکربندی کنید. Accelerate و Decelerate کسری از مدت زمان هستند؛ مجموع آن‌ها نباید بیش از ۱ باشد.

فایل ورودی همان فایلی است که در مثال چرخش ایجاد شد و اولین رفتار آن یک چرخش است. این مثال فقط زمان‌بندی آن رفتار را تغییر می‌دهد؛ زاویهٔ ۹۰ درجه همان‌جا می‌ماند. جدا نگه داشتن زاویه و زمان‌بندی، تنظیم سرعت را بدون بازسازی کل انیمیشن آسان‌تر می‌کند.

using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation("rotation.pptx");
var effect = presentation.Slides[0].Timeline.MainSequence[0];

var rotation = (IRotationEffect)effect.Behaviors[0];
rotation.Timing.Duration = 2f;
rotation.Timing.TriggerDelayTime = 0.5f;
rotation.Timing.RepeatCount = 3f;
rotation.Timing.Accelerate = 0.2f;
rotation.Timing.Decelerate = 0.2f;

presentation.Save("timing.pptx", SaveFormat.Pptx);

این رفتار از یک مدت زمان دو ثانیه، تأخیر نیم ثانیه‌ای و تعداد تکرار ۳ استفاده می‌کند. ۲۰٪ اول و ۲۰٪ آخر مدت زمان برای شتاب و کاهش سرعت استفاده می‌شود.

سیاست‌های تکرار دیگر شامل RepeatDuration، RepeatUntilEndSlide، و RepeatUntilNextClick هستند؛ تنها یکی را انتخاب کنید نه همه را به‌هم. AutoReverse پس از اجرای پیشرو، انیمیشن را به عقب می‌چرخاند. شتاب و کاهش سرعت برای تغییرات پیوسته اعمال می‌شود، نه برای انتساب‌های گسسته یا دستورات.

ساخت مسیر حرکتی

از CreateMotionEffect برای ایجاد حرکت استفاده کنید. متدهای From، To و By مختصات یا جابجایی‌های درصدی را توصیف می‌کنند. برای داشتن مسیر قابل ویرایش، یک MotionPath ایجاد کنید و به IMotionEffect.Path اختصاص دهید. IMotionPath دستورات مسیر را ذخیره می‌کند.

MotionCommandPathType نوع عملیات را انتخاب می‌کند:

Command	Points	Meaning
MoveTo	One	تعیین موقعیت شروع.
LineTo	One	حرکت در طول یک قطعهٔ مستقیم تا نقطهٔ انتها.
CurveTo	Three	دنبال کردن یک منحنی مکعبی تعریف‌شده توسط دو نقطهٔ کنترل و یک نقطهٔ انتها.
CloseLoop	None	بازگشت به موقعیت شروع.
End	None	پایان مسیر.

MotionPathPointsType ویژگی‌های ویرایش نقطه‌ها را توصیف می‌کند، مانند نقطهٔ گوشه‌ای یا هموار. این نوع نقطه جایگزین نوع فرمان نمی‌شود. برای مثال منحنی زیر از نوع نقطهٔ منحنی استفاده کنید و برای قطعات مستقیم از نوع نقطهٔ گوشه‌ای.

مختصات مسیر نسبت به ابعاد اسلاید نرمال‌سازی می‌شوند: جابه‌جایی X برابر ۰٫۲۵ نشان‌دهندهٔ یک‌چهارم عرض اسلاید است، نه ۰٫۲۵ پیکسل. مقدار Y مثبت به سمت پایین است. دستورات مطلق موقعیت‌ها را در سامانهٔ مختصات مسیر مشخص می‌کنند؛ دستورات نسبی جابجایی نسبت به موقعیت فعلی را نشان می‌دهند. این موضوع جدا از Origin است که چارچوب مرجع مسیر را انتخاب می‌کند، و PathEditMode که نحوهٔ جابه‌جایی مسیر هنگام جابه‌جایی شکل را کنترل می‌کند.

ساخت مسیر مستقیم

یک رفتار حرکتی با نقطهٔ شروع، یک قطعهٔ مستقیم و یک دستور پایان ایجاد کنید. متد IMotionPath.Add نوع فرمان، نقاط آن، نوع نقطه، و پرچم مختصات نسبی را می‌پذیرد.

دستور شروع (۰,۰) را تعیین می‌کند و خط به (۰٫۲۵, ۰) ختم می‌شود که مسیر یک جابجایی افقی یک‌چهارم عرض اسلاید می‌شود. دستور پایان هیچ نقطه‌ای ندارد. پس از اختصاص مسیر، افزودن رفتار حرکتی به اثر، این مسیر را به مستطیل متصل می‌کند.

using System;
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.PathRight, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var motion = factory.CreateMotionEffect();
motion.Origin = MotionOriginType.Layout;
motion.Timing.Duration = 2f;

var path = new MotionPath();
path.Add(MotionCommandPathType.MoveTo, new[] { new PointF(0, 0) }, MotionPathPointsType.Auto, false);
path.Add(MotionCommandPathType.LineTo, new[] { new PointF(0.25f, 0) }, MotionPathPointsType.Corner, false);
path.Add(MotionCommandPathType.End, Array.Empty<PointF>(), MotionPathPointsType.None, false);

motion.Path = path;
effect.Behaviors.Add(motion);

presentation.Save("motion.pptx", SaveFormat.Pptx);

motion.pptx شامل یک رفتار حرکتی با سه دستور مسیر است. مثال‌های ویرایشی زیر از این ساختار شناخته‌شده استفاده می‌کنند.

مقایسهٔ مختصات مطلق و نسبی

این دو شیء مسیر همان مسیر را توصیف می‌کنند. دستور مطلق در (۰٫۳, ۰٫۱) پایان می‌یابد؛ دستور نسبی (۰٫۱, ۰٫۱) را به موقعیت فعلی (۰٫۲, ۰) اضافه می‌کند.

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

using System.Drawing;
using Aspose.Slides.Animation;

var absolutePath = new MotionPath();
absolutePath.Add(MotionCommandPathType.MoveTo, new[] { new PointF(0.2f, 0) }, MotionPathPointsType.Auto, false);
absolutePath.Add(MotionCommandPathType.LineTo, new[] { new PointF(0.3f, 0.1f) }, MotionPathPointsType.Corner, false);

var relativePath = new MotionPath();
relativePath.Add(MotionCommandPathType.MoveTo, new[] { new PointF(0.2f, 0) }, MotionPathPointsType.Auto, false);
relativePath.Add(MotionCommandPathType.LineTo, new[] { new PointF(0.1f, 0.1f) }, MotionPathPointsType.Corner, true);

هر یک از این مسیرها را به یک رفتار حرکتی اختصاص دهید تا در ارائه استفاده شوند. آرگومان بولی نهایی برای آن دستور، مختصات نسبی را انتخاب می‌کند.

جایگزینی یک خط با یک منحنی

motion.pptx را باز کنید و دستور خط آن را با یک منحنی مکعبی جایگزین کنید. ابتدا دو نقطهٔ کنترل و سپس نقطهٔ انتها را فراهم کنید.

موقعیت شروع توسط دستور قبلی تأمین می‌شود. دو نقطهٔ اول منحنی را شکل می‌دهند، در حالی که نقطهٔ سوم مقصد نهایی است؛ این‌ها سه مقصد متوالی نیستند. به‌روز کردن نوع دستور، نوع نقطه‌ و آرایهٔ نقاط به طور همزمان، قطعه را با هندسهٔ جدید سازگار نگه می‌دارد.

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation("motion.pptx");
var effect = presentation.Slides[0].Timeline.MainSequence[0];
var motion = (IMotionEffect)effect.Behaviors[0];

var path = motion.Path;
path[1].CommandType = MotionCommandPathType.CurveTo;
path[1].PointsType = MotionPathPointsType.CurveSmooth;
path[1].Points = new[] { new PointF(0.1f, 0), new PointF(0.2f, 0.1f), new PointF(0.3f, 0.1f) };

presentation.Save("curve.pptx", SaveFormat.Pptx);

در curve.pptx مسیر هنوز سه دستور دارد؛ دستور میانی اکنون یک منحنی را تعریف می‌کند.

بررسی و ویرایش یک مسیر ذخیره‌شده

هر IMotionCmdPath ویژگی‌های Points، CommandType، PointsType و IsRelative را نشان می‌دهد. مثال‌های زیر از مسیر سه‑دستوری شناخته‌شده در motion.pptx استفاده می‌کنند. برای ورودی‌های دلخواه، قبل از ویرایش با اندیس، اثر مورد نظر را پیدا کنید و نوع دستورها و تعداد نقاط را بررسی کنید.

خواندن دستورات و مختصات

مسیر را بدون تغییر بخوانید. دستورات End و CloseLoop نیازی به نقطه ندارند، بنابراین آرایهٔ نقطهٔ تهی را در نظر بگیرید.

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

using System;
using Aspose.Slides;
using Aspose.Slides.Animation;

using var presentation = new Presentation("motion.pptx");
var effect = presentation.Slides[0].Timeline.MainSequence[0];
var motion = (IMotionEffect)effect.Behaviors[0];

var path = motion.Path;
foreach (var segment in path)
{
    Console.WriteLine($"{segment.CommandType}, relative: {segment.IsRelative}");
    if (segment.Points != null)
        foreach (var point in segment.Points)
            Console.WriteLine($"X={point.X}, Y={point.Y}");
}

فهرست شامل یک نقطهٔ شروع، یک خط مطلق به (۰٫۲۵, ۰) و یک دستور End است.

تغییر نقطهٔ انتها

motion.pptx را باز کنید و آرایهٔ نقاط خط را برای جابجایی نقطهٔ انتها جایگزین کنید.

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

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation("motion.pptx");
var effect = presentation.Slides[0].Timeline.MainSequence[0];

var motion = (IMotionEffect)effect.Behaviors[0];
motion.Path[1].Points = new[] { new PointF(0.4f, 0.1f) };

presentation.Save("motion-endpoint.pptx", SaveFormat.Pptx);

خط در motion-endpoint.pptx به (۰٫۴, ۰٫۱) پایان می‌یابد؛ فایل اصلی تغییر نکرده است.

جایگزینی یک قطعه

از Insert و RemoveAt برای جایگزینی خط در motion.pptx استفاده کنید. درج خط جدید باعث می‌شود خط قدیمی به اندیس ۲ منتقل شود.

این نشان می‌دهد که یک شیء دستور را جایگزین می‌کنیم نه مختصات موجود آن را ویرایش می‌کنیم. پس از درج، مجموعه موقتاً شامل دستور شروع، خط جدید، خط قدیمی و دستور End می‌شود. حذف اندیس ۲ خط قدیمی را حذف می‌کند و مسیر جدید جای خود را می‌گیرد.

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation("motion.pptx");
var effect = presentation.Slides[0].Timeline.MainSequence[0];
var motion = (IMotionEffect)effect.Behaviors[0];

var path = motion.Path;
path.Insert(1, MotionCommandPathType.LineTo, new[] { new PointF(0.2f, 0.1f) }, MotionPathPointsType.Corner, false);
path.RemoveAt(2);

presentation.Save("motion-edited.pptx", SaveFormat.Pptx);

مسیر ذخیره‌شده هنوز سه دستور دارد؛ خط جدید به (۰٫۲, ۰٫۱) پایان می‌یابد و دستور End در انتهاست.

تعديل و تأیید یک رفتار موجود

وقتی ایندکس رفتار ناشناخته باشد، آن را بر اساس نوع انتخاب کنید. این مثال rotation.pptx را باز می‌کند، IRotationEffect را می‌یابد، زاویه را تغییر می‌دهد و پس از بازگشایی مجدد مقدار ذخیره‌شده را بررسی می‌کند.

بررسی نوع باعث می‌شود حلقه رفتارهایی که چرخش نیستند را نادیده بگیرد. بارگذاری دوم فایل ذخیره‌شده را به شیء ارائهٔ جداگانه‌ای می‌خواند، بنابراین مقایسه داده‌های حفظ‌شده نه مقدار در حافظه را می‌سنجد. این مثال همچنان فرض می‌کند اثر شناخته‌شده اولین اثر در توالی اصلی است؛ انتخاب رفتار بر اساس نوع لزوماً اثر درست را در یک ارائهٔ دلخواه پیدا نمی‌کند.

using System;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation("rotation.pptx");
var effect = presentation.Slides[0].Timeline.MainSequence[0];

foreach (var behavior in effect.Behaviors)
{
    if (behavior is IRotationEffect rotation)
        rotation.By = 180f;
}

presentation.Save("rotation-edited.pptx", SaveFormat.Pptx);

using var reopened = new Presentation("rotation-edited.pptx");
var savedEffect = reopened.Slides[0].Timeline.MainSequence[0];

foreach (var behavior in savedEffect.Behaviors)
{
    if (behavior is IRotationEffect rotation)
        Console.WriteLine($"Rotation preserved: {Math.Abs(rotation.By - 180f) < 0.001f}");
}

خروجی Rotation preserved: True است. الگوی بررسی نوع را برای رفتارهای دیگر نیز اعمال کنید. برای یک بررسی کامل حفظ، شکل هدف، اثر، انواع و ترتیب رفتارها، زمان‌بندی و دستورات مسیر را مقایسه کنید. برای ارائه‌ای با طرح انیمیشن ناشناخته، به خواندن انیمیشن‌های شکل برای پیمایش توالی‌های اصلی و تعاملی مراجعه کنید.

ترتیب رفتارها، پیش‌تنظیم‌ها و پخش

ترتیب در IBehaviorCollection همان ترتیب ذخیره‌شدهٔ عملیات‌های یک اثر است. این یک لیست پخش نیست که هر رفتار به‌طور خودکار منتظر رفتار قبلی بماند. زمان‌بندی و اثر حاوی آن برنامه زمان‌بندی را تعیین می‌کند. رفتارها می‌توانند همپوشانی داشته باشند و عملیات‌های یک‌موردی می‌توانند از طریق Additive و Accumulate با هم تعامل داشته باشند. برای زمان‌بندی «جا به جایی، سپس چرخش» فقط با بازآرایی مجموعه کافی نیست؛ از زمان‌بندی صریح یا اثرهای جداگانه همان‌طور که در انیمیشن شکل توضیح داده شده استفاده کنید.

Type و Subtype اثر، پیش‌تنظیم آن را توصیف می‌کنند. اینها توصیف کامل یک درخت رفتار ویرایش‌شده نیستند. پیش‌تنظیم و زیرنوع را پیش از سفارشی‌سازی رفتارها انتخاب کنید: تغییر پیش‌تنظیم می‌تواند مجموعه را بازسازی کرده و عملیات سفارشی شما را از بین ببرد. به‌عنوان مثال، تغییر یک اثر Spin سفارشی به Fade می‌تواند رفتار چرخش را با رفتارهای set و filter جایگزین کند. پس از تغییر پیش‌تنظیم یا زیرنوع، مجموعه را دوباره بررسی کنید. پاک کردن رفتارهای پیش‌تنظیم می‌تواند عملیات‌های نمایانی یا مقداردهی اولیه‌ای که پیش‌تنظیم نیاز دارد را نیز حذف کند. مثال‌ها به‌طور عمدی از اشکال قابل مشاهده استفاده می‌کنند و رفتارها را جایگزین می‌کنند؛ آنها تمام پیاده‌سازی پیش‌تنظیم‌ها را بازسازی نمی‌کنند.

سازگاری فرمت‌ها

حفظ درخت رفتار تضمین‌کنندهٔ پخش یکسان در هر نمایشگر یا رندر کنندهٔ خروجی نیست. داده‌های ذخیره‌شده و خروجی رندر شده را جداگانه بررسی کنید.

فرمت یا خروجی	مواردی که باید بررسی شود
PPTX	به‌عنوان فرمت اصلی برای این مثال‌ها استفاده شود. پس از بازگشایی، درخت رفتار ویرایش‌پذیر را تأیید کنید، سپس پخش را در نسخهٔ PowerPoint مورد نظر بررسی کنید.
PPT	نمایندگی باینری قدیمی می‌تواند متفاوت از PPTX باشد. یک چرخهٔ ذخیره‑بازگشایی جداگانه و پخش را تست کنید؛ از موفقیت خروجی PPTX برای فرض پشتیبانی از هر ترکیب سفارشی نتیجه‌گیری نکنید.
PDF, PNG, JPEG و سایر تصاویر اسلایدهای ثابت	شامل نمایهٔ ثابت اسلاید هستند، نه یک خط زمان قابل پخش یا فریم نهایی انیمیشن تضمین‌شده.
HTML5	هنگام فعال‌سازی انیمیشن شکل در گزینه‌های خروجی، انیمیشن‌های پشتیبانی‌شده را می‌تواند پخش کند. ترکیب‌های سفارشی را در مرورگر تست کنید.
Animated GIF	فریم‌های رندر شده را ذخیره می‌کند، نه رفتارهای ویرایش‌پذیر یا تعاملات مبتنی بر کلیک. حرکت رندر شدهٔ واقعی را بررسی کنید.
Video	فریم‌های انیمیشن را رندر و به‌صورت ویدئو رمزگذاری می‌کند. پشتیبانی محدود به انیمیشن‌ها و اثرهای پشتیبانی‌شده رندر کننده است؛ دستورات و رویدادهای تعاملی به یک خط زمان ویرایش‌پذیر تبدیل نمی‌شوند.

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

چرا اثر من قبل از اضافه کردن هر چیزی شامل رفتارها است؟

ایجاد یک اثر پیش‌تعریف‌شده ممکن است عملیات زیربنایی آن را ایجاد کند. قبل از تصمیم‌گیری برای گسترش پیش‌تنظیم یا جایگزینی رفتارها، آن‌ها را بررسی کنید.

آیا جابجایی یک رفتار به ابتدا باعث می‌شود اول اجرا شود؟

لزوماً نیست. ترتیب مجموعه جایگزین زمان‌بندی نیست. تأخیرها، مدت زمان‌ها و تعاملات بین عملیات‌های یک ویژگی را بررسی کنید.

چرا یک دستور End هیچ نقطه‌ای ندارد؟

این دستور پایان مسیر را علامت‌گذاری می‌کند و نیازی به مختصات ندارد. هنگام بررسی مسیر خوانده‌شده از یک فایل، برای آرایهٔ نقطهٔ تهی بررسی کنید.

آیا یک دور موفق به‌تنهایی تأیید پخش می‌شود؟

نه. بازگشایی حفظ ویژگی‌هایی که بررسی کردید را تأیید می‌کند. برای تأیید رفتار بصری، پخش‌کنندهٔ اسلایدشو یا خروجی انیمیشن‌دار را جداگانه تست کنید.

بهبود ارائه‌های پاورپوینت با انیمیشن‌ها در .NET ایجاد اثرات سه‌بعدی در ارائه‌ها با استفاده از .NET