---
title: "GetPlayerFacingAngle | open.mp"
description: "دریافت زاویه‌ای که بازیکن به آن طرف نگاه می‌کند."
canonical: https://omp.itsneufox.com/fa/docs/scripting/functions/GetPlayerFacingAngle
language: fa
---

# GetPlayerFacingAngle

## توضیحات

دریافت زاویه‌ای که بازیکن به آن طرف نگاه می‌کند.

| نام | توضیحات |
| --- | --- |
| playerid | بازیکنی که می‌خواهید زاویه‌اش را دریافت کنید. |
| &Float:angle | متغیر Float برای ذخیره زاویه، به صورت reference پاس داده می‌شود. |

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

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

**false** - تابع در اجرا ناموفق بود. این یعنی بازیکن وجود ندارد.

زاویه بازیکن در متغیر مشخص شده ذخیره می‌شود.

## مثال‌ها

```c
public OnPlayerCommandText(playerid, cmdtext[])
{
    if (!strcmp(cmdtext, "/angle", true))
    {
        new string[64];

        new Float:angle;
        GetPlayerFacingAngle(playerid, angle);

        format(string, sizeof(string), "Your facing angle: %0.2f", angle);
        SendClientMessage(playerid, 0xFFFFFFFF, string);
        return 1;
    }
    return 0;
}
```

## نکات

یادداشت

زاویه‌های برگشتی زمانی که در وسیله نقلیه هستید معمولاً صحیح نیستند. برای دریافت زاویه صحیح در حین بودن در وسیله نقلیه، از [GetVehicleZAngle](https://omp.itsneufox.com/fa/docs/scripting/functions/GetVehicleZAngle) استفاده کنید.

هشدار

زاویه‌ها در GTA:SA معکوس هستند؛ 90 درجه در دنیای واقعی شرق است، اما در GTA:SA 90 درجه در واقع غرب است. شمال و جنوب هنوز هم 0/360 و 180 هستند. برای تبدیل این، به سادگی 360 - angle را انجام دهید.

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

-   [GetVehicleZAngle](https://omp.itsneufox.com/fa/docs/scripting/functions/GetVehicleZAngle): بررسی زاویه فعلی وسیله نقلیه.
-   [SetPlayerFacingAngle](https://omp.itsneufox.com/fa/docs/scripting/functions/SetPlayerFacingAngle): تنظیم زاویه نگاه بازیکن.
-   [GetPlayerRotationQuat](https://omp.itsneufox.com/fa/docs/scripting/functions/GetPlayerRotationQuat): دریافت چرخش quaternion بازیکن.