Ctrl+K

BaseComponent

اعلان

public abstract class Strawberry.Core.BaseComponent

کلاس پایه برای همه‌ی جزء (Component) در موتور Strawberry. جزء‌های سفارشی باید از این کلاس ارث ببرند تا با سیستم موجود-جزء یکپچه شوند. این کلاس انتزاعی است و روی موجود (Entity) مالک قرار می‌گیرد.

ارث‌بری از: Strawberry.ReferenceObject

ویژگی‌ها

Owner

موجود (Entity) مالک این جزء را دریافت می‌کند.

Entity Owner { get }

Scene

صحنه‌ای (Scene) که موجود مالک در حال حاضر در آن قرار دارد را دریافت می‌کند. اگر موجود جزء هیچ صحنه‌ای نباشد null برمی‌گرداند.

Scene Scene { get }

GameContext

کانتکست بازی فعلی IGameContext را دریافت می‌کند. اگر موجود یا صحنه در دسترس نباشد null برمی‌گرداند.

IGameContext GameContext { get }

Keyboard

نمونه‌ی Keyboard از GameContext.InputManager را دریافت می‌کند.

IKeyboard Keyboard { get }

PointingDevice

نمونه‌ی PointingDevice از GameContext.InputManager را دریافت می‌کند.

IPointingDevice PointingDevice { get }

Enabled

آیا این جزء در حال حاضر فعال است.

bool Enabled { get }

AssetManager

شیء مدیر دارایی صحنه‌ی فعلی را دریافت می‌کند. اگر موجود جزء هیچ صحنه‌ای نباشد null برمی‌گرداند.

AssetManager AssetManager { get }

PauseState

پرچم‌های وضعیت توقف این جزء را دریافت یا تنظیم می‌کند.

PauseStateFlags PauseState { get set }

متدها

Initialize virtual

هنگام مقداردهی اولیه‌ی جزء فراخوانی می‌شود. این متد را override کنید تا وضعیت اولیه‌ی جزء را تنظیم کنید.

void Initialize(Entity owner)

پارامترها:

نام نوع توضیحات
owner Strawberry.Core.Entity موجود (Entity) مالک این جزء.

OnBegin virtual

هنگامی که جزء به یک موجود اضافه می‌شود فراخوانی می‌شود.

void OnBegin()

OnEnabled virtual

هنگامی که جزء فعال می‌شود فراخوانی می‌شود.

void OnEnabled()

OnComponentAdded virtual

هنگامی که یک جزء جدید به موجود مالک اضافه می‌شود فراخوانی می‌شود. این متد همچنین روی جزء جدید برای هر جزء موجود در موجود نیز فراخوانی می‌شود.

void OnComponentAdded(BaseComponent component)

پارامترها:

نام نوع توضیحات
component Strawberry.Core.BaseComponent جزء تازه اضافه‌شده.

OnDisabled virtual

هنگامی که جزء غیرفعال می‌شود فراخوانی می‌شود.

void OnDisabled()

OnFinished virtual

هنگامی که جزء یا موجود مالک در حال پایان چرخه‌حیات است فراخوانی می‌شود. برای پاکسازی یا اعمال نهایی override کنید.

void OnFinished()

OnBeginUpdate virtual

در آغاز چرخه‌ی بروزرسانی، پیش از OnUpdate فراخوانی می‌شود.

void OnBeginUpdate()

OnUpdate virtual

در هر فریم در چرخه‌ی بروزرسانی اصلی فراخوانی می‌شود. برای پیاده‌سازی منطق فریم‌به‌فریم override کنید.

void OnUpdate()

OnEndUpdate virtual

در پایان چرخه‌ی بروزرسانی، پس از OnUpdate فراخوانی می‌شود.

void OnEndUpdate()

OnFixedUpdate virtual

در بازه‌های زمانی ثابت، مستقل از نرخ فریم فراخوانی می‌شود. معمولاً برای محاسبات فیزیک و منطق حساس به زمان استفاده می‌شود.

void OnFixedUpdate()

OnRender virtual

در فاز رندر فراخوانی می‌شود. برای پیاده‌سازی منطق رسم یا رندر این جزء override کنید.

void OnRender()

Removed virtual

هنگامی که جزء از مالکش حذف می‌شود فراخوانی می‌شود. برای پاکسازی و آزادسازی منابع override کنید. مقدار Owner را به null تنظیم می‌کند.

void Removed()

Enable

جزء را فعال می‌کند.

void Enable()

Disable

جزء را غیرفعال می‌کند.

void Disable()