FROGANS A. Tamas FSDL 2.1 STG Interactive May 2004 Frogans Slide Description Language - 2.1 Status Destined to the developer community, this document specifies version 2.1 of the FSDL and replaces and renders obsolete any previous specifications concerning the FSDL. Distribution of this document is unlimited under the terms of the copyright statement. Comments on this document are welcome and may be made by e-mail at the address: fsdl@frogans.com. Abstract This document serves as a reference guide for the markup language called the Frogans Slide Description Language (FSDL) which is used for developing frogans. The frogans are a means for end-users to consult content on the Internet or on private IP networks. Frogans are independent from, but compatible with, other existing applications such as WWW, Newsgroup, E-mail, and IRC. Copyright Notice Copyright (C) STG Interactive (2000-2004). All Rights Reserved. Document URL: http://www.frogans.com/en/doc/FSDL21.txt See 21.1. Full Copyright Statement of the FSDL Specifications. Terms of Use for Developers and Software Publishers The free use of the FSDL as a markup language for developers of frogans and publishers of authoring tools and server applications is subject to their respective terms of use. See 21.2. Use of the FSDL by Developers of Frogans. See 21.3. Use of the FSDL by Publishers of Authoring Tools. See 21.4. Use of the FSDL by Publishers of Server Applications. STG Interactive Frogans Page [1] FSDL 2.1 Frogans Slide Description Language May 2004 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3. FSDL Documents . . . . . . . . . . . . . . . . . . . . . . . 6 3.1. Frogans Root Directory . . . . . . . . . . . . . . . . . . 6 3.2. Document Structure . . . . . . . . . . . . . . . . . . . . 7 3.3. Document Character Set and Encoding . . . . . . . . . . . . 8 3.4. Character and Entity References . . . . . . . . . . . . . . 8 3.5. File Sizes . . . . . . . . . . . . . . . . . . . . . . . . 9 3.6. Loading Times . . . . . . . . . . . . . . . . . . . . . . . 9 3.7. Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 4. Starting and Ending the Slide - FROGANS element . . . . . . . 11 5. Setting Image Resources - SETIMAGE element . . . . . . . . . 13 6. Setting Pixels Resources - SETPIXELS and PIX elements . . . . 18 7. Setting Draw Resources - SETDRAW element . . . . . . . . . . 21 8. Managing Text Resources . . . . . . . . . . . . . . . . . . . 24 8.1. Defining Fonts - FONT element . . . . . . . . . . . . . . . 24 8.2. Setting Text Resources - SETTEXT and TEXT elements . . . . 27 9. Setting Duplicated Resources - SETCOPY element . . . . . . . 33 10. Pre-processing of Resources - PROCESS and FILTER elements . . 34 11. Defining the Shape of the Slide - SHAPE element . . . . . . . 38 12. Defining the Content of the Slide - CONTENT element . . . . . 43 13. Enhancing the Content of the Slide . . . . . . . . . . . . . 48 13.1. Applying Masks - MASK element . . . . . . . . . . . . . . . 48 13.2. Sketching Reliefs - RELIEF element . . . . . . . . . . . . 52 13.3. Adding Shadows - SHADOW element . . . . . . . . . . . . . . 54 14. Linking and Navigation - BUTTON element . . . . . . . . . . . 56 15. Auto-Refresh and Slide Show - NEXT element . . . . . . . . . 62 16. Redirecting to Another Slide - REDIRECT element . . . . . . . 64 17. Creating and Maintaining Sessions - SESSION element . . . . . 66 18. Planning for Statistics - STATS element . . . . . . . . . . . 68 19. Going On-line . . . . . . . . . . . . . . . . . . . . . . . . 70 19.1. Requesting Identifiers from End-users . . . . . . . . . . . 70 19.2. Choosing a Network Protocol . . . . . . . . . . . . . . . . 72 19.3. Hosting a Frogans on a HTTP Server . . . . . . . . . . . . 73 20. Creating Short-cuts and Links to a Frogans . . . . . . . . . 79 20.1. Making a Frogans Short-cut File . . . . . . . . . . . . . . 79 20.2. Hosting Frogans Short-cuts on a HTTP Server . . . . . . . . 80 20.3. Editing a leaptofrogans.net Hyperlink . . . . . . . . . . . 81 21. Working with the FSDL . . . . . . . . . . . . . . . . . . . . 82 21.1. Full Copyright Statement of the FSDL Specifications . . . . 83 21.2. Use of the FSDL by Developers of Frogans . . . . . . . . . 84 21.3. Use of the FSDL by Publishers of Authoring Tools . . . . . 84 21.4. Use of the FSDL by Publishers of Server Applications . . . 84 STG Interactive Frogans Page [2] FSDL 2.1 Frogans Slide Description Language May 2004 1. Introduction The Frogans Slide Description Language (FSDL) is a complete markup language exclusively dedicated to the development of frogans which are published on scalable, virtual networks established on the Internet or on private IP networks, called frogans networks. Frogans is a hyperlink-based, distributed information system which was created by STG Interactive to provide the Internet community with a very simple means of publishing and consulting content, on multiple devices. Frogans are known for their unique and creative format which is easy to use, light and does not compete with open applications on the end-user's screen. Each frogans can contain an unlimited number of pages (slides) which are developed using the FSDL. As for all information systems, Frogans has its own dedicated system for addressing content. Each frogans is identified by a unique frogans address, whose structure creates an even greater affinity between the editor's content and the end-user. A frogans address starts with the name of the frogans network on which the frogans is published. For example, frogans addresses starting 'frogans*' are associated with the main frogans network, that is operated by STG Interactive. The FSDL eliminates barriers for developers in working with enhanced graphics and hyperlinks, by providing a clear and comprehensible structure for the code which is closely related to the slide's layout. FSDL documents can be quickly and easily hand-coded. They can also be produced dynamically on a server to automatically update or personalize the frogans for the end-user. As it supports all reading directions for written languages and is ISO 10646/Unicode compliant, the FSDL actively helps to promote the compatible exchange of information over the Internet. This document specifies version 2.1 of the FSDL. Future versions presenting additional features of this markup language will be released with higher version numbers, following input from the frogans developer community. STG Interactive Frogans Page [3] FSDL 2.1 Frogans Slide Description Language May 2004 2. Terms dedicated frogans network A public frogans network or a private frogans network that is not the main frogans network. end-user A person using the Frogans Player software to consult frogans. end-user's system A computer or device connected to the Internet, or to a private IP network, that can display frogans. frogans Sets of uniquely shaped slides which can be visualized by the end-user using the Frogans Player. A frogans is published by a frogans editor, on a frogans network, through a frogans address. frogans address An address which serves to reference a frogans. The format of a frogans address is 'network*gatename' or 'network*gatename.extension', where 'network' is the name of the frogans network on which the frogans is published. On the main frogans network, where addresses start with 'frogans*', the 'gatename' and 'extension' are chosen by the frogans editor. frogans editor A content editor who publishes a frogans on a frogans network. frogans favorites An end-user's selection of frogans addresses. Each frogans favorite has its session information saved on the end-user's system until the end-user reopens the frogans. frogans network A scalable virtual network established on the Internet or on a private IP network to publish frogans. Frogans Network System Language, FNSL A complete markup language dedicated to the operation of frogans networks. Frogans Player A free downloadable software, published by STG Interactive, that lets end-users browse and navigate frogans. frogans root directory A server directory which contains a frogans (FSDL documents and resources). Its location on the Internet or on a private IP network is transmitted through the frogans address. STG Interactive Frogans Page [4] FSDL 2.1 Frogans Slide Description Language May 2004 frogans short-cut A file containing a frogans address which is destined to facilitate the opening of a frogans by the end-user as well as the transmission of frogans addresses from end-user to end-user. frogans slide, slide A frogans slide is comparable to a page on the World Wide Web. A frogans slide is a set of files containing a FSDL document and its related resources. An unlimited number of slides can be grouped together to make up a frogans. Frogans Slide Publisher A free downloadable software, published by STG Interactive, that helps developers create frogans slides. FSDL document A file containing a sequence of characters which are organized according to the FSDL specifications. home slide A frogans slide which is displayed every time the end-user opens the frogans. login and password A login and password given by the frogans editor to the end-user to gain access to the frogans. Login and passwords can be used to personalize the content or services in the frogans and are an alternative to PIDs. main frogans network A public frogans network, operated by STG Interactive, where frogans addresses start with 'frogans*'. On the main frogans network, frogans can be published by any frogans editor, individual or organization, from anywhere in the world, in any language. PID, personal identifier A personal identifier given by the frogans editor to the end- user to gain access to the frogans. PIDs can be used to personalize the content or services in the frogans and are an alternative to login and passwords. private frogans network A frogans network established on a private IP network. public frogans network A frogans network established on the Internet. STG Interactive Frogans Page [5] FSDL 2.1 Frogans Slide Description Language May 2004 3. FSDL Documents 3.1. Frogans Root Directory All files of a frogans must be regrouped into a single directory called the frogans root directory. The frogans root directory contains FSDL documents and associated resources; it can be organized with sub-directories. For example: --Frogans root directory | |--SubDir1 | | | | Slide2.fsdl | | Pix2.gif | | Slide1.fsdl | Pix1a.png | Pix1b.jpg In a FSDL document, file names of resources and other associated FSDL documents must include the complete file path from the frogans root directory. The name of the frogans root directory is not included in the file path. File names always start with a slash (/). For example: the files in the preceding example are named '/Slide1.fsdl', '/Pix1a.png', '/Pix1b.jpg', '/SubDir1/Slide2.fsdl' and '/SubDir1/Pix2.gif'. File names, including their path, are case sensitive strings of alphanumeric characters: A-Z, a-z, 0-9, underscore, dash, dot and slash (/). File names cannot end with a slash or a dot. File names cannot contain the sequences '..', './', '/.' and '//'. Spaces and backslashes (\) are not accepted. File names must contain between 2 and 128 characters. The file name of a FSDL document should have the extension '.fsdl' or '.fsd', but is not mandatory. For example, if the FSDL document is delivered dynamically by the server hosting the frogans, file name extensions such as '.php', '.asp' or '.jsp' may also be used. For more information about hosting the frogans on a server, see 19. Going On-line. STG Interactive Frogans Page [6] FSDL 2.1 Frogans Slide Description Language May 2004 3.2. Document Structure The FSDL document conforms to XML 1.0 specifications to assure maximum interoperability with servers and end-user systems. The FSDL document must start with one of the following XML declarations: As the FSDL document encoding is transmitted through the frogans address, the encoding attribute in the XML declaration is not used by the Frogans Player. See 3.3. Document Character Set And Encoding. The XML declaration is then followed by one of these document type declarations: To maintain FSDL document clarity and readability, the document type declaration must not contain an internal subset. The root element of the FSDL document is FROGANS. See 4. FROGANS element. All element names and their attributes are always written in uppercase in the FSDL document. Attribute values are delimited by single or double quotation marks. All elements contained in the FSDL document must have an end tag. For example: Block Of Text Empty elements must either have an end tag or the start tag must end with />. For example: can also be written The FSDL document may contain comments using the common syntax . An error left in the FSDL document will lead to a parsing error message. STG Interactive Frogans Page [7] FSDL 2.1 Frogans Slide Description Language May 2004 3.3. Document Character Set and Encoding The encoding is not specified in the XML declaration as it is transmitted through the frogans address. When publishing a frogans on the main frogans network, the FSDL document encoding is specified in 'my account' on frogans.com (frogans address parameters). At the time of publication (May 2004), the character set of the FSDL document is ISO 10646/Unicode and the format used to encode the FSDL document must be either UTF-8 (RFC 2279) or UTF-16 (RFC 2781). For more information, see FNSL specifications version 3.0 (10. Making a Lookup Record). In the future, other character sets and formats used to encode the FSDL document may be recognized by the Frogans Player. An optional BOM (Byte Order Mark) can be placed at the start of the FSDL document. When using UTF-16 encoding, the BOM is used to determine if the FSDL document is serialized in big-endian or little-endian order; if there is no BOM at the start of the FSDL document, big-endian order is assumed. 3.4. Character and Entity References The FSDL document may contain numeric character references and entity references. Numeric character references can be used with the syntax: &#D; or &#xH; where D is the decimal value, and H the non-case sensitive, hexadecimal value of the character in ISO 10646/Unicode. Examples: N (letter N) N (letter N) N (letter N) Recognized entity references are: < less than sign (<) (<) > greater than sign (>) (>) " double quote sign (") (") & ampersand (&) (&) ' apostrophe (') (') © copyright sign (©) ® registered trademark (®) # number sign (#) (#) $ dollar sign ($) ($) STG Interactive Frogans Page [8] FSDL 2.1 Frogans Slide Description Language May 2004 € euro sign (€)   non-breaking space ( ) Entity references are case sensitive. An ampersand (&) or a less than sign (<) must always be replaced by their numeric character references or their entity references in the value of an attribute and in the text characters placed between the start and end tags of an element. 3.5. File Sizes The total file size, including the FSDL document and the resources used to display the slide, is categorized as follows: - Very light: up to 4,096 bytes - Light: 4,097 to 8,192 bytes - Normal: 8,193 to 16,384 bytes - Heavy: 16,385 to 32,768 bytes - Very Heavy: 32,769 to 65,536 bytes The total file size should not exceed 32,768 bytes in order to minimize the loading time of the slide on the end-user's system. The total file size must not exceed 65,536 bytes. The maximum file size of an image downloaded to a separate viewer is 1,048,576 bytes (1 MB). See 14. BUTTON element (GOTO attribute). The maximum file size of a file downloaded to the end-user's system is 8,388,608 bytes (8 MB). See 14. BUTTON element (GOTO attribute). 3.6. Loading Times The loading time of the FSDL document must not exceed 60 seconds, otherwise a time out will occur on the end-user's system. The loading time of the resources used to display the slide must not exceed 90 seconds, otherwise the slide will be displayed with missing resources. The loading time of an image downloaded to a separate viewer must not exceed 7,200 seconds, otherwise a time out will occur on the end- user's system. See 14. BUTTON element (GOTO attribute). The loading time of a file downloaded to the end-user's system must not exceed 7,200 seconds, otherwise a time out will occur on the end- user's system. See 14. BUTTON element (GOTO attribute). STG Interactive Frogans Page [9] FSDL 2.1 Frogans Slide Description Language May 2004 3.7. Cache FSDL documents are never cached on the end-user's system. In order to reuse an image file in different slides of the frogans without repeated loading of the same file by the Frogans Player, see 5. SETIMAGE element (CACHE attribute). Images downloaded to a separate viewer are not cached on the end- user's system. See 14. BUTTON element (GOTO attribute). Files downloaded are not cached on the end-user's system. See 14. BUTTON element (GOTO attribute). STG Interactive Frogans Page [10] FSDL 2.1 Frogans Slide Description Language May 2004 4. Starting and Ending the Slide - FROGANS element The FROGANS element defines the beginning and the end of the FSDL document. It is a root element as it contains all other elements necessary to define the frogans slide: - Resource management elements are SETIMAGE, SETPIXELS, SETDRAW, FONT, SETTEXT, SETCOPY and PROCESS, - Layout elements are SHAPE and CONTENT, - Linking and navigation elements are BUTTON, NEXT, REDIRECT, SESSION and STATS. The attributes associated with the FROGANS element are: VERSION - Required The version of the specifications to which the FSDL document conforms. Is not case sensitive. The value of this attribute must be identical to the FSDL version which is transmitted through the frogans address. When the frogans is published on the main frogans network, the FSDL version is specified in 'my account' on frogans.com (frogans address parameters). * "FSDL2.1" : FSDL specifications version 2.1 COLOR - Optional The background color of the slide. Is a non-case sensitive, six-digit hexadecimal number prefixed by a hash mark (each color component is represented by two digits, in the order of red, green, blue). The default value is "#FFFFFF" (white). Examples of accepted values: COLOR="#FFFFFF" (white) COLOR="#ffffff" (white) COLOR="#000000" (black) COLOR="#808080" (gray) COLOR="#FF0000" (red) COLOR="#008000" (green) COLOR="#0000FF" (blue) COLOR="#FFFF00" (yellow) STG Interactive Frogans Page [11] FSDL 2.1 Frogans Slide Description Language May 2004 Examples of refused values: COLOR="" COLOR="# FF0000" COLOR="FF0000" COLOR="#FF000" COLOR="#F00" COLOR="red" EDGECOLOR - Optional The color of the inner edge of the slide. Is a non-case sensitive six-digit hexadecimal number prefixed by a hash mark (each color component is represented by two digits, in the order of red, green, blue). The inner edge is used to make the frogans slide stand out on the screen of the end-user's system and therefore, can not be removed or enlarged. Its thickness is constant in all sizes of the slide on the screen. The default value is "#000000" (black). Examples of accepted values: EGDECOLOR="#000000" (black) EDGECOLOR="#FFFFFF" (white) EDGECOLOR="#ffffff" (white) EGDECOLOR="#C0C0C0" (silver) EGDECOLOR="#800000" (maroon) EGDECOLOR="#800080" (purple) EGDECOLOR="#FF00FF" (fuchsia) EGDECOLOR="#00FF00" (lime) EGDECOLOR="#808000" (olive) EGDECOLOR="#008080" (teal) EGDECOLOR="#00FFFF" (aqua) Examples of refused values: EGDECOLOR="" EGDECOLOR="# FF0000" EGDECOLOR="FF0000" EGDECOLOR="#FF000" EGDECOLOR="#F00" EGDECOLOR="red" STG Interactive Frogans Page [12] FSDL 2.1 Frogans Slide Description Language May 2004 5. Setting Image Resources - SETIMAGE element The SETIMAGE element designs an image resource which can be used to contribute to the shape of the slide (see 11. SHAPE element), to fill an area within the slide (see 12. CONTENT element), or to apply a mask to a content (see 13.1. MASK element). The SETIMAGE element is placed between the start and end tags of the FROGANS element. The SETIMAGE element does not contain any other elements. A single image resource can be reused many times within the same slide. The format used to encode the image file must be either JPEG, PNG or GIF (if GIF file is animated, only the first frame is displayed). The image file may contain transparency information (such as certain PNG or GIF image files) to define transparent areas in the resource. The image file is limited to 1024 pixels width by 1024 pixels height in order to minimize the loading and processing time of image resources on the end-user's system. The total file size of the slide, including its image files, is limited to 65,536 bytes. See 3.5. File Sizes. To display an image in a larger size on the end-user's system, a separate viewer can be used. See 14. BUTTON element (GOTO attribute). If different image resources have identical FILE and DATA attributes in the FSDL document, the specified image file is loaded only once by the Frogans Player. The image file is loaded by the Frogans Player even if there is no SHAPE, CONTENT or MASK element in the FSDL document which refers to the image resource. The attributes associated with the SETIMAGE element are: RESID - Required The unique identifier of the image resource for the slide. Is a non-case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, without spaces. The string must contain between 1 and 16 characters. Examples of accepted values: RESID="foo1" RESID="Foo1" RESID="foo2" STG Interactive Frogans Page [13] FSDL 2.1 Frogans Slide Description Language May 2004 RESID="foo_1" Examples of refused values: RESID="" RESID="foo-1" RESID="foo/1" RESID="foo.1" RESID="foo 1" RESID="foo1, foo2" ASPECT - Required The way the image resource occupies the areas of its associated SHAPE, CONTENT or MASK elements (defined by their SIZE or RSIZE attributes). Is not case sensitive. * "BASE" specifies that the whole image resource is displayed in its original proportions to occupy the largest part of the area. Can be combined with ADJUST attribute to pan the image resource * "SPREAD" specifies that the image resource is spread out to completely occupy the area. Does not preserve the original proportions of the image resource * "ECHO" specifies that the whole image resource is displayed in its original proportions to occupy the largest part of the area, and is then duplicated to occupy the remaining parts. Can be combined with ADJUST attribute to pan the image resource * "ZOOM" specifies that a part of the image resource is displayed in its original proportions to completely occupy the area. Can be combined with ADJUST attribute to pan the image resource ADJUST - Optional Applicable only if ASPECT="BASE", "ECHO" and "ZOOM" Adjusts the position of the image resource, through a left to right or top to bottom pan effect, on the areas of its associated SHAPE, CONTENT or MASK elements. Is a whole decimal number between -100 and 100. Spaces are accepted between the sign and the first digit. The default value is "0" (centered). Examples of accepted values: ADJUST="0" (centered) ADJUST="-100" (far left or top position) ADJUST="100" (far right or bottom position) STG Interactive Frogans Page [14] FSDL 2.1 Frogans Slide Description Language May 2004 ADJUST="33" (one third of the position to the right or bottom of center) ADJUST="- 100" ADJUST="+100" Examples of refused values: ADJUST="" ADJUST="33.3" ADJUST="200" FILE - Required The file name of the image in the frogans root directory. Is a case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, dash, dot and slash (/). The string cannot end with a slash or a dot. The string cannot contain the sequences '..', './', '/.' and '//'. Spaces and backslashes (\) are not accepted. The string must contain between 2 and 128 characters. The file name always starts with a slash (/). If the image is located in a sub-directory, the file name must include the complete file path from the frogans root directory. See 3.1. Frogans Root Directory. An image file extension is not relevant and therefore, is not required. Examples of accepted values: FILE="/pic1.jpg" FILE="/pic-1.jpg" FILE="/pic_1.jpg" FILE="/subdir/pic1.jpg" FILE="/pic1.png" FILE="/pic1.gif" FILE="/pic1.php" FILE="/pic1.asp" FILE="/pic1.jsp" FILE="/pic1.cgi" FILE="/pic1" Examples of refused values: FILE="" FILE="/" FILE="pic1.jpg" FILE="/.jpg" FILE="/pic1." FILE="\pic1.jpg" FILE="./pic1.jpg" FILE="../pic1.jpg" FILE="subdir/pic1.jpg" STG Interactive Frogans Page [15] FSDL 2.1 Frogans Slide Description Language May 2004 FILE="/subdir/" FILE="/subdir//pic1.jpg" FILE="/subdir\pic1.jpg" FILE="/pic1.php?option=2" FILE="/pic1.php?option=2&language=Swedish" FILE="frogans*GateName/pic1.jpg" FILE="http://SpecificDomainName.com/pic1.jpg" DATA - Optional Additional data that can be sent to the server hosting the frogans, at the time of the request for the image file by the Frogans Player. Is a case sensitive, comma separated list of items in the 'name=value' format. A maximum of 32 items is accepted in the list. Spaces can be placed before or after commas and equal signs. 'name' is a case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, without spaces. The string must contain between 1 and 16 characters. Each string of characters must be different from the others and cannot contain the non-case sensitive string of characters 'FROGANS'. The following non-case sensitive strings of characters are reserved and cannot be used: 'ADDRESS', 'PID', 'LOGIN', 'PASSWORD', 'SESSION', 'CERTIFICATE', 'KEY'. 'value' is a case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, dash and percent sign, without spaces. The string must contain between 1 and 128 characters. For more information about the way data is sent by the Frogans Player to the server hosting the frogans, see 19. Going On-line. The default value is "" (no data). Examples of accepted values: DATA="" (no data) DATA="option=2" DATA="option=2,language=Swedish" DATA="option = 2 , language=Swedish" DATA="option=2,language=Swedish,First_Name=Laura" DATA= "referer=http%3A%2F%2Fwww%2ESpecificDomainName%2Ecom%2F" Examples of refused values: DATA="?option=2" DATA="option=2&language=Swedish" DATA="pic1.php?option=2" DATA="slide2.php?option=2" STG Interactive Frogans Page [16] FSDL 2.1 Frogans Slide Description Language May 2004 DATA="session=abc123" DATA="referer=http://www.SpecificDomainName.com/" CACHE - Optional Indicates if the image file must be temporarily saved in a cache on the end-user's system once loaded. Is not case sensitive. Cache is used to avoid the repeated loading of the same image file for display in other slides of the same frogans. If data is specified in the DATA attribute, the image file is loaded by the Frogans Player and is not saved in the cache, no matter what the value specified in the CACHE attribute is. Each frogans open on the screen of the end-user's system has its own cache, which contains up to 512 image files, representing up to 1,048,576 bytes (1 MB). If the cache is full and a new image file is added, the oldest image files in the cache are removed. Image files are automatically removed from the cache when the end-user closes the frogans or after 24 hours. When the Frogans Player receives a request from the end-user to reload the slide, the image file will also reload even if the value of the CACHE attribute is set to "ON". An image file is included in the total file size of the slide, even if it has already been saved in the cache. See 3.5. File Sizes. The default value is "ON". * "ON" specifies image file is saved in the cache once loaded. The image file will not reload if it is already saved in the cache. * "OFF" specifies image file is not saved in the cache once loaded. If the image file is already in the cache, it will be removed before loading. STG Interactive Frogans Page [17] FSDL 2.1 Frogans Slide Description Language May 2004 6. Setting Pixels Resources - SETPIXELS and PIX elements The SETPIXELS element designs a resource made up of pixels which can be used to contribute to the shape of the slide (see 11. SHAPE element), to fill an area within the slide (see 12. CONTENT element), or to apply a mask to a content (see 13.1. MASK element). The SETPIXELS element is placed between the start and end tags of the FROGANS element. The SETPIXELS element only contains PIX elements. A single pixels resource can be reused many times within the same slide. The size of a pixels resource is 1 to 16 pixels in width and 1 to 16 pixels in height. A pixels resource can be used to handle color gradients, masks and other effects, without loading an image file (see 5. SETIMAGE element). The pixels are regrouped line by line, between the start and end tags of PIX elements. The number of PIX elements represents the height of the pixel resource. All PIX elements are placed between the start and end tags of the SETPIXELS element. The PIX element does not contain any other elements, just characters. Each line in a PIX element is a comma separated list of pixels organized from left to right. Each pixel is specified by a non-case sensitive, hexadecimal number prefixed by a hash mark. Spaces can be placed before or after commas. Each PIX element contains the number of pixels specified in the WIDTH attribute of the SETPIXELS element. The format for the hexadecimal number depends on the type of pixels resource specified in the BITMAP attribute of the SETPIXELS element. For example: #FF000080,#00FF00FF,#0000FFFF #00FF00FF,#0000FF80,#FF000000 The SETPIXELS element can contain between 1 and 16 PIX elements. The PIX element can contain between 1 and 16 pixels. There are no attributes associated with the PIX element. STG Interactive Frogans Page [18] FSDL 2.1 Frogans Slide Description Language May 2004 The attributes associated with the SETPIXELS element are: RESID - Required The unique identifier of the pixels resource for the slide. Is a non-case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, without spaces. The string must contain between 1 and 16 characters. Examples: see 5. SETIMAGE element WIDTH - Required The width of the pixels resource in number of pixels. Is a whole decimal number between 1 and 16. Signs are not accepted. Examples of accepted values: WIDTH="1" (minimum width) WIDTH="16" (maximum width) WIDTH="8" (average width) Examples of refused values: WIDTH="" WIDTH="+1" WIDTH="8.5" WIDTH="20" BITMAP - Required Denotes the type of pixels resource to be used. Is not case sensitive. When using "RGBA", "A" or "YA", an alpha channel is available to create transparent pixels. A pixel is opaque if its alpha component is "FF"; it is fully transparent if its alpha component is "00". * "RGB" specifies a color bitmap. Each pixel is represented by #RRGGBB where RR, GG and BB are the two-digit hexadecimal numbers for the red, green and blue components * "RGBA" specifies a color bitmap with an alpha channel. Each pixel is represented by #RRGGBBAA where RR, GG, BB and AA are the two-digit hexadecimal numbers for the red, green, blue and alpha components * "A" specifies a single color bitmap with an alpha channel. Each pixel is represented by #AA where AA is the two-digit hexadecimal number for the alpha component. The color of the pixels is specified in the COLOR attribute STG Interactive Frogans Page [19] FSDL 2.1 Frogans Slide Description Language May 2004 * "Y" specifies a grayscale bitmap. Each pixel is represented by #YY where YY is the two-digit hexadecimal number for the gray component * "YA" specifies a grayscale bitmap with an alpha channel. Each pixel is represented by #YYAA where YY and AA are the two-digit hexadecimal numbers for the gray and alpha components COLOR - Optional Applicable only if BITMAP="A" The uniform color of the pixels resource. Is a non-case sensitive, six-digit hexadecimal number prefixed by a hash mark (each color component is represented by two digits, in the order of red, green, blue). The default value is "#0000FF" (blue). Examples: see 4. FROGANS element STG Interactive Frogans Page [20] FSDL 2.1 Frogans Slide Description Language May 2004 7. Setting Draw Resources - SETDRAW element The SETDRAW element designs a graphic resource which can be used to contribute to the shape of the slide (see 11. SHAPE element), to fill an area within the slide (see 12. CONTENT element), or to apply a mask to a content (see 13.1. MASK element). The SETDRAW element is placed between the start and end tags of the FROGANS element. The SETDRAW element does not contain any other elements. A single graphic resource can be reused many times within the same slide. The attributes associated with the SETDRAW element are: RESID - Required The unique identifier of the graphic resource for the slide. Is a non-case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, without spaces. The string must contain between 1 and 16 characters. Examples: see 5. SETIMAGE element FORM - Required Denotes the form of the graphic resource. Is not case sensitive. * "RECT-P" specifies a rectangular perimeter * "RECT-A" specifies a rectangular area * "RREC-P" specifies a rounded rectangular perimeter * "RREC-A" specifies a rounded rectangular area * "ELLI-P" specifies an elliptical perimeter * "ELLI-A" specifies an elliptical area * "POLY-P" specifies a polygonal line * "POLY-A" specifies a polygonal area * "POLX-A" specifies an alternating polygonal area (for complex polygons with crisscrossing coordinates) STG Interactive Frogans Page [21] FSDL 2.1 Frogans Slide Description Language May 2004 THICK - Optional Applicable only if FORM="RECT-P", "RREC-P", "ELLI-P" and "POLY-P" Thickness of the line which designates the perimeter. Is a whole decimal number between 0 and 100. It represents the percentage of the width or the height of the resource, whichever is lower, divided by two (SIZE or RSIZE attributes of SHAPE, CONTENT and MASK elements). Signs are not accepted. The default value is "25" (one quarter of the maximum thickness). Examples of accepted values: THICK="25" (one quarter of the maximum thickness) THICK="0" (no thickness) THICK="100" (maximum thickness) THICK="33" (one third of the maximum thickness) Examples of refused values: THICK="" THICK="+33" THICK="33.3" THICK="200" THICK="-33" RSIZE - Optional Applicable only if FORM="RREC-P" and "RREC-A" Relative width and height of the ellipse defined for the corners of the rounded rectangular perimeter/area. Is a comma separated, pair of whole decimal numbers between 0 and 100. It represents the percentage of the width or the height of the resource (SIZE or RSIZE attributes of SHAPE, CONTENT and MASK elements). Spaces can be placed before or after the comma. Signs are not accepted. The default value is "25,25" (quarter width, quarter height). Examples of accepted values: RSIZE="25,25" (quarter width, quarter height) RSIZE="100,100" (full width, full height) RSIZE="50,100" (half width, full height) RSIZE="50,50" (half width, half height) RSIZE="50 , 50" (half width, half height) Examples of refused values: RSIZE="" RSIZE="+100,100" RSIZE="200,100" RSIZE="-50,100" STG Interactive Frogans Page [22] FSDL 2.1 Frogans Slide Description Language May 2004 RSIZE="100" RSIZE="50.5,100" COORDS - Required Applicable only if FORM="POLY-P", "POLY-A" and "POLX-A" Relative X,Y coordinates of the points of the polygonal perimeter/area. Is a comma separated, pair of whole decimal numbers between 0 and 100. The coordinate 0,0 is top-left of the resource and the coordinate 100,100 is bottom-right. Spaces can be placed before or after commas. Signs are not accepted. A maximum of 256 X,Y coordinates is possible. If FORM="POLY-P", the first X,Y coordinate must be repeated at the end of the value to close the polygon. If FORM="POLY-P", at least two different points must be specified. If FORM="POLY-A" and "POLX-A", at least three different points must be specified. Examples of accepted values: COORDS="0,100,50,50,75,75,100,0" (chart graphic line) COORDS="50,0,100,100,0,50" (triangular area) COORDS="50,0,100,100,0,50,50,0" (triangular perimeter) COORDS="50,0,75,100,0,30,100,30,25,100" (star shaped area) COORDS="50,0,75,100,0,30,100,30,25,100,50,0" (star shaped perimeter) COORDS="50 , 0 , 100 , 100 , 0 , 50" (triangular area) Examples of refused values: COORDS="" COORDS="50,0" COORDS="+50,0,100,100,0,-50" COORDS="50,0,100,100,0,50,100" COLOR - Optional The uniform color of the form. Is a non-case sensitive, six-digit hexadecimal number prefixed by a hash mark (each color component is represented by two digits, in the order of red, green, blue). The default value is "#0000FF" (blue). Examples: see 4. FROGANS element STG Interactive Frogans Page [23] FSDL 2.1 Frogans Slide Description Language May 2004 8. Managing Text Resources To set a text resource, one or more fonts must be defined in the FSDL document using FONT elements. 8.1. Defining Fonts - FONT element The FONT element designs a font which can be used in the context of a text resource (see 8.2. SETTEXT and TEXT elements). The FONT element is placed between the start and end tags of the FROGANS element. The FONT element does not contain any other elements. Up to 32 different FONT elements can be used in the slide. A single font can be reused for different text resources within the same slide. The attributes associated with the FONT element are: FONTID - Required The unique identifier of the font for the slide. Is a non-case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, without spaces. The string must contain between 1 and 16 characters. Examples of accepted values: FONTID="foo1" FONTID="Foo1" FONTID="foo2" FONTID="foo_1" Examples of refused values: FONTID="" FONTID="foo-1" FONTID="foo/1" FONTID="foo.1" FONTID="foo 1" FONTID="foo1, foo2" NAME - Optional The name of the font used to display the characters of the text. Is a comma separated list of five possible font names, which takes into account non-recognition of a font by the end-user's system. Spaces can be placed before or after commas. A font name is a non-case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, dash, commercial at (@), and spaces. STG Interactive Frogans Page [24] FSDL 2.1 Frogans Slide Description Language May 2004 The string must contain between 1 and 31 characters. The end-user's system will display the first available font on the list. If none is available, a substitute font will be displayed. The default value is "Arial,Verdana,Times New Roman". Examples of accepted values: NAME="Arial,Verdana,Times New Roman" NAME="Arial , Verdana , Times New Roman" NAME="Arial" NAME="Verdana" NAME="Times New Roman" Examples of refused values: NAME="" NAME="Arial," NAME="Arial,,Verdana" NAME="Arial+Verdana" STYLE - Optional The style of the font used to display the characters of the text. Is a non-case sensitive, comma separated list of up to four letters which can be used individually or in combination, in any order. Spaces can be placed before or after commas. The default value is "" (no style). * "B" specifies bold style * "I" specifies italic style * "U" specifies underline style * "S" specifies strikeout style Examples of accepted values: STYLE="" (no style) STYLE="B" (bold style) STYLE="b" (bold style) STYLE="B,I" (bold + italic styles) STYLE="B , I" (bold + italic styles) STYLE="I,B" (bold + italic styles) STYLE="B,I,U,S" (bold + italic + underline + strikeout styles) Examples of refused values: STYLE="," STYLE="B," STG Interactive Frogans Page [25] FSDL 2.1 Frogans Slide Description Language May 2004 STYLE="B,B" STYLE="BI" STYLE="B I" STYLE="B,,I" STYLE="B,I," STYLE="B,I,A" COLOR - Optional The color of the font used to display the characters of the text. Is a non-case sensitive, six-digit hexadecimal number prefixed by a hash mark (each color component is represented by two digits, in the order of red, green, blue). The default value is "#0000FF" (blue). Examples: see 4. FROGANS element SPACING - Optional The spacing between each character of the text. Is a whole decimal number between -100 and 100. Spaces are accepted between the sign and the first digit. The default value is "0" (default spacing). Examples of accepted values: SPACING="0" (default spacing) SPACING="100" (maximum spacing) SPACING="33" (one third of the maximum spacing) SPACING="-100" (no spacing, fully superimposed) SPACING="+100" SPACING="- 100" Examples of refused values: SPACING="" SPACING="33.3" SPACING="200" STG Interactive Frogans Page [26] FSDL 2.1 Frogans Slide Description Language May 2004 8.2. Setting Text Resources - SETTEXT and TEXT elements The SETTEXT element designs a text resource which can be used to contribute to the shape of the slide (see 11. SHAPE element), to fill an area within the slide (see 12. CONTENT element), or to apply a mask to a content (see 13.1. MASK element). The SETTEXT element is placed between the start and end tags of the FROGANS element. The SETTEXT element only contains TEXT elements. A single text resource can be reused many times within the same slide. The text characters are regrouped block by block between the start and end tags of TEXT elements. All TEXT elements are placed between the start and end tags of the SETTEXT element. The TEXT element does not contain any other elements, just text characters. For example: This is a block of text This is a second block of text The text characters can be displayed horizontally or vertically, to be read from left to right (LTR), right to left (RTL), top to bottom (TTB) or bottom to top (BTT), using the FORMAT attribute of the SETTEXT element. The text resource can be made up of 1 to 16 lines (rows or columns) of text characters. The number of lines is specified in the LINES attribute of the SETTEXT element. If the line is horizontal, the default height of the font used to display the text characters is the height of the associated SHAPE, CONTENT or MASK elements (defined by their SIZE or RSIZE attributes) divided by the specified number of lines. If the line is vertical, the default width of the font used to display the text characters (column width) is the width of the associated SHAPE, CONTENT or MASK elements (defined by their SIZE or RSIZE attributes) divided by the specified number of lines. The spacing between the lines of the text resource can be changed using the LINESPACE attribute of the SETTEXT element. The font's width or height will be increased or reduced in proportion to the value of the LINESPACE attribute. STG Interactive Frogans Page [27] FSDL 2.1 Frogans Slide Description Language May 2004 The text characters of a block of text are displayed on one or more lines of the text resource. When using the STRETCH attribute of the SETTEXT element, the block of text is displayed in a single line of the text resource. Each block of text begins on a new line of the text resource, except when using the JOIN attribute of the TEXT element. If there is not enough space for all of the text characters defined in the SETTEXT element to be displayed, the remaining text characters will be ignored. If the text characters do not completely fill the available space, the last lines of the text resource can remain empty. The font used to display the text characters must be designed in a preceding FONT element (see 8.1. FONT element). The font's identifier is specified in the FONTID attribute of the SETTEXT element. Each TEXT element can have a different font (FONTID attribute of the TEXT element) and can reverse the direction of the text when it is displayed (REVDIR attribute of the TEXT element). To use different fonts and text directions in a single block of text, several TEXT elements can be joined together (JOIN attribute of the TEXT element). For example: This is a block of text This is dnoces a block of text The SETTEXT element can contain up to 16 TEXT elements. Each block of text can contain up to 768 text characters. Numeric character references and entity references can be used. See 3.4. Character and Entity References. Horizontal tabulation ( ) and line feed ( ) characters are automatically replaced by the space character ( ). Any combination of two or more values denoting a space will result in a single space. Spaces immediately following or preceding the TEXT element tags are not taken into account. Non-breaking spaces can be used to place succeeding spaces anywhere in a line of text. STG Interactive Frogans Page [28] FSDL 2.1 Frogans Slide Description Language May 2004 The attributes associated with the SETTEXT element are: RESID - Required The unique identifier of the text resource for the slide. Is a non-case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, without spaces. The string must contain between 1 and 16 characters. Examples: see 5. SETIMAGE element FORMAT - Required The format of the text resource. Is not case sensitive. * "H-TTB-LTR" specifies that the characters must be displayed horizontally, in rows organized from top to bottom, reading left to right * "H-TTB-RTL" specifies that the characters must be displayed horizontally, in rows organized from top to bottom, reading right to left * "H-BTT-LTR" specifies that the characters must be displayed horizontally, in rows organized from bottom to top, reading left to right * "H-BTT-RTL" specifies that the characters must be displayed horizontally, in rows organized from bottom to top, reading right to left * "V-LTR-TTB" specifies that the characters must be displayed vertically, in columns organized from left to right, reading top to bottom * "V-LTR-BTT" specifies that the characters must be displayed vertically, in columns organized from left to right, reading bottom to top * "V-RTL-TTB" specifies that the characters must be displayed vertically, in columns organized from right to left, reading top to bottom * "V-RTL-BTT" specifies that the characters must be displayed vertically, in columns organized from right to left, reading bottom to top STG Interactive Frogans Page [29] FSDL 2.1 Frogans Slide Description Language May 2004 LINES - Required The number of lines (rows or columns) to make up the text resource. Is a whole decimal number between 1 and 16. Signs are not accepted. Examples of accepted values: LINES="1" (one line) LINES="8" (eight lines) Examples of refused values: LINES="" LINES="+1" LINES="8.5" LINES="20" FONTID - Required The unique identifier of the default font to be used to display the text resource. Is a non-case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, without spaces. The string must contain between 1 and 16 characters. Examples: see 8.1. FONT element TALIGN - Optional The default alignment of the blocks of text in the text resource (horizontal or vertical). Is not case sensitive. The default value is "BEGIN" (align start of the block of text). * "BEGIN" specifies align start of the block of text * "END" specifies align end of the block of text * "CENTER" specifies align center * "JUSTIFY" specifies align justified LINESPACE - Optional The spacing between each line of the text resource. Is a whole decimal number between -100 and 100. Spaces are accepted between the sign and the first digit. Has no effect if there is only one line in the text resource (LINES attribute). The default value is "0" (default spacing). STG Interactive Frogans Page [30] FSDL 2.1 Frogans Slide Description Language May 2004 Examples of accepted values: LINESPACE="0" (default spacing) LINESPACE="100" (maximum spacing) LINESPACE="33" (one third of the maximum spacing) LINESPACE="-100" (no spacing, fully superimposed) LINESPACE="+100" LINESPACE="- 100" Examples of refused values: LINESPACE="" LINESPACE="33.3" LINESPACE="200" STRETCH - Optional Forces each block of text to occupy a single line in the text resource, in relation to the other blocks of text. Is not case sensitive. The longest block of text to be displayed will completely occupy its line in the text resource by changing the original proportions of the font. The other blocks of text will be displayed using the same font proportions as the longest line. Must be set to "OFF" in order to preserve the original proportions of the font. The default value is "OFF" (no stretch). * "OFF" specifies no stretch * "ON" specifies stretch The attributes associated with the TEXT element are: FONTID - Optional The unique identifier of the font to be used to display the text characters placed between the start and end tags of the TEXT element. Is a non-case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, without spaces. The string must contain between 1 and 16 characters. The default value is specified in the FONTID attribute of the SETTEXT element which contains the TEXT element. Examples: see 8.1. FONT element STG Interactive Frogans Page [31] FSDL 2.1 Frogans Slide Description Language May 2004 TALIGN - Optional The alignment of the block of text (horizontal or vertical). Is not case sensitive. If the block of text is made up of several TEXT elements (JOIN attribute), the value of the TALIGN attribute used to align the block of text is found in the first TEXT element. The default value is specified in the TALIGN attribute of the SETTEXT element which contains the TEXT element. Examples: see 8.2. SETTEXT element REVDIR - Optional Reverses the direction of the text characters placed between the start and end tags of the TEXT element. Is not case sensitive. The initial direction is specified in the FORMAT attribute of the SETTEXT element which contains the TEXT element. The default value is "OFF" (direction is not reversed) * "OFF" specifies direction is not reversed * "ON" specifies direction is reversed JOIN - Optional Indicates if the text characters, placed between the start and end tags of the TEXT element, must be joined with the text characters of the previous TEXT element to display a single block of text with different fonts or text directions. Is not case sensitive. Has no effect on the first TEXT element of the SETTEXT element. The default value is "OFF" (text characters are not joined). * "OFF" specifies text characters are not joined * "ON" specifies text characters are joined with a space character * "NOSPACE" specifies text characters are joined without a space character STG Interactive Frogans Page [32] FSDL 2.1 Frogans Slide Description Language May 2004 9. Setting Duplicated Resources - SETCOPY element The SETCOPY element initializes a copy of an existing resource (image, graphic, pixels or text) designed in a preceding element. The SETCOPY element is placed between the start and end tags of the FROGANS element. The SETCOPY element does not contain any other elements. The new resource has the identical attribute values of the original resource and retains the processes already applied on the original (see 10. PROCESS and FILTER elements). Additional processes can be applied on the new resource. The attributes associated with the SETCOPY element are: RESID - Required The unique identifier of the new resource for the slide. Is a non-case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, without spaces. The string must contain between 1 and 16 characters. Examples: see 5. SETIMAGE element SOURCE - Required The unique identifier of the original resource for the slide. Is a non-case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, without spaces. The string must contain between 1 and 16 characters. Examples of accepted values: SOURCE="foo1" SOURCE="Foo1" SOURCE="foo2" SOURCE="foo_1" Examples of refused values: SOURCE="" SOURCE="foo-1" SOURCE="foo/1" SOURCE="foo.1" SOURCE="foo 1" SOURCE="foo1, foo2" STG Interactive Frogans Page [33] FSDL 2.1 Frogans Slide Description Language May 2004 10. Pre-processing of Resources - PROCESS and FILTER elements The PROCESS element defines a series of processes to be applied on a resource (image, graphic, pixels or text), before it is used in the SHAPE, CONTENT and MASK elements. The resource must be designed in a preceding element. The PROCESS element is placed between the start and end tags of the FROGANS element. The PROCESS element only contains FILTER elements. Up to 16 different processes can be applied on the same resource using successive FILTER elements. The first FILTER element represents the first process to be applied, and so on. All FILTER elements are placed between the start and end tags of the PROCESS element. The FILTER element does not contain any other elements. For example: To reuse the same resource in the slide, but each with different processes, the original resource must be duplicated using the SETCOPY element before applying processes on the copies. By treating the original resource, all copies will be affected. The only attribute associated with the PROCESS element is: RESID - Required The unique identifier of the resource to be processed. Is a non-case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, without spaces. The string must contain between 1 and 16 characters. Examples: see 5. SETIMAGE element The attributes associated with the FILTER element are: CUE - Required Denotes the filter used to process the red, green and blue (RGB) and alpha (A) components of the resource. Is not case sensitive. * "LIGHT" specifies a filter which modifies the brightness of the resource (affects RGB components) STG Interactive Frogans Page [34] FSDL 2.1 Frogans Slide Description Language May 2004 * "CONTRAST" specifies a filter which modifies the contrast of the resource (affects RGB components) * "SATURATION" specifies a filter which modifies the color saturation of the resource (affects RGB components) * "HUE" specifies a filter which modifies the color hue of the resource (affects RGB components) * "SOLARIZE" specifies a filter which applies color solarization to the resource (affects RGB components) * "ADDCOLOR" specifies a filter which adds or subtracts a certain color uniformly to/from the resource (affects RGB components) * "MIXCOLOR" specifies a filter which blends a certain color uniformly with the resource (affects RGB components) * "NEGATIVE" specifies a filter which applies a negative effect to the resource (affects RGB components) * "ADDTRANS" specifies a filter which adds or subtracts a uniform transparency to/from the resource (affects A component) * "REVERSE" specifies a filter which reverses the transparency of the resource (affects A component) * "LUMAKEY" specifies a filter which gives transparency to areas of the resource whose luminance is of a certain value (affects A component) * "CHROMAKEY" specifies a filter which gives transparency to areas of the resource whose color is of a certain value (affects A component) * "LUMATOALPHA" specifies a filter which transfers the luminance of the resource to its alpha/transparency channel (affects A component) * "ALPHATOLUMA" specifies a filter which transfers the alpha/transparency channel of the resource to its luminance (affects RGB components) STG Interactive Frogans Page [35] FSDL 2.1 Frogans Slide Description Language May 2004 LEVEL - Optional Applicable only if CUE="LIGHT", "CONTRAST", "SATURATION", "SOLARIZE", "ADDCOLOR", "MIXCOLOR" and "ADDTRANS" The level of the effect to be applied on the resource. Is a whole decimal number between -100 and 100. Spaces are accepted between the sign and the first digit. Level zero is considered as having no effect. If CUE="SOLARIZE" and "MIXCOLOR", only positive levels are processed. The default value is "25" (one quarter of the maximum positive effect). Examples of accepted values: LEVEL="25" (one quarter of the maximum positive effect) LEVEL="100" (maximum positive effect) LEVEL="0" (no effect) LEVEL="-25" (one quarter of the maximum negative effect) LEVEL="-100" (maximum negative effect) LEVEL="+25" LEVEL="- 25" Examples of refused values: LEVEL="" LEVEL="33.3" LEVEL="200" ANGLE - Optional Applicable only if CUE="HUE" The angle added to the H component of each pixel of the resource (in HSV color space). Is a whole decimal number representing degrees between -180 and 180. Spaces are accepted between the sign and the first digit. The default value is "90" (90 degrees). Examples of accepted values: ANGLE="90" (90 degrees) ANGLE="0" (0 degree) ANGLE="-45" (-45 degrees) ANGLE="+90" ANGLE="- 45" Examples of refused values: ANGLE="" ANGLE="33.3" ANGLE="270" STG Interactive Frogans Page [36] FSDL 2.1 Frogans Slide Description Language May 2004 TOLERANCE - Optional Applicable only if CUE="LUMAKEY" and "CHROMAKEY" The tolerance of the effect to be applied on the resource. Is a whole decimal number between 0 and 100. Level zero means no tolerance. Signs are not accepted. The default value is "10" (one tenth of the maximum tolerance). Examples of accepted values: TOLERANCE="10" (one tenth of the maximum tolerance) TOLERANCE="100" (maximum tolerance) TOLERANCE="0" (no tolerance) Examples of refused values: TOLERANCE="" TOLERANCE="33.3" TOLERANCE="+25" TOLERANCE="-25" TOLERANCE="200" COLOR - Optional Applicable only if CUE="ADDCOLOR", "MIXCOLOR", "LUMAKEY" and "CHROMAKEY" The color to be used in the process. Is a non-case sensitive, six-digit hexadecimal number prefixed by a hash mark (each color component is represented by two digits, in the order of red, green, blue). If CUE="LUMAKEY", only the luminance of the specified color is used (a gray value can be specified, such as "#A0A0A0"). The default value is "#FF0000" (red). Examples: see 4. FROGANS element STG Interactive Frogans Page [37] FSDL 2.1 Frogans Slide Description Language May 2004 11. Defining the Shape of the Slide - SHAPE element The SHAPE element defines a specific shape, which contributes to the overall shape of the slide, by using an existing resource (image, graphic, pixels or text). The resource must be designed in a preceding element. The SHAPE element is placed between the start and end tags of the FROGANS element. The SHAPE element does not contain any other elements. Up to 64 different SHAPE elements can be combined successively to define complex shapes (COMBINE attribute). The slide layout is conducted on a grid which is used for sizing and positioning specified shapes. The size of the grid is 800 units width by 600 units height which corresponds to a 4 by 3 ratio. The grid uses vector units of measurement, which are the same for both horizontal and vertical axes. For example, an elliptical area whose width and height are identical on the grid will appear as a circle. Coordinate 0,0 is left-top on the grid. The coordinate 799,599 is right-bottom. If no SHAPE element is found in the FSDL document, or if the shape (can be a combined shape) is less than 25% of the grid area, the default shape of the slide is a rounded rectangle. The attributes associated with the SHAPE element are: RESID - Required The unique identifier of the resource to be used in specifying the shape. Is a non-case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, without spaces. The string must contain between 1 and 16 characters. Examples: see 5. SETIMAGE element SIZE - Required The size of the specified shape on the grid before rotation. Is a comma separated, pair of whole decimal numbers, representing its width and height. The width is a number between 0 and 800 and the height is a number between 0 and 600. Spaces can be placed before or after the comma. Signs are not accepted. STG Interactive Frogans Page [38] FSDL 2.1 Frogans Slide Description Language May 2004 Examples of accepted values: SIZE="80,40" SIZE="80, 40" SIZE="80 , 40" SIZE="100,200" Examples of refused values: SIZE="" SIZE="+80,40" SIZE="80" SIZE="80.5,40" POS - Required The position of the specified shape on the grid. Is a comma separated, pair of whole decimal numbers representing its X,Y coordinate. X is a number between 0 and 799 and Y is a number between 0 and 599. Spaces can be placed before or after the comma. Signs are not accepted. Examples of accepted values: POS="400,300" (center of the grid) POS="0,0" (left-top of the grid) POS="799,599" (right-bottom of the grid) POS="400, 300" POS="400 , 300" Examples of refused values: POS="" POS="+400,300" POS="800,600" POS="400" POS="400.5,300" POS="-200,300" ALIGN - Optional The alignments of the specified shape in relation to its position on the grid (POS attribute). Is a comma separated list of two constants representing its horizontal and vertical alignments. The horizontal alignment can be left, center or right. The vertical alignment can be top, middle or bottom. Spaces can be placed before or after the comma. The horizontal alignment always precedes the vertical alignment. The default value is "CENTER,MIDDLE" (center and middle align). * "LEFT,TOP" specifies left and top align STG Interactive Frogans Page [39] FSDL 2.1 Frogans Slide Description Language May 2004 * "LEFT,MIDDLE" specifies left and middle align * "LEFT,BOTTOM" specifies left and bottom align * "CENTER,TOP" specifies center and top align * "CENTER,MIDDLE" specifies center and middle align * "CENTER,BOTTOM" specifies center and bottom align * "RIGHT,TOP" specifies right and top align * "RIGHT,MIDDLE" specifies right and middle align * "RIGHT,BOTTOM" specifies right and bottom align ANGLE - Optional The clockwise rotation angle of the specified shape on the grid. The rotation axis corresponds to the position of the specified shape on the grid (POS attribute). Is a whole decimal number representing degrees between -180 and 180. Spaces are accepted between the sign and the first digit. The default value is "0" (no rotation). Examples: see 10. FILTER element FLIP - Optional Flips the specified shape on the grid. Is not case sensitive. The default value is "OFF" (the shape is not flipped). * "OFF" specifies that the shape is not flipped * "ON" specifies that the shape is to be flipped along its horizontal and vertical dimensions * "XDIR" specifies that the shape is to be flipped along its horizontal dimension * "YDIR" specifies that the shape is to be flipped along its vertical dimension STG Interactive Frogans Page [40] FSDL 2.1 Frogans Slide Description Language May 2004 DROPOUT - Optional The transparency threshold over which areas of the resource are dropped out when defining the shape. Is a non-case sensitive, two-digit hexadecimal number prefixed by a hash mark. The default value is "#80" (areas with a transparency of less than "#80" are dropped out). Examples of accepted values: DROPOUT="#80" (areas with a transparency of less than "#80" are dropped out) DROPOUT="#FF" (all areas are dropped out unless opaque) DROPOUT="#00" (no area is dropped out) DROPOUT="#ff" Examples of refused values: DROPOUT="" DROPOUT="# FF" DROPOUT="FF" DROPOUT="#F" COMBINE - Optional The mode used to combine the specified shape with preceding SHAPE elements in the FSDL document. Is not case sensitive. Has no effect if the shape is the first SHAPE element in the FSDL document to be combined for each size of the slide (LEAPOUT attribute). The default value is "OR" (union of the specified shape to the existing). * "OR" specifies the union of the specified shape to the existing * "AND" specifies the intersection of the specified shape with the existing * "DIFF" specifies the subtraction of the specified shape from the existing * "XOR" specifies the exclusive union of the specified shape to the existing STG Interactive Frogans Page [41] FSDL 2.1 Frogans Slide Description Language May 2004 LEAPOUT - Optional The conditions under which the specified shape is combined depending on the size of the slide on the screen (of the end- user's system). Is not case sensitive. The default value is "ANYSIZE". * "ANYSIZE" specifies that the shape is combined in all sizes of the slide on the screen * "SMALL" specifies that the shape is combined only when the slide on the screen is smaller than one quarter of its largest size * "LARGE" specifies that the shape is combined only when the slide on the screen is larger than one quarter of its largest size STG Interactive Frogans Page [42] FSDL 2.1 Frogans Slide Description Language May 2004 12. Defining the Content of the Slide - CONTENT element The CONTENT element defines a content to be displayed on the slide by using an existing resource (image, graphic, pixels or text). The resource must be designed in a preceding element. The CONTENT element is placed between the start and end tags of the FROGANS element or between the start and end tags of the BUTTON element. The CONTENT element only contains MASK, RELIEF and SHADOW elements. Up to 128 different CONTENT elements can be used to create complex content. Specified contents are displayed within the slide, one on top of the other, in the order that their CONTENT elements appear in the FSDL document. The slide layout is conducted on a grid which is used for sizing and positioning specified content. The size of the grid is 800 units width by 600 units height which corresponds to a 4 by 3 ratio. The grid uses vector units of measurement, which are the same for both horizontal and vertical axes. For example, an elliptical area whose width and height are identical on the grid will appear as a circle. Coordinate 0,0 is left-top on the grid. The coordinate 799,599 is right-bottom. To enhance the specified content, optional elements can be placed between the start and end tags of the CONTENT element. See 13. MASK, RELIEF and SHADOW elements. The attributes associated with the CONTENT element are: RESID - Required The unique identifier of the resource to be used in specifying the content. Is a non-case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, without spaces. The string must contain between 1 and 16 characters. Examples: see 5. SETIMAGE element STG Interactive Frogans Page [43] FSDL 2.1 Frogans Slide Description Language May 2004 SIZE - Required The size of the specified content on the grid before rotation. Is a comma separated, pair of whole decimal numbers, representing its width and height. The width is a number between 0 and 800 and the height is a number between 0 and 600. Spaces can be placed before or after the comma. Signs are not accepted. Examples: see 11. SHAPE element POS - Required The position of the specified content on the grid. Is a comma separated, pair of whole decimal numbers representing its X,Y coordinate. X is a number between 0 and 799 and Y is a number between 0 and 599. Spaces can be placed before or after the comma. Signs are not accepted. Examples: see 11. SHAPE element ALIGN - Optional The alignments of the specified content in relation to its position on the grid (POS attribute). Is a comma separated list of two constants representing its horizontal and vertical alignments. The horizontal alignment can be left, center or right. The vertical alignment can be top, middle or bottom. Spaces can be placed before or after the comma. The horizontal alignment always precedes the vertical alignment. The default value is "CENTER,MIDDLE" (center and middle align). * "LEFT,TOP" specifies left and top align * "LEFT,MIDDLE" specifies left and middle align * "LEFT,BOTTOM" specifies left and bottom align * "CENTER,TOP" specifies center and top align * "CENTER,MIDDLE" specifies center and middle align * "CENTER,BOTTOM" specifies center and bottom align * "RIGHT,TOP" specifies right and top align * "RIGHT,MIDDLE" specifies right and middle align * "RIGHT,BOTTOM" specifies right and bottom align STG Interactive Frogans Page [44] FSDL 2.1 Frogans Slide Description Language May 2004 ANGLE - Optional The clockwise rotation angle of the specified content on the grid. The rotation axis corresponds to the position of the specified content on the grid (POS attribute). Is a whole decimal number representing degrees between -180 and 180. Spaces are accepted between the sign and the first digit. The default value is "0" (no rotation). Examples: see 10. FILTER element FLIP - Optional Flips the specified content on the grid. Is not case sensitive. The default value is "OFF" (the content is not flipped). * "OFF" specifies that the content is not flipped * "ON" specifies that the content is to be flipped along its horizontal and vertical dimensions * "XDIR" specifies that the content is to be flipped along its horizontal dimension * "YDIR" specifies that the content is to be flipped along its vertical dimension BLUR - Optional The level of the blur effect to be applied on the content. Is a whole decimal number between 0 and 100. Signs are not accepted. The default value is "0" (no effect). Examples of accepted values: BLUR="0" (no effect) BLUR="100" (maximum effect) BLUR="33" (one third of the maximum effect) Examples of refused values: BLUR="" BLUR="33.3" BLUR="200" BLUR="+25" BLUR="-25" STG Interactive Frogans Page [45] FSDL 2.1 Frogans Slide Description Language May 2004 OPACITY - Optional The percentage of opacity for the content, after optional masks have been applied (MASK element). Is a whole decimal number between 0 and 100. Signs are not accepted. The default value is "100" (opacity is not modified). Examples of accepted values: OPACITY="100" (opacity is not modified) OPACITY="0" (fully transparent) OPACITY="50" (half opacity) Examples of refused values: OPACITY="" OPACITY="33.3" OPACITY="200" OPACITY="+25" OPACITY="-25" ANTIALIAS - Optional Indicates if an antialiasing effect is applied on the content, before its rotation. Is not case sensitive. Antialiasing effect is applied on content specified with graphic and text resources (SETDRAW and SETTEXT elements). The default value is "ON" (antialiasing effect is applied). * "ON" specifies antialiasing effect is applied * "OFF" specifies antialiasing effect is not applied VISIBLE - Optional Applicable only if the CONTENT element is contained in a BUTTON element The conditions under which the content is visible in the button, in relation to the mouse cursor position on the slide. Is not case sensitive. The default value is "ALWAYS" (the content is displayed at all times). * "ALWAYS" specifies that the content is displayed at all times * "MOUSEOVER" specifies that the content is displayed only if the mouse cursor passes over the button STG Interactive Frogans Page [46] FSDL 2.1 Frogans Slide Description Language May 2004 * "MOUSEAWAY" specifies that the content is displayed only if the mouse cursor is not on the button CURSOR - Optional The transparency threshold over which areas of the content are not reactive to the mouse cursor. Is a non-case sensitive, two-digit hexadecimal number prefixed by a hash mark. Can be used whether or not the CONTENT element is contained in a BUTTON element. The default value is "#80" (areas with a transparency of less than "#80" are not reactive to the mouse cursor). Examples of accepted values: CURSOR="#80" (areas with a transparency of less than "#80" are not reactive to the mouse cursor) CURSOR="#FF" (only opaque areas are reactive) CURSOR="#00" (all areas are reactive to the mouse cursor) CURSOR="#ff" Examples of refused values: CURSOR="" CURSOR="# FF" CURSOR="FF" CURSOR="#F" LEAPOUT - Optional The conditions under which the content is displayed depending on the size of the slide on the screen (of the end-user's system). Is not case sensitive. If the CONTENT element is contained in a BUTTON element, the default value is "LARGE". Otherwise, it is "ANYSIZE". * "ANYSIZE" specifies that the content is displayed in all sizes of the slide on the screen * "SMALL" specifies that the content is displayed only when the slide on the screen is smaller than one quarter of its largest size * "LARGE" specifies that the content is displayed only when the slide on the screen is larger than one quarter of its largest size STG Interactive Frogans Page [47] FSDL 2.1 Frogans Slide Description Language May 2004 13. Enhancing the Content of the Slide To enhance a content to be displayed on the slide, MASK, RELIEF and SHADOW elements can be defined and placed between the start and end tags of the CONTENT element. 13.1. Applying Masks - MASK element The MASK element defines a mask which is applied to a content on the slide. The mask is defined by using an existing resource (image, graphic, pixels or text) whose transparency is combined with the transparency of the content (COMBINE attribute). Up to eight different masks can be applied on the content using successive MASK elements. The masks are combined in the order that their MASK elements appear in the FSDL document. If the content is rotated, the mask is applied before the rotation. The MASK element is placed between the start and end tags of the CONTENT element. The MASK element does not contain any other elements. For example: The specified mask is positioned on the same grid used for the CONTENT element. See 12. CONTENT element. The attributes associated with the MASK element are: RESID - Required The unique identifier of the resource to be used in specifying the mask. Is a non-case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, without spaces. The string must contain between 1 and 16 characters. Examples: see 5. SETIMAGE element RSIZE - Optional The relative size of the specified mask on the grid. Is a comma separated, pair of whole decimal numbers between 0 and 100. It represents the percentage of the width or the height of the content on the grid. Spaces can be placed before or after the comma. Signs are not accepted. STG Interactive Frogans Page [48] FSDL 2.1 Frogans Slide Description Language May 2004 The size of the mask is always equal to or smaller than the content size. The default value is "100,100" (full width, full height). Examples: see 7. SETDRAW element RPOS - Optional The relative position of the specified mask on the grid. Is a comma separated, pair of whole decimal numbers, representing the X,Y coordinate of the center of the mask, relative to where the content is placed. X is a number between -399 and 400 and Y is a number between -299 and 300. Spaces can be placed before or after the comma, and are accepted between the sign and the first digit. The default value is "0,0" (same position) Examples of accepted values: RPOS="0,0" (same position) RPOS="20,20" (bottom-right) RPOS="-20,-20" (top-left) RPOS="20 , - 20" RPOS="+20,20" Examples of refused values: RPOS="" RPOS="20" RPOS="20.5,20" ANGLE - Optional The clockwise rotation angle of the specified mask, relative to the content's rotation angle, on the grid. The rotation axis corresponds to the center of the specified mask. Is a whole decimal number representing degrees between -180 and 180. Spaces are accepted between the sign and the first digit. The default value is "0" (no rotation). Examples: see 10. FILTER element STG Interactive Frogans Page [49] FSDL 2.1 Frogans Slide Description Language May 2004 FLIP - Optional Flips the specified mask on the grid. Is not case sensitive. The default value is "OFF" (the mask is not flipped). * "OFF" specifies that the mask is not flipped * "ON" specifies that the mask is to be flipped along its horizontal and vertical dimensions * "XDIR" specifies that the mask is to be flipped along its horizontal dimension * "YDIR" specifies that the mask is to be flipped along its vertical dimension BLUR - Optional The level of the blur effect to be applied on the specified mask. Is a whole decimal number between 0 and 100. Signs are not accepted. The default value is "0" (no effect). Examples: see 12. CONTENT element OPACITY - Optional The percentage of opacity for the specified mask. Is a whole decimal number between 0 and 100. Signs are not accepted. The default value is "100" (opacity is not modified). Examples: see 12. CONTENT element ANTIALIAS - Optional Indicates if an antialiasing effect is applied on the specified mask, before its rotation. Is not case sensitive. Antialiasing effect is applied on masks specified with graphic and text resources (SETDRAW and SETTEXT elements). The default value is "ON" (antialiasing effect is applied). * "ON" specifies antialiasing effect is applied * "OFF" specifies antialiasing effect is not applied STG Interactive Frogans Page [50] FSDL 2.1 Frogans Slide Description Language May 2004 COMBINE - Optional The mode used to combine the transparency of the specified mask with the transparency of the existing content. Is not case sensitive. The default value is "OR" (union of the specified mask to the existing). * "OR" specifies the union of the specified mask to the existing * "AND" specifies the intersection of the specified mask with the existing * "DIFF" specifies the subtraction of the specified mask from the existing * "XOR" specifies the exclusive union of the specified mask to the existing STG Interactive Frogans Page [51] FSDL 2.1 Frogans Slide Description Language May 2004 13.2. Sketching Reliefs - RELIEF element The RELIEF element defines a relief which is applied to a content. Up to four different reliefs can be applied to the content using successive RELIEF elements. Reliefs are displayed, one on top of the other, in the order that their RELIEF elements appear in the FSDL document. If the content is rotated, the relief is applied before the rotation. The RELIEF element is placed between the start and end tags of the CONTENT element. The RELIEF element does not contain any other elements. For example: The specified relief is positioned on the same grid used for the CONTENT element. See 12. CONTENT element. The attributes associated with the RELIEF element are: RPOS - Optional The relative position of the specified relief on the grid. Is a comma separated, pair of whole decimal numbers, representing the X,Y coordinate of the center of the relief, relative to where the content is placed. X is a number between -399 and 400 and Y is a number between -299 and 300. Spaces can be placed before or after the comma, and are accepted between the sign and the first digit. The default value is "20,20" (bottom-right) Examples: see 13.1. MASK element COLOR - Optional The color of the specified relief. Is a non-case sensitive, six-digit hexadecimal number prefixed by a hash mark (each color component is represented by two digits, in the order of red, green, blue). STG Interactive Frogans Page [52] FSDL 2.1 Frogans Slide Description Language May 2004 The default value is "#FFFFFF" (white). Examples: see 4. FROGANS element BLUR - Optional The level of the blur effect to be applied on the specified relief. Is a whole decimal number between 0 and 100. Signs are not accepted. The default value is "0" (no effect). Examples: see 12. CONTENT element OPACITY - Optional The percentage of opacity for the specified relief. Is a whole decimal number between 0 and 100. Signs are not accepted. The default value is "100" (opacity is not modified). Examples: see 12. CONTENT element STG Interactive Frogans Page [53] FSDL 2.1 Frogans Slide Description Language May 2004 13.3. Adding Shadows - SHADOW element The SHADOW element defines a shadow which is applied to a content. A shadow is displayed next to the content on the slide. If the content contains transparent areas, the transparency of those areas will be applied to the shadow. Up to four different shadows can be added to the content using successive SHADOW elements. Shadows are displayed, one on top of the other, in the order that their SHADOW elements appear in the FSDL document. If the content is rotated, the shadow is applied after the rotation. The SHADOW element is placed between the start and end tags of the CONTENT element. The SHADOW element does not contain any other elements. For example: The specified shadow is positioned on the same grid used for the CONTENT element. See 12. CONTENT element. Shadows are not reactive to the mouse cursor. The attributes associated with the SHADOW element are: RPOS - Optional The relative position of the specified shadow on the grid. Is a comma separated, pair of whole decimal numbers, representing the X,Y coordinate of the center of the shadow, relative to where the content is placed. X is a number between -399 and 400 and Y is a number between -299 and 300. Spaces can be placed before or after the comma, and are accepted between the sign and the first digit. The default value is "20,20" (bottom-right) Examples: see 13.1. MASK element STG Interactive Frogans Page [54] FSDL 2.1 Frogans Slide Description Language May 2004 COLOR - Optional The color of the specified shadow. Is a non-case sensitive, six-digit hexadecimal number prefixed by a hash mark (each color component is represented by two digits, in the order of red, green, blue). The default value is "#000000" (black). Examples: see 4. FROGANS element BLUR - Optional The level of the blur effect to be applied on the specified shadow. Is a whole decimal number between 0 and 100. Signs are not accepted. The default value is "0" (no effect). Examples: see 12. CONTENT element OPACITY - Optional The percentage of opacity for the specified shadow. Is a whole decimal number between 0 and 100. Signs are not accepted. The default value is "100" (opacity is not modified). Examples: see 12. CONTENT element STG Interactive Frogans Page [55] FSDL 2.1 Frogans Slide Description Language May 2004 14. Linking and Navigation - BUTTON element The BUTTON element defines a button on the slide which is made up of one or more specified contents. The BUTTON element is placed between the start and end tags of the FROGANS element. The BUTTON element only contains CONTENT elements. Up to 32 different BUTTON elements can be used to create complex content. Multiple contents can be combined to create complex roll-over buttons. The CONTENT elements which define the specified contents are placed between the start and end tags of the BUTTON element. For example: The VISIBLE attribute of each CONTENT element indicates how the content in the button is displayed in relation to the mouse cursor position on the slide. See 12. CONTENT element. A button on the slide always takes priority over any button which may be displayed under it. The area of the frogans slide covered by one or more buttons should not exceed 50% of the grid area, so the end-user can easily move the frogans on screen. Buttons are not reactive on the edge of the frogans slide, as this area is reserved to let the end-user resize the frogans on screen. The attributes associated with the BUTTON element are: GOTO - Required Denotes the type of button to be used. Is not case sensitive. * "SLIDE" specifies a button which leads to another slide in the same frogans * "PIC" specifies a button which begins the process of downloading an image to be displayed in a larger size on the end-user's system, in a separate viewer. The image file is found in the frogans root directory. STG Interactive Frogans Page [56] FSDL 2.1 Frogans Slide Description Language May 2004 The format used to encode the image file must be either JPEG, PNG or GIF (if GIF file is animated, only the first frame is displayed). The image file is limited to 1600 pixels width by 1600 pixels height. For information about image file size limitations, see 3.5. File Sizes. * "FILE" specifies a button which begins the process of downloading a file to be saved on the end-user's system. The file is found in the frogans root directory. For information about file size limitations, see 3.5. File Sizes. * "REOPEN" specifies a button which closes the frogans and reopens it automatically, to re-request a PID or login and password for example. * "FROGANS" specifies a button which opens another frogans, that has a different frogans address * "WEB" specifies a button which opens the end-user's default browser to display a Web document whose URL starts with 'http://' * "SWEB" specifies a button which opens the end-user's default browser to display a Web document whose URL starts with 'https://' (secured protocol) * "EMAIL" specifies a button which opens the end-user's default mailer to send an e-mail FILE - Required Applicable only if GOTO="SLIDE", "PIC" and "FILE" The file name in the frogans root directory. Is a case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, dash, dot and slash (/). The string cannot end with a slash or a dot. The string cannot contain the sequences '..', './', '/.' and '//'. Spaces and backslashes (\) are not accepted. The string must contain between 2 and 128 characters. The file name always starts with a slash (/). If the file is located in a sub-directory, the file name must include the complete file path from the frogans root directory. See 3.1. Frogans Root Directory. Examples: see 5. SETIMAGE element and 15. NEXT element STG Interactive Frogans Page [57] FSDL 2.1 Frogans Slide Description Language May 2004 DATA - Optional Applicable only if GOTO="SLIDE", "PIC" and "FILE" Additional data that can be sent to the server hosting the frogans, at the time of the request for the FSDL document, the image file or the file to be downloaded, by the Frogans Player. See 5. DATA attribute of the SETIMAGE element. For more information about the way data is sent by the Frogans Player to the server hosting the frogans, see 19. Going On-line. The default value is "" (no data). ADDRESS - Required Applicable only if GOTO="FROGANS" The address of another frogans. If this frogans is published on the main frogans network, the address is a case sensitive string of characters in the format 'frogans*gatename' or 'frogans*gatename.extension', without spaces. If this frogans is published on a dedicated frogans network, the address is a case sensitive string of characters in the format 'network*gatename' or 'network*gatename.extension', without spaces, where 'network' is the name of the dedicated frogans network. 'gatename' is a case sensitive string of alphanumeric characters: A-Z, a-z, 0-9 and dash. The string cannot start or end with a dash. The string must contain between 2 and 32 characters. 'extension' is a case sensitive string of alphanumeric characters: A-Z, a-z, 0-9 and dash. The string cannot start or end with a dash. The string must contain between 3 and 16 characters. 'network' is a case sensitive string of alphanumeric characters: A-Z, a-z, 0-9 and dash. The string cannot start or end with a dash. The string must contain between 1 and 24 characters. Examples of accepted values: ADDRESS="frogans*GateName" ADDRESS="frogans*GateName.Extension" ADDRESS="frogans*gatename" ADDRESS="MyNetwork*GateName" ADDRESS="my-network*GateName.Extension" STG Interactive Frogans Page [58] FSDL 2.1 Frogans Slide Description Language May 2004 Examples of refused values: ADDRESS="" ADDRESS="frogans*-GateName" ADDRESS="frogans*GateName.Extension-" ADDRESS="frogans*" ADDRESS="GateName" ADDRESS="GateName.Extension" ADDRESS="*GateName" ADDRESS="frogans * GateName" ADDRESS="frogans*GateName . Extension" ADDRESS="frogans*GateName/subdir/" ADDRESS="frogans*GateName/file.fsdl" ADDRESS="http://www.SpecificDomainName.com/" ADDRESS="http://www.SpecificDomainName.com/subdir/" URL - Required Applicable only if GOTO="WEB" The URL of a document hosted on a Web server (html page, image, mp3, animation, video, etc.). The URL must begin with 'http://' and can contain up to 512 case sensitive characters. The host specified in the URL cannot include a user or password declaration. The URL cannot contain a fragment. The & entity reference must be used in place of an ampersand (&) in the URL. See 3.4. Character and Entity References. Examples of accepted values: URL="http://www.SpecificDomainName.com/" URL="http://www.SpecificDomainName.com/page.htm" URL="http://www.SpecificDomainName.com/dir/page.htm" URL="http://www.SpecificDomainName.com/pic1.jpg" URL="http://www.SpecificDomainName.com/music.mp3" URL="http://www.SpecificDomainName.com/anim.swf" URL="http://www.SpecificDomainName.com/video.asx" URL="http://www.SpecificDomainName.com/video.rm" URL="http://www.SpecificDomainName.com/home.asp?a=7&b=2" URL="http://www.SpecificDomainName.com:81/page.htm" URL="http://1.2.3.4/" Examples of refused values: URL="" URL="http://www.SpecificDomainName.com" URL="www.SpecificDomainName.com" URL="http://www.SpecificDomainName.com/page.html#top" URL="http://www.SpecificDomainName.com/home.asp?a=7&b=2" URL="https://www.SpecificDomainName.com/" URL="mailto:Name@SpecificDomainName.com" STG Interactive Frogans Page [59] FSDL 2.1 Frogans Slide Description Language May 2004 URL="Name@SpecificDomainName.com" URL="rtsp://www.SpecificDomainName.com/video.rm" URL="http://frogans*GateName" URL="frogans*GateName" SURL - Required Applicable only if GOTO="SWEB" The URL of a document hosted on a Web server (html page, image, mp3, animation, video, etc.) using a secured protocol. The URL must begin with 'https://' and can contain up to 512 case sensitive characters. The host specified in the URL cannot include a user or password declaration. The URL cannot contain a fragment. The & entity reference must be used in place of an ampersand (&) in the URL. See 3.4. Character and Entity References. Examples of accepted values: SURL="https://www.SpecificDomainName.com/" SURL="https://www.SpecificDomainName.com/page.htm" SURL="https://www.SpecificDomainName.com/dir/page.htm" SURL="https://www.SpecificDomainName.com/pic1.jpg" SURL="https://www.SpecificDomainName.com/music.mp3" SURL="https://www.SpecificDomainName.com/anim.swf" SURL="https://www.SpecificDomainName.com/video.asx" SURL="https://www.SpecificDomainName.com/video.rm" SURL= "https://www.SpecificDomainName.com/home.asp?a=7&b=2" SURL="https://www.SpecificDomainName.com:81/page.htm" SURL="https://1.2.3.4/" Examples of refused values: SURL="" SURL="https://www.SpecificDomainName.com" SURL="www.SpecificDomainName.com" SURL="https://www.SpecificDomainName.com/page.html#top" SURL="https://www.SpecificDomainName.com/home.asp?a=7&b=2" SURL="http://www.SpecificDomainName.com/" SURL="mailto:Name@SpecificDomainName.com" SURL="Name@SpecificDomainName.com" SURL="rtsp://www.SpecificDomainName.com/video.rm" SURL="https://frogans*GateName" SURL="frogans*GateName" STG Interactive Frogans Page [60] FSDL 2.1 Frogans Slide Description Language May 2004 EMAIL - Required Applicable only if GOTO="EMAIL" The e-mail address. It can contain up to 128 case sensitive characters. Examples of accepted values: EMAIL="Name@SpecificDomainName.com" Examples of refused values: EMAIL="" EMAIL="Name@SpecificDomainName.com, Name2@SpecificDomainName.com" EMAIL="mailto:Name@SpecificDomainName.com" EMAIL="Name@SpecificDomainName.com?subject=Hello" EMAIL="http://www.SpecificDomainName.com/" EMAIL="frogans*GateName" SUBJECT - Optional Applicable only if GOTO="EMAIL" The subject of the e-mail. Is a case sensitive string of up to 32 alphanumeric characters: A-Z, a-z, 0-9, spaces and .-,_()!*:; The default value is "" (no subject). Examples of accepted values: SUBJECT="" (no subject) SUBJECT="Hello" SUBJECT="Hello, :-)" SUBJECT="Hello 19." Examples of refused values: SUBJECT="Date & Time" SUBJECT="Name@SpecificDomainName.com" SUBJECT="Name@SpecificDomainName.com?subject=Hello" STG Interactive Frogans Page [61] FSDL 2.1 Frogans Slide Description Language May 2004 15. Auto-Refresh and Slide Show - NEXT element The NEXT element defines another slide in the same frogans to be loaded and displayed automatically. The NEXT element is placed between the start and end tags of the FROGANS element. The NEXT element does not contain any other elements. The NEXT element is optional. Only one NEXT element can be used in the FSDL document. The next slide is displayed after a delay, plus the time necessary to load the slide file and its image resources. Loading times will vary according to the physical network's capacity between the server hosting the frogans and the end-user's system. If the end-user clicks on a button leading to another slide in the same frogans before the delay has expired or before the next slide is fully loaded, the procedure is cancelled. If the end-user closes the Frogans Player, all frogans navigation is stopped. The attributes associated with the NEXT element are: DELAY - Required The period of time until the next slide begins to load. Is a whole decimal number representing seconds between 5 and 86400. Signs are not accepted. Examples of accepted values: DELAY="5" (minimum delay, 5 seconds) DELAY="86400" (maximum delay, 24 hours) DELAY="60" (60 seconds delay) Examples of refused values: DELAY="" DELAY="0" DELAY="3" DELAY="+5" FILE - Required The file name of the FSDL document in the frogans root directory representing the next slide. Is a case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, dash, dot and slash (/). The string cannot end with a slash or a dot. The string cannot contain the sequences '..', './', '/.' and '//'. Spaces and backslashes (\) are not accepted. The string must contain between 2 and 128 characters. STG Interactive Frogans Page [62] FSDL 2.1 Frogans Slide Description Language May 2004 The file name always starts with a slash (/). If the FSDL document is located in a sub-directory, the file name must include the complete file path from the frogans root directory. See 3.1. Frogans Root Directory. Examples of accepted values: FILE="/slide2.fsdl" FILE="/slide-2.fsdl" FILE="/slide_2.fsdl" FILE="/subdir/slide2.fsdl" FILE="/slide2.fsd" FILE="/slide2.php" FILE="/slide2.asp" FILE="/slide2.jsp" FILE="/slide2.cgi" FILE="/slide2" Examples of refused values: FILE="" FILE="/" FILE="slide2.fsdl" FILE="/.fsdl" FILE="/slide2." FILE="\slide2.fsdl" FILE="./slide2.fsdl" FILE="../slide2.fsdl" FILE="subdir/slide2.fsdl" FILE="/subdir/" FILE="/subdir//slide2.fsdl" FILE="/subdir\slide2.fsdl" FILE="/slide2.php?option=2" FILE="/slide2.php?option=2&language=Swedish" FILE="frogans*GateName/slide2.fsdl" FILE="http://SpecificDomainName.com/slide2.fsdl" DATA - Optional Additional data that can be sent to the server hosting the frogans, at the time of the request for the FSDL document by the Frogans Player. See 5. DATA attribute of the SETIMAGE element. For more information about the way data is sent by the Frogans Player to the server hosting the frogans, see 19. Going On-line. The default value is "" (no data). STG Interactive Frogans Page [63] FSDL 2.1 Frogans Slide Description Language May 2004 16. Redirecting to Another Slide - REDIRECT element The REDIRECT element indicates that another slide in the same frogans must be loaded and displayed automatically without delay. The FSDL document containing the REDIRECT element will not result in a displayed slide. A session can be maintained with a redirect (see 17. SESSION element). The REDIRECT element is placed between the start and end tags of the FROGANS element. The REDIRECT element does not contain any other elements. The REDIRECT element is optional. Only one REDIRECT element can be used in the FSDL document. When using the REDIRECT element, the SESSION element is the only other element which can be placed between the start and end tags of the FROGANS element. The REDIRECT element cannot be used if the FSDL document has been loaded from another FSDL document containing a REDIRECT element. The attributes associated with the REDIRECT element are: FILE - Required The file name of the FSDL document in the frogans root directory. Is a case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, dash, dot and slash (/). The string cannot end with a slash or a dot. The string cannot contain the sequences '..', './', '/.' and '//'. Spaces and backslashes (\) are not accepted. The string must contain between 2 and 128 characters. The file name always starts with a slash (/). If the FSDL document is located in a sub-directory, the file name must include the complete file path from the frogans root directory. See 3.1. Frogans Root Directory. Examples: see 15. NEXT element DATA - Optional Additional data that can be sent to the server hosting the frogans, at the time of the request for the FSDL document by the Frogans Player. STG Interactive Frogans Page [64] FSDL 2.1 Frogans Slide Description Language May 2004 See 5. DATA attribute of the SETIMAGE element. For more information about the way data is sent by the Frogans Player to the server hosting the frogans, see 19. Going On-line. The default value is "" (no data). STG Interactive Frogans Page [65] FSDL 2.1 Frogans Slide Description Language May 2004 17. Creating and Maintaining Sessions - SESSION element The SESSION element defines a session identifier for the slide (SESSID attribute). The SESSION element is placed between the start and end tags of the FROGANS element. The SESSION element does not contain any other elements. The SESSION element is optional. Only one SESSION element can be used in the FSDL document. The session identifier is sent to the server hosting the frogans by the Frogans Player at the time of the request for: - a FSDL document, representing another slide in the frogans, whose file is defined in the FILE attribute of a BUTTON, NEXT or REDIRECT element. Additional data may also be sent to the server at the time of the request (DATA attribute of the BUTTON, NEXT and REDIRECT elements). - an image file, specified in the FILE attribute of a SETIMAGE element, if additional data is specified (DATA attribute of the SETIMAGE element). If no additional data is specified, the session identifier is not sent. - an image file or a file to be downloaded, specified in the FILE attribute of a BUTTON element (where GOTO="PIC" or GOTO="FILE"), if additional data is specified (DATA attribute of the BUTTON element). If no additional data is specified, the session identifier is not sent. No session identifier is sent by the Frogans Player to the server when there is no SESSION element in the FSDL document or if the SESSID attribute is "". For more information about the way the session identifier and additional data are sent by the Frogans Player to the server hosting the frogans, see 19. Going On-line. The session identifier can be changed from slide to slide by the server hosting the frogans in order to update the information contained within the session identifier. In order to maintain a session when the end-user navigates from slide to slide, it is necessary to place the SESSION element in each slide of the frogans. The session ends when no SESSION element is found in the FSDL document or if the SESSID attribute is "". If the value of the RETURN attribute is set to "ON" and the end-user has added the frogans to his frogans favorites, the session STG Interactive Frogans Page [66] FSDL 2.1 Frogans Slide Description Language May 2004 identifier is saved on the end-user's system if the frogans is closed. This session identifier will be sent to the server hosting the frogans by the Frogans Player when the end-user reopens the frogans; at that time, the PID or login and password would not be requested by the Frogans Player nor sent to the server. The attributes associated with the SESSION element are: SESSID - Required The session identifier for the slide. Is a case sensitive string of alphanumeric characters: A-Z, a-z, 0-9, underscore, dash and percent sign, without spaces. The string can contain up to 2048 characters. Examples of accepted values: SESSID="" (no session identifier) SESSID="123" SESSID="abc-ABC" SESSID="abc_ABC" SESSID="abc%20ABC" SESSID="abc%2FABC" Examples of refused values: SESSID="abc ABC" SESSID="abc/123" SESSID="abc?123" SESSID="abc=123" SESSID="abc#123" SESSID="abc:123" SESSID="abc.123" RETURN - Required Indicates if the session identifier can be saved on the end-user's system if the frogans is closed. Is not case sensitive. A session identifier is saved only if the end-user has added the frogans to his frogans favorites. If the server hosting the frogans changes the session identifier from slide to slide, the last identifier received from the server is saved when the frogans is closed. * "OFF" specifies that the session identifier cannot be saved. If a previous session identifier has been saved, it will be removed. * "ON" specifies that the session identifier can be saved STG Interactive Frogans Page [67] FSDL 2.1 Frogans Slide Description Language May 2004 18. Planning for Statistics - STATS element The STATS element indicates that a hit must be processed automatically on a server used for collecting statistics about the end-user's navigation on the frogans. The hit is processed by the Frogans Player just before the slide is displayed on the end-user's system. The STATS element is placed between the start and end tags of the FROGANS element. The STATS element does not contain any other elements. The STATS element is optional. Only one STATS element can be used in the FSDL document. When the Frogans Player receives a request from the end-user to reload the slide, the hit will be processed again. The attributes associated with the STATS element are: HIT - Required Denotes the type of hit to be processed. Is not case sensitive. * "WEB" specifies a hit on a Web server URL - Required Applicable only if HIT="WEB" The URL of a Web document requested by the Frogans Player. The URL must begin with 'http://' and can contain up to 512 case sensitive characters. The host specified in the URL cannot include a user or password declaration. The URL cannot contain a fragment. The & entity reference must be used in place of an ampersand (&) in the URL. See 3.4. Character and Entity References. If the frogans is published on the main frogans network or another public frogans network, the server hosting the Web document is accessed by the Frogans Player using public IP addresses. If the frogans is published on a private frogans network, the server hosting the Web document is accessed by the Frogans Player using private IP addresses. STG Inter