[筆記] Round() 不一定是四捨五入

　　使用程式語言函式庫提供的 `Round()` 之類的函式對數值做四捨五入時，要小心它的捨入結果可能不是所預期的四捨五入，因而踩到雷。

來看看 Python 的：

來看看 JavaScript 的：

最後看看 C# 的：

可以發現，對 1.5 跟 3.5 都是四捨五入到 2 與 4，可是在 Python 與 C# 中，對 2.5 的結果卻是 2。

[筆記] Unity3D - 繼承類別不要有與基礎類別同名的屬性

　　最近在寫遊戲時遭遇一點困難：在繼承基礎類別時，需要將其附屬的資料類別一併繼承，而在建立繼承類別的實體後，遇到初始化基礎類別的資料類別的問題，原因只是因為兩者的欄位 (field) 同名。有問題的程式碼像這樣：

class Character : MonoBehaviour
{
    protected CharacterData data;

    ...
}

class CharacterData : ScriptableObject
{
    public float movingVelocity = 10.0f;
    public float rotatingVelocity = 10.0f;
}

class Player : Character
{
    public new PlayerData data;

    private void Start()
    {
        base.data = data;
    }

    ...
}

[CreateAssetMenu(fileName = "PlayerData",
    menuName = "Scriptable Object/PlayerData", order = 1)]
class PlayerData : CharacterData
{
    public float firingPeriod = 0.1f;
}

Unity 在編譯後會出現錯誤訊息，"The same field name is serialized multiple times in the class or its parent class. This is not supported: Base(Player) data"：

即使可以忽略錯誤訊息將 PlayerData 的 scriptable object 設給 data 欄位：

但只要重新編譯後，該欄位還是會變回 None，即使為基礎類別的 data 加上 [HideInInspector] 的性質。因為 Unity 無法為一個物件同名的欄位初始化多次（一次是 Player 裡的 data，一次是繼承的 Character 裡的 data）。

[筆記] API 設計概念 — 下篇

  下篇整理演講後半的內容，主要更進一步探討類別跟函式的設計概念。

類別設計

---

減少易變性（mutability）

• 除非有好理由，不然類別應該要 immutable：好處是單純、thread-safe、可重複使用；缺點是每個不同的值都是獨立的物件，也就是為了改一個值，就要放棄現在的物件取得新的物件。

  以 python 為例，int 是 immutable 的，所以使用 '1' 的值，它只要產生一次對應的物件，後續只要使用到 '1' 的值，就使用同一個物件即可。

>>> id(1)
10914496
>>> x = 1
>>> id(x)
10914496

[筆記] API 設計概念 — 上篇

  當初在設計 MLGame 專案時，為了能夠讓遊戲開發者和玩家能夠使用 MLGame 架構，於是嘗試查了關於 API 設計的概念。本篇整理一場 Google 的技術演講，演講標題為「How to Design a Good API and Why it Matters」，演講雖然是在講 API 的設計概念，但我認為這些概念在平常撰寫程式上也很受用。演講以 Java 為舉例語言，文章中會引用演講中的例子，我也會盡量舉在專案中（以 Python 撰寫）遇到的情況。

• 投影片：http://fwdinnovations.net/whitepaper/APIDesign.pdf
• 演講錄影：https://www.youtube.com/watch?v=aAb7hSCtvGw（有 CC 字幕）

上篇整理演講前半段的部分，主要是 API 設計的通用概念。

為何 API 設計重要？

---

• 好的 API 可以是公司最重要的資產之一：客戶會使用 API 來製作產品，同時也會學習使用 API。而放棄一個 API 去學習另一個全新的 API 的成本太高，所以一個好的 API 會吸引客戶來使用
• 壞的 API 就會是公司的負債：客戶會佔滿客服線路。公司要修改 API 也會困難重重，造成技術負債
• 發布的 API 就發布了：修改 API 可能會造成客戶的程式崩潰。

為何 API 設計對你重要？

---

• 平常寫程式也是在做 API 設計：好程式是模組化的，而模組之間的界線就是 API。而且好的模組應該要能夠一再被重複使用
• 以 API 設計的方式去寫程式可以增進程式品質

[筆記] 矩形的碰撞偵測 (下篇) - 沒被偵測到的碰撞

　　有時就是天不從人願，當覺得碰撞 OK，反彈 OK 的時候，就會出現不 OK 的情況。做了一個球速會漸漸加快的 pixel game，然後遊戲就逐漸毋湯。當球移動的速度很快的時候，球會穿越平台，連碰撞都沒有被偵測到，然後就蹦蹦了。

問題點

---

如圖所示，當球一次移動的距離大於板子的厚度時，板子可是一點感覺都沒有呢。因為球的移動並非連續移動，而是在這個影格是 A 地點，下一個影格就直接出現在 B 地點（直接加上要移動的距離）。可以想像做碰撞偵測時，是看當下每個物件的位子來判斷有沒有碰撞的，所以當球直接「掠過」板子時，就不會被偵測到碰撞。如此一來就會出現穿板的現象，原本應該繼續的遊戲，就 Game Over 了。