How To Use Media Connection: Step by Step

These steps describe the procedure for creating a multi-source application (typically multilingual) using Media Connection.



Read the Overview of Media Connection help topic.


Create your ToolBook application for one language or "source" as you normally would. Create any resources, clips, and other media you plan to use. Typically you will want to place any source files (bmp's, avi's etc.) that will change in a directory or directories specific to the current source.



When you've completed your content, copy the TB Connection Setup button from the TB Connection catalog onto the first page of your application book.



Right click on the setup button to access its extended properties and set the TBC Author Mode to true. This will display the tool palette and add a Connection menu to author level ToolBook.



Use the Setup Sources tool (available from either the Connection menu or the tool palette) to setup a source corresponding to the existing content. For example, if you've created your application in English, setup an "English" source.



Use the various Media Connection tools to write selected media to a database (e.g., Write Resources or Write Clips). Use the Edit tools (Edit Resources, Edit Clips, or Edit Other Media Types) to specify file locations and other properties for each media record. If you are using specific directories per source, you can edit search paths to point to the directories where the media source files will reside.



After writing media to the database and editing properties and search paths, again use the Setup Sources window to setup a source for each additional source (e.g., language) you will want. IMPORTANT: When you select a database for each additional source (in the Setup Sources window), typically you will want to Duplicate your existing database (the one that already has your existing media in it). This can simplify the editing process.



After defining additional sources, you can change the current source and edit each database and/or the search paths for that source.



If you intend to let your users swap sources at runtime, make sure you select either "From Database" or "From Properties" in the Runtime Read options. Then copy a Change Source button from the TB Connection catalog into your application to let your users change media.



Use the Prepare for Runtime option on the Connection menu to prepare your application for runtime.



If you plan to use Media Connection at runtime, include all necessary files with your installation. See Distributing Your Application for details.