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/08/14 12:12]
adminmar [TableImport]
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 =====
-The plugin installer can be downloaded at: [[https://www.tomkod.com/product/tables/]] +==== Overview ==== 
-A free trial is included, and yearly licenses can be purchased on the aforementioned page. +The plugin installer can be downloaded at: [[https://www.tomkod.com/product/tables/]]\\  
-//Table// works for both Rhino 5 and Rhino 6, but some features only exist in the Rhino version.+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 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. 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}}
  
-==== License activation ==== +{{page>start:plugins:common#[Toolbar]&noindent&nofooter&nodate}}
-The free evaluation can be used once per computer, and requires a network access to the following adress51.254.220.203 \\  +
-The license activation requires network access to www.tomkod.com \\  +
-Please check your firewall in case of failure. +
- +
-==== Toolbar ==== +
-The toolbars for Rhino are always included in your plugins installation directory, or can be downloaded [[http://downloads.tomkod.com/Tools/TomkodToolbars.zip|here]]+
-To install them, you just have to drag/drop the file “Tomkod.rui” to a rhino window.+
  
 ===== Features and commands ===== ===== Features and commands =====
  
-==== TableAbout ====+==== 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.
-<WRAP center round todo 60%> +{{ :start:plugins:table:table_about.jpg?nolink&400 |}} 
-TODO + 
-</WRAP>+==== 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//** 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 54: 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 worksheetsthe user will be asked to pick one among the list: 
-If the excel file has several sheetsyou will be asked to pick one among the list: +{{ :start:plugins:table:table_sheetselector.jpg?nolink |}}
-<WRAP center round todo 60%> +
-Missing Image +
-</WRAP>+
 === Scripted mode === === Scripted mode ===
-<WRAP center round todo 60%> +This command can be scripted using RhinoScript or your own macros: 
-TODO +{{ :start:plugins:table:table_import_scriptedmode.jpg?nolink |}}
-</WRAP>+
 ===  Options ===  ===  Options === 
-<WRAP center round todo 60%> +{{:start:plugins:table:table_commandlineoptions.jpg?nolink }} \\  
-TODO +^ Name            ^ Description                                                                               ^^ 
-</WRAP> +| 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 ====
-<WRAP center round todo 60%> +This command will reload every tables from their original document (.xls, .xlsx, .csv).\\  
-TODO +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). 
-</WRAP> +==== 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.