---
title: "ApplyActorAnimation | open.mp"
description: "اعمال یک انیمیشن به یک بازیگر (Actor)."
canonical: https://omp.itsneufox.com/fa/docs/scripting/functions/ApplyActorAnimation
language: fa
---

# ApplyActorAnimation

هشدار

This function was added in SA-MP 0.3.7 and will not work in earlier versions!

## توضیحات

اعمال یک انیمیشن به یک بازیگر (Actor).

| نام | توضیحات |
| --- | --- |
| actorid | شناسه بازیگر برای اعمال انیمیشن. |
| const animationLibrary\[\] | کتابخانه انیمیشن که از آن انیمیشن اعمال می‌شود. |
| const animationName\[\] | نام انیمیشن برای اعمال در کتابخانه مشخص شده. |
| float:delta | سرعت پخش انیمیشن (از 4.1 استفاده کنید). |
| bool:loop | اگر true باشد، انیمیشن تکرار می‌شود. اگر false باشد، انیمیشن یکبار پخش می‌شود. |
| bool:lockX | اگر false باشد، بازیگر پس از تکمیل انیمیشن به مختصات X قبلی خود برمی‌گردد (برای انیمیشن‌هایی که بازیگر را حرکت می‌دهند مثل راه رفتن). true آنها را به موقعیت قبلی برنمی‌گرداند. |
| bool:lockY | مثل بالا اما برای محور Y. باید مثل پارامتر قبلی نگه داشته شود. |
| bool:freeze | تنظیم این روی true بازیگر را در انتهای انیمیشن منجمد می‌کند. false منجمد نمی‌کند. |
| time | تایمر بر حسب میلی‌ثانیه. برای حلقه بی‌نهایت باید 0 باشد. |

## مقدار بازگشتی

**true** - تابع با موفقیت اجرا شد.

**false** - تابع اجرا نشد. بازیگر مشخص شده وجود ندارد.

## مثال‌ها

```c
new gMyActor;

public OnGameModeInit()
{
    gMyActor = CreateActor(179, 316.1, -134.0, 999.6, 90.0); // بازیگر به عنوان فروشنده در Ammunation
    ApplyActorAnimation(gMyActor, "DEALER", "shop_pay", 4.1, false, false, false, false, 0); // انیمیشن پرداخت
    return 1;
}

public OnPlayerConnect(playerid)
{
    // از قبل کتابخانه انیمیشن 'DEALER' را برای بازیکن بارگذاری کنید
    ApplyAnimation(playerid, "DEALER", "null", 4.1, false, false, false, false, 0);
    return 1;
}
```

## نکات

یادداشت

شما باید کتابخانه انیمیشن را برای بازیکنی که بازیگر انیمیشن را برای او اعمال می‌کند از قبل بارگذاری کنید، نه برای بازیگر. در غیر این صورت، انیمیشن تا زمانی که تابع دوباره اجرا نشود به بازیگر اعمال نمی‌شود.

## توابع مرتبط

-   [ClearActorAnimations](https://omp.itsneufox.com/fa/docs/scripting/functions/ClearActorAnimations): پاک کردن هرگونه انیمیشن اعمال شده به بازیگر.
-   [GetActorAnimation](https://omp.itsneufox.com/fa/docs/scripting/functions/GetActorAnimation): دریافت انیمیشنی که بازیگر در حال حاضر اجرا می‌کند.