<HTML>
	<HEAD>
    	<TITLE>Adobe ExtendScript Toolkit</TITLE>
		<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css">
		<LINK HREF="adobe.css" REL="stylesheet" TYPE="text/css">
        <LINK HREF="tabs.css" REL="stylesheet" TYPE="text/css">
 	</HEAD>
<BODY> 
    <div class="header"><a href="http://www.adobe.com"><img src="adobelogo.jpg" alt="http://www.adobe.com"></a>&nbsp;<b>ExtendScript ToolKit</b></div>
<!-- Generated by Doxygen 1.5.5 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul>
      <li class="current"><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="annotated.html"><span>Classes</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="dirs.html"><span>Directories</span></a></li>
    <li>
      <form action="search.php" method="get">
        <table cellspacing="0" cellpadding="0" border="0">
          <tr>
            <td><label>&nbsp;<u>S</u>earch&nbsp;for&nbsp;</label></td>
            <td><input type="text" name="query" value="" size="20" accesskey="s"/></td>
          </tr>
        </table>
      </form>
    </li>
    </ul>
  </div>
</div>
<!-- Generated by Doxygen 1.5.1-p1 -->
<h1><a class="anchor" name="basicexernalobject_p">Using the BasicExternalObject Sample</a></h1><h2><a class="anchor" name="intro_sec">
Introduction</a></h2>
This page documents how to build and run the BasicExternalObject sample, which demonstrates using the "direct" interface to an External Object. Note that the instructions apply with appropriate changes for compiling and running the sample named SampleLib, which shows how to use the "object" interface to an External Object. The direct interface is appropriate when you have a library that exposes functions, rather than classes.<h2><a class="anchor" name="build_sec">
Building the BasicExternalObject project</a></h2>
<h3><a class="anchor" name="step7">
Building on Windows</a></h3>
<h5>Opening the BasicExternalObject Project on Windows</h5>
<p>
We assume that you have Visual Studio 2005 installed on your workstation.

<ol type=1>
<li>Navigate to SDKINSTALL/samples/cpp/build/basicexternalproject/win</li>
<li>Double click BasicExternalObject.vcproj and/or open the project in Visual Studio 2005. Use the keyboard shortcut Ctrl-Alt-L or View &gt; Solution Explorer if you cannot see the project files.</li><li>Expand the BasicExternalObject project <ul>
<li>The project contents should resemble the following: <div class="fragment"><pre class="fragment">
BasicExternalObject/
	Header Files
		BasicExternalObject.h
		SoSharedLibDefs.h
		...
	Source Files
		BasicExternalObject.cpp
</pre></div></li>
</ul>
</li><li>Inspect any of the source files by double clicking them in the Solution Explorer
</li></ol>
<h5>Building</h5>
<p>
The project has two different build configurations, Release and Debug. To change to build configuration:

<ol type=1>
<li>Select Build &gt; Configuration Manager</li><li>In the "Active solution configuration" drop dow, set the configuration to build</li><li>Press Close</li></ol>
<p>
The default path for the project output is dependant on which build configuration was used and will either of the following:

<ul>
<li>SDKINSTALL/samples/cpp/build/basicexternalobject/win/Release/ </li>
<li>SDKINSTALL/samples/cpp/build/basicexternalobject/win/Debug/</li>
</ul>
To create the library then build the project by:<ol type=1>
<li>Selecting Build &gt; Build Solution or press 'F7'</li></ol>
<p>
If, for example, the Release configuration was used, then the compiled DLL can be found at SDKINSTALL/samples/cpp/build/basicexternalobject/win/Release/BasicExternalObject.dll
<h3><a class="anchor" name="step8">
Building BasicExternalObject on Mac OS</a></h3>
<h5>Opening the BasicExternalObject Project on Mac</h5>
<ol type=1>
<li>Navigate to Navigate to SDKINSTALL/samples/cpp/build/basicexternalobject/mac/</li>
<li>Double click BasicExternalObject.xcodeproj</li><li>Expand the BasicExternalObject project <ul>
<li>The project contents should resemble the following: <div class="fragment"><pre class="fragment">
BasicExternalObject/
	Source
		BasicExternalObject.cpp
		BasicExternalObject.h
		SoSharedLibDefs.h
		BasicExternalObject_Prefix.pch
	Resources
		Info.plist
		InfoPlist.strings		
	External Frameworks and Libraries
		Carbon.framework
	Products
		BasicExternalObject.framework
</pre></div></li>
</ul>
</li><li>Inspect any of the source files by double clicking them in the Groups &amp; Files pane
</li></ol>
<h5>Building</h5>
<p>
The project has two different build configurations, Release and Debug. To change to build configuration:

<ol type=1>
<li>Select Project &gt; Set Active Configuration</li><li>Choose the configuration you require</li></ol>
<p>
The default path for the project output is dependant on which build configuration was used and will either be:

<ul>
<li>SDKINSTALL/samples/cpp/build/basicexternalobject/mac/Release/ </li>
<li>SDKINSTALL/samples/cpp/build/basicexternalobject/mac/Debug/</li>
</ul>
To create the famework then build the project by:
<ol type=1>
<li>Selecting Build &gt; Build or press cmd B</li></ol>
<p>
If, for example, the Release configuration was used then the compiled DLL can be found at SDKINSTALL/samples/cpp/build/basicexternalobject/mac/Release/BasicExternalObject.framework
<p>
The compiled framework can be found SDKINSTALL/samples/cpp/build/basicexternalobject/mac/Release/BasicExternalObject.framework
<h2><a class="anchor" name="install_sec">
Running the Library</a></h2>
Within the SDKINSTALL/samples/cpp/scripts/ folder there is the loadExternalObject.jsx script. This script can be loaded into the ESTK and run from its current location.
<h5>Loading and Running</h5>
<p>
To load and run the sample:

<ol type=1>
<li>Open loadExternalObject.jsx in the ESTK</li><li>Run the script by selecting Debug &gt; Run or by pressing F5</li>
<li>A dialog window will appear to display output of the object calls</li></ol>
<p><img src="1ptrans.gif" />
<p><img src="1ptrans.gif"  />
<p><img src="asn.gif" width="114" height="45" border="0" alt="Adobe Solutions Network">Copyright&#169; 2008 Adobe Systems Incorporated. All rights reserved.</p>
<p>
    	<a href="http://www.adobe.com/misc/copyright.html">Terms of Use</a>&nbsp;
        <a href="http://www.adobe.com/misc/privacy.html">Online Privacy Policy</a>&nbsp;
        <a href="http://access.adobe.com">Adobe and accessibility</a>&nbsp;
        <a href="http://www.adobe.com/aboutadobe/antipiracy/main.html">Avoid software piracy</a>&nbsp;
        <a href="http://www.adobe.com/misc/agreement.html">Permissions and Trademarks</a>
</p>
</body>
</html>