Difference between revisions of "LIBRARY"

From MatterControl Manual
Jump to: navigation, search
(Adding Incomplete Template)
(Adding custom folders from your hard drive)
 
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The library is a place for organizing and storing your designs. It includes 4 different sections; Local Library, Cloud Library, Purchased, and Downloads. Inside each section, design files can be organized using a traditional folder structure.
+
[[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.  
  
[[File:Library.png|right|frame|Top Level Library View]]
+
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.
  
== Local Library ==
+
In most sections, models can be organized using a traditional folder structure.
 +
__TOC__
 +
== Sections ==
  
This is a place for storing designs on your local system. Any designs you had in the Library prior to MatterControl 1.4 will be put here.
+
=== <span class="mw-headline" id="Local_Library">[[File:Local Library.png]]</span> ===
  
== Cloud Library ==
+
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''' 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.
+
=== <span class="mw-headline" id="Cloud_Library">[[File:Cloud Library.png]]</span> ===
  
Designs within the Cloud Library are synced automatically across any devices you are currently logged into and can also be viewed from the [https://sync.mattercontrol.com/ MatterControl Sync] website.  
+
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.
  
For more information on the Cloud Library check out [http://www.matterhackers.com/articles/in-depth-mattercontrol-cloud-library In Depth: MatterControl Cloud Library for Designs].
+
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.  
  
== Purchased ==
+
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].
  
Automatically contains any designs you have purchased from the [http://www.matterhackers.com/store/digital-designs MatterHackers Design Store].
+
=== <span class="mw-headline" id="Purchased">[[File:Purchased.png]]</span> ===
  
== Downloads ==
+
Automatically contains any designs purchased from the [http://www.matterhackers.com/store/digital-designs MatterHackers Design Store].
  
This gives you direct access to the Downloads folder on your hard drive '''~/Downloads''' on Linux/Mac or '''C:\Users\{user}\Downloads''' 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.
+
=== <span class="mw-headline" id="Shared with Me">[[File:Shared with Me.png]]</span> ===
  
In the future, we plan to add the ability to track any other directory in your file system as well.
+
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]]
[[Category:Incomplete]]
 

Latest revision as of 11:23, 14 December 2016

The Library pane, when a MatterHackers account is signed in, has purchased models, and models shared from another user.
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.

Sections

Local Library.png

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

Cloud Library.png

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.

Purchased.png

Automatically contains any designs purchased from the MatterHackers Design Store.

Shared with Me.png

Contains any models shared from other users using the Share Library Item function in the Cloud Library section.

Downloads.png

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.

Navigation

Top Level

To open a section, hover over the section and click the Open button at the right side.

Open Library.png

In a section

The Local Library section with Home, Search, Edit, Add and Create Folder buttons active.
Once in a section, a breadcrumb trail shows the current location within each section, subsequent folders, or search results.

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.

Library View Print.png

Also, some new buttons become visible: Home, Search, and Edit, and two become active: Add and Create Folder.

Add

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 or Shared with Me sections.

Create Folder

Create Folder Library.png

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

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 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.

Share

Opens the Share Library Item dialog box.

Available only in the Cloud Library section.

Active when only one file is selected.

Rename

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 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