====== Table - User Manual ======

===== Introduction =====

//Table// is a plugin for Rhino 3D, designed to add the possibility to create, import, or edit spreadsheets in your Rhino document.

===== Plugin installation =====
==== Overview ====
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.\\ 
//Table// works with 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#[License activation]&noindent&nofooter&nodate}}

{{page>start:plugins:common#[Toolbar]&noindent&nofooter&nodate}}

===== Features and commands =====

==== Table_About ====
This command can be used only from the command line prompt. It displays the plugin's current revision and license status.
{{ :start:plugins:table:table_about.jpg?nolink&400 |}}

==== Table_License ====
This command can be used only from the command line prompt. It displays the plugin's activation form.

See [[table-usermanual#license_activation]].

==== TableCreate ====
=== Walkthrough ===
The command **//TableCreate//** allows creating a new table directly from Rhino. At first, it will show a basic spreadsheet editor:
{{ :start:plugins:table:table_spreadsheeteditor.jpg?nolink |}}

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

===  Options === 
{{:start:plugins:table:table_commandlineoptions.jpg?nolink }} \\ 
^ Name            ^ Description                                                                               ^^
| 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 ====
The command **//TableEdit//**((Only available with Rhino 6-7)) allows us to edit a table created or imported with our plugin. 
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.
==== TableImport ====
=== Walkthrough ===
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 offers to select a compatible file:
{{ :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:
{{ :start:plugins:table:table_sheetselector.jpg?nolink |}}
=== Scripted mode ===
This command can be scripted using RhinoScript or your own macros:
{{ :start:plugins:table:table_import_scriptedmode.jpg?nolink |}}
===  Options === 
{{:start:plugins:table:table_commandlineoptions.jpg?nolink }} \\ 
^ Name            ^ Description                                                                               ^^
| 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 ====
This command will reload every tables from their original document (.xls, .xlsx, .csv).\\ 
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.