The User Library is a user-created custom library of projects and resources that can become integrated into InstaMAT's library. Adding projects and resources to the User Library makes them available for use in other InstaMAT Studio projects. This also makes them accessible with InstaMAT's integrations.
This article covers how to add resources to the User Library and where to locate them in InstaMAT Studio and InstaMAT's integrations.
¶ How to Locate the User Library Folder
By default, InstaMAT's User Library folder is located in the InstaMAT user data directory commonly found in your user's Documents folder. For example: ~/<Your-Username>/Documents/InstaMAT/Library. InstaMAT Package files (.IMP files) added to the "Library" subdirectory will be made available within InstaMAT.
¶ Custom User Paths
Custom user paths can be defined in InstaMAT Studio's Preferences panel. These paths allow the user to provide multiple locations for the InstaMAT directory. Directories listed here will be organized with InstaMAT's folder structure including a "Library" subdirectory. It is important to set these paths both in InstaMAT Studio and in the settings for InstaMAT's integrations.
The User Paths section in InstaMAT Studio's Preferences panel.
The Path Settings section in InstaMAT for Unity's InstaMAT Settings panel.
¶ Where to Find User Library Assets in InstaMAT Studio
Projects and resources added to the User Library are accessible throughout the InstaMAT Studio interface and can be located in the MAT Library panel, Quick Search, and also with the Resource Picker panel.
In the
MAT Librarypanel and theResource Pickerpanel, clicking the (Show Only User Library Content) button makes it possible to filter only User Library content.
¶ Where to Find User Library Assets in InstaMAT's Integrations
Assets in the User Library are accessable from the Library Browser panel. Clicking the (User Packages) button will filter only user content.
¶ How to Save a Project to the User Library
To save a project to the User Library:
- Assign the project a category. A category can be assigned in the Graph Object Editor or in the Layering Project Editor for layering projects.
- Move the InstaMAT Package file (.IMP) to the User Library folder.
¶ How to Save a Resource to the User Library
Resources such as a mesh, image, or font can be added to the User Library making them accessible for other InstaMAT projects.
To add a resource to the User Library:
- Import the resouce into an InstaMAT Package (.IMP) file.
- Save the InstaMAT Package file to the User Library folder.
InstaMAT will categorize the resources based on their type and make them available under the Assets category.