Bu kod örneği, yerel oyuncunun
`PlayerMouse`'ının `Class.Player:GetMouse()` fonksiyonu kullanılarak nasıl elde edileceğine dair basit bir örnek içermektedir.
Bu kod, `StarterPlayerScripts` içindeki bir `LocalScript`'e yerleştirilmelidir.

PlayerMouse, `Class.Mouse` nesnesi ile aynı şekilde davranır ve bu nesne `Class.Tool.Equipped` kullanılarak elde edilir. Yerel oyuncunun `Class.Player:GetMouse()` yöntemi ile `Class.LocalScript|LocalScripts` üzerinden erişilebilir. Hem PlayerMouse hem de `Class.Mouse`, `Class.UserInputService` ile değiştirilmiş eski API'lardır.

PlayerMouse ile `Class.Mouse` nesnesi arasındaki tek fark, PlayerMouse'ın `Class.Player:GetMouse()` yöntemi kullanılarak elde edilebilmesidir.

Çoğu durumda, geliştiricilerin yeni `Class.UserInputService`'i kullanmaları önerilir. Ancak PlayerMouse ve Mouse nesneleri çeşitli nedenlerle desteklenmeye devam etmektedir. Girişlerinizi özelleştirme ile ilgili daha fazla bilgi için [Input and Camera](/input) sayfasına bakın.


PlayerMouse

PlayerMouse, `Class.Mouse` nesnesi ile aynı şekilde davranır ve bu nesne `Class.Tool.Equipped` kullanılarak elde edilir. Hem PlayerMouse hem de `Class.Mouse`, `Class.UserInputService` ile değiştirilmiş eski API'lardır.


**Fare** `Class.UserInputService` ve `Class.ContextActionService` ile değiştirilmiştir, bu da daha geniş bir kapsamı kapsar, daha fazla özelliğe sahiptir ve **çok platformlu** desenleri daha iyi destekler. Yaygın kullanımı sayesinde desteklenmeye devam etmektedir, ancak bu alternatifleri kullanmayı ciddi şekilde düşünmelisiniz.

**Fare** nesnesi, esas olarak düğmeler ve ışın izleme için çeşitli API'leri barındırır. `Class.Players.LocalPlayer` içindeki `Class.Player:GetMouse()` çağrısıyla erişilebilir. Ayrıca `Class.Tool.Equipped` olayında da geçilir.

- En dikkat çekici özelliği `Class.Mouse.Icon|Icon` özelliğidir ve bu, imlecin görünümünü değiştirir.
- Sürekli olarak, `Class.Mouse.TargetFilter|TargetFilter` özelliğini kullanarak ekran fare konumunu 3D dünyaya ışın izler, ışın izleme sonuçlarını `Class.Mouse.Hit|Hit`, `Class.Mouse.Target|Target` ve `Class.Mouse.TargetSurface|TargetSurface` özelliklerinde saklar. Bu özellikler basit durumlar için yararlı olabilir, ancak daha karmaşık [ışın izleme](/workspace/raycasting) senaryolarında `Class.WorldRoot:Raycast()` kullanılmalıdır.
- `Class.Plugin|Plugins`, benzer şekilde davranan bir `Class.PluginMouse` almak için `Class.Plugin:GetMouse()` kullanabilir.

```lua
-- Bir LocalScript'ten:
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
-- Fare imlecini ayarlama
mouse.Icon = "rbxasset://SystemCursors/Wait"
```
Not:

- Bu nesne işaretçi hareketini kontrol etmez/karşılamaz. Bunu yapmak için `Class.UserInputService.MouseBehavior` ve `Class.UserInputService.MouseDeltaSensitivity`'ye bakın.
- İki işlev aynı giriş olayıyla bağlıysa, `Class.Mouse.Button1Down|Button1Down` gibi **her iki** işlev de olay tetiklendiğinde çalıştırılacaktır. Girişi yönlendirme/geçirme kavramı yoktur, çünkü olaylar bu davranışı desteklemez. Ancak `Class.ContextActionService`, `Class.ContextActionService:BindAction()|BindAction` ile bu davranışı sunmaktadır.
- Bir fare tüm platformlarda mevcut olmayabilir, ancak Fare, genellikle fare veya işaretçi donanımı bulunmayan mobil (dokunmatik) ve konsol (oyun kumandası) üzerinde çalışır. Açık çok platformlu davranışlar için `Class.UserInputService` ve `Class.ContextActionService`'yi kullanın.

  Daha fazla bilgi için [Girdi ve Kamera](/input) sayfasına bakın ve deneyimlerinizde girişleri özelleştirin.

Bu olay, oyuncu sol fare düğmesine bastığında tetiklenir. Bu bir `Class.Tool`'dan erişilebilir; örneğin, bir `Class.LocalScript` içinde yerleştirildiğinde, alttaki kod her sol fare düğmesine basıldığında `Button1Down` yazdırır.

```lua
local tool = script.Parent  -- Bu bir Tool nesnesi olduğundan emin olun.

tool.Equipped:Connect(function(mouse)
	mouse.Button1Down:Connect(function()
		print("Button1Down")
	end)
end)
```
Fare'nin dünya alanındaki konumunu ve herhangi bir `Class.BasePart`'a işaret edip etmediğini `Class.Mouse.Hit|Hit` ve `Class.Mouse.Target|Target` özelliklerini kullanarak öğrenebilirsiniz.

Mouse.Button1Down

Sol fare düğmesine basıldığında tetiklenir.

Bu olay, oyuncu sol fare düğmesini serbest bıraktığında tetiklenir. Bu bir `Class.Tool`'dan erişilebilir; örneğin, bir `Class.LocalScript` içinde yerleştirildiğinde, alttaki kod her sol fare düğmesi serbest bırakıldığında `Button1Up` yazdırır.

```lua
local tool = script.Parent  -- Bu bir Tool nesnesi olduğundan emin olun.

tool.Equipped:Connect(function(mouse)
	mouse.Button1Up:Connect(function()
		print("Button1Up")
	end)
end)
```
Fare'nin dünya alanındaki konumunu ve herhangi bir `Class.BasePart`'a işaret edip etmediğini `Class.Mouse.Hit|Hit` ve `Class.Mouse.Target|Target` özelliklerini kullanarak öğrenebilirsiniz.

Mouse.Button1Up

Sol fare düğmesi serbest bırakıldığında tetiklenir.

Bu olay, oyuncu sağ fare düğmesine bastığında tetiklenir. Bu bir `Class.Tool`'dan erişilebilir; örneğin, bir `Class.LocalScript` içinde yerleştirildiğinde, alttaki kod her sağ fare düğmesine basıldığında `Button2Down` yazdırır.

```lua
local tool = script.Parent  -- Bu bir Tool nesnesi olduğundan emin olun.

tool.Equipped:Connect(function(mouse)
	mouse.Button2Down:Connect(function()
		print("Button2Down")
	end)
end)
```
Fare'nin dünya alanındaki konumunu ve herhangi bir `Class.BasePart`'a işaret edip etmediğini `Class.Mouse.Hit|Hit` ve `Class.Mouse.Target|Target` özelliklerini kullanarak öğrenebilirsiniz.

Mouse.Button2Down

Sağ fare düğmesine basıldığında tetiklenir.

Bu olay, oyuncu sağ fare düğmesini serbest bıraktığında tetiklenir. Bu bir `Class.Tool`'dan erişilebilir; örneğin, bir `Class.LocalScript` içinde yerleştirildiğinde, alttaki kod her sağ fare düğmesi serbest bırakıldığında `Button2Up` yazdırır.

```lua
local tool = script.Parent  -- Bu bir Tool nesnesi olduğundan emin olun.

tool.Equipped:Connect(function(mouse)
	mouse.Button2Up:Connect(function()
		print("Button2Up")
	end)
end)
```
Fare'nin dünya alanındaki konumunu ve herhangi bir `Class.BasePart`'a işaret edip etmediğini `Class.Mouse.Hit|Hit` ve `Class.Mouse.Target|Target` özelliklerini kullanarak öğrenebilirsiniz.

Mouse.Button2Up

Sağ fare düğmesi serbest bırakıldığında tetiklenir.

Bu örnek, fare olaylarının her karede nasıl geçtiğini gösterir

Fare başka bir fare olayına geçmediği her kalp atışında tetiklenir.

