Export (0) Print
Expand All

Storing Ink in HTML

Storing Ink in HTML

Description of storing ink in HTML.

It is usually desirable to copy a more complicated set of information than can be contained in ink serialized format (ISF). HTML is especially useful as an interoperability format because of its strong acceptance as an industry standard and its ability to represent heterogeneous content.

HTML is widely understood, well documented, and familiar to many developers. There are many tools for HTML production. In addition, Microsoft® Windows® contains application programming interfaces (APIs) for rendering and manipulation of HTML. Finally, the Tablet PC Platform APIs provide the fortified GIF persistence format, which is suitable for embedding in other formats, most importantly HTML. This format consists of a GIF file with Ink Serialized Format (ISF) embedded in an application extension block.

These GIF files are representations of ink objects that:

  • Render in applications that are not ink-enabled, such as browsers or legacy word processors.
  • Contain all the necessary information from the original ink that one would want to maintain for purposes such as editing or recognition.

These GIF files can be produced by using the persistence methods of the Tablet PC Platform APIs. They are GIFs and should use the GIF extension and, to an application that is not ink-enabled, there is nothing different about them from a normal GIF. To an ink-enabled application, however, there is a rich set of data underlying the image.

After it is produced by the Tablet PC Platform APIs, a fortified GIF is referenced by an IMG tag in HTML. The HTML is then stored in the standard CF_HTML Clipboard slot. This allows the HTML to be visible to other applications, whether or not they are ink-enabled. The image itself can be stored in the Windows internet cache and set to age out after an appropriate amount of time.

Specific adornments to the IMG tag are provided or required. These adornments identify the HTML as containing ink. The following example refers to a fortified GIF by using HTML tags:

<img href="34372423432.gif" />

If it is necessary to refer to the image by some other means, such as cascading style sheets or Vector Markup Language (VML), there should still be an IMG tag referencing the image. This allows cutting and pasting into and out of any application that accepts HTML representations of ink.

Applications that support ink in HTML should:

  • Generate CF_HTML when the user executes a copy. When generating CF_HTML on copy (or save as HTML), use the Ink.Save method, specifying the PersistenceFormat.Gif value in the p parameter, to generate a fortified GIF image. The alt text should be set to the most accurate recognition result. You can set positioning to either absolute or in-place, as desired.
  • Check all IMG tags to determine if any images they point to contain ink, if the CF_HTML slot is chosen for a paste. If so, treat the images as Ink objects internally. Although only GIF files are supported in this version, your application should check non-GIF images as well, in case additional image formats are supported in the future.
  • Support the copying and pasting of ISF. Applications that support HTML should also support ISF to enhance interoperability with ink-enabled applications that do not recognize HTML. This is similar to the convention that applications that place HTML on the Clipboard also place text.

For more information about fortified GIFs, see Building Blocks.

Show:
© 2014 Microsoft