The tool enables copy-paste functionality for arrays and lists in the Unity Inspector - more precisely, ranges of array and list elements. The main plugin features are:

• copying an array or list element range and placing copied elements in the Geek Clipboard,
• pasting array or list elements available in the Geek Clipboard in an array or list,
• setting and resizing the array or list element range,
• copying either a locked element range or unlocked range (based on a clicked index).

As all our "Geek Utilities", this copy-paste utility can enhance your workflow and increase productivity.

The addons included in this package extend the Unity Editor as described below.

Full source code included.

WEBSITE | DOC | GEEK ADDONS | SUPPORT FORUM | BUG REPORTS | FORUM

--------------------------------------------------

OTHER RELEASED 4AI GEEK ADDONS

--------------------------------------------------

• Geek Tools
• List & Array Toolbox
• Editor List & Array Toolkit
• Inspector List & Array Toolkit
• SELECT-RANGE-LOCK Geek Inspector Addons
• CUT-INSERT-RANGE Geek Inspector Addons
• MOVE-RANGE-LOCK Geek Inspector Addons
• Visit the publisher page for the full list of productivity extensions.

------------------------------

DEMO SCENE

------------------------------

You can test this package with the free demo scene available in the Asset Store.
For testing, you can also use two MonoBehaviour scripts: ExampleArrays.cs and ExampleLists.cs that contain many different arrays and lists. Attach the scripts to any game objects, define array and list data and then, just right-click on array/list element names to display a context menu with appended 4AI Geek Context Menu.

This Geek Inspector Addons bundle includes three families of commands described below: “COPY”, “PASTE”, “RANGE” 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.

------------------------------

BUNDLE COMMANDS

------------------------------

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

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

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

------------------------------

HOW TO USE IT

------------------------------

For the purpose of this description the term “right-click” will be used as the operation opening a context menu.

You can open the 4AI Geek Context Menu as any context menu in the Unity Inspector by right-clicking on an array or list element name (not a value). In some versions of Unity it is also possible to right-click on the array/list name itself - in this case it assumes that the clicked element index is zero. 4AI Geek Context Menu is appended to the standard Unity context menu items. You can learn more details at:
https://4ai.io/geek-inspector-addons/

------------------------------

BUNDLE ADDONS

------------------------------

The bundle contains some of soon-to-be released separate Geek Inspector Addons, including necessary Geek Inspector Addons Core 1.0 files. Check the Unity Asset Store for availability of the addons. The plugins are planned to have the following names:

• COPY Array / List range - Geek Inspector Addon
• PASTE Array / List elements - Geek Inspector Addon
• SET Array / List RANGE to N - Geek Inspector Addon
• RESIZE Array / List RANGE by N - Geek Inspector Addon
• SET Array / List RANGE <START, END> and LOCK - Geek Inspector Addon

------------------------------

DEFINITIONS

------------------------------

Common terms and identifiers simplifying the descriptions:

• clickedINDEX – clicked array or list item index,
• START – current FIXED / LOCKED range start,
• END – current FIXED / LOCKED 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,
• GEEK CLIPBOARD – internal Geek Inspector Addons clipboard.

------------------------------

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.

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 <clickedINDEX, clickedINDEX+R-1> 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.

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.

------------------------------

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.

------------------------------

DEMO SCENE

------------------------------

A demo scene is planned to be provided in the Unity Asset Store as a free asset. Check the Unity Asset Store for availability. For testing, you can also use two MonoBehaviour scripts: ExampleArrays.cs and ExampleLists.cs that contain many different arrays and lists. Attach the scripts to any game objects, define array and list data and then, just right-click on array/list element names to display a context menu with appended 4AI Geek Context Menu.

------------------------------

EXTENSIONS

------------------------------

Some extensions for the Geek Inspector Addons framework are planned to be released in the Unity Asset Store, for example:

• Geek Context Menu style configuration (e.g. it will be possible to change some indentations, prefixes and suffixes),
• Geek Context Menu items visibility and priority (order).

Check the Unity Asset Store for availability.

------------------------------------------------------------

TYPES SUPPORTED BY COPY & PASTE OPERATIONS

------------------------------------------------------------

The following serialized property types (SerializedPropertyType) are supported by copy & paste commands:

• ObjectReference,
• Integer,
• Float,
• Boolean,
• String,
• Vector2,
• Vector2Int,
• Vector3,
• Vector3Int,
• Vector4,
• Quaternion,
• Bounds,
• BoundsInt,
• Rect,
• RectInt,
• Enum,
• Color,
• Character,
• LayerMask,
• AnimationCurve,
• Generic,
• ArraySize - supported once copying generic types,
• ExposedReference - it is supported in the code, but it has not been tested.

The following types are not supported by copy & paste operations:
• FixedBufferSize,
• Gradient.

This plugin performs a lot of reasonable conversions when pasting copied values, for example:
• float to int,
• float to long,
• double to int,
• double to long,
• int to float,
• int to double,
• long to float,
• long to double,
• Vector2Int to Vector2,
• Vector2 to Vector2Int,
• Vector3Int to Vector3,
• Vector3 to Vector3Int,
• Vector4 to Quaternion,
• Quaternion to Vector4,
• BoundsInt to Bounds,
• Bounds to BoundsInt,
• RectInt to Rect,
• Rect to RectInt,
• many types to String...

This version of the plugin doesn't support copy & paste operations for array and list ranges between Unity projects. It might be possible with an extension in the future or e.g. in a PRO version.

Check the Unity Asset Store for availability.

------------------------------

LINKS

------------------------------

Links related to Geek Addons:

• PLUGIN WEBSITE & DOCUMENTATION
• Free Demo Scene - Geek Addons Demo
• Geek Addons page
• Geek Inspector Addons page
• Forum
• Support Forum
• Bug Reports Forum
• Unity forum thread related to Geek Inspector Addons (Works in Progress)
• Unity forum thread related to COPY-PASTE-RANGE Geek Inspector Addons release
• Contact

--------------------------------------------------

OTHER RELEASED 4AI GEEK ADDONS

--------------------------------------------------

• Geek Tools
• List & Array Toolbox
• Editor List & Array Toolkit
• Inspector List & Array Toolkit
• SELECT-RANGE-LOCK Geek Inspector Addons
• CUT-INSERT-RANGE Geek Inspector Addons
• MOVE-RANGE-LOCK Geek Inspector Addons
• Visit the publisher page for the full list of productivity extensions.

------------------------------------

SOCIAL PAGES

------------------------------------

• 4AI on Facebook
• 4AI on Twitter
• 4AI on Linkedin

FULL SOURCE CODE included.

WEBSITE | DOC | GEEK ADDONS | SUPPORT FORUM | BUG REPORTS | FORUM