Not: Bu olay, fare'nin durduğunu belirlemek için kullanılmamalıdır. Her kalp atışında tetiklendiği için `Class.Mouse.Move` olayları arasında tetiklenir.

`Class.Mouse` nesnesini elde etmek için lütfen `Class.Mouse` sayfasına bakın.

Geliştiriciler, fare'nin dünya uzayındaki konumu ve herhangi bir `Class.BasePart`'a hangi nesneye işaret ettiğini öğrenebilir.

Not: Geliştiricilere yeni çalışmalarında `Class.UserInputService`'yi kullanmaları önerilir.

Mouse.Idle

Fare başka bir fare olayına geçmediği her kalp atışında tetiklenir.

Aşağıdaki örnek, 'mouse' tanımlandıysa, basılan
anahtarı (örneğin "q") ve o anahtarın ASCII değerini (örneğin 113) yazdıracaktır.

Bu olay, bir tuşa basıldığında tetiklenir ve geçirilen argüman, basılan tuştur.

Not:

- Tüm tuşlar bu olayı oluşturmaz. Ancak, belirli tuşlarla, örneğin "/", `Class.Mouse.KeyUp` olayını kullanarak bunu aşabilirsiniz.
- Bazı tuşlar, başka tuşlarla aynı dizeyi oluşturur.
- Dizenin boş olması (muhtemelen "\\0" tuş kodu yüzünden) mümkündür.

Mouse.KeyDown

Mouse.keyDown

Aşağıdaki örnek, 'mouse' tanımlandığı varsayılarak, bırakılan tuşu
(yani "q") ve o tuşun ascii değerini (örneğin 113) yazdıracaktır.

Bu olay, bir tuş serbest bırakıldığında tetiklenir ve geçen argüman, serbest bırakan tuşu belirtir.

Not:

- Tüm tuşlar bu olayı üretmez. Ancak, bazı tuşlarla, örneğin "/" ile, bu olayı kullanarak
  çözebilirsiniz; [[API:Class/Mouse/KeyUp|KeyUp]] olayını kullanarak.
- Bazı tuşlar, diğer tuşlarla aynı dizeyi oluşturur.
- Dizenin boş olması mümkündür (belki de "\\0" tuş kodu nedeniyle).


Mouse.KeyUp

Bir tuş serbest bırakıldığında tetiklenir.


Aşağıdaki örnek, `Class.Players.LocalPlayer|yerel oyuncu`'nun fareleri ile
fare ile parçaları taşımalarına olanak tanır.

Oyuncu, bir parçanın üzerinde sol fare tuşuna bastığında, o parça
`Class.Mouse.Target|fare'nin hedefi` olur ve _nokta_ haline gelir. Oyuncu
sol fare tuşunu bırakmadığı sürece, o parça, oyuncu fareyi hareket ettirdiğinde
fare'nin dünya pozisyonuna taşınır.

`Class.Mouse.TargetFilter` özelliğinin, fare'nin dünya pozisyonunu hesaplarken
hareket eden parçayı göz ardı etmesine olanak tanıdığını unutmayın.

Kod, bir `LocalScript` içinde yerleştirildiğinde beklendiği gibi çalışmalıdır.

Fare hareket ettiğinde tetiklenir.

Bu olay, farenin pozisyonu güncellendiğinde tetiklenir, bu nedenle
hareket ederken tekrar tekrar tetiklenir.

`Class.Mouse` nesnesini nasıl alacağınız hakkında bilgi için lütfen
`Class.Mouse` sayfasına bakın.

Geliştiriciler, farenin dünya alanındaki konumunu bulabilir ve
`Class.Mouse.Hit` ile `Class.Mouse.Target` özelliklerini kullanarak
`Class.BasePart`'a yöneldiğini kontrol edebilir.

```
mouse.Move:Connect(function()
	local position = mouse.Hit.p
	local target = mouse.Target
	print(target, position)
end)
```
Geliştiricilerin, yeni çalışmalarında `Class.Mouse` nesnesi yerine
`Class.UserInputService`'i kullanmaları önerilir.


Mouse.Move

Aşağıdaki örnek, oyuncunun faresini (veya "mouse" adlı bir değişken olarak
ayarladıysanız), bir `Class.Tool`, `Class.HopperBin` veya `Class.Player:GetMouse()`
yöntemi kullanılarak edindiğinizi varsayıyor. Oyuncu geri kaydırdığında
"Fare geri gitti!" yazdıracaktır.

WheelBackward olayı, fare tekerleği geriye doğru kaydırıldığında tetiklenir.
Bu olay için olası kullanımlar, birinci şahıs nişancı (FPS) oyununda bir silahın dürbününü
açmak veya oyuncunun kamerasını yakınlaştırmaktır.

Bu, aşağı yönlü kaydırma olaylarıyla birlikte kullanılabilir,
`Class.Mouse.WheelForward`.

`Class.Mouse` nesnesini nasıl alacağınız hakkında bilgi için lütfen
`Class.Mouse` sayfasına bakın.

Geliştiricilerin, yeni çalışmalarda `Class.Mouse` nesnesi yerine
`Class.UserInputService`'i kullanmaları önerilir.


Mouse.WheelBackward

Fare tekerleği geriye doğru kaydırıldığında tetiklenir.


Aşağıdaki örnek, oyuncunun faresini (veya bunu 'fare' adlı bir değişken olarak ayarladığınızı) varsayıyor.
Bu `Tool`, `HopperBin` veya `Class.Player:GetMouse()` yöntemi aracılığıyla yapılmış olabilir. Oyuncu ileri kaydırdığında "Fare ileri gitti!"
çıkacak şekilde yazdırır.

WheelForward olayı, fare tekerleği ileriye doğru kaydırıldığında tetiklenir.
Bu olay için olası kullanımlar, birinci şahıs nişancı (FPS) oyununda bir silahın dürbününü
 açmak veya oyuncunun kamerasını yakınlaştırmaktır.

Bu, geri kaydırma olaylarıyla birlikte kullanılabilir,
`Class.Mouse.WheelBackward`.

`Class.Mouse` nesnesini nasıl alacağınız hakkında bilgi için lütfen
`Class.Mouse` sayfasına bakın.

Geliştiricilerin, yeni çalışmalarda `Class.Mouse` nesnesi yerine
`Class.UserInputService`'i kullanmaları önerilir.


Mouse.WheelForward

Fare tekerleği ileriye doğru kaydırıldığında tetiklenir.


Mouse

Bu örnekteki kod, `StarterPlayerScripts` içindeki bir `LocalScript`'e yerleştirildiğinde, karakterin başı ile
`Class.Mouse.Hit` arasında her zaman kırmızı bir lazer demeti çizer.

Dikkat: Bu demet, üçüncü şahıs görünümünde engellerden doğrudan geçecektir çünkü
`Mouse`'un ışın taraması `Class.Workspace.CurrentCamera`'dan değil, baştan yapılır.

Aşağıdaki kod, `Class.Mouse.Hit` ile `Class.Mouse.Origin` arasındaki farkı
görselleştirir. Bunu yapmak için, kod hem vurulan hem de orijin
`Datatype.CFrame` değerlerinin `Datatype.Vector3` pozisyonlarını kullanır
`.p` ile.

Fark, orijinin "fare nereden geldiği" (orijini) ve vurulmanın "fareye basıldığında
fare vuruşunun olduğu konum" olmasıdır.

Bu örnek ayrıca fare orijininin `CurrentCamera` pozisyonuna çok benzer olduğunu,
iki pozisyon arasındaki büyüklüğü (mesafe) yazdırarak görselleştirir.

Bu özellik, fare'nin 3D uzaydaki konumunun `Datatype.CFrame`'ini belirtir. `Class.Mouse.TargetFilter` ve onun alt öğeleri göz ardı edilecektir.

Geliştiriciler, Hit'in konumunu şu şekilde alabilir:

```
local position = mouse.Hit.Position
```
Hit genellikle `Class.Tool|Tools` tarafından silahı fareye doğru ateşlemek için kullanılır.

Geliştiriciler, faresi hangi `Class.BasePart` nesnesine yönlendirdiğini görmek için `Class.Mouse.Target`'ı kullanmalıdır.

#### Mouse.Hit nasıl hesaplanır?

