<![CDATA[
<table cellspacing="0" cellpadding="0">
<tr height="150">
<td align="left"><img src="../../../../img/logo.gif" alt="IAC logo"></img></td>
<td width="100%" rowspan="2" align="left" valign="center">
<table cellspacing="0" cellpadding="0">
<tr>
<td>
<table class="navigate_doc" width="100%" border="0" align="center">
<tr bgcolor="c6c6e0" align="center">
<th nowrap width="1%" height="32">P0182</th>
<th nowrap width="98%">CopyXXXOnTrigger</th>
<th nowrap width="1%">14th December 2001</th>
</tr>
<tr>
<td align="left" colspan="3">
<p><b>Authors:</b> Brian Selle, Leon Thrane, Ian Curington, AVS Inc.; Paul G. Lever, MVC
<b>Version:</b> 1.0
<b>Path:</b> iac_proj/copxontg/</p>
<a href="../../misc.shtml" target="_top"><img src="../../../../img/misc.gif" width="42" height="30" border="0" alt="Miscellaneous"></a>
<a href="copxontg.shtml" target="_top">
<img src="../../../../img/doc_umac.gif" border="0"
width="30" height="30"
alt="User Macro Document - CopyXXXOnTrigger"></a>
<a href="source/misc/copxontg/copxontg.tar.gz">
<img src="../../../../img/targz.gif"
border="0" width="52" height="30"
alt="Archive - copxontg.tar.gz"></a>
<a href="source/misc/copxontg/copxontg.tar.Z">
<img src="../../../../img/tarz.gif"
border="0" width="52" height="30"
alt="Archive - copxontg.tar.Z"></a>
<a href="source/misc/copxontg/copxontg.zip">
<img src="../../../../img/zip.gif"
border="0" width="52" height="30"
alt="Archive - copxontg.zip"></a>
</td>
</tr>
</table>
<br>
</td>
</tr>
<tr>
<td>
<!-- BEGIN CONTENT PAGE -->
<h1>CopyXXXOnTrigger</h1>
<h3>Synopsis</h3>
<p>
These modules are an extension to the GMOD.copy_on_change module which is used
to copy different data types when a trigger is set.
</p>
<p>
<hr>
<pre>
module modCopyOnTrigger <compile_subs = 0,
need_objs = "GMOD.copy_on_change"> {
prim trigger<NEportLevels={2,0}>;
prim input<NEportLevels={2,0}>;
prim output<NEportLevels={0,2}>;
boolean on_inst = 1;
omethod+notify_inst+req Update(
.trigger+req+notify,
.input+req+read,
.output+write
) = "GMODcopy_on_change";
};
module modCopyArrayOnTrigger <compile_subs = 0,
need_objs = "GMOD.copy_on_change"> {
prim trigger<NEportLevels={2,0}>;
prim input<NEportLevels={2,0}> [];
prim output<NEportLevels={2,0}> [];
boolean on_inst = 1;
omethod+notify_inst+req Update(
.trigger+req+notify,
.input+read,
.output+write
) = "GMODcopy_on_change";
};
module modCopyGroupOnTrigger <compile_subs = 0,
need_objs = "GMOD.copy_on_change"> {
prim trigger<NEportLevels={2,0}>;
group &input<NEportLevels={2,0}>;
group &output<NEportLevels={2,0}>;
boolean on_inst = 1;
omethod+notify_inst+req Update(
.trigger+req+notify,
.input+req+read,
.output+req+write
) = "GMODcopy_on_change";
};
module modCopyGroupArrayOnTrigger <compile_subs = 0,
need_objs = "GMOD.copy_on_change"> {
prim trigger<NEportLevels={2,0}>;
group &input<NEportLevels={2,0}> [];
group &output<NEportLevels={2,0}> [];
boolean on_inst = 1;
omethod+notify_inst+req Update(
.trigger+req+notify,
.input+req+read,
.output+write
) = "GMODcopy_on_change";
};
module modCopyOnPtrTrigger <compile_subs = 0,
need_objs = "GMOD.copy_on_change"> {
group *trigger<NEportLevels={2,0}>;
prim input<NEportLevels={2,0}>;
prim output<NEportLevels={0,2}>;
boolean on_inst = 1;
omethod+notify_inst+req Update(
.trigger+req+notify,
.input+req+read,
.output+write
) = "GMODcopy_on_change";
};
</pre>
<hr>
</p>
<h3>Description</h3>
<p>
These modules copy the input to the output if the trigger is activated. They are
extensions of the GMOD.copy_on_change for different data types.
<p>
Use:
<ul>
<li><b>modCopyOnTrigger</b> for primitive types such as integer, float,
char, string
<li><b>modCopyArrayOnTrigger</b> for arrays of primitive types such as integer, float,
char, string
<li><b>modCopyGroupOnTrigger</b> for groups (group references) (this includes
Mesh, Mesh+NodeData)
<li><b>modCopyGroupArrayOnTrigger</b> for arrays of groups (group references) (this includes
Mesh, Mesh+NodeData)
<li><b>modCopyOnPtrTrigger</b> to trigger if a more complex object changes
</ul>
</p>
<h3>Inputs</h3>
<p>
<i><b>trigger</b></i>
</p>
<p>
executes the module to copy the input to the output.
</p>
<p>
<i><b>input</b></i>
</p>
<p>
contains the data to be copied when the trigger changes.
</p>
<h3>Outputs</h3>
<p>
<i><b>output</b></i>
</p>
<p>
contains a copy of the input if the trigger has been activated.
</p>
<h3>Files</h3>
<p>
<I>iac_proj/copontrg/cxtgmods.v</I> Creates the CopyXXXOnTriggerMods library containing the
low-level modules modCopyOnTrigger, modCopyArrayOnTrigger,
modCopyGroupOnTrigger, modCopyGroupArrayOnTrigger and
modCopyOnPtrTrigger.
</p>
<h3>Authors</h3>
<p>
<pre>
Brian Selle, Leon Thrane, Advanced Visual Systems Inc.
Documentation - Ian Curington, Advanced Visual Systems Inc.
</pre>
</p>
<h3>Modifications</h3>
<p>
<pre>
Paul G. Lever
</pre>
</p>
<h3>Contact</h3>
<p>
<pre>
International AVS Centre
Manchester Visualization Centre
Manchester Computing
University of Manchester
Oxford Road
Manchester
United Kingdom
M13 9PL
</pre>
</p>
<!-- END CONTENT PAGE -->
</td>
</tr>
</table>
</td>
</tr>
<tr height="100%">
<td class="sideLink" width="25%" align="left" valign="top" nowrap="nowrap">
<p><a href="../../../../general/index.shtml" target="_top">General Information</a></p>
<p><a href="../../../../repository/index.shtml" target="_top">Repositories</a></p>
<p class="sideLinkLevel2"><a href="../../../new/index.shtml" target="_top"> New Releases</a></p>
<p class="sideLinkLevel2"><a href="../../../download/index.shtml" target="_top"> Download</a></p>
<p class="sideLinkLevel2"><a href="../../../submit/index.shtml" target="_top"> Submit</a></p>
<p class="sideLinkLevel2"><a href="../../../pfiles/index.shtml" target="_top"> Project Files</a></p>
<p class="sideLinkLevel2"><a href="../../../avs5/index.shtml" target="_top"> AVS5</a></p>
<p class="sideLinkLevel2"><a href="../../../express/index.shtml" target="_top"> AVS/Express</a></p>
<p class="sideLinkLevel3"><a href="../../atoz.shtml" target="_top"> A to Z</a></p>
<p class="sideLinkLevel3"><a href="../../number.shtml" target="_top"> Project #</a></p>
<p></p>
<p class="sideLinkLevel3"><a href="../../data_io.shtml" target="_top"> Data IO</a></p>
<p class="sideLinkLevel3"><a href="../../filters.shtml" target="_top"> Filters</a></p>
<p class="sideLinkLevel3"><a href="../../mappers.shtml" target="_top"> Mappers</a></p>
<p class="sideLinkLevel3"><a href="../../misc.shtml" target="_top"> Miscellaneous</a></p>
<p class="sideLinkLevel3"><a href="../../special.shtml" target="_top"> Special Projects</a></p>
<p class="sideLinkLevel2"><a href="../../../pog/index.shtml" target="_top"> Project Guidelines</a></p>
<p><a href="../../../../usergroup/index.shtml" target="_top">User Group</a></p>
<p><a href="../../../../training/index.shtml" target="_top">Training Materials</a></p>
</td>
</tr>
</table>
<table width="100%" border="0" cellspacing="0" cellpadding="0" bgcolor="c6c6e0">
<tr>
<td><img src="../../../../img/foot1.gif" alt="IAC" width="155" height="25"></td>
<td width="100%"> Last Updated:
<!-- #BeginEditable "date-stamp" -->
26th November 2002
<!-- #EndEditable --></td>
</tr>
</table>
]]>