Viewer

((('''Index'''
* [#intro|Introduction]
* [#features|Features]
* [#usage|Usage]
** [#usage_executable|How to create the executable]
** [#usage_layout|How to make a good layout]
* [#KnownIssues|Known issues]
* [#History|History]
* [#SeeAlso|See  also]
* [#References|References])))


{BR}[anchor|#intro]
==Introduction==

Viewer File Type plug-in allows to create standalone executable files (*.exe) from your worksheets. SMath Viewer is an alternative GUI for SMath Studio.

The idea of SMath Viewer is that SMath Studio (as well as Mathcad) is a great application but sometimes it is too complex for regular engineer. Indeed, SMath Studio was initially created for composing worksheets of any complexity with many of built-in features introduced to simplify this process. As a result sometimes the end-users have to see too much excess information on the worksheets when it is just needed to read results of calculations in convenient way.

SMath Viewer plug-in creates applications to show only data users are needed to be seen. At the same time it works directly with SMath Studio worksheets, so no any significant actions required to reuse existing libraries of files. SMath Viewer is a distribution platform for worksheets created using SMath Studio.

'''So SMath Studio is an editor for worksheets and SMath Viewer is a reader'''.


{BR}[anchor|#features]
==Features==

* It automatically supports all plug-ins created for SMath Studio (all DLLs from plugins directory of SMath Studio);
* It has built-in multilanguage support - just set all text entries, descriptions and file properties in several languages and SMath Viewer will be opened in correct language for different users;
* It supports units;
* Allows you to protect your worksheets (end-user cannot see the logic of your worksheet);
* End-user just cannot accidentally change or break you worksheet - output results will be always correct;
* There is no need to install applications - just copy and run them anywhere;
* Output application is faster even then SMath Studio! This is because when you work with a tab on the form on any data change only controls located on this tab will be recalculated. Other controls from other tabs will not affect on the overall evaluation speed;
* Application supports multi-threading, so it always response;
* Size of the output application is about 0.5MB (it may vary based on plug-ins and languages used).

Two versions of the Viewer are available:

{| cellspacing="1" cellpadding="5" border="0" style="text-align: center; border: 1px solid green; margin-left:auto; margin-right:auto;"
<!--

BUILT-IN PLUGINS

-->
|-
| colspan="3" style="background-color: #ecffec; color: green; font-weight: bold;" | Viewer File Type Plugin
|- style="background-color: green; color: white; font-weight: bold; text-align: center;"
| style="width: 200px;" | License
| style="width: 150px;" | Built-in version
| style="width: 150px;" | Paid version
<!--

USE THE FOLLOWING SCHEME FOR ANY NEW ROW (copy, paste and modify)

|-
| '''Feature'''
| style="color: red;" | ✘
| style="color: green;" | ✔

-->
|- style="height: 50px;"
| '''Personal usage'''
| style="color: green;" | ✔
| style="color: green;" | ✔
|- style="height: 50px;"
| '''Learning/Academic usage'''
| style="color: green;" | ✔
| style="color: green;" | ✔
|- style="height: 50px;"
| '''Commercial or sale usage'''
| style="color: red;" | ✘
| style="color: green;" | ✔
|- style="background-color: green; color: white; font-weight: bold; text-align: center;"
| style="width: 200px;" | Feature
| style="width: 150px;" | Built-in version
| style="width: 150px;" | Paid version
|- style="height: 50px;"
| '''Signs by code certificate'''
| style="color: red;" | ✘
| style="color: green;" | ✔
|- style="height: 50px;"
| '''Worksheets obfuscation'''
| style="color: red;" | ✘
| style="color: green;" | ✔
|- style="height: 50px;"
| '''Custom icons'''
| style="color: red;" | ✘
| style="color: green;" | ✔
|}


{BR}[anchor|#usage]
==Usage==
{BR}[anchor|#usage_executable]
====How to create the executable====

Open SMath Studio 0.96; create some variables, formulas and text in the worksheet and then open the Save File dialog (File > Save as).

{{{{[image|worksheet|{UP}Viewer/wiki_usage_01.png] [image|save worksheet|{UP}Viewer/wiki_usage_02.png]}}}}

Choose '''Executable files (*.exe)''' from the drop-down list under the '''File name''' input field and press the Save button.

{{{{[image|save as dialog|{UP}Viewer/wiki_usage_03.png]}}}}

In the chosen directory you'll see an output application which is ready to be started.

{{{{[image|output file|{UP}Viewer/wiki_usage_04.png]}}}}

Double click on it and you will see SMath Viewer form where all the created regions shown as standard OS (Operating System) controls.

{{{{[image|the executable|{UP}Viewer/wiki_usage_05.png]}}}}

{BR}[anchor|#usage_layout]
====How to make a good layout====

Some regions (such as Math Region or Plot) in SMath Studio has a [Descriptions|Description] feature; use it to set description for the items.

{{{{[image|variable's descriptions|{UP}Viewer/wiki_usage_06.png] [image|input fields tags|{UP}Viewer/wiki_usage_07.png]}}}}

Use expanded Area region to group items on the output form (nested Areas supported) or collapsed Area regions to hide regions you don't want to be a part of user interface.

{{{{[image|expanded area region|{UP}Viewer/wiki_usage_08.png] [image|grouped items|{UP}Viewer/wiki_usage_09.png]}}}}

Use Separator region to separate your worksheet on several tabs (to set title for the first tab just put Separator before all other regions).

{{{{[image|separator regions|{UP}Viewer/wiki_usage_10.png] [image|tabs|{UP}Viewer/wiki_usage_11.png]}}}}

Fill in fields in Properties dialog (File > Properties) to set output window title, program's description, author etc. This is very important to make a solid final product.

{{{{[image|worksheet properties|{UP}Viewer/wiki_usage_12.png] [image|executable title|{UP}Viewer/wiki_usage_13.png]}}}}

Use [Units|units] in your worksheet (nice units selectors will be automatically shown in output application).

{{{{[image|variables with units|{UP}Viewer/wiki_usage_14.png] [image|units handling of the executable|{UP}Viewer/wiki_usage_15.png]}}}}

Use multiple languages in your worksheet.

{{{{[image|localizations|{UP}Viewer/wiki_usage_16.png]}}}}


{BR}[anchor|#KnownIssues]
==Known issues==
{| cellspacing="0" cellpadding="8" border="0" style="text-align: center; width: 100%; background-color: #ecffec;"
|-
| style="color: green; font-weight: bold; font-style: italic; font-size: 11px;" | to  inform the developers about issues you found out use the Issues Tracker: [http://smath.info/bts/Projects/ProjectSummary.aspx?pid=3|SMath Viewer (SV)]
|}

All opened issues about SMath Viewer can be found in the [http://smath.info/bts/Issues/IssueList.aspx?pid=3&m=2|dedicated section of the Issues Tracker]


{BR}[anchor|#History]
==History==

* SMath [http://en.smath.info/forum/default.aspx?g=posts&m=9253|0.96.4868]: ViewerFileType built-in plugin added.


{BR}[anchor|#SeeAlso]
==See also==

* [Plugins|Plugins]
* [Descriptions|Descriptions]
* [Units|Units]


{BR}[anchor|#References]
==References==

* SMath Viewer features [http://en.smath.info/forum/default.aspx?g=posts&m=9315|SMath Studio Forum  »  Conversations  »  Features announcements  »  SMath Viewer]