Hit CFrame'inin konumu, fare'nin içsel `Datatype.Ray` (uzatılmış bir `Class.Mouse.UnitRay` versiyonu) ile 3D uzaydaki bir nesne arasındaki kesişim noktası olarak hesaplanır.

Hit CFrame'inin yönelimi, `Class.Mouse.UnitRay` yönüyle ilişkilidir.

```
local unitRayDirection = mouse.UnitRay.Direction
local mouseHitDirection = mouse.Hit.lookVector
-- unitRayDirection ≈ mouseHitDirection
-- vektörler yaklaşık olarak eşittir
```
Not: `Class.Workspace.CurrentCamera`'nın ruloyu hesaplarken kullanılmadığını unutmayın. 

Fare'nin içsel ışını 1.000 stud (birim) uzanır. Eğer fare 3D uzaydaki bir nesneye göstermiyorsa (örneğin gökyüzüne doğru gösteriyorsa), bu özellik `Class.Workspace.CurrentCamera`'dan 1.000 stüd (birim) uzaklıkta olacaktır.

Mouse.Hit

Fare'nin 3D uzaydaki konumunun `Datatype.CFrame`'i.

Mouse.hit

Bu örnek, `Class.Players.LocalPlayer` fare simgesini bir
yer dragonu görüntüsüne değiştirmektedir.


**Simge** işaretçiyi temsil eden görüntüyü belirleyen bir özelliktir. Eğer
boşsa, varsayılan bir ok kullanılır. Fare `Class.GuiButton` üzerinde durduğunda,
bu özellik geçici olarak göz ardı edilir.

Fareyi tamamen gizlemek için, **şeffaf** bir görüntü kullanmayın &ndash;
bunun yerine `Class.UserInputService.MouseIconEnabled`'ı false olarak ayarlayın.

Deneyimlerde kullanıcı fare simgesini almak/ayarlamak için bölümdeki
`Class.UserInputService.MouseIcon`'u kullanmalısınız. `Class.Mouse.Icon`, fare imlecini ayarlamak için yeni API
yayınlandıktan sonra kullanımdan kaldırılacaktır.

##### Bir İmleç Tasarlamak

Kendi fare imleçlerinizi oluştururken şu yönergeler faydalı olabilir:

- Kullanılan görüntünün boyutları imlecin boyutunu belirler.
- Görüntünün boyutları herhangi bir eksende 256 pikseli geçmemelidir.
- Görüntünün **merkezi**, fare girişlerinin uygulandığı noktadır.
- Varsayılan fare görüntüsü 64x64 pikseldir, fare 17x24 piksel alan kaplar.

##### Sistem İmlekleri

`Class.PluginMouse` kullanırken `Class.Plugin:GetMouse()` ile elde edilen,
sistemin varsayılan imleçlerine benzer aşağıdaki simgeleri kullanabilirsiniz:
eller, oklar, I-kirişleri vb. Bunu GUI olaylarıyla bir arada kullanabilirsiniz:
`Class.GuiObject.MouseEnter|MouseEnter`,
`Class.GuiObject.MouseLeave|MouseLeave`, ve
`Class.GuiButton.MouseButton1Down|MouseButton1Down` gibi,
belirli türdeki GUI bileşenleriyle etkileşimde tutarlı bir Studio deneyimi sağlamak için.
Unutmayın ki bunlar sadece Studio eklentileri için çalışır; diğer `Class.Mouse`
nesneleri için çalışmaz.

<table>
    <thead>
        <tr>
            <th>Görünüm*</th>
            <th>Varlık</th>
            <th>Önerilen Kullanım</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Pointer.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Arrow</code></td>
            <td>Varsayılan tıklama ve seçim.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-PointingHand.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/PointingHand</code></td>
            <td>Aktif bir bağlantının/düğmenin üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-OpenHand.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/OpenHand</code></td>
            <td>Taşınabilir bir nesnenin üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-GrabbingHand.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/ClosedHand</code></td>
            <td>Bir nesneyi sürükleme.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-IBeam.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/IBeam</code></td>
            <td>Bir metin alanının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeNS.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeNS</code></td>
            <td>Dikey yeniden boyutlandırma tutamacının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeEW.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeEW</code></td>
            <td>Yatay yeniden boyutlandırma tutamacının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeNESW.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeNESW</code></td>
            <td>Bir köşe yeniden boyutlandırma tutamacının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeNWSE.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeNWSE</code></td>
            <td>Bir köşe yeniden boyutlandırma tutamacının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeAll.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeAll</code></td>
            <td>Çok yönlü yeniden boyutlandırma tutamacının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeSplitV.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SplitNS</code></td>
            <td>Dikey "böl" tutamacının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeSplitH.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SplitEW</code></td>
            <td>Yatay "böl" tutamacının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Forbidden.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Forbidden</code></td>
            <td>Bir kilitli/yasaklı nesnenin üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Wait.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Wait</code></td>
            <td>Bir eylemin ilerlediğini gösterme.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Busy.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Busy</code></td>
            <td>Sistemin meşgul olduğunu gösterme.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Crosshair.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Cross</code></td>
            <td>Bırakma noktası üzerinde durma.</td>
        </tr>
    </tbody>
</table>

<figcaption>* Bu görünüm yaklaşık olup &mdash; gerçek görünüm işletim sisteminize bağlıdır.</figcaption>


Mouse.Icon

`Class.Mouse` simgesi olarak kullanılan görüntü içeriği kimliği.


**Simge** işaretçiyi temsil eden görüntüyü belirleyen bir özelliktir. Eğer
boşsa, varsayılan bir ok kullanılır. Fare `Class.GuiButton` üzerinde durduğunda,
bu özellik geçici olarak göz ardı edilir. Bu özellik sadece varlık URI'lerini destekler.

Fareyi tamamen gizlemek için, **şeffaf** bir görüntü kullanmayın &ndash;
bunun yerine `Class.UserInputService.MouseIconEnabled`'ı false olarak ayarlayın.

Deneyimlerde kullanıcı fare simgesini almak/ayarlamak için bölümdeki
`Class.UserInputService.MouseIcon`'u kullanmalısınız. `Class.Mouse.Icon`, fare imlecini ayarlamak için yeni API
yayınlandıktan sonra kullanımdan kaldırılacaktır.

##### Bir İmleç Tasarlamak

Kendi fare imleçlerinizi oluştururken şu yönergeler faydalı olabilir:

- Kullanılan görüntünün boyutları imlecin boyutunu belirler.
- Görüntünün boyutları herhangi bir eksende 256 pikseli geçmemelidir.
- Görüntünün **merkezi**, fare girişlerinin uygulandığı noktadır.
- Varsayılan fare görüntüsü 64x64 pikseldir, fare 17x24 piksel alan kaplar.

##### Sistem İmlekleri

`Class.PluginMouse` kullanırken `Class.Plugin:GetMouse()` ile elde edilen,
sistemin varsayılan imleçlerine benzer aşağıdaki simgeleri kullanabilirsiniz:
eller, oklar, I-kirişleri vb. Bunu GUI olaylarıyla bir arada kullanabilirsiniz:
`Class.GuiObject.MouseEnter|MouseEnter`,
`Class.GuiObject.MouseLeave|MouseLeave`, ve
`Class.GuiButton.MouseButton1Down|MouseButton1Down` gibi,
belirli türdeki GUI bileşenleriyle etkileşimde tutarlı bir Studio deneyimi sağlamak için.
Unutmayın ki bunlar sadece Studio eklentileri için çalışır; diğer `Class.Mouse`
nesneleri için çalışmaz.

