Search Unity

Editor List & Array Toolkit [RELEASED]

Discussion in 'Assets and Asset Store' started by 3dmars, Apr 23, 2021.

  1. 3dmars

    3dmars

    Joined:
    Jan 3, 2016
    Posts:
    52

    This toolkit enables essential commands useful for arrays and lists - more precisely, operations on ranges of array and list elements. All included "Geek Productivity Commands" are available in the GameObject context menu, Assets context menu and in the Inspector context menu related to list and array properties. The main plugin features are:
    • copying selected game objects or assets to the Geek Clipboard, ordered in different ways (e.g. by executing copy commands using the alphanumeric sort by asset file path or game object name),
    • moving a range of array or list elements from one place to another within a given array or list,
    • copying a range of array or list elements to the Geek Clipboard,
    • copying all array or list elements to the Geek Clipboard,
    • pasting array or list elements available in the Geek Clipboard into an array or list,
    • copying either a locked element range or unlocked range (based on a clicked index),
    • cutting a range of array or list elements and placing them in the Geek Clipboard,
    • inserting array or list elements available in the Geek Clipboard into an array or list at a clicked index,
    • appending array or list elements available in the Geek Clipboard after a clicked index in an array or list,
    • duplicating a range of array or list elements - once and many times,
    • deleting a range of array or list elements,
    • setting and resizing a range of array or list elements,
    • different operation modes such as a locked or unlocked element range mode,
    • locking all the list or array range.

    This Geek Addons bundle includes the following families of commands described below: “GameObject Menu COPY”, “Assets Menu COPY”, “MOVE”, “COPY”, “PASTE”, “CUT”, “DELETE”, “INSERT”, “APPEND”, “DUPLICATE”, “DUPLICATE Nx”, “RANGE”, “LOCK”, “COPY ALL” and “LOCK ALL” commands. You can access them in the 4AI Geek Context Menu appended to a standard Unity context menu related to array and list properties. The command names are shortened in this description usually.

    PACKAGE CONTENT

    See the details below.

    editor-list-array-toolkit-cropped-assets-gameobject-menus-c256.gif

    BUNDLE COMMANDS

    GameObject Menu COPY commands

    "GameObject Menu COPY" commands appear in the Hierarchy view and GameObject menu:

    • 4AI --> Copy
    • 4AI Geek Copy (submenu)
      • COPY Selected GAME OBJECTS - HIERARCHY ORDER
      • COPY Selection
      • COPY Selection - Alphanumeric SORT by NAME
      • COPY Selection - SORT by NAME

    Assets Menu COPY commands

    "Assets Menu COPY" commands appear in the Assets menu:

    • 4AI --> Copy
    • 4AI Geek Copy (submenu)
      • COPY Selection - Alphanumeric SORT by ASSET PATH
      • COPY Selection - Alphanumeric SORT by NAME
      • COPY Selection
      • COPY Selection - SORT by ASSET PATH
      • COPY Selection - SORT by NAME

    MOVE commands
    • MOVE <a, b> (submenus; appears when the range is unlocked)
      • MOVE <a, b> to array Start or End
      • MOVE <a, b> by N
    • MOVE <a, b> and LOCK (submenus; appears when the range is unlocked)
      • MOVE <a, b> to array Start or End
      • MOVE <a, b> by N
    • MOVE <START, END> LOCKED (submenus; appears when the range is locked)
      • MOVE <START, END> to array Start or End
      • MOVE <a, b> by N
    • MOVE <START, END> and UNLOCK (submenus; appears when the range is locked)
      • MOVE <a, b> to array Start or End
      • MOVE <a, b> by N

    COPY & COPY ALL commands
    • COPY range
    • COPY range LOCKED (appears when the range is locked)
    • COPY and LOCK range and SET (range) END
    • COPY ONE item
    • COPY ALL items

    PASTE commands

    • PASTE (appears when the range is unlocked)
    • PASTE and LOCK range

    DUPLICATE & DUPLICATE Nx commands

    • DUPLICATE range
    • DUPLICATE range LOCKED
    • DUPLICATE N x range (submenus)
    • DUPLICATE N x range LOCKED (submenus)

    CUT commands

    • CUT range
    • CUT range LOCKED

    DELETE commands

    • DELETE range
    • DELETE range LOCKED

    INSERT commands

    • INSERT at [x] (appears when the range is unlocked)
    • INSERT at [x] and LOCK (appears when the range is locked)
    • INSERT and LOCK range at [x] (appears when the range is unlocked)

    APPEND commands
    • APPEND at [x] (appears when the range is unlocked)
    • APPEND at [x] and LOCK (appears when the range is locked)

    RANGE commands
    • SET RANGE to R (submenus)
    • SET RANGE to R LOCKED (submenus)
    • RESIZE RANGE by R (submenus)
    • RESIZE RANGE by R LOCKED (submenus)
    • SET range START and LOCK
    • SET range END and LOCK

    LOCK & LOCK ALL commands

    • LOCK range (appears when the range is unlocked)
    • UNLOCK range (appears when the range is locked)
    • RELOCK range (appears when the range is locked)
    • LOCK ALL

    GEEK CONTEXT MENU ITEMS

    editor-list-array-toolkit-cropped-assets-gameobject-menus-c256.gif

    editor-list-array-toolkit-40.png

    >>> GET IT IN THE ASSET STORE <<<

    editor-list-array-toolkit-58.png

    View attachment 840256

    editor-list-array-toolkit-gameObject-menu.png


    editor-list-array-toolkit-assets-menu.png

    >>> GET IT IN THE ASSET STORE <<<

    ADDON DESCRIPTIONS
    Below you can find descriptions of the current Geek Inspector Context Menu addons.

    Common terms and identifiers simplifying the descriptions

    • clickedINDEX – clicked array or list item index,
    • START – current fixed range start,
    • END – current fixed range end,
    • R – current range size (equal to: END-START+1 in the LOCKED state or b-a+1 in the UNLOCKED state),
    • <a, b> – a range where a = clickedINDEX and (b - a + 1) = R
    • <START, END>, LOCKED range – a range locked to specific array or list elements that is modified if the position of elements change,
    • FIXED range – a range that was usually LOCKED earlier and UNLOCKED later,
    • regular range <a, b> - the range <a, b> where b >= a,
    • GEEK CLIPBOARD – internal Geek Inspector Addons clipboard.
    GameObject MENU COMMANDS

    4AI → COPY

    Uses a default COPY command to copy game objects or selection using a specific object order. After the installation the default COPY command is: “COPY Selected GAME OBJECTS - HIERARCHY ORDER”. It can be changed by creating another class similar to DefaultGameObjectCopyExecutor, but this feature is not documented and is not guaranteed to be used in the future. Use it at your own risk.

    4AI Geek Copy (submenu)
    • COPY Selected GAME OBJECTS - HIERARCHY ORDER
      COPY selected GAME OBJECTS to the Geek Clipboard, ordered as in the Hierarchy view.

    • COPY Selection
      COPY Selection to the Geek Clipboard. You can use it to copy both selected game objects and assets. If objects are selected one by one, copied objects usually have the selection order, but it is not guaranteed.

    • COPY Selection - Alphanumeric SORT by NAME
      COPY Selection to the Geek Clipboard. You can use it to copy both selected game objects and assets. Copied objects use “alphanumeric sort by name”, so any numbers in the name are not sorted as strings. For example, sorting the names “Abc1, Abc10, Abc2” will give “Abc1, Abc2, Abc10” because 1 < 2 < 10.

    • COPY Selection - SORT by NAME
      COPY Selection sorted by name to the Geek Clipboard. You can use it to copy both selected game objects and assets.

    Assets MENU COMMANDS

    4AI → COPY

    Uses a default COPY command to copy selection (usually assets) using a specific object order. After the installation the default COPY command is: “COPY Selection - Alphanumeric SORT by ASSET PATH”. It can be changed by creating another class similar to DefaultAssetsCopyExecutor, but this feature is not documented and is not guaranteed to be used in the future. Use it at your own risk.

    4AI Geek Copy (submenu)

    • COPY Selection - Alphanumeric SORT by ASSET PATH
      COPY Selection to the Geek Clipboard. You can use it to copy both selected game objects and assets. Copied objects use “alphanumeric sort by asset path”, so any numbers in the asset path are not sorted as strings. For example, sorting the asset paths “Dir/Abc1, Dir/Abc10, Dir/Abc2” will give “Dir/Abc1, Dir/Abc2, Dir/Abc10” because 1 < 2 < 10.

    • COPY Selection - Alphanumeric SORT by NAME
      COPY Selection to the Geek Clipboard. You can use it to copy both selected game objects and assets. Copied objects use “alphanumeric sort by name”, so any numbers in the name are not sorted as strings. For example, sorting the names “Abc1, Abc10, Abc2” will give “Abc1, Abc2, Abc10” because 1 < 2 < 10.

    • COPY Selection
      COPY Selection to the Geek Clipboard. You can use it to copy both selected game objects and assets. If objects are selected one by one, copied objects usually have the selection order, but it is not guaranteed.

    • COPY Selection - SORT by ASSET PATH
      COPY Selection sorted by asset path to the Geek Clipboard. You can use it to copy both selected game objects and assets.

    • COPY Selection - SORT by NAME
      COPY Selection sorted by name to the Geek Clipboard. You can use it to copy both selected game objects and assets.

    LIST & ARRAY SINGLE COMMANDS
    SET range START and LOCK
    SET the array or list range START to clickedINDEX so that the final range is <clickedINDEX, END> and is LOCKED. See the LOCK range command for more information.

    SET range END and LOCK
    SET the array or list range END to clickedINDEX so that the final range is <START, clickedINDEX> and is LOCKED. See the LOCK range command for more information.

    LOCK range
    LOCK the range <clickedINDEX, R>. If you execute a command such as MOVE range by N or SHIFT range by N on a LOCKED range, the whole range will be moved or shifted by N too. When you have a LOCKED range, you can click on any array / list item and it will not have any effect on the range a given command will use. The range will be equal to <START, END>.

    UNLOCK range
    Unlocks the range, which means that the current range will be recalculated based on the current clickedINDEX and current range size R. If you click at a different array or list element, the range will start at that element. The related context menu item is available when the range is LOCKED.

    RELOCK range
    UNLOCK the range <START, END> and LOCK the range <clickedINDEX, clickedINDEX+R-1>, so that the new range size is unchanged, but the START is equal to clickedINDEX. The related context menu item is available when the range is LOCKED.

    LOCK ALL
    LOCK the whole range of a given list or array. If you execute a command such as MOVE range by N or SHIFT range by N on a LOCKED range, the whole range will be moved or shifted by N too. When you have a LOCKED range, you can click on any array / list item and it will not have any effect on the range a given command will use. The range will be equal to <START, END>.

    COPY range
    COPY the range <clickedINDEX, clickedINDEX+R-1> to the GEEK CLIPBOARD.

    The final range and the range end must fit in the array or list.

    COPY range LOCKED
    COPY the LOCKED range <START, END> to the GEEK CLIPBOARD.

    The final range and the range end must fit in the array or list. The related context menu item is available when the range is LOCKED.

    COPY and LOCK range and SET (range) END
    COPY the range <START, clickedINDEX> to the GEEK CLIPBOARD and LOCK it. Set the range END to clickedINDEX.

    The final range and the range end must fit in the array or list.

    COPY ONE item
    COPY ONE clicked item to the GEEK CLIPBOARD.

    The final range and the range end (element index in this case) must fit in the array or list.

    COPY ALL items
    COPY the whole range of a given array or list to the GEEK CLIPBOARD.

    PASTE
    PASTE the GEEK CLIPBOARD contents at the clickedINDEX. The pasted values will override the old ones. The whole content and the last item must fit in the array or list.

    PASTE and LOCK range
    PASTE the GEEK CLIPBOARD contents at the clickedINDEX. The pasted values will override the old ones. Next, LOCK the pasted range. The whole content and the last item must fit in the array or list.

    DUPLICATE range
    DUPLICATE the range <clickedINDEX, clickedINDEX+R-1>. The whole content is appended just after the content being duplicated.

    The related context menu item is available when the range is UNLOCKED.

    DUPLICATE range LOCKED
    DUPLICATE the LOCKED range <START, END>. The whole content is appended just after the content being duplicated.

    The related context menu item is available when the range is LOCKED.

    CUT range
    CUT the range <clickedINDEX, clickedINDEX+R-1> so that it is copied to the GEEK CLIPBOARD and deleted.

    The related context menu item is available when the range is UNLOCKED. The calculated range must be regular and must fit in the array or list.

    CUT range LOCKED
    CUT the LOCKED range <START, END> so that it is copied to the GEEK CLIPBOARD and deleted.

    The related context menu item is available when the range is LOCKED. The range must be regular and must fit in the array or list.

    DELETE range
    DELETE the range <clickedINDEX, clickedINDEX+R-1>.

    The related context menu item is available when the range is UNLOCKED. The calculated range must be regular and must fit in the array or list.

    DELETE range LOCKED
    DELETE the LOCKED range <START, END>.

    The related context menu item is available when the range is LOCKED. The range must be regular and must fit in the array or list.

    INSERT at [x]
    INSERT the GEEK CLIPBOARD contents at x=clickedINDEX and just before the item[clickedINDEX]. No items are overridden during this operation.

    The related context menu item is available when the range is UNLOCKED.

    INSERT at [x] and LOCK
    INSERT the GEEK CLIPBOARD contents at the x=clickedINDEX and just before the item[clickedINDEX]. Next, lock the range of inserted elements. No items are overridden during this operation.

    The related context menu item is available when the range is LOCKED.

    INSERT and LOCK range at [x]
    INSERT the GEEK CLIPBOARD contents at the x=clickedINDEX and just before the item[clickedINDEX]. Next, lock the range of inserted elements. No items are overridden during this operation.

    The related context menu item is available when the range is UNLOCKED.

    APPEND at [x]
    APPEND the GEEK CLIPBOARD contents just after the x=clickedINDEX and just before the next item: clickedINDEX+1. No items are overridden during this operation.

    The related context menu item is available when the range is UNLOCKED.

    APPEND at [x] and LOCK
    APPEND the GEEK CLIPBOARD contents just after the x=clickedINDEX and just before the next item: clickedINDEX+1. Next, lock the range of appended elements. No items are overridden during this operation.

    The related context menu item is available when the range is LOCKED.

    LIST & ARRAY SUBMENUS
    SET RANGE to R (submenus)
    SET range to <clickedINDEX, clickedINDEX+R-1> so that the range size equals R. R is chosen by one of the command submenu items.

    SET RANGE to R LOCKED (submenus)
    SET range to <START, START+R-1> so that the range size equals R. R is chosen by one of the command submenu items. Next, update the LOCKED range. The related context menu item is available when the range is LOCKED. See the LOCK range command for more information.

    RESIZE RANGE by R (submenus)
    RESIZE the range <clickedINDEX, clickedINDEX+currentR-1> by R, so that the final range is <clickedINDEX, clickedINDEX+currentR+R-1>, where currentR is the range size before the operation. R is chosen by one of the command submenu items.

    RESIZE RANGE by R LOCKED (submenus)
    RESIZE the range <START, END> by R, so that the final range is <START, END+R>, where currentR is the range size before the operation. R is chosen by one of the command submenu items. Next, update the LOCKED range. The related context menu item is available when the range is LOCKED. See the LOCK range command for more information.

    MOVE <a, b> (submenus)
    MOVE the range <clickedINDEX, clickedINDEX+R-1>:

    • to the array Start or End.
    • by N.
    The final range and the range end must fit in the array or list. N is chosen by one of the command submenu items.

    MOVE <a, b> and LOCK (submenus)
    MOVE the range <clickedINDEX, clickedINDEX+R-1>:

    • to the array Start or End.
    • by N.
    Next, LOCK the range. The final range and the range end must fit in the array or list. N is chosen by one of the command submenu items. See the LOCK range command for more information.

    MOVE <START, END> LOCKED (submenus)
    MOVE the range <START, END>:

    • to the array Start or End.
    • by N.
    Next, update the LOCKED range. The final range and the range end must fit in the array or list. N is chosen by one of the command submenu items. The related context menu item is available when the range is LOCKED. See the LOCK range command for more information.

    MOVE <START, END> and UNLOCK (submenus)
    MOVE the range <START, END>:

    • to the array Start or End.
    • by N.
    Next, UNLOCK the range. The final range and the range end must fit in the array or list. N is chosen by one of the command submenu items. The related context menu item is available when the range is LOCKED.

    DUPLICATE N x range (submenus; duplicate N times)
    DUPLICATE the range <clickedINDEX, clickedINDEX+R-1> N times. The whole content is appended just after the content being duplicated.

    DUPLICATE N x range LOCKED (submenus; duplicate N times)
    DUPLICATE the LOCKED range <START, END> N times. The whole content is appended just after the content being duplicated.


    You can find more details in the Unity Asset Store and on the plugin website at https://4ai.io/editor-list-array-toolkit/.

    If you are interested in other addons, you can find more information on all current and planned Geek Inspector Addons at https://4ai.io/geek-inspector-addons/ .

     
    Last edited: Jun 4, 2021
  2. 3dmars

    3dmars

    Joined:
    Jan 3, 2016
    Posts:
    52
  3. 3dmars

    3dmars

    Joined:
    Jan 3, 2016
    Posts:
    52
    Last edited: Mar 6, 2022
  4. 3dmars

    3dmars

    Joined:
    Jan 3, 2016
    Posts:
    52