Hosting QB Damage Points in HTML

This page describes the steps to use the QB Damage Points Control in HTML pages (IE4+). This assumes you have properly installed QB Damage Points ActiveX Control (NOT the preview).

Because either Visual Studio (VS) or the MS Office Script Editor (MSE) are already installed on so many computers, the procedure will focus more on both tools. Access MSE using Alt+Shift+F11 from any Office 2000+ application. Otherwise you can get ActiveX Control Pad (CtlPad) from download.com.

Creating a new page

You can copy the following HTML code to host QB Damage Points in your page (0.97 and compatible)

<html>
<body>
<object id="QBDMap1" width="100%" height="100%"
classid="clsid:A220B8BD-F9C6-4CC0-8DCC-2BA591D9D615">


</object>
</body></html>

With web authoring tools locate QB Damage Points in the list of ActiveX controls installed on your machine. If QB Damage Points does not appear, you need to reinstall it.

In VS/MSE, use Tools>Customize Toolbox. You will need to drag the QB Damage Points from the toolbox to the HTML document.
In FrontPage 2000+, use Insert>Web Component>ActiveX Controls.
In CtlPad, use Edit>Insert ActiveX Control.

At this stage, you can run the page with IE, create a map, but you will not be able to configure anything. To do so, there are a couple of steps to follow.

Defining the initial settings

Initial settings determine which options will be available to the user.

If you are using a web authoring tool, open the property pages specific to QB Damage Points.
In VS/MSE, select the QB Damage Points control (appears as a big grey box), open the context menu and select Properties.
In CtlPad, place the insert point somewhere in the <object> tag and click the button in the margin.

In the property page:

Check Read-Only Map if you don't want users to change your maps
Check Changeable Configuration if you are using dynamic scripting, or if you often need to change configurations.
Specify a startup file to prevent users to open other maps (file on your hard drive - sorry, no http URL)
Click Apply to confirm your changes.

Defining the initial configuration

The initial configuration contains the definition of the attributes of units, weapons and hte map. To change the configuration, click Edit Configuration from the property page.

The Configuration window allows you to add, delete or modify object attributes, and select the available run modes for your configuration. You can also import settings from another configuration, and export everything once you are finished.

If VS/MSE prompts you to apply changes made to the property pages when you leave the Configuration editor, answer Yes. Save the HTML page to your disk.

How do I configure manually?

To define the initial configuration:

Use the QB Damage Points Map Editor which comes with the distribution
Edit the configuration as described above
Export your configuration and remember to which file you saved it.
Open the configuration file (.qbf) in a text editor. Remove all carriage returns to fit in one line.
Add the following tag between the <object> tags (notice the difference between ' and "):

<param name="Configuration"
 value='<QBDamageConfig><!-- insert text here....--></QBDamageConfig>'
>

To define the settings, add the following tags between the <object> tags:

<param name="StartupFile"
 value="c:\my documents\etc etc etc">

```
<param name="Flags"
 value="2" or "4">
```

If this looks too difficult for you, there are code samples in the distribution, ready for your use.