<table>
    <thead>
        <tr>
            <th>Görünüm*</th>
            <th>Varlık</th>
            <th>Önerilen Kullanım</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Pointer.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Arrow</code></td>
            <td>Varsayılan tıklama ve seçim.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-PointingHand.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/PointingHand</code></td>
            <td>Aktif bir bağlantının/düğmenin üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-OpenHand.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/OpenHand</code></td>
            <td>Taşınabilir bir nesnenin üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-GrabbingHand.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/ClosedHand</code></td>
            <td>Bir nesneyi sürükleme.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-IBeam.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/IBeam</code></td>
            <td>Bir metin alanının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeNS.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeNS</code></td>
            <td>Dikey yeniden boyutlandırma tutamacının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeEW.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeEW</code></td>
            <td>Yatay yeniden boyutlandırma tutamacının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeNESW.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeNESW</code></td>
            <td>Bir köşe yeniden boyutlandırma tutamacının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeNWSE.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeNWSE</code></td>
            <td>Bir köşe yeniden boyutlandırma tutamacının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeAll.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SizeAll</code></td>
            <td>Çok yönlü yeniden boyutlandırma tutamacının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeSplitV.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SplitNS</code></td>
            <td>Dikey "böl" tutamacının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-ResizeSplitH.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/SplitEW</code></td>
            <td>Yatay "böl" tutamacının üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Forbidden.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Forbidden</code></td>
            <td>Bir kilitli/yasaklı nesnenin üzerinde durma.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Wait.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Wait</code></td>
            <td>Bir eylemin ilerlediğini gösterme.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Busy.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Busy</code></td>
            <td>Sistemin meşgul olduğunu gösterme.</td>
        </tr>
        <tr>
            <td><img src="../../../assets/misc/Mouse-Icon-Crosshair.png" width="30" /></td>
            <td><code>rbxasset://SystemCursors/Cross</code></td>
            <td>Bırakma noktası üzerinde durma.</td>
        </tr>
    </tbody>
</table>

<figcaption>* Bu görünüm yaklaşık olup &mdash; gerçek görünüm işletim sisteminize bağlıdır.</figcaption>


Mouse.IconContent

`Class.Mouse` simgesi olarak kullanılan görüntünün içeriği. Sadece
varlık URI'lerini destekler.


Orijin `Class.Mouse` özelliği, farenin nereden geldiğini belirten bir `Datatype.CFrame`dir.
`Class.Workspace.CurrentCamera`'da konumlandırılmış ve farenin 3D
konumuna yönlendirilmiştir.

`Class.Mouse.UnitRay`, Orijinal'le aynı konumdan başlar ve aynı
yönde bir stud uzatır.

```lua
local unitRay = mouse.UnitRay
local origin = mouse.Origin
-- unitRay.Direction = origin.p
-- unitRay.Direction ≈ origin.lookVector
```
3D uzayda `Class.Mouse`'ın konumu için `Class.Mouse.Hit`'e bakınız.


Mouse.Origin

`Class.Workspace.CurrentCamera`'da konumlandırılmış ve farenin 3D konumuna
yönlendirilmiş bir `Datatype.CFrame`.


Bir `LocalScript`'te `StarterPlayerScripts` içinde yerleştirildiğinde, aşağıdaki kod
herhangi bir `BasePart`'ın `Class.BasePart.BrickColor`'unu değiştirir
oyuncunun tıkladığı, örneğin spawn konumu veya zemin plakası gibi.


`Class.Mouse|mouse`'ın işaret ettiği 3D uzaydaki nesne.

Not:

- Eğer `Class.Mouse.TargetFilter` ayarlandıysa, hedef filtre ve onun
  alt nesneleri göz ardı edilecektir.
- Fare `Class.BasePart`'a işaret etmediğinde, örneğin gökyüzüne işaret ettiğinde,
Hedef `nil` olur.
- 3D uzaydaki farenin konumunu arayan geliştiricilerin `Class.Mouse.Hit`
  kullanımını önerilir.


Mouse.Target

`Class.Mouse|mouse`'ın işaret ettiği 3D uzaydaki nesne.


Mouse.target

Bu özellik, fare tarafından `Class.Mouse.Hit` ve `Class.Mouse.Target`
hesaplanırken göz ardı edilecek bir nesneyi belirler. Nesnenin alt nesneleri de
 göz ardı edilir, bu nedenle, bu özelliğin ayarlandığı nesnenin alt nesnesi
olan birden fazla nesneyi göz ardı etmek mümkündür. Bu özellik, `Class.Mouse.Hit`
yada `Class.Mouse.Target`'ı etkilememesi gereken özel efektler veya dekorasyonlar içeren
modeller filtrelenirken kullanılabilir.

Bu özellik, herhangi bir `Class.Instance` veya `nil` olarak ayarlanabilir;
örneğin:

```lua
local Players = game:GetService("Players")
local Workspace = game:GetService("Workspace")

local player = Players.LocalPlayer
local mouse = player:GetMouse()
mouse.TargetFilter = Workspace.Model
```
Unutmayın ki `Class.Player.Character|Character`'ı `Class.Players.LocalPlayer` fare
otomatik olarak göz ardı eder.


Mouse.TargetFilter

`Class.Mouse.Hit` ve `Class.Mouse.Target`'ı belirlerken göz ardı edilecek
bir nesnenin (ve onun alt nesnelerinin) belirlenmesi.


Bu örnekteki kod, `StarterPlayerScripts` içinde bir `LocalScript`'e yerleştirildiğinde, üzerine tıklanan herhangi bir `BasePart`'ın yüzeyini rastgele bir yüzeye ayarlayacaktır.

Bu özellik, fare ile işaret edilen `Class.BasePart` yüzeyinin `Enum.NormalId`
belirtilir. Bu özellik, farenin dünyadaki konumundan (`Class.Mouse.Hit`) ve
fare ile işaret edilen parçadan (`Class.Mouse.Target`) türetilmiştir.

Bu özellik, farenin bir parçaya işaret etmediği durumlarda anlamlı değildir,
örneğin fare gökyüzüne işaret ettiğinde. O durumda, bu özellik 'Sağ' olarak
ayarlanır. Bu özelliği kullanmadan önce, farenin hedefinin `nil` olmadığını
kontrol edin.

```lua
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
-- Fare ile işaret edilen bir parçanın varlığını kontrol et
if mouse.Target then
	print("Fare, " .. mouse.TargetSurface.Name .. " tarafını, " .. mouse.Target.Name .. "'ı hedef alıyor.")
else
	print("Fare, hiçbir yere işaret etmiyor.")
end
```


Mouse.TargetSurface

Fare ile işaret edilen `Class.BasePart` yüzeyinin `Enum.NormalId`'sini
belirtilir.


UnitRay özelliği, farenin 3D uzaydaki konumuna (yukarıdaki `Class.Mouse.Hit` ile
belirtilmiştir) yönlendirilmiş bir `Datatype.Ray`dir. `Class.Workspace.CurrentCamera`
'nın `Class.Camera.CFrame|CFrame`inden kaynaklanmaktadır. Tüm birim ışınlar gibi,
bir mesafeye sahiptir.

```lua
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local mouse = player:GetMouse()
print(mouse.UnitRay.Direction.Magnitude) -- Her zaman 1
```


Mouse.UnitRay

Fare ile 3D pozisyona yönlendirilmiş bir `Datatype.Ray`.


Bu kod örneği, bir `Datatype.Vector2` oluşturmanın nasıl yapılacağını gösterir.
`Mouse` nesnesinin ekran üzerindeki pozisyonunu (`Class.Mouse.X|X()` ve
`Class.Mouse.Y|Y()`) ve ekranın boyutunu
(`Class.Mouse.ViewSizeX|ViewSizeX()` ve `Class.Mouse.ViewSizeY|ViewSizeY()`) temsil eder.
Bunları kullanarak, fare pozisyonunu ekranda normalize edebilirsiniz,
 böylece üst çubuğun hemen altındaki sol üst köşe (0, 0) noktasına ve sağ alt köşe
(1, 1) noktasına karşılık gelir. Bu normalize edilmiş pozisyon,
fare hareket ettikçe `Class.Mouse.Move|Move()` olayı kullanılarak hesaplanır ve yazdırılır.

ViewSizeX özelliği, oyun penceresinin boyutunun yatay bileşenini piksel cinsinden tanımlar.


Mouse.ViewSizeX

Oyun penceresinin piksel cinsinden genişliğini tanımlar.


ViewSizeY özelliği, oyun penceresinin boyutunun dikey bileşenini piksel cinsinden tanımlar.
Bu uzunluk, üst çubuk tarafından kullanılan alanı da içerir.


Mouse.ViewSizeY

Oyun penceresinin piksel cinsinden yüksekliğini tanımlar.


Fare pozisyonundaki değişiklikleri algılarken,
`Class.ContextActionService:BindAction()` ile `Enum.UserInputType.MouseMovement`
veya `Class.UserInputService.InputChanged` kullanmanız önerilir; bu,
farenin konumunu `Class.InputObject.Position|Position` (bir
`Datatype.Vector3`) kullanarak tanımlar, bu nedenle bu ve ilişkili özellikleri
kullanmak yerine önerilir.

