Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
start:plugins:table:table-usermanual [2020/12/21 16:00]
adminmar Fixed references missing to Rhino7, New license forms,& Yak UI
start:plugins:table:table-usermanual [2021/11/04 14:19]
adminmar
Line 3: Line 3:
 ===== Introduction ===== ===== Introduction =====
  
-//Table// is a plugin for Rhino 3D, designed to add the possibility to create, import or edit spreadsheets in your Rhino document.+//Table// is a plugin for Rhino 3D, designed to add the possibility to create, importor edit spreadsheets in your Rhino document.
  
 ===== Plugin installation ===== ===== Plugin installation =====
Line 9: Line 9:
 The plugin installer can be downloaded at: [[https://www.tomkod.com/product/tables/]]\\  The plugin installer can be downloaded at: [[https://www.tomkod.com/product/tables/]]\\ 
 A free trial is included, and yearly licenses can be purchased on the aforementioned page.\\  A free trial is included, and yearly licenses can be purchased on the aforementioned page.\\ 
-//Table// works either for Rhino 5((Rhino5.12 or later)), Rhino 6((Rhino6.15 or later)) and Rhino7((Tested up to Rhino 7.1)), but some features are not included in the Rhino 5 version.+//Table// works either for Rhino 5((Rhino 5.12 or higher)), Rhino 6((Rhino 6.15 or higher))and Rhino7((Rhino 7.5 or higher)), but some features are not included in the Rhino 5 version.
  
 {{page>start:plugins:common#[Yak]&noindent&nofooter&nodate}} {{page>start:plugins:common#[Yak]&noindent&nofooter&nodate}}
Line 30: Line 30:
 ==== TableCreate ==== ==== TableCreate ====
 === Walkthrough === === Walkthrough ===
-The command **//TableCreate//** allows to create a new table directly from Rhino. At first it will show a basic spreadsheet editor:+The command **//TableCreate//** allows creating a new table directly from Rhino. At firstit will show a basic spreadsheet editor:
 {{ :start:plugins:table:table_spreadsheeteditor.jpg?nolink |}} {{ :start:plugins:table:table_spreadsheeteditor.jpg?nolink |}}
  
-Afterward, the user will be able to pick the Table's insertion point, with a realtime preview. ((In rhino5, the preview might not display the texts with the selected font))+Afterward, the user will be able to pick the Table's insertion point, with a real-time preview. ((In rhino5, the preview might not display the texts with the selected font))
 {{ :start:plugins:table:table_example.jpg?nolink&200 |}} {{ :start:plugins:table:table_example.jpg?nolink&200 |}}
  
-=== Options === +===  Options ===  
-{{:start:plugins:table:table_commandlineoptions.jpg?nolink&200 }} \\  +{{:start:plugins:table:table_commandlineoptions.jpg?nolink }} \\  
-  * //FontHeight://  Takes a number for the text height. +^ Name            ^ Description                                                                               ^^ 
-  //Font:// Pops up a dialog to let the user select the required font family. {{ :start:plugins:table:table_fontselector.jpg?nolink&200 |}} +FontHeight   | Sets the text height                                                                 || 
 +| Corner          | Sets which angle should be used as snap point.\\ The possible values are: //UpperLeft//, //UpperRight//,  //LowerLeft//,  //LowerRight//|| 
 +| TitleRow       | None  | No title row will be added                                          | 
 +| :::                   | Above | A title row will be added above the table content | 
 +| :::                   | Below | A title row will be added below the table content | 
 +| Font              | {{:start:plugins:table:table_fontselector.jpg?nolink&170 |}}  Pops up a dialog to let the user select the required font family.||
 ==== TableEdit ==== ==== TableEdit ====
-The command **//TableEdit//**((Only available with Rhino 6)) allows to edit a table created or imported with our plugin.  +The command **//TableEdit//**((Only available with Rhino 6-7)) allows us to edit a table created or imported with our plugin.  
-It works exactly the same as the command [[start:plugins:table:table-usermanual#TableCreate|TableCreate]], except that the user will be asked to select an existing table to edit.+It works the same as the command [[start:plugins:table:table-usermanual#TableCreate|TableCreate]], except that the user will be asked to select an existing table to edit.
  
 The same spreadsheet editor and options are available. The same spreadsheet editor and options are available.
Line 49: Line 53:
 === Walkthrough === === Walkthrough ===
 The command **//TableImport//** allows to import a spreadsheet from an Excel file (.xls, .xlsx) or from a csv file (.csv). The command **//TableImport//** allows to import a spreadsheet from an Excel file (.xls, .xlsx) or from a csv file (.csv).
-After launching the command, a dialog offer to select a compatible file:+After launching the command, a dialog offers to select a compatible file:
 {{ :start:plugins:table:table_import.jpg?nolink&400 |}} {{ :start:plugins:table:table_import.jpg?nolink&400 |}}
 If the excel file has several worksheets, the user will be asked to pick one among the list: If the excel file has several worksheets, the user will be asked to pick one among the list:
Line 57: Line 61:
 {{ :start:plugins:table:table_import_scriptedmode.jpg?nolink |}} {{ :start:plugins:table:table_import_scriptedmode.jpg?nolink |}}
 ===  Options ===  ===  Options === 
-{{:start:plugins:table:table_commandlineoptions.jpg?nolink&200 }} \\  +{{:start:plugins:table:table_commandlineoptions.jpg?nolink }} \\  
-  * //FontHeight://  Takes a number for the text height. +^ Name            ^ Description                                                                               ^^ 
-  //Font:// Pops up a dialog to let the user select the required font family. {{ :start:plugins:table:table_fontselector.jpg?nolink&200 |}} +FontHeight   | Sets the text height                                                                 || 
 +| Corner          | Sets which angle should be used as snap point.\\ The possible values are: //UpperLeft//, //UpperRight//,  //LowerLeft//,  //LowerRight//|| 
 +| TitleRow       | None  | No title row will be added                                          | 
 +| :::                   | Above | A title row will be added above the table content | 
 +| :::                   | Below | A title row will be added below the table content | 
 +| Font              | {{:start:plugins:table:table_fontselector.jpg?nolink&170 |}}  Pops up a dialog to let the user select the required font family.|| 
 +| SpreadSheetIndex\\ (Scripted mode only)  | For excel import, sets the worksheet((Excel tab)) index.\\ (Default is 0, meaning first tab)  ||
 ==== TablesReload ==== ==== TablesReload ====
-This command will reload every tables in the document from their original document (.xls, .xlsx, .csv).\\  +This command will reload every tables from their original document (.xls, .xlsx, .csv).\\  
-The tables whose original file has been deleted or moved will be ignored, as well as tables created inside Rhino.+The tables whose original file can't be found((From //Table// 3.3.3, both the absolute path and the relative path are stored in the Tables' user texts. When reloading, the command will first try to use the absolute path, and if it fails it will fall back to using the relative path.)) will be ignored, as well as tables created inside Rhino (No external references). 
 +==== TableDuplicate ==== 
 +The command **//TableDuplicate//**((Only available with Rhino 6-7)) allows us to duplicate a table created or imported with our plugin.  
 +Using this command instead of Rhino's to duplicate a Table avoids the issue of sharing the same DimensionStyle between a table and its copy.