Document Asset

    Description

    The Document Asset is used to display documents in a scroll or book format.

    IntuiFace supports:

    • Adobe Portable Document Format (.pdf)
    • Microsoft Office files (.doc, .xls, .ppt)
    • XPS Document format (.xps)

    In addition, virtually all other file types can be freely converted into the PDF format.

    NOTES:

    • To accelerate on-screen rendering, all documents are converted by Composer and Player into bitmaps (specifically, into the png format). In IntuiFace Composer, it occurs the first time the document is inserted into a Scene. In IntuiFace Player, it occurs the first time an experience runs. All subsequent uses of that document in a given Composer project, and all future runs of that experience in the Player, do not regenerate the bitmap.
    • You can specify the dpi (dots per inch) resolution for these bitmaps using the DPI property found in the Appearance property category for the Document Asset. The higher the DPI, the higher the resolution (good) and the more RAM required to store the bitmap in memory (not so good). IntuiFace defaults to 96 DPI.

    Supported document formats

    The .pdf format

    • Adobe's Portable Document Format, .pdf, is natively supported by IntuiFace.
    • As a natively supported format, you can import and display .pdf files without requiring local installation of Adobe Acrobat.
    • Because documents are rendered as bitmaps to accelerate on-screen rendering, all embedded hyperlinks will be lost.
    • enter a web URL in the Document property of the Document Asset to display a PDF file hosted in the cloud.

    Document-online.jpg

    Microsoft Office formats

    • Microsoft Office files - Word, PowerPoint, Excel - can be imported into IntuiFace Composer as Document assets if Microsoft Office 2007 or later is installed on the same computer.
    • The importation process converts these Office file formats into .pdf files using a virtual printer. All Microsoft Office-specific features of these formats are thus lost during the conversion.
    • If you wish to precisely control the look-and-feel of each post-conversion file, including page layout, use an external .pdf printer from the originating software and import the resulting .pdf file into Composer.

    The .xps format

    • The XPS document format, .xps, is natively supported by IntuiFace.
    • Since PDF format is natively supported, we encourage you to use PDF files.

    Adding documents to your experience

    To work with documents you can either

    • import a document from your hard drive by either drag & dropping it from Windows Explorer or using the Import Content button in the Content Library, you can also add a blank document from the asset panel and double click it to import a document.
    • reference, rather than import, a document by entering its file path or Web URL in the Document property of the Document Asset

    Imported documents are automatically copied by Composer into your IntuiFace project's file structure. As a result, there is no need to store a separate copy of each document on the computers hosting Player.

    Referenced documents must have paths/URLs that are universally consistent from one device to the next to ensure successful deployment across multiple PCs.

    What to do with unsupported document formats?

    Other document formats should be converted into the .pdf format to successfully import them into Composer.

    Properties Triggers & Actions

    Properties

    See our list of common properties for details about properties shared by all asset types.

    Document Properties

    • Style defines the style of the manipulation for the document

    Book-styles.jpg

    • Book   pages are turned by tapping or dragging the top or bottom outer corner of the document
    • Horizontal scroll   pages are scrolled horizontally
    • Vertical scroll   pages are scrolled vertically

    Book-styles-visual.jpg

    Appearance

    • DPI: render quality for the document

      • NOTE: new set of images are generated each time the DPI value is changed. Changing the DPI value will generate a number of images directly proportional with the number of changes multiplied by the number of pages in your document.
    • Show curtain shadows: show a feedback when more pages are browsable

    TransparentPixel.png

    Triggers

    See Triggers Overview to get details of common triggers shared by all assets

    Document specific triggers

    • Is moved to the first page: Raised when the first page has been reached.
    • Is moved to the last page: Raised when the last page has been reached.
    • Is moved to the next page: Raised when moved to the next page.
    • Is moved to the previous page: Raised when moved to the previous page.
    • Page is changed: Raised when the page has changed.
    • Reaches a page: Raised when the specified page number has been reached
      • Page number: Defines the "Reaches page" number parameter

    The screenshot below illustrates the set of triggers specific to the Document Asset (click to zoom)
    Triggers-Document.jpg

    Actions

    See Actions Overview to get details of common actions shared by all assets

    Document specific triggers

    • First page: Go to the first page of the document.
    • Go to page: Go to a specific page in the document
      • Page number: Defines the "go to page" action parameter.
    • Last page: Go to the last page.
    • Next page: Go to the next page.
    • Previous page: Go to the previous page.
    • Change document: Replace current content with the new content located at a specified URI.
      • NOTE: This action only works if the content is a PDF file.

    The screenshot below illustrates the set of actions specific to the Document Asset (click to zoom)
    Actions-Document.jpg