Difference between revisions of "LIBRARY"
(Adding Incomplete Template) |
(→Adding custom folders from your hard drive) |
||
(15 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | 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 has five sections; three static and two dynamic. |
− | + | The '''Local Library''', '''Cloud Library''', and '''Downloads''' sections are always visible. The '''Purchased''' and '''Shared with Me''' sections are shown only when they contain models. | |
− | == | + | In most sections, models can be organized using a traditional folder structure. |
+ | __TOC__ | ||
+ | == Sections == | ||
− | + | === <span class="mw-headline" id="Local_Library">[[File:Local Library.png]]</span> === | |
− | + | Stores designs in the local file system. Any designs in the Library prior to MatterControl 1.4 are put here after the upgrade. | |
− | + | === <span class="mw-headline" id="Cloud_Library">[[File:Cloud Library.png]]</span> === | |
− | Designs | + | The '''Cloud Library''' allows instant access to design files through MatterControl from anywhere with an Internet connection. Designs stored in the Cloud Library are tied to a [[MatterHackers.com account]]. Once signed in the user can browse and manage any design files previously added and add new files. |
− | + | Designs within the Cloud Library are synced automatically across any devices the user is currently logged into and can also be viewed from the [https://sync.mattercontrol.com/ MatterControl Sync] website. | |
− | + | For more information on the Cloud Library check out [[Cloud#File_Sharing|the MatterControl wiki page for CLOUD SYNC]] and [http://www.matterhackers.com/articles/in-depth-mattercontrol-cloud-library In Depth: MatterControl Cloud Library for Designs]. | |
− | + | === <span class="mw-headline" id="Purchased">[[File:Purchased.png]]</span> === | |
− | + | Automatically contains any designs purchased from the [http://www.matterhackers.com/store/digital-designs MatterHackers Design Store]. | |
− | + | === <span class="mw-headline" id="Shared with Me">[[File:Shared with Me.png]]</span> === | |
− | In the | + | 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 current location within each section, 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 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 folder on your hard drive the same way it does with the [[Library#Downloads|Downloads]] folder. To do this, create a file called {{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 | ||
+ | }} | ||
[[Category:Features]] | [[Category:Features]] | ||
− |
Latest revision as of 11:23, 14 December 2016
The Library is a place for organizing and storing models. It has five sections; three static and two dynamic.The Local Library, Cloud Library, and Downloads sections are always visible. The Purchased and Shared with Me sections are shown only when they contain models.
In most sections, models can be organized using a traditional folder structure.
Contents
Sections
Stores designs in the local file system. Any designs in the Library prior to MatterControl 1.4 are put here after the upgrade.
The Cloud Library allows instant access to design files through MatterControl from anywhere with an Internet connection. Designs stored in the Cloud Library are tied to a MatterHackers.com account. Once signed in the user can browse and manage any design files previously added and add new files.
Designs within the Cloud Library are synced automatically across any devices the user is currently logged into and can also be viewed from the MatterControl Sync website.
For more information on the Cloud Library check out the MatterControl wiki page for CLOUD SYNC and In Depth: MatterControl Cloud Library for Designs.
Automatically contains any designs purchased from the MatterHackers Design Store.
Contains any models shared from other users using the Share Library Item function in the Cloud Library section.
Gives direct access to the Downloads folder on the hard drive ~/Downloads
on Linux/Mac or C:\Users\{user}\Downloads
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.
Top Level
To open a section, hover over the section and click the Open button at the right side.
In a section
Once in a section, a breadcrumb trail shows the current location within each section, subsequent folders, or search results.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.
Also, some new buttons become visible: Home, Search, and Edit, and two become active: Add and Create Folder.
Add
Opens the operating system's file selection window so the user can choose a .STL, .AMF, .GCODE, or .ZIP file to add to the currently displayed section.
Not available in the Purchased or Shared with Me sections.
Create Folder
Creates a folder in the currently displayed section.
Not available in the Purchased or Shared with Me sections.
Home
Returns to the top level of the Library, as shown in the screenshot at the top right of this page.
Search
Searches the currently displayed section for the text input in the 'Search Library' field.
Edit
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 or 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 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.
Opens the Share Library Item dialog box.
Available only in the Cloud Library section.
Active when only one file is selected.
Rename
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 folder on your hard drive the same way it does with the Downloads folder. To do this, create a file called LibraryFolders.conf
in the MatterControl application data directory. Add the full path to the folders you want to track on separate lines. Here is an example:
/home/matterhacker/testsupport/Printed Parts /home/matterhacker/Designs