Changes

__NOTOC__The [[File:Library.png|right|frame|<center>The '''Library''' pane, when a MatterHackers account is [[Sign in|signed in]], has [[#Purchased|purchased models]], and [[FILE menu#Enter Share Code|models shared from another user]].</center>]]The Library is a place for organizing and storing models. It includes 4 different has five sections: Local Library, Cloud Library, Purchased, ; three static and Downloads. In each section, models can be organized using a traditional folder structuretwo dynamic.

[[File:Library.png|right|frame|<center>The '''Local Library''', '''Cloud Library''' pane, when a MatterHackers account is [[Sign in|signed in]] and has [[#'''Downloads''' sections are always visible. The '''Purchased|purchased ''' and '''Shared with Me''' sections are shown only when they contain models]].</center>]]

In most sections, models can be organized using a traditional folder structure.__TOC__== Local Library Sections ==

This is a place for storing designs on your local system. Any designs you had in the === <span class="mw-headline" id="Local_Library">[[File:Local Library prior to MatterControl 1.4 will be put here.png]]</span> ===

== Cloud Stores designs in the local file system. Any designs in the Library ==prior to MatterControl 1.4 are put here after the upgrade.

The '''=== <span class="mw-headline" id="Cloud_Library">[[File:Cloud Library''' is a new option for storing designs that gives you instant access to your design files from anywhere. Designs stored in the Cloud Library are tied to your user account. After signing-in you'll be able to browse and manage any design files that you've previously added and add new files. png]]</span> ===

The '''Cloud Library''' allows instant access to design files through MatterControl from anywhere with an Internet connection. Designs within stored in the Cloud Library are synced automatically across any devices you are currently logged into and can also be viewed from the tied to a [https://sync.mattercontrol[MatterHackers.com/ MatterControl Syncaccount] website]. Once signed in the user can browse and manage any design files previously added and add new files.

For more information on Designs within the Cloud Library check out are synced automatically across any devices the user is currently logged into and can also be viewed from the [httphttps://wwwsync.matterhackersmattercontrol.com/articles/in-depth-mattercontrol-cloud-library In Depth: MatterControl Cloud Library for DesignsSync]website.

Automatically contains any designs you have purchased from the === <span class="mw-headline" id="Purchased">[http[File://wwwPurchased.matterhackers.compng]]</store/digital-designs MatterHackers Design Store].span> ===

This gives you direct access to the Downloads folder on your hard drive === <codespan class="mw-headline" id="Shared with Me">~/Downloads</code> on Linux/Mac or <code>C[[File:\Users\{user}\DownloadsShared with Me.png]]</codespan> on Windows). Any STL or AMF files in that folder will automatically appear here. Any changes you make to these designs in MatterControl will be saved to disk as an AMF file, either replacing the existing AMF or creating a new one of the design was originally an STL.===

Contains any models shared from other users using the [[Library/Share Library Item|Share Library Item]] function in the Cloud Library section. === <span class="mw-headline" id="Downloads">[[File:Downloads.png]]</span> === Gives direct access to the Downloads folder on the hard drive <code>~/Downloads</code> on Linux/Mac or <code>C:\Users\{user}\Downloads</code> on Windows). Any STL, AMF, or GCODE files in that folder will automatically appear here. Any changes made to these designs in MatterControl will be saved to disk as an AMF file. Depending on the original file type, this will either create a new AMF with the same name but with a different file extension, or replace the existing AMF file. == Navigation == === Top Level === To open a section, hover over the section and click the '''Open''' button at the right side. [[File:Open Library.png]] === In a section === [[File:Library In section.png|right|framed|<center>The '''Local Library''' section with '''Home''', '''Search''', '''Edit''', '''Add''' and '''Create Folder''' buttons active.</center>]]Once in a section, a breadcrumb trail shows the futurecurrent location within each section, we plan subsequent folders, or search results. [[File:Library_Breadcrumb.png]] Models can be viewed or printed directly by hovering over their bar in the list. The '''View''' button opens the model in a new [[3D View]] window. The '''Print''' button slices the model using the current [[Settings]] and begins the print. [[File:Library View Print.png]] Also, some new buttons become visible: '''Home''', '''Search''', and '''Edit''', and two become active: '''Add''' and '''Create Folder'''. === Add === [[File:Add Library.png]] Opens the operating system's file selection window so the user can choose a .STL, .AMF, .GCODE, or .ZIP file to add to the ability currently displayed section. Not available in the [[#Purchased|Purchased]] or [[#Shared with Me|Shared with Me]] sections. === Create Folder === [[File:Create Folder Library.png]] Creates a folder in the currently displayed section. Not available in the [[#Purchased|Purchased]] or [[#Shared with Me|Shared with Me]] sections. === Home === Returns to the top level of the Library, as shown in the [[:File:Library.png|screenshot at the top right of this page]]. === Search === Searches the currently displayed section for the text input in the 'Search Library' field.  === Edit === [[File:Edit1.png|right|framed|<center>The '''Local Library''' section in '''Edit''' mode.]] Shows advanced file and folder options. Check a box next to a file or folder to activate applicable file action buttons above. Not available in the [[#Purchased|Purchased]] or [[#Shared with Me|Shared with Me]] sections. ==== Export ==== Opens the [[File export options]] dialog box to export the currently selected file. Active when only one file is selected. ==== Edit ==== Opens the selected file in a new 3D View window in [[3D View/Edit|Edit mode]]. Active when only one file is selected. ==== Remove ==== Removes the selected file(s) from the current Library section. Active when one or more files are selected. ==== Share ==== Opens the [[Library/Share Library Item|Share Library Item]] dialog box. Available only in the [[#Cloud Library|Cloud Library]] section. Active when only one file is selected. ==== Rename ==== [[File:Rename Item box.png]] Opens the '''Rename Item''' dialog box. Enter a new name for the model and click 'Rename' to apply. Active when only one file is selected. ==== Add to Queue ==== Adds the selected file(s) to the [[Queue]]. Active when one or more files are selected. ==== Done ==== Exits '''Edit''' mode. == Adding custom folders from your hard drive == The library can be set up to track any other directory in folder on your hard drive the same way it does with the [[Library#Downloads|Downloads]] folder. To do this, create a file system as wellcalled {{ic|LibraryFolders.conf}} in the MatterControl [[Data directory|application data directory]]. Add the full path to the folders you want to track on separate lines.Here is an example: {{bc|/home/matterhacker/testsupport/Printed Parts/home/matterhacker/Designs}}