X özelliği, farenin ekran üzerindeki yatay bileşenini tanımlar.
Konum, üst çubuğun altında, sol üst köşeye göre piksel cinsinden ölçülür.
Bu özellik, fare konumunu temsil eden bir `Datatype.Vector2` üretmek için
`Class.Mouse.Y` ile kullanılabilir:

```lua
local position = Vector2.new(mouse.X, mouse.Y)
```
Bu özellik, `Class.Object.Changed|Changed` veya
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal`'dan alınan sinyali ateşlemez.
Bunun yerine `Class.Mouse.Move` olayını kullanın.


Mouse.X

Faraların ekran üzerindeki X (yatay) bileşenini tanımlar.


Fare pozisyonundaki değişiklikleri algılarken,
`Class.ContextActionService:BindAction()` ile `Enum.UserInputType.MouseMovement`
veya `Class.UserInputService.InputChanged` kullanmanız önerilir; bu,
farenin konumunu `Class.InputObject.Position|Position` (bir
`Datatype.Vector3`) kullanarak tanımlar, bu nedenle bu ve ilişkili özellikleri
kullanmak yerine önerilir.

Y özelliği, farenin ekran üzerindeki dikey bileşenini tanımlar.
Konum, üst çubuğun altında, sol üst köşeye göre piksel cinsinden ölçülür.
Bu özellik, fare konumunu temsil eden bir `Datatype.Vector2` üretmek için
`Class.Mouse.X` ile kullanılabilir:

```lua
local position = Vector2.new(mouse.X, mouse.Y)
```
Bu özellik, `Class.Object.Changed|Changed` veya
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal`'dan alınan sinyali ateşlemez.
Bunun yerine `Class.Mouse.Move` olayını kullanın.


Mouse.Y

Faraların ekran üzerindeki Y (dikey) bileşenini tanımlar.


İşaretçi girişi için yararlı üyeleri içeren eski nesne.

`Instance`, Roblox sınıf hiyerarşisindeki tüm sınıflar için temel sınıftır
`Class.DataModel` ağacının bir parçası olabilir.

Kök `Instance` nesneleri doğrudan oluşturmak mümkün değildir, ancak özel
`Datatype.Instance.new()` yapılandırıcı, sınıf adını bir parametre olarak alarak, nesneleri kod aracılığıyla oluşturur ve oluşturulan nesneyi döndürür.

Bir nesnenin soy ağacındaki değişiklikleri algılamayı, `Class.Instance.AncestryChanged` olayıyla bağlanarak gösterir.

ChangingPart'in Parent'ı zamanla farklı değerlere ayarlanır. Parçanın ebeveyni, parçanın atasıdır, bu yüzden `Class.Instance.AncestryChanged` olayı değiştiğinde tetiklenecektir.


Bu örneğin yeniden ebeveynlenmesi veya herhangi bir atanın yeniden ebeveynlenmesi durumunda tetiklenir.

Bu olayı, Stüdyo'da bir nesnenin silinmesini takip etmek için kullanabilirsiniz, örneğin Explorer'da manuel silme veya bir eklenti aracılığıyla. Eğer bir örneğin `Class.Instance:Destroy()` ile yok olduğunda tespit etmeniz gerekiyorsa, `Class.Instance.Destroying` olayını kullanın.

Instance.AncestryChanged

child

`Class.Instance.Parent|Parent` özelliği değişen örnek,
bu örnek veya daha uzak bir atası, **değil**
biriken işleyiciye bağlıdır.

parent

Bu nesnenin veya birinin atalarının `Class.Instance.Parent` özelliği değiştiğinde tetiklenir.

Bu olay, örnekte herhangi bir özelliğin değiştiği her durumda tetiklenir,
özellikle bir özelliğin `nil` olarak ayarlandığı durumlarda. Değişen özelliğin adı,
bu bağlı fonksiyona iletilir.

Örneğin, aşağıdaki kod parçası, bir parçanın özellikleri her değiştiğinde `attributeChanged()`
fonksiyonunu tetikler:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "değişti")
end

part.AttributeChanged:Connect(attributeChanged)
```
Ayrıca, belirli bir özelliğin değiştiğinde tetiklenen olayı döndüren `Class.Instance:GetAttributeChangedSignal()`'ı kontrol edin.

Instance.AttributeChanged

attribute

`Class.Instance` üzerinde bir özellik değiştiğinde tetiklenir.

Bu kod parçası, nesneler Workspace'e eklendikçe isimlerini yazdırır:

Bir nesne bu `Class.Instance`'ye ebeveynlendikten sonra tetiklenir.

Not, bu yöntemi istemci üzerinde sunucu tarafından oluşturulan nesneleri tespit etmek için kullanırken, bu nesnelerin alt nesnelerine indeksleme yaparken `Class.Instance:WaitForChild()`'i kullanmak gereklidir. Çünkü nesne ve alt nesneler sunucudan istemciye aynı anda kopyalanacağı garanti edilmemektedir. Örneğin:

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- Alt nesnelerin henüz kopyalanmamış olabileceğinden WaitForChild() kullanın
	local head = child:WaitForChild("Head")
end)
```
Not, bu olay yalnızca `Class.Instance`'nin hemen altındaki çocuklar için işler. Tüm alt nesneleri yakalayan bir olay için `Class.Instance.DescendantAdded`'i kullanın.

Ayrıca, `Class.Instance.ChildRemoved`'ı kontrol edin.

Instance.ChildAdded

Bir nesne bu `Class.Instance`'ye ebeveynlendikten sonra tetiklenir.

Instance.childAdded

Bu kesit, nesnelerin Workspace'ten kaldırıldıkça isimlerini yazdırır:

Bu `Class.Instance`'den bir çocuk kaldırıldıktan sonra tetiklenir.

Kaldırılan, bir nesnenin ebeveyninin bu `Class.Instance`'den başka bir şeye değişmesini ifade eder. Not, bu olay, bir çocuğun yok olduğu (kullanarak `Class.Instance:Destroy()`) durumunda da tetiklenir çünkü yok etme fonksiyonu bir nesnenin ebeveynini `nil` olarak ayarlar.

Bu olay yalnızca `Class.Instance`'nin hemen altındaki çocuklar için işler. Tüm alt nesneleri yakalayan bir olay için `Class.Instance.DescendantRemoving`'i kullanın.

Ayrıca, `Class.Instance.ChildAdded`'ı kontrol edin.

Instance.ChildRemoved

Bu `Class.Instance`'den bir çocuk kaldırıldıktan sonra tetiklenir.

Aşağıdaki örnek, Workspace'e eklenen her nesnenin adını yazdıracaktır:

Bu olay, bir alt nesne `Class.Instance`'ye eklendikten sonra tetiklenir.

Her alt nesne için tetiklendiğinden, bir nesneyi `Class.Instance`'ye ebeveynlendiğinizde bu nesne ve tüm alt nesneleri için olay tetiklenecektir.

Eğer yalnızca `Class.Instance`'nin **doğrudan çocuklarıyla** ilgileniyorsanız, bunun yerine `Class.Instance.ChildAdded`'i kullanın.

Ayrıca, `Class.Instance.DescendantRemoving`'i kontrol edin.

Instance.DescendantAdded

descendant

Bir alt nesne `Class.Instance`'ye eklendikten sonra tetiklenir.

Aşağıdaki örnek, herhangi bir bebeğin adı Workspace'ten kaldırılırken yazdırılır:

Bu olay, bir ebeveyn `Class.Instance`'nin değişmesi üzere **hemen önce** tetiklenir, böylelikle bir **alt nesne** artık bir alt nesne olmayacaktır. `Class.Instance:Destroy()|Destroy()` bir örneğin `Class.Instance.Parent|Parent`'ini `nil` olarak değiştirir, bu nedenle ebeveynlerinden birinin alt nesnesinde bu yöntemi çağırmak bu olayı tetikleyecektir.

Bu olay, alt nesnenin kaldırılmadan önce tetiklendiğinden, bu olayın tetiklendiği sırada alt nesnenin ebeveyni değişmemiş olacaktır. Eğer alt nesne ayrıca ebeveynin **doğrudan çocuğu** ise, bu olay `Class.Instance.ChildRemoved`'den önce tetiklenecektir.

Bir alt nesnenin çocukları varsa, bu olay önce alt nesne ile, ardından onun alt nesneleri ile tetiklenir.

