// =================== // Viewpoint Media Publisher Readme // =================== Readme_publisher.txt This file - describes how to use templates Viewpoint Media Publisher.exe The executable application [Defaults] The folder containing preferences [HTML Support] The folder containing any HTML templates used The text below describes how to use the Viewpoint Media Publishers templates, and how to make your own custom templates. It is a general description only and we recommend you read the Viewpoint Media Publisher User Guide to really understand how the Viewpoint Media Publisher can help you streamline the process of integrating your VET content with your HTML pages. // =================== // Template files // =================== HTML files generated from MTX/MTZ files are produced by replacing special template strings inside the HTML template files using the user input fields from the main dialog. The user input fields in the main dialog are constructed automatically by the Viewpoint Media Publisher. It does this by examining the "replaceable" template items in the specified HTML file. If you create a folder of the same name as the template with "_resources" appended, (as in "generic_resources" folder for "generic.html"), those will also get copied to the location of the new HTML file. The Viewpoint Media Publisher ships with standard templates. However, you can create your own templates to improve your workflow. The standard templates are: generic.html - This is the standard template. Any new templates you create should be based on the generic.html template. wireframe.html - This template includes javascript to change the render mode between default and wire (wireframe). The template also creates a button to trigger the render mode change. poser.html - This template includes "ComponentMinimumVersion="50332936" in both the embed/object tag. This forces the Viewpoint Media Player to update the Scene Component to the 3.0.5 version and is required if your content is created using Poser from Curious Labs. oldstyle.html - This template places the Object/Embed tag and the Viewpoint JavaScript functions directly into the HTML page. This approach to the Object/Embed tag has been deprecated. This template is provided for backward compatibility reasons and in general we do not recommend that you use this template. // =================== // Template Items // =================== To create a customized HTML template: Use your prefered HTML editing application to create your desired html page. This will become your template. Save your html page in the same location as the generic.html file and make a copy as a backup. The Viewpoint Media Publisher will then make this template selectable from the "HTML template menu" list. Create a folder that starts with name of your file and ends with _resources e.g. cooltemplate_resources. Copy the files from generic_resources into your resources folder. Open the generic.html page in notepad. Everything between the and tags is required for your VET content. Integrate this into your html page. In addition you can, if you like, include the statement. You can now add in "replaceable" template items if further customization is required. For example: Font=((VMP))Enter a Font((VMP)) The surrounding "((VMP))" indicates a replaceable template item. When you select a template, the Viewpoint Media Publisher will look for any "replaceable" template items and generate a field in the user interface that allows input of a value. That value will then replace the "replaceable" template item in the generated html file. Additionally, you can specify default values using "::" in the "replaceable" template item. For example: Font=((VMP))Enter a Font::Arial((VMP)) will create a user input field labeled "Enter a Font", whose default value will be Arial. NOTE: We recommend that you use CSS for controlling your html page's style. If you need to adjust the layout of your template use the backup copy of your html page. Make your adjustments in your HTML editor, then copy/paste the new code to your template. Additionally, there is a TYPE field that can be used with Temlate items. Currently, the only supported type is VERSION. It can be used used to convert from human version strings into the Borg-like versioning used by the Viewpoint Media Player GenieMinimumVersion="((VMP))VMP Min Version::3.0.8.00::VERSION((VMP))" NOTE: The following keywords are reserved: ((VMP))FILENAME((VMP)) replaced with the MTX/MTZ filename ((VMP))BUILD((VMP)) replaced with the Viewpoint Media Publisher build version ((VMP))FORMSDATA((VMP)) replaced with buttons from the MTX/MTZ file ((VMP))BROADCASTKEY((VMP)) replaced with the broadcast key URL ((VMP))PATH((VMP)) replaced with the resource files path ((VMP))DESCRIPTION((VMP)) replaced with an empty string - used to display template information