The Additional Resources dialog

The Additional Resources dialog allows you to add additional resources to your publication that will be referred to in an OpusScript program. Each new resource can be given an Alias, which acts as a shorthand method of referring to the full pathname for the resource. Resources can be any type of file, such as a video clip, an audio sound or a sound.

You can also ship additional material with your publication via the Additional Files option when publishing.

Note:
The Additional Resources tab appears in both the Page Properties and Publications Properties dialogs. The resources added in the Publication Properties dialog can be used in an OpusScript program on any page in your publication, while resources added to a page can only be used in OpusScript programs on that page.

To add a resource available throughout the publication:

Click on the Publication Properties option in the Publication menu to open the Publication Properties dialog.
Click on the Additional Resources tab in the Publication Properties dialog.
Click on the Add button to open the Additional Resources dialog – see below for more information.

To add a resource to a Page:

Select the page name in the Objects tab of the Page Organiser.
Right-click on the page name to open the page’s right-click menu and select the Properties option – this will open the Page Properties dialog.
Click on the Additional Resources tab in the Page Properties dialog.
Click on the Add button to open the Additional Resources dialog – see below for more information.

Setting up the Additional Resources dialog:

Use the Add Single File option to add a single resource. Click on the $image\Button_Browse_Ellipsis.jpg$ button to open the Windows Open dialog box to locate the resource you want to add.
Use the Add Directory option if you want to add more than one resource. This will highlight the other options in the Add Directory panel (see points 3 to 5 below). Click on the $image\Button_Browse_Ellipsis.jpg$ button to open the Windows Open dialog box to locate the directory you want to add.
Use the All Files option in the Add Directory panel if you want to add all the files contained in the selected directory. By default, this option is selected.

Note:
If you know which resources you want to add, it can be quicker to move/copy these resources to a new folder on your computer and use this option to add them all in one go.

Use the Wildcard option in the Add Directory panel if you only want to include resources that match your entry in the Wildcard box. By default, this box has the selection criteria *.* which means all files.

Note:
For example, to include only JPG files from the directory, you would type *.JPG into the box; to enter all files beginning with voice (whether they are JPG, WAV, AVI or any other file type) you would enter voice*.*

Use the Recurse Subfolders options if you want to add all resources that appear in sub-folders of the folder you entered in the Add Directory box (point 2 above). By default, this option is not ticked, which means that sub-folder resources are not added.

Note:
This option is available for both the All Files and Wildcard options described above.

Use the Default option in the Script Alias panel if you want to keep the full pathname of the resource. By default, this option is selected.

Note:
For example, if the resource’s pathname is c:\sounds\splash.wav – when referring to this in OpusScript, you will need to enter the full pathname e.g. PlaySound("c:\sounds\splash.wav")

Use the Alias option in the Script Alias panel if you want alias name that is prefixed to the added resources. Type the name of the alias in the box provided.

Note:
For example, if the resource’s pathname is c:\sounds\splash.wav you could use the alias name splash instead – when referring to this file in OpusScript, you need only enter the alias name e.g. PlaySound("splash")

Click on the OK button to save your changes – this dialog will close and the Additional Resources tab will be re-displayed showing the new resources in the Additional Resources list.

Note:
If you selected Add Directory and you want to enter an alias name, the alias is then prefixed to the filename of the resources. For example, if a directory contained six files named pic1.jpg to pic6.jpg and you entered the alias sequence, the result would be an alias name of sequence\pic1.jpg; sequence\pic2.jpg; and so on.