PlugIn plugin for Take Command / TCC / TCC/LE
beta version 0.10.22 2024-04-02
Charles Dye
Purpose:
This is a pointless demonstration plugin, which does a few things but
nothing that you care about. It adds two new commands,
PLUGINHELP and
REMARK; one new function,
@REVERSE; an internal
variable, _HELLO; and one hotkey,
Ctrl-Home.
(This is just the demo plugin from the SDK, plus an .HTML file, help system, version info structure, startup message, error-header routine, and a few other features I find handy. It’s a base I can modify to create new plugins.)
Installation:
To use this plugin, copy PlugIn.dll and
PlugIn.chm to some known location on your hard
drive. (If you are still using the 32-bit version of Take Command, take
PlugIn-x86.dll instead of
PlugIn.dll.) Load the .DLL file with a
PLUGIN /L command, for example:
plugin /l c:\bin\tcmd\test\plugin.dll
If you copy these files to a subdirectory named PlugIns within your Take Command program directory, the plugin will be loaded automatically when TCC starts.
Plugin Features:
| New Commands: | ||||
|---|---|---|---|---|
PLUGINHELP | REMARK | |||
| New Function: | ||||
@REVERSE | ||||
| New Variable: | ||||
_HELLO | ||||
| New Hotkey: | ||||
| Ctrl-Home | ||||
Syntax Note:
The syntax definitions in the following text use these conventions for clarity:
BOLD CODE | indicates text which must be typed exactly as shown. |
CODE | indicates optional text, which may be typed as shown or omitted. |
| Bold italic | names a required argument; a value must be supplied. |
| Regular italic | names an optional argument. |
| ellipsis… | after an argument means that more than one may be given. |
New Commands:
PLUGINHELP — Open the PlugIn
plugin help file.
Syntax:
PLUGINHELP /C /F /S /S:text /V topic
/C | select the “Contents” tab |
/F | select the “Favorites” tab |
/S | select the “Search” tab |
/S:text | select the “Search” tab and search for text |
/V | show detailed plugin version info |
| topic | the page to display |
The PLUGINHELP command will locate and open this
plugin’s help file. In most cases, the internal HELP
command, and the F1 and Ctrl-F1 keys, will
be more convenient. The main advantage of this command is that it can be used
to open the help file to any desired topic, not only to the names of commands,
functions, and variables.
Note that any /C /F or /S must
precede the topic on the command line. (This
command has a very simple-minded parser.)
REMARK — Display a trivial message.
Syntax:
REMARK text…
| text | any actual text arguments will be ignored |
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Mauris sapien nibh, volutpat vitae tristique ac, tristique non lectus. Proin nisl enim, cursus vitae elementum sit amet, accumsan sed ante. Quisque non erat quis magna molestie posuere quis vel elit. Nullam interdum malesuada turpis non rutrum. Ut sit amet blandit turpis. Aliquam in dui ut quam pharetra porttitor et nec leo. Aliquam facilisis gravida dignissim. Vestibulum blandit tempor erat non dignissim. Proin lacus erat, aliquam a blandit a, porta ultrices dui. Nunc ornare, leo in faucibus semper, purus felis pretium sem, a mollis magna libero ut purus. Aenean lacinia dapibus sagittis. Donec iaculis vehicula vestibulum. Aliquam condimentum semper purus eget ullamcorper. Nunc mollis, turpis eget facilisis euismod, velit nisi facilisis nisi, volutpat tincidunt orci nisi nec velit. Fusce est ipsum, tristique at fringilla a, fringilla et est.
remark Any sufficiently advanced cell-phone
technology is indistinguishable from schizophrenia.
New Function:
@REVERSE — Returns its
input text, reversed.
Syntax:
%@REVERSE[text]
| text | text to be reversed |
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce sed nibh in dui vehicula sodales. Ut pellentesque dignissim porttitor. Nam eu erat nibh, quis gravida sapien. Nullam sollicitudin dolor in diam elementum pellentesque. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nam eu ipsum vel sapien tincidunt ultricies. Suspendisse semper tristique aliquet. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Proin ipsum nulla, mattis ut tincidunt sed, porttitor at augue. Curabitur vitae dui urna, sed dapibus nunc. Donec egestas lacus non turpis tristique quis ullamcorper nisl eleifend. Fusce eu elementum tortor. Praesent sagittis convallis hendrerit. Nullam consectetur, lorem at euismod varius, quam mauris laoreet nunc, at molestie dolor nibh et tortor. Cras eget dui metus, ac porta eros. Curabitur vulputate accumsan urna id accumsan.
echo %@reverse[This is only a stupid little test.]
New Variable:
_HELLO — Returns a simple
text string.
Syntax:
%_HELLO
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque a neque at orci scelerisque ullamcorper mattis eget metus. Nunc sodales fermentum neque, in accumsan mauris tincidunt id. Donec blandit quam at ipsum porttitor vel venenatis arcu iaculis. Nam ante urna, fringilla eget pharetra eget, consectetur at sem. Phasellus at accumsan nulla. Donec blandit accumsan magna a molestie. Curabitur a ligula enim. Suspendisse in nisl ac augue consequat volutpat ac eu elit. Donec ante nibh, faucibus dapibus gravida nec, placerat eget mauris. Maecenas consectetur posuere rutrum. Donec augue lacus, scelerisque ut venenatis non, suscipit nec neque. Suspendisse ut lacus a nunc rutrum varius at laoreet nulla. Suspendisse et mollis sapien. Curabitur orci magna, rutrum eu tristique sit amet, elementum vitae neque. Donec posuere imperdiet nunc vitae elementum. Donec non sapien a nunc cursus facilisis.
echo %_hello
New Hotkey:
Ctrl-Home — Changes the current command line to “foo”.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla dapibus elementum magna ut aliquam. Fusce sed dui euismod est faucibus interdum. Mauris aliquet turpis eget dui vestibulum congue. Vestibulum mollis nulla ac justo auctor elementum in vel neque. Mauris sed feugiat augue. Nam tincidunt, diam et tincidunt varius, tellus elit porttitor odio, non ultricies leo felis eget massa. Donec convallis, nulla in dictum euismod, urna augue faucibus elit, ut interdum risus arcu eget nulla. Nunc semper feugiat sapien aliquet elementum. Morbi varius, purus in fermentum aliquam, nunc turpis tristique lacus, sit amet viverra nisl nibh a nisl. Morbi purus orci, gravida tincidunt tempus at, consequat non sapien. Quisque ac justo ac arcu molestie ultrices in non dolor. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Morbi sed felis erat. Duis tristique ultricies tellus. Praesent consectetur, justo eget lobortis dapibus, nisl dolor scelerisque justo, vitae congue turpis neque sed nisi. In viverra imperdiet commodo. Nunc nulla ipsum, eleifend vel molestie eu, aliquet at erat. Duis id turpis nisi, et commodo ligula.
Startup Message:
This plugin displays an informational line when it initializes. The
message will be suppressed in transient or pipe shells. You can disable it
for all shells by defining an environment variable named NOLOADMSG,
for example:
set /e /u noloadmsg=1
Status and Licensing:
Consider this beta software. It may well have issues. Try it at your own risk. If you find a problem, you can report it in the JP Software support forum.
PlugIn is currently licensed only for testing purposes. I may make binaries and source code available under some free license once I consider it ready for use.
Download:
You can download the current version of this plugin from http://charlesdye.net/dl/plugin.zip.