[Unity]Unity Editor Extensions – Menu Items

參考來源: https://unity3d.com/learn/tutorials/topics/interface-essentials/unity-editor-extensions-menu-items

Adding Menu Items

1
2
3
4
5
6
7
public class MenuItems : MonoBehaviour {
    [MenuItem("TopTools/Find")]
    private static void doSomething()
    {
        Debug.Log("Find");
    }
}






1
2
3
4
5
6
7
public class MenuItems : MonoBehaviour {
    [MenuItem("Window/Find")]
    private static void doSomething()
    {
        Debug.Log("Find");
    }
}

















Hotkeys


以下是支援的熱鍵(也可以互相合併):
  • % – CTRL on Windows / CMD on OSX
  • # – Shift
  • & – Alt
  • LEFT/RIGHT/UP/DOWN – Arrow keys
  • F1…F2 – F keys
  • HOME, END, PGUP, PGDN

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// Add a new menu item with hotkey CTRL-SHIFT-A

    [MenuItem("Tools/Find %#a")]

    private static void doSomething3(){}



    // Add a new menu item with hotkey CTRL-G

    [MenuItem("Tools/Find1 %g")]

    private static void doSomething4(){}



    // Add a new menu item with hotkey G

    [MenuItem("Tools/Find2  _g")]

    private static void doSomething5(){}






Special Paths

Unity 有一些"Special" paths作用於Context menus(menus在點擊右鍵選單顯示)
  • Assets – items will be available under the “Assets” menu, as well using right-click inside the project view.
  • Assets/Create – items will be listed when clicking on the “Create” button in the project view (useful when adding new types that can be added to the project)
  • CONTEXT/ComponentName – items will be available by right-clicking inside the inspector of the given component.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
    // Add a new menu item with hotkey CTRL-SHIFT-A

    [MenuItem("Tools/Find %#a")]

    private static void doSomething3(){}



    // Add a new menu item with hotkey CTRL-G

    [MenuItem("Tools/Find1 %g")]

    private static void doSomething4(){}



    // Add a new menu item with hotkey G

    [MenuItem("Tools/Find2 _g")]

    private static void doSomething5(){}
結果如下:



Validation

Some menu items only make sense in a given context, and should not be available otherwise. Enabling/disabling menu items according to their usage context is done by adding validation methods.
Validation methods are static methods, marked with the MenuItem attribute, passing true to the validation argument.
The validation method should have the same menu path as the menu it is validating, and should return a boolean value to determine whether the menu item is active or not.
For example, Validation methods can be used to add a right-click menu to Texture assets only under the project view:
1
2
3
4
5
6
7
8
9
10
11
12
   [MenuItem("Assets/ProcessTexture")]
    private static void DoSomethingWithTexture()
    {
        Debug.Log("DoSomethingWithTexture");
    }

     [MenuItem("Assets/ProcessTexture", true)]
    private static bool NewMenuOptionValidation()
    {
        //點到的物件必須是相同型態，回傳true才有辦法執行DoSomethingWithTexture
        return Selection.activeObject.GetType() == typeof(Texture2D);
    }

Controlling Order with Priority

Priority is a number that can be assigned to a menu item (passed to the MenuItem attribute) that controls the ordering of menu items under the root menu.
Menu items are also automatically grouped according to their assigned priority in increments of 50:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
    [MenuItem("NewMenu/Option1", false, 1)]
    private static void NewMenuOption()
    {
    }

     [MenuItem("NewMenu/Option2", false, 2)]
    private static void NewMenuOption2()
    {
    }

     [MenuItem("NewMenu/Option3", false, 3)]
    private static void NewMenuOption3()
    {
    }

     [MenuItem("NewMenu/Option4", false, 51)]
    private static void NewMenuOption4()
    {
    }

     [MenuItem("NewMenu/Option5", false, 52)]
    private static void NewMenuOption5()
    {
    }

The code example results in the menu that has 2 groups of items, according to the assigned priority:


Related Classes

MenuCommand

When adding a new menu item to an inspector (using “CONTEXT/Component”, as described above), sometimes it is necessary to get a reference to the actual component (e.g: to modify its data).
This can be done by adding a MenuCommand argument to the static method that defines the new menu item:
1
2
3
4
5
6
7
    [MenuItem("CONTEXT/RigidBody/New Option")]
    private static void NewMenuOption(MenuCommand menuCommand)
    {
        // The RigidBody component can be extracted from the menu command using the context field.
        var rigid = menuCommand.context as Rigidbody;
    }

ContextMenu

This attribute allows defining context menu items. This works exactly the same as defining a method with the MenuItem attribute with a path that starts with “CONTEXT/…”.
The difference is that with this attribute, you define the default context menu for a given component, whereas with the MenuItem approach, you “extend” other components’ menus (for example – the default components that are part of the engine).
1
2
3
4
5
6
7
    public string Name;

     [ContextMenu("Reset Name")]
    private static void ResetName()
    {
        Name = string.Empty;
    }

ContextMenuItem