#### Uyarı

Bu olay, kaldırılan alt nesne ile tetiklenir.
Alt nesnenin `Class.Instance.Parent|Parent`'ini başka bir şeyle ayarlamaya çalışmak başarısız olacaktır. Aşağıda bunu gösteren bir örnek bulunmaktadır:

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Bu fonksiyonda alt nesnenin ebeveynini değiştirmeyin!
	-- Bu olay, ebeveyn manipüle edildiği için tetiklenir ve değişiklik henüz gerçekleşmemiştir
	-- Bu nedenle ebeveyni şu şekilde değiştirmek sorunludur:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Ayrıca, `Class.Instance.DescendantAdded|DescendantAdded`'ı kontrol edin.

Instance.DescendantRemoving

Bir `Class.Instance`'nin alt nesnesi kaldırılmadan hemen önce tetiklenir.

Bu örnek, Immediate sinyal davranışını kullanırken, bir
örneğin yok edildiğinde bağlı fonksiyonun beklemesine kadar yerinde kaldığını gösterir.


Bu örnek, Ertelenmiş sinyal davranışı kullanıldığında, bir Instance'ın
sinyal ateşlenmeden önce yok edildiğini göstermektedir.


Bağlı bir fonksiyon hala kullanılırken `Class.Instance` asla bellekten silinmeyecektir. Ancak, fonksiyon herhangi bir noktada bekleme yaparsa,
`Class.Instance` ve onun alt nesneleri `nil`'e ebeveynlendirilir.

Eğer `Class.Workspace.SignalBehavior` özelliği  `Enum.SignalBehavior.Immediate` olarak ayarlandıysa,
bu olay, `Class.Instance` veya bir atası `Class.Instance:Destroy()` ile yok edilmeden hemen önce tetiklenecektir.

Eğer `Class.Workspace.SignalBehavior` özelliği `Enum.SignalBehavior.Deferred` olarak ayarlandıysa,
bu olay bir sonraki yeniden başlatma noktasında tetiklenecektir, ki bu da `Class.Instance` veya bir atası `Class.Instance:Destroy()` ile yok edildikten sonraki zamandır.

`Enum.SignalBehavior.Deferred|Deferred` davranışında, bir betiği kendi `Class.Instance.Destroying` olayına bağlamak sorunludur, çünkü betik geri çağrının çağrılabileceği noktadan önce yok olacaktır (yani çalışmayacaktır).

Bir `Class.Instance` i Stüdyoda silerken, örneğin [Explorer](/studio/explorer) üzerinden manuel silme veya bir eklenti aracılığıyla,
`Class.Instance` yok edilmez. Bunun yerine, ebeveyn `nil` olarak ayarlanır ki bunu `Class.Instance.AncestryChanged` ile takip edebilirsiniz.

Instance.Destroying

Örnek, `Class.Instance:Destroy()` aracılığıyla yok edilmeden hemen önce (veya sonrasına ertelenerek) tetiklenir.

Bu olay, her zaman bir stil özelliği değiştirildiğinde tetiklenir,
özellikle bir özelliğin `nil` olarak ayarlandığı durumlarda.

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("Stil özellikleri değişti")
end

meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
```

Instance.StyledPropertiesChanged

Herhangi bir stil özelliği değiştirildiğinde tetiklenir, özellikle bir özellik `nil` olarak ayarlandığında.

Bu yöntem, etiket uygulandığında etkisiz hale gelir, bir etiket uygular.
Bir etiket başarıyla eklenirse, sağlanan etiketle birlikte
`Class.CollectionService:GetInstanceAddedSignal()` tarafından oluşturulan bir sinyal tetiklenir.

#### Uyarılar

- İstemci tarafında eklenen bir nesnenin etiketleri, sunucu daha sonra o nesneye bir etiket ekler veya kaldırırsa
  silinecektir çünkü sunucu tüm etiketleri birlikte kopyalar ve önceki etiketleri geçersiz kılacaktır.

- Bir nesneyi etiketlerken, etiketin işlevselliğini sağlamak için bazı kaynakların kullanılması yaygındır, örneğin
  olay bağlantıları veya tablolar. Bellek sızıntılarını önlemek için, bir etikete artık ihtiyaç kalmadığında bunları temizlemek iyi bir fikirdir (koparıp,
  `nil` olarak ayarlamak vb.). Bunu `Class.Instance:RemoveTag()` çağrılırken, `Class.Instance:Destroy()` çağrıldığında veya `Class.CollectionService:GetInstanceRemovedSignal()` tarafından döndürülen bir sinyale bağlı bir işlevde yapın.

Instance:AddTag

Çocuklar işlevi, nesnenin çocuklarının bir dizisini döndürür.

Instance:children

Nesnenin çocuklarının bir dizisini döndürür.

Bu yöntem, bir nesnenin tüm çocuklarını ve soylarını yok eder.

```
local part = Instance.new("Part")

-- Bazı ışıldaklar ekleyelim
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
Eğer **tüm** çocukları ve soyları yok etmek istemiyorsanız, ya
`Class.Instance:GetChildren()` ya da `Class.Instance:GetDescendants()` kullanarak o çocuklar/soylar arasında döngüye girebilir ve hangi nesneleri yok etmeniz gerektiğini seçebilirsiniz. Örneğin, aşağıdaki kod örneği, bir `Class.Model`'dan inen tüm
`Class.BasePart|BaseParts`'ı yok edecektir:

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```

Instance:ClearAllChildren

Bu yöntem, bir nesnenin tüm çocuklarını yok eder.

Modeli `Class.Instance:Clone()` kullanarak klonlamayı gösterir.

`Clone()` bir nesnenin ve tüm soylarının bir kopyasını oluşturur,
`Class.Instance.Archivable|Archivable` olmayan tüm nesneleri yok sayar. Kök nesnenin kopyası
bu yöntemle döndürülür ve `Class.Instance.Parent|Parent`'ı `nil` olarak ayarlanır. Eğer nesne kendisi `Class.Instance.Archivable|Archivable` değeri `false` ise,
hesap bu yöntem `nil` döndürecektir.

Eğer bir referencia nesne, örneğin `Class.ObjectValue.Value`, kopyalanan bir nesnede ayarlanırsa,
kopyanın özelliklerinin değeri orijinalinin değerine bağlıdır:

- Eğer bir referans özelliği **aynı zamanda** kopyalandıysa,
kopya bu kopyaya işaret edecektir.
- Eğer bir referans özelliği **kopyalanmamış** bir nesneye işaret ediyorsa,
kopyada aynı değer korunacaktır.

Instance:Clone

Bir nesnenin ve tüm soylarının bir kopyasını oluşturur; `Class.Instance.Archivable|Archivable` olmayan nesneleri yok sayar.

Instance:clone

Bir Parçayı `Class.Instance:Destroy()` fonksiyonunu kullanarak yok etmenin gösterimi.

Bu fonksiyon, artık gereksiz olan nesneleri imha etmenin doğru yoludur.


`Class.Instance.Parent` özelliğini `nil` olarak ayarlar, `Class.Instance.Parent`
özelliğini kilitler, tüm bağlantıları koparır ve tüm çocuklara `Destroy()` çağrısı yapar. Bu yöntem,
artık gerekli olmayan nesneleri atmanın doğru yoludur.

Artık gerekli olmayan nesneleri atmak önemlidir, çünkü gereksiz nesneler ve
yerlerdeki bağlantılar bellek kullanır ve zamanla ciddi performans sorunlarına yol açabilir.

`Destroy()` çağrıldıktan sonra bir nesneye referans veren değişkenleri `nil`
a ayarlamak en iyi uygulamadır. Bu, kodunuzun nesneyle ilgili herhangi bir şeye erişmesini engeller.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Bunu yapmayın:
print(part.Name)  --> "Hello, world"
-- Yukarıdaki satırın çalışmasını önlemek için bunu yapın:
part = nil
```
Bir `Class.Instance`, bu yöntemle yok edildiğinde,
tekrar kullanılamaz çünkü `Class.Instance.Parent` özelliği kilitlenir. Nesneyi **geçici olarak** kaldırmak, yok etmek yerine,
`Class.Instance.Parent|Parent` değerini `nil` olarak ayarlayarak yapılabilir. Örneğin:

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Belirli bir süre sonra bir nesneyi yok etmek için,
`Class.Debris:AddItem()` kullanın.

Instance:Destroy

`Class.Instance.Parent` özelliğini `nil` olarak ayarlar, `Class.Instance.Parent`
özelliğini kilitler, tüm bağlantıları koparır ve tüm çocuklara `Destroy()` çağrısı yapar.

Instance:destroy

Verilen isme eşit olan `Class.Instance`'nin ilk atasını döndürür.

Bu yöntem yukarıya doğru çalışır, yani nesnenin hemen üstündeki `Class.Instance.Parent`
dan başlar ve `Class.DataModel`'e kadar çıkar. Eşleşen bir ata bulunamazsa, `nil` döndürür.

Aşağıdaki kod parçacığı, `Car` adındaki nesnenin ilk atasını bulacaktır.

```
local car = object:FindFirstAncestor("Car")
```
Belirli bir sınıfın atalarını bulan bu yöntemin varyantları için lütfen `Class.Instance:FindFirstAncestorOfClass()` ve `Class.Instance:FindFirstAncestorWhichIsA()`'ya bakın.

Instance:FindFirstAncestor

name

Verilen isme eşit olan `Class.Instance`'nin ilk atasını döndürür.

Verilen className'e eşit olan `Class.Object.ClassName`'in ilk atasını döndürür.

Bu yöntem yukarıya doğru çalışır; yani nesnenin hemen üstündeki `Class.Instance.Parent`
dan başlar ve `Class.DataModel`'e kadar çıkar. Eşleşen bir ata bulunamazsa, `nil` döndürür.

Bu yöntemin yaygın bir kullanım durumu, bir `Class.BasePart`'ın ait olduğu `Class.Model`'ı bulmaktır. Örneğin:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Bu yöntem, `Class.Instance:FindFirstAncestor()`'ın bir varyantıdır ve `Class.Object.ClassName` özelliğini kontrol eder;
`Class.Instance:FindFirstAncestorWhichIsA()` ise sınıf mirasını dikkate almak için `Class.Object:IsA()` metodunu kullanır.

Instance:FindFirstAncestorOfClass

className

Verilen className'e eşit olan `Class.Object.ClassName`'in ilk atasını döndürür.

Verilen className için, `Class.Object:IsA()` değerinin true döndürdüğü `Class.Instance`'nin ilk atalarını döndürür.

Bu yöntem yukarıya doğru çalışır; yani nesnenin hemen üstündeki `Class.Instance.Parent`
dan başlar ve `Class.DataModel`'e kadar çıkar. Eşleşen bir ata bulunamazsa, `nil` döndürür.

`Class.Instance:FindFirstAncestorOfClass()`'dan farklı olarak, bu yöntem `Class.Object:IsA()` metodunu kullanır ve sınıf mirasını dikkate alır. Örneğin:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Bu nedenle, aşağıdaki kod parçacığı, ilk `Class.BasePart` ata ile sonuçlanır; bu, `Class.WedgePart`, `Class.MeshPart` veya `Class.Part` olsun.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```

`Class.Instance:FindFirstAncestor()`'a da bakın.

Instance:FindFirstAncestorWhichIsA

Verilen className için, `Class.Object:IsA()` değerinin true döndürdüğü `Class.Instance`'nin ilk atalarını döndürür.

Aşağıdakiler, Workspace içinde "Brick" adlı bir nesne arayacaktır. Eğer bulunursa, bu
nesnenin adını "Foo" olarak değiştirecektir.

Verilen isme sahip olan `Class.Instance` çocuklarından ilki döndürülür; eğer böyle bir çocuk yoksa
`nil` döner. İsteğe bağlı `recursive` argümanı `true` ise, bu yöntem yalnızca `Class.Instance`'nin hemen çocuklarına değil, tüm soylarına bakar.

#### Bir Nesnenin Varlığını Kontrol Etme

`FindFirstChild()` bir nesnenin varlığını doğrulamanız gerektiğinde gereklidir.
Eğer çocuk ismiyle indekslenirse, çocuk mevcut değilse bir hata fırlatır.

```lua
local Workspace = game:GetService("Workspace")

-- Aşağıdaki satır parça yoksa hata verir.
Workspace.Part.Transparency = 0.5
```
Daha iyi bir yaklaşım, önce `Part`'ı kontrol etmek için `FindFirstChild()` kullanmak ve sonra gerekli olan kodu çalıştırmak için bir `if` ifadesi kullanmaktır.

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

#### Bir Özellik ile Eşleşen Bir Çocuğu Bulma

Bazen bir nesnenin `Class.Instance.Name|Name`'i, `Class.Instance.Parent|Parent`'nin bir özelliğiyle aynıdır. Noktalamayı kullanırken, isimleri aynı olan çocuklar üzerinde özellikler önceliklidir.

Aşağıdaki örnekte, `Color` adında bir `Class.Folder` eklenir, ayrıca bu `Class.Part`, `Class.Part.Color` özelliğine sahiptir. `part.Color` öğesi,
`Datatype.Color3` özelliğinin değerine atıfta bulunur, çocuk `Class.Folder` nesnesine değil. `Class.Instance:FindFirstChild()|FindFirstChild()` kullanmanın faydası, yeni özelliklerin tanıtılmasının kodunuza herhangi bir risk yüklememesi gerektiğidir.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- Özellik
local c2 = part:FindFirstChild("Color")  -- Alt klasör
```

#### Performans Notları

`Class.Instance:FindFirstChild()|FindFirstChild()` kullanmak, noktalamayı kullanmaktan yaklaşık %20 daha uzun sürer ve bir nesneye referans tutmaktan neredeyse 8 kat daha uzun sürer. Bu yüzden, performansa bağlı kodda, örneğin sıkı döngülerde veya `Class.RunService.Heartbeat` ve `Class.RunService.PreRender` ile ilişkili işlevlerde kullanılmamalıdır. Bunun yerine, sonucu bir değişkende saklayın veya `Class.Instance.ChildAdded|ChildAdded` veya `Class.Instance:WaitForChild()|WaitForChild()` kullanmayı düşünün ve belirli bir isme sahip çocuğun ne zaman erişilebilir olduğunu tespit edin.

Instance:FindFirstChild

recursive

Aramanın yeniden işleme tabi olup olmayacağı.

Verilen isme sahip olan `Class.Instance` çocuklarından ilki döndürülür.

Instance:findFirstChild

Verilen `className`'e eşit olan `Class.Instance`'nin ilk çocuğunu döndürür.
`Class.Instance:FindFirstChildWhichIsA()`'dan farklı olarak bu yöntem yalnızca `className` ile eşleşen nesneleri döndürür ve sınıf mirasını görmezden gelir. Eğer eşleşen bir çocuk yoksa bu yöntem `nil` döndürür.

Instance:FindFirstChildOfClass

Verilen `className`'e eşit olan `Class.Instance`'nin ilk çocuğunu döndürür.

Verilen `className` için `Class.Object:IsA()` değerinin true döndürdüğü ilk `Class.Instance` çocuğunu döndürür.

Eğer eşleşen bir çocuk yoksa, bu yöntem `nil` döndürür. Eğer isteğe bağlı `recursive` argümanı true ise, bu yöntem tüm soyları arar; yalnızca `Class.Instance`'nin hemen çocuklarını değil.

`Class.Instance:FindFirstChildOfClass()`'dan farklı olarak, bu yöntem `Class.Object:IsA()` kullanır ve sınıf mirasını dikkate alır. Örneğin:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Bu nedenle, aşağıdaki kod parçacığı ilk `Class.BasePart` çocuğunu döndürecektir; bu, `Class.WedgePart`, `Class.MeshPart` veya `Class.Part` olsun.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
İsimle bir çocuğu arayan geliştiricilerin, bunun yerine `Class.Instance:FindFirstChild()` kullanmaları gerekir.

Instance:FindFirstChildWhichIsA

Verilen `className` için `Class.Object:IsA()` değerinin true döndürdüğü ilk `Class.Instance` çocuğunu döndürür.

Verilen `Class.Instance.Name`'e sahip ilk soy döndürülür.

Bu yöntem devre dışıdır ve kullanılamaz. Bir nesnenin ilk soyunu bulmak için,
`Class.Instance:FindFirstChild()` üzerindeki yeniden işlem parametresini kullanmayı düşünün.

Instance:FindFirstDescendant

Verilen `Class.Instance.Name`'e sahip ilk soy döndürülür.

Eğer `Class.Instance` bir `Class.Actor`'sa, `Class.Actor` nesnesini döndürür. Aksi takdirde, en yakın atası `Class.Actor` döndürülür. Eğer hiçbir atası `Class.Actor` değilse, sonuç `nil` olur.

Instance:GetActor

Nesneyle ilişkili `Class.Actor`'ı döndürür; varsa.

Bu yöntem, verilen özellik adına atanan değeri döndürür. Eğer hiçbir özellik atanmamışsa, `nil` döner.

Örneğin, aşağıdaki kod parçacığı, örneğin `InitialPosition` özelliğinin değerini ayarlayıp alır:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

#### Ayrıca Bakınız

- `Class.Instance:SetAttribute()` verilen isimle verilen değeri atar.
- `Class.Instance:GetAttributes()` her nesnenin özellikleri için anahtar-değer çiftlerini döndürür.

Instance:GetAttribute

Verilen özelliğin ismine atanmış değer. Eğer hiçbir özelliğe atanmadıysa, `nil` döner.

Verilen özellik adı için atanan değeri döndürür.

Bu yöntem, tam olarak `Class.Object.Changed|Changed` olayına benzer bir olayı döndürür; ancak, yalnızca belirtilen özelliği değiştiğinde tetiklenir; etkili bir şekilde, `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` ile benzer ancak
ozellikler için.

Genellikle, örneğin özelliğin ismini kontrol eden bir işlevin bulunduğu bir bağlantı yerine bu yöntemin kullanılması iyi bir fikirdir. Bu yöntem, aynı nesne üzerinde aynı özellik adına yapılan sonraki çağrılar aynı olayı döndürür.

Aşağıdaki kod örneği, parça `InitialPosition` özelliği değiştiğinde `attributeChanged()` işlevini tetikleyen bir sinyal döndürür:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("Attribute changed")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Ayrıca `Class.Instance.AttributeChanged`'e bakın; bu, nesne üzerindeki tüm özellikler değiştiğinde tetiklenir.

Instance:GetAttributeChangedSignal

Değişiklik sinyalinin döndürüldüğü belirli özelliğin ismi.

Verilen özelliğin değiştiğinde tetiklenen bir olay.

Verilen özelliğin değiştiğinde tetiklenen bir olayı döndürür.

Bu yöntem, her bir özelliğin anahtar-değer çiftleri için bir sözlük döndürür; burada anahtar, özelliğin ismi ve değer sıfır olmayan bir değerdir.

Örneğin, aşağıdaki kod parçacığı, bir nesnenin özelliklerini ve değerlerini yazdırır:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)
part:SetAttribute("CanUse", true)

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
Ayrıca, belirli bir özellik adına atanmış değeri döndürmek için `Class.Instance:GetAttribute()`'e bakın.

Instance:GetAttributes

Her bir özellik için `string → variant` çiftlerinden oluşan bir sözlük; burada string özelliklerin ismini ve variant sıfır olmayan bir değerdir.

Nesnenin özelliklerinin bir sözlüğünü döndürür.

Aşağıdakiler çalıştırıldığında Workspace'teki tüm nesnelerin adını yazdırır.

Nesnenin doğrudan çocuklarını içeren bir dizi (sayısal olarak dizinlenmiş bir tablo) döndürür ya da her `Class.Instance`'ın `Class.Instance.Parent|Parent` değeri nesneye eşitse.
Dizi, sayısal veya genel `for` döngüsü kullanılarak yineleyebilir:

```lua
local Workspace = game:GetService("Workspace")

-- Sayısal döngü örneği
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " is child number " .. i)
end
```

```lua
local Workspace = game:GetService("Workspace")

-- Genel döngü örneği
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " is child number " .. i)
end
```
Geri döndürülen dizinin herhangi bir belirli sıra ile sıralanmadığını ve bu yüzden manuel sıralamanın (örneğin `Library.table.sort()` kullanarak) önerildiğini unutmayın; bu, bu yöntemin döndürdüğü çocukları sıralamak için.

Ayrıca `Class.Instance:GetDescendants()|GetDescendants()` yöntemine de bakın.

Instance:GetChildren

Nesnenin çocuklarını içeren bir dizi.

Nesnenin tüm çocuklarını içeren bir dizi döndürür.

Instance:getChildren

Roblox tarafından dahili olarak kullanılan hata ayıklama kimliğinin şifrelendiği bir dizi döndürür. Not:

- Bu öğe korumalıdır. Bir `Class.Script` veya `Class.LocalScript` içinde kullanılmaya çalışılması bir hataya neden olacaktır.
- Bir hata ayıklama kimliği, hata ayıklama işlemlerinde kullanılan bir kimliktir. Bu, bir hata ayıklayıcının her bir talimatı uygulama işlemi olmadan önce okumasını sağlar. Roblox'taki tüm nesneler, gerektiğinde hata ayıklanabilen işlemler gibi davranır ve her işlem talimatları (veya 'kod') yürütür.
- Bu, benzer nesneleri birbirinden ayırması gereken eklentiler için yararlı olabilir (aynı isme sahip nesneler gibi).

Instance:GetDebugId

scopeLength

Roblox tarafından dahili olarak kullanılan hata ayıklama kimliğinin şifrelendiği bir dizi döndürür.

GetDescendants genellikle belirli bir tür objenin tüm soyundan gelenleri bir
şeyler yapmak için kullanılır. Bu örnekteki kod, GetDescendants ve
`Class.Instance:IsA()` kullanarak çalışma alanındaki tüm parçaları bulur ve
onları yeşil yapar.

Bu nesne yöntemi, nesnenin tüm soylarını içeren bir dizi döndürür. `Class.Instance:GetChildren()`'den farklı olarak, bu yöntem yalnızca bir nesnenin doğrudan çocuklarını döndürmez, nesnenin her çocuğunu, o çocukların her çocuğunu vb. bulur.

Geri döndürülen dizinin herhangi bir belirli sıra ile sıralanmadığını ve bu yüzden manuel sıralamanın (örneğin `Library.table.sort()` kullanarak) önerildiğini unutmayın; bu, bu yöntemin döndürdüğü çocukları sıralamak için. Ayrıca, bir kombinasyon seçici ve birleşimcilerle soyları sorgulamak için `Class.Instance:QueryDescendants()|QueryDescendants()` yöntemine de bakın.

Instance:GetDescendants

Nesnenin tüm soylarını içeren bir dizi döndürür.

Bu kod örneği, `Class.Instance:GetFullName()` fonksiyonunun davranışını göstermektedir.
Fonksiyonun `DataModel` hiyerarşisinde olmayan bir nesne üzerinde çağrıldığında nasıl davrandığını
ve dönüş değerinin özel karakterleri nasıl kaçırmadığını gösterir.

Bu kod örneği `Class.Instance:GetFullName()` fonksiyonunu Lua'da yeniden uygular.

Nesnenin soylarını anlatan bir dizi döndürür. Dizi, nesnenin ve atalarının `Class.Instance.Name|Name` değerlerinin birleştirilmesidir; noktalarla ayrılmıştır. `Class.DataModel` (`game`) dikkate alınmaz. Örneğin, `Class.Workspace` içindeki bir `Class.Part`, `Class.Workspace.Part` döndürebilir.

`Class.DataModel`'ün soyuna ait olmayan bir `Class.Instance` üzerinde çağrıldığında, bu yöntem, `Class.Instance.Parent|Parent` değeri olmayan en üsttekine kadar tüm ataları dikkate alır.

Bu yöntem, günlüğe kaydetme ve hata ayıklama için yararlıdır. Döndürülen dizinin işlevsel bir işlem için parçalara ayrılmasını istememelisiniz; bu yöntem, nesne isimlerindeki noktaları (veya diğer sembolleri) kaçırmaz. Diğer bir deyişle, çıktısı genellikle geçerli bir Luau tanımlayıcısı gibi görünmesine rağmen, garanti edilmez.

Instance:GetFullName

Nesnenin soylarını anlatan bir dizi döndürür.

Instance

`Instance`, Roblox sınıf hiyerarşisindeki tüm sınıflar için temel sınıftır
`Class.DataModel` ağacının bir parçası olabilir.

/reference/engine/classes/PlayerMouse.yaml