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
start:plugins:table:table-usermanual [2020/12/21 14:49]
adminmar [Table_About]
start:plugins:table:table-usermanual [2021/11/04 14:26] (current)
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 =====
 +==== Overview ====
 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 for both Rhino 5((Rhino5.12 or later)) and Rhino 6((Rhino6.15 or later)), but some features only exist in the Rhino version.+//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 version.
  
-<WRAP center round tip 80%> +{{page>start:plugins:common#[Yak]&noindent&nofooter&nodate}}
-Our //Table// plugin is also compatible with __Yak__, Rhino's new package manager ((Rhino 6 or later only)). You can install it from the repository with the following command line: +
-{{ :start:plugins:table:table_install_yak.jpg?nolink |}} +
-</WRAP>+
  
 {{page>start:plugins:common#[License activation]&noindent&nofooter&nodate}} {{page>start:plugins:common#[License activation]&noindent&nofooter&nodate}}
Line 23: Line 21:
 ==== Table_About ==== ==== Table_About ====
 This command can be used only from the command line prompt. It displays the plugin's current revision and license status. 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 ==== ==== 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 45: 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 53: 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.