This attribute is added to fields of a component (MonoBehaviour) class, to allow adding context menus at a finer resolution. While the ContextMenu attribute shown above adds context menus at the component level, marking fields with this attribute will add a right-click menu to individual public fields.
Since this attribute is added to a field and not a method, it accepts 2 arguments: the display name of the menu item and a name of a method (instance method) to be invoked when the menu item is selected.
1
2
3
4
5
6
7
    [ContextMenuItem("Randomize Name", "Randomize")]
    public string Name;

     private void Randomize()
    {
        Name = "Some Random Name";
    }








留言

張貼留言

這個網誌中的熱門文章

[Unity]UGUI 原理篇 (一)：Canvas 渲染模式

圖片
參考 Canvas 渲染模式   Unity – Manual: Canvas Canvas : Canvas Component 是 UI布局和渲染的抽象空間，所有的UI都必須在Canvas之下(子物件) Render Mode UI渲染的方式有三種 Screen Space - Overlay : 螢幕空間 - 覆蓋  Screen Space - Camera : 螢幕空間 - 攝影機 World Space : 世界座標空間 Screen Space - Overlay 在此模式下不會參照到Camera，UI直接顯示在任何圖形之上 Pixel Perfect : 可以使圖像更清晰，但是有額外的性能開銷，如果在有大量UI動畫時，動畫可能會不平順 Sort Order : 深度值，該值越高顯示越前面 Target Display : 在特定的Camera才會顯示 Additional Shader Channels : 自訂Shader Screen Space – Camera 使用一個Camera作為參照，將UI平面放置在Camera前的一定距離，因為是參照Camera，如果螢幕大小、分辨率、Camera視錐改變時UI平面會自動調整大小。如果Scene中的物件(GameObject)比UI平面更靠近攝影機，就會遮擋到UI平面。 Render Camera ：用於渲染的攝影機 Plane Distance ：與Camera的距離 Sorting Layer ：Canvas屬於的排序層，在 Edit->Project Setting->Tags and Layers->Sorting Layers 進行新增，越下方的層顯示越前面 Order in Layer ：Canvas屬於的排序層下的順序，該值越高顯示越前面 World Space 把物體當作世界座標中的平面(GameObject)，也就是當作3D物件，顯示3D UI Event Camera ：處理UI事件(Click、Drag)的Camera，所設定的Camera才能觸發事件
閱讀完整內容

[Android]JavaScript與Android溝通

------------有問題的方法------------------------------------------------------------------- 在 Android 裡將網頁載入到畫面 使用  WebView 元件 就可以很輕鬆達成任務， 如果要再加上跟 JavaScript 的 互動 的話 Android 系統也提供了 互通機制 可從 Android 呼叫 JavaScript 的函式 或從 JavaScript 呼叫 Android 的函式。 設定 Android 端 建立一個類別 JavaScriptInterface 專門 給 JavaScript 呼叫 1 2 3 4 5 6 /** 建立給 JavaScript 呼叫的函式 **/ public class JavaScriptInterface {      public void fun1() {          //Android 要執行的程式碼      } } 設定 WebView 的功能 1 2 3 4 5 //啟用 WebView 的 JavaScript 執行功能 webView.getSettings().setJavaScriptEnabled( true ); //設定允語 JavaScript 呼叫的對應名稱 webView.addJavascriptInterface( new JavaScriptInterface(), "android" ); 設定 JavaSript 端 1 2 3 4 5 <script type= "text/javascript" >      function fun2() {          //JavaScript 要執行的程式碼      } </script> JavaScript 與 Android 程式碼互相呼叫 Android 1 mWebView.loadUrl( "javascript:f
閱讀完整內容

[Android]加載圖片導致內存溢出(Out of Memory 異常)

方案一、讀取圖片時注意方法的調用，適當壓縮 儘量 不要使用 setImageBitmap 或 setImageResource 或 BitmapFactory.decodeResource 來設置一張大圖，因為這些函數在完成 decode 後，最終都是通過 java 層的 createBitmap 來完成的，需要消耗更多記憶體。 因此， 改用先通過 BitmapFactory.decodeStream 方法 ，創建出一個 bitmap ，再將其設為 ImageView 的 source ， decodeStream 最大的秘密在於其直接調用 JNI>>nativeDecodeAsset() 來完成 decode ，無需再使用 java 層的 createBitmap ，從而節省了 java 層的空間。         InputStream is =   this .getResources().openRawResource(R.drawable.pic1);         BitmapFactory.Options options =   new   BitmapFactory.Options();         options. inJustDecodeBounds   =   false ;         options. inSampleSize   = 10;     //   width ， height 設為原來的十分一           Bitmap btp = BitmapFactory. decodeStream (is,  null , options); 如果在讀取時加上圖片的 Config 參數，可以跟有效減少載入的記憶體，從而跟有效阻止拋 out of Memory 異常。                    /*讀取本地資源的圖片*/          public   static   Bitmap readBitMap(Context context,   int   resId){          BitmapFactory.Options opt =   new   BitmapFactory.Options();         opt
閱讀完整內容