FSDL Software Library

Version: Alpha 0.6.1
Release date: February 26, 2016

Status

This version is deprecated - It is no longer able to validate FSDL documents based on FSDL 3.0 - find the latest version

This version of the FSDL Software Library is embedded in version 0.6.1 of Frogans Player for Developers (alpha).

Note: The FSDL Software Library (alpha) is a preliminary version provided on an "as is" basis. The OP3FT cannot guarantee that the rendering performed by this alpha version will be compatible down to the last pixel with the rendering performed by the release version of the FSDL Software Library. The API of the FSDL Software Library is also subject to change.

To be informed of the distribution of versions of Frogans Player, subscribe free of charge to the Announcement read-only mailing list.

Purpose

The FSDL Software Library is the reference implementation of the FSDL technical specification version 3.0.

The FSDL Software Library provides the ability to parse and validate FSDL documents, and render them as Frogans slides. The FSDL Software Library also provides access to prepared resources and individual layers of Frogans slides.

Intended audience

The FSDL Software Library (alpha) is intended for developers wishing to contribute to the development of the FSDL language and of the FSDL Software Library by creating and testing software such as an authoring tool or a CMS (Content Management System), implemented either as a desktop application or a Web-based application.

Any contribution to the development of the Frogans technology, in any form, is considered as acceptance of the Frogans Technology Development Contributor Policy and the commitments it contains, without restriction or reserve.

By using the FSDL Software Library, developers can guarantee that Frogans sites designed using their software will be fully compliant with the FSDL technical specification, and will be rendered exactly the same, down to the last pixel, when they are published online and navigated using Frogans Player on any device.

Rather than wasting time implementing the complex rendering algorithms defined in the FSDL specification, developers can focus their efforts on designing productive graphical interfaces and optimizing Frogans site creation workflows.

Feedback sought

This alpha version represents an opportunity for developers to participate in the development of the Frogans technology.

To post questions or suggestions, or to report errors relating to the FSDL language or to this FSDL Software Library version, subscribe free of charge to the Early-questions mailing list. Please prefix the subject of any posts you make to this list concerning FSDL 3.0 with "[FSDL]" and prefix the subject of any posts concerning the FSDL Software Library with "[FSDL-Lib]".

The OP3FT is looking for feedback from the developer community in two key areas:

The FSDL 3.0 language
You can suggest improvements in the design of FSDL, such as:
- changes to the minimum, maximum, and default values of attributes
- changes to applicability rules for attributes
- new Frogans slide rendering constraints (intended to ensure useability for end-users)

The implementation of the FSDL Software Library
You can suggest improvements or report errors in the implementation of the FSDL Software Library, in areas such as:
- validation of FSDL documents (including error messages)
- rendering of Frogans slides
- the Application Programming Interface (API)

Your feedback can concern either a given platform (Windows, MacOS X, or Linux) or all platforms. It can concern either a given programming language (C, C++, Java, C#, VB, Objective C, PHP, or Node.js) or all languages.

Requirements

Operating System versions currently supported:

Windows 32-bit

Windows 2000
Windows XP
Windows Vista
Windows 7
Windows 8
Windows 8.1
Windows 10

Mac OS X 32-bit

Mac OS 10.6.6
Mac OS 10.7
Mac OS 10.8
Mac OS 10.9
Mac OS 10.10

Linux 32-bit/64-bit

GLibC 2.2.5 or higher (GlibC 2.14 or higher currently required for PHP 5.4, 5.5, 5.6)

Programming languages currently supported:

C
C++
Java 1.6, 1.7, 1.8
Objective C
PHP 5.4, 5.5, 5.6 (Linux 64-bit only)

Support for the following operating systems is under development and will be available soon:

Windows 64-bit
Mac OS X 64-bit

Support for the following programming languages is under development and will be available soon:

C# (.NET)
Node.js
Pascal (Delphi, FPC)
Python

Release information

The FSDL Software Library is written in C. It allows you to create and test software based on the Frogans Slide Description Language (FSDL).

This version implements the graphical elements of FSDL 3.0.
It does not implement dynamic elements of FSDL.

The following elements are available for testing: <frogans-fsdl>, <file>, <resimage>, <respixels>, <resdraw>, <respath>, <setfont>, <font>, <restext>, <text>, <setfilter>, <filter>, <setrelief>, <relief>, <setshadow>, <shadow>, <resmerge>, <merge>, <layer>, <button>, and <next>.

This version does not manage Frogans slide rendering constraints (intended to ensure useability for end-users), which are currently under discussion.

Future versions of the FSDL Software Library will support dynamic elements of FSDL.

Change log:

Changes between 0.5.1 and 0.6.1:

The file names of the binaries now include the version of the library. This is to reduce the risk of incompatibility problems when upgrading from one version of the library to another, and to allow two versions of the library to coexist on the same system.
The initialization and finalization functions of the library have been modified. These functions are called internally by the Java and PHP wrappers. The version of the library must now be passed to the initialization function. Errors occurring during the initialization and finalization functions are now retrieved by a specific function getting the state of the library.
The function to check the version of the library is replaced by a function getting the version of the library.
Sample programs for Java and PHP have been added to the archive file of the library.

Known issues (as of February 26, 2016):

The second and third steps in the optimization of the FSDL Software Library have not been completed yet. (The second step consists in optimizing processes implemented in low-level functions, and the third step consists in optimizing the overall process for parsing and rendering Frogans slides.) Therefore, parsing and rendering can be slow. The release version of the FSDL Software Library will be significantly faster. As a reminder, the first step was completed with alpha version 0.1.7 of Frogans Player for Developers. (This step consisted in enabling options that control optimization when compiling the Frogans Player runtime engine, which is written in C and embeds the FSDL Software Library.)
The error reporting system of the XML parser and the FSDL validator can generate incomplete or inaccurate messages.
Since Frogans slide rendering constraints are not managed yet, internal rendering errors can still occur. Such an error can occur, for example, if the lead or the vignette representation of the Frogans slide is unintentionally authored to be fully transparent, or if the placement of a button prevents it from being visible.

Download

FSDL Software Library (archive in 7z format): fsdl-software-library-alpha0.6.1.7z - 37.3 MB - [ SHA1 ]
FSDL Software Library (archive in tarball format): fsdl-software-library-alpha0.6.1.tar.gz - 55.5 MB - [ SHA1 ]
FSDL Software Library (archive in zip format): fsdl-software-library-alpha0.6.1.zip - 55.6 MB - [ SHA1 ]

Instructions

For a video presentation on the FSDL Software Library and how to create desktop and Web-based applications, watch the presentations given during the Frogans Technology Conference 6, available at conference.frogans.org.

Sample programs for Java and PHP are provided in the archive file of the FSDL Software Library.

The interface files (for C, Java and PHP) of the FSDL Software Library serve as a reference for calling the functions of the library.

The FSDL Software Library is being developed in compliance with version 1.0 of the UPIL (Uniform Portable Interface Language) technical specification. This is to ensure the accessibility of the FSDL Software Library for developers using the main programming languages on various platforms.

Archive file contents
Desktop applications: Running a sample program for Java
Web-based applications: Running a sample program for PHP (Linux 64-bit)

Archive file contents

The archive file is organized as follows:

fsdl-software-library-alpha0.6.1/
│
├── README.txt
│
├── COPYRIGHT-AND-LICENSE
│   ├── Copyright-and-License.txt
│   └── Licenses
│       ├── Apache-license.txt
│       ├── ARPHICPL.txt
│       ├── Bitstream-license.txt
│       ├── ICU-license.txt
│       ├── OFL.txt
│       └── Unicode-license.txt
│
├── reference-implementation ◀─────── Directory containing the reference implementation of the library
│   │
│   ├── upil
│   │   └── upil-types.h ◀─────── UPIL basic types for C
│   │
│   └── fsdl
│       ├── fsdl.h ◀─────── Library's interface file for C
│       │
│       └── binaries
│           ├── fsdl-fonts.dat ◀─────── File containing the fonts defined in FSDL 3.0
│           ├── windows
│           │   └── 32-bit
│           │       └── fsdl-alpha0.6.1.dll ◀─────── x86 version for Windows
│           ├── macosx
│           │   └── 32-bit
│           │       └── libfsdl-alpha0.6.1.dylib ◀─────── x86 version for Mac OS X
│           └── linux
│               ├── 32-bit
│               │   └── libfsdl-alpha0.6.1.so ◀─────── x86 version for Linux
│               └── 64-bit
│                   └── libfsdl-alpha0.6.1.so ◀─────── x64 version for Linux
│
├── sample-programs
│   │
│   ├── desktop
│   │   │
│   │   └── java
│   │       │
│   │       └── sampleFsdlTool ◀─────── Directory containing the desktop sample program for Java
│   │           ├── Launch.java
│   │           ├── SampleSlideDataManager.java
│   │           ├── ImagePanel.java
│   │           ├── ToolException.java
│   │           └── resource
│   │               ├── home.fsdl.tpl
│   │               ├── slide2.fsdl.tpl
│   │               └── world240x240.png
│   │
│   ├── web-based
│   │   │
│   │   └── php
│   │       │
│   │       └── sampleFsdlTool ◀─────── Directory containing the web-based sample program for PHP
│   │           ├── index.php
│   │           ├── index-with-trace.php
│   │           ├── Launch.php
│   │           ├── SampleSlideDataManager.php
│   │           ├── ToolException.php
│   │           └── resource
│   │               ├── home.fsdl.tpl
│   │               ├── slide2.fsdl.tpl
│   │               └── world240x240.png
│   │
│   └── mobile
│
└── wrappers
    │
    ├── java ◀─────── Directory containing the wrapper of the library for Java
    │   │
    │   ├── upil ◀─────── Directory containing the UPIL basic types for Java
    │   │   ├── UpilBoolean.java
    │   │   ├── UpilInteger32.java
    │   │   ├── UpilBuffer.java
    │   │   └── UpilBufferInternals.java
    │   │
    │   └── fsdl
    │       ├── Fsdl.java ◀─────── Library's interface file for Java
    │       ├── FsdlInternals.java
    │       │
    │       └── binaries
    │           ├── windows
    │           │   └── 32-bit
    │           │       └── fsdl4java-alpha0.6.1.dll ◀─────── x86 version for Windows
    │           ├── macosx
    │           │   └── 32-bit
    │           │       └── libfsdl4java-alpha0.6.1.dylib ◀─────── x86 version for Mac OS X
    │           └── linux
    │               ├── 32-bit
    │               │   └── libfsdl4java-alpha0.6.1.so ◀─────── x86 version for Linux
    │               └── 64-bit
    │                   └── libfsdl4java-alpha0.6.1.so ◀─────── x64 version for Linux
    │
    └── php ◀─────── Directory containing the wrappers of the library for PHP
        │
        ├── 5.4
        │   └── non-zts ◀─────── Directory containing the wrapper of the library for PHP 5.4 - non ZTS
        │       │
        │       ├── upil ◀─────── Directory containing the UPIL basic types for PHP
        │       │   ├── UpilBuffer.php ◀─────── UPIL buffer basic type's interface file (for information only)
        │       │   └── binaries
        │       │       └── linux
        │       │           └── 64-bit
        │       │               ├── libupilbuffer4php-alpha0.6.1.so ◀─────── x64 version for Linux
        │       │               └── libupilbuffer4php-alpha0.6.1.ini
        │       │
        │       └── fsdl
        │           ├── Fsdl.php ◀─────── Library's interface file for PHP (for information only)
        │           │
        │           └── binaries
        │               └── linux
        │                   └── 64-bit
        │                       ├── libfsdl4php-alpha0.6.1.so ◀─────── x64 version for Linux
        │                       └── libfsdl4php-alpha0.6.1.ini
        │
        ├── 5.5
        │   └── non-zts ◀─────── Directory containing the wrapper of the library for PHP 5.5 - non ZTS
        │       │
        │       ├── upil ◀─────── Directory containing the UPIL basic types for PHP
        │       │   ├── UpilBuffer.php ◀─────── UPIL buffer basic type's interface file (for information only)
        │       │   └── binaries
        │       │       └── linux
        │       │           └── 64-bit
        │       │               ├── libupilbuffer4php-alpha0.6.1.so ◀─────── x64 version for Linux
        │       │               └── libupilbuffer4php-alpha0.6.1.ini
        │       │
        │       └── fsdl
        │           ├── Fsdl.php ◀─────── Library's interface file for PHP (for information only)
        │           │
        │           └── binaries
        │               └── linux
        │                   └── 64-bit
        │                       ├── libfsdl4php-alpha0.6.1.so ◀─────── x64 version for Linux
        │                       └── libfsdl4php-alpha0.6.1.ini
        │
        └── 5.6
            └── non-zts ◀─────── Directory containing the wrapper of the library for PHP 5.6 - non ZTS
                │
                ├── upil ◀─────── Directory containing the UPIL basic types for PHP
                │   ├── UpilBuffer.php ◀─────── UPIL buffer basic type's interface file (for information only)
                │   └── binaries
                │       └── linux
                │           └── 64-bit
                │               ├── libupilbuffer4php-alpha0.6.1.so ◀─────── x64 version for Linux
                │               └── libupilbuffer4php-alpha0.6.1.ini
                │
                └── fsdl
                    ├── Fsdl.php ◀─────── Library's interface file for PHP (for information only)
                    │
                    └── binaries
                        └── linux
                            └── 64-bit
                                ├── libfsdl4php-alpha0.6.1.so ◀─────── x64 version for Linux
                                └── libfsdl4php-alpha0.6.1.ini

	

Desktop applications: Running a sample program for Java

The following instructions are provided for Eclipse IDE for Java Developers, Mars.1 Release (4.5.1). They can be easily adapted to other Eclipse versions. Java versions currently supported are 1.6, 1.7 and 1.8. Platforms currently supported are Windows 32-bit, Mac OS X 32-bit, Linux 32-bit, and Linux 64-bit.

Prerequisite

Install Java SE Development Kit on your system
Install Eclipse IDE for Java Developers on your system

Setting up the Java project

Run Eclipse and select a workspace.
Select the main menu item File -> New -> Project...
In the Java folder, select Java project and click Next.
Enter the following Project name: SampleFsdlTool (case sensitive). Check Use default location, select Use default JRE, select Create separate folders for sources and class files, and click Finish. If you are invited to Open Associated Perspective, click Yes.
In the Package Explorer, right click on SampleFsdlTool and select the contextual menu item New -> Folder. Enter the following Folder name: fonts and click Finish. Repeat the same operation to create the folder native-lib.
In the Package Explorer, expand SampleFsdlTool, right click on src and select the contextual menu item New -> Folder. Enter the following Folder name: frogans and click Finish. Repeat the same operation to create the folder sampleFsdlTool (case sensitive).
In the Package Explorer, expand SampleFsdlTool and src, right click on frogans and select the contextual menu item New -> Folder. Enter the following Folder name: upil and click Finish. Repeat the same operation to create the folder fsdl.
In the Package Explorer, expand SampleFsdlTool and src, right click on sampleFsdlTool (case sensitive) and select the contextual menu item New -> Folder. Enter the following Folder name: resource and click Finish.

Copying files from the archive file

Download the FSDL Software Library archive file, and uncompress it to a temporary directory. This temporary directory contains the fsdl-software-library-alpha0.6.1 directory. All copies described hereafter are made from the fsdl-software-library-alpha0.6.1 directory.
Copy the file reference-implementation/fsdl/binaries/fsdl-fonts.dat to the fonts folder of the Java project.
In this step, the operations depend on your operating system.
For Windows 32-bit:
Copy the two files reference-implementation/fsdl/binaries/windows/32-bit/fsdl-alpha0.6.1.dll and wrappers/java/fsdl/binaries/windows/32-bit/fsdl4java-alpha0.6.1.dll to the native-lib folder of the Java project.
For Mac OS X 32-bit:
Copy the two files reference-implementation/fsdl/binaries/macosx/32-bit/libfsdl-alpha0.6.1.dylib and wrappers/java/fsdl/binaries/macosx/32-bit/libfsdl4java-alpha0.6.1.dylib to the native-lib folder of the Java project.
For Linux 32-bit:
Copy the two files reference-implementation/fsdl/binaries/linux/32-bit/libfsdl-alpha0.6.1.so and wrappers/java/fsdl/binaries/linux/32-bit/libfsdl4java-alpha0.6.1.so to the native-lib folder of the Java project.
For Linux 64-bit:
Copy the two files reference-implementation/fsdl/binaries/linux/64-bit/libfsdl-alpha0.6.1.so and wrappers/java/fsdl/binaries/linux/64-bit/libfsdl4java-alpha0.6.1.so to the native-lib folder of the Java project.
Copy the four files UpilBoolean.java, UpilInteger32.java, UpilBuffer.java, and UpilBufferInternals.java, located in the wrappers/java/upil directory, to the src/frogans/upil folder of the Java project.
Copy the two files Fsdl.java and FsdlInternals.java, located in the wrappers/java/fsdl directory, to the src/frogans/fsdl folder of the Java project.
Copy the four files Launch.java, SampleSlideDataManager.java, ImagePanel.java, and ToolException.java, located in the sample-programs/desktop/java/sampleFsdlTool directory, to the src/sampleFsdlTool folder of the Java project.
Copy the three files home.fsdl.tpl, slide2.fsdl.tpl, and world240x240.png, located in the sample-programs/desktop/java/sampleFsdlTool/resource directory, to the src/sampleFsdlTool/resource folder of the Java project.
In the Package Explorer, right click on SampleFsdlTool and select the contextual menu item Refresh.

Configuring the Java project

In the Package Explorer, right click on SampleFsdlTool and select the contextual menu item Properties.
On the left of the Properties window, select Run/Debug Settings and click New.... Select Java Application and click OK.
In the Edit Configuration window, replace the name New_configuration by SampleFsdlTool.
In the Main tab of the Edit Configuration window, click Search, then select Launch - sampleFsdlTool and click OK.
For MacOSX 32-bit only: in the Arguments tab of the Edit Configuration window, enter -d32 in the VM arguments field.
In the Environment tab of the Edit Configuration window, click New... and enter:
For Windows 32-bit: Name = PATH and Value = ./native-lib
For Mac OS X 32-bit: Name = DYLD_LIBRARY_PATH and Value = ./native-lib
For Linux 32-bit and Linux 64-bit: Name = LD_LIBRARY_PATH and Value = ./native-lib
and click OK.
Click OK on the Edit Configuration window. Click OK on the Properties window.

Running the sample program

In the Package Explorer, expand SampleFsdlTool, src, and sampleFsdlTool.
Select (i.e. double click on) the file Launch.java.
If you are using Java 1.6: in the file Launch.java, replace the two occurrences of JComboBox<String> by JComboBox.
Run.

Note: In the sample program, changes to the content of a text field is taken into account after pressing the Enter key.

Developing your program

When developing your program, two exceptions can be raised by the wrapper of the library for Java (JNI wrapper): java.lang.IllegalArgumentException (e.g. if an argument is null) and java.lang.RuntimeException (e.g. if an argument is a class for which a member has not been set).

Packaging your program for distribution

This section will be available in a future release.

Web-based applications: Running a sample program for PHP (Linux 64-bit)

The following instructions are provided for Debian 8. They can easily be adapted to other Linux distributions. PHP versions currently supported are 5.4, 5.5 and 5.6. Web server currently supported is Apache 2.

Installing the FSDL Software Library

Become super user:
$ su -
Install PHP 5:
# apt-get install php5
Once the installation is complete, check that the PHP version installed is 5.4, 5.5 or 5.6:
# php --version
Download the FSDL Software Library archive file, and uncompress it to a temporary directory.
Go to the temporary directory:
# cd fsdl-software-library-alpha0.6.1/
Copy the font file to your system:
# mkdir -p /usr/lib/fsdl/alpha0.6.1
# cp reference-implementation/fsdl/binaries/fsdl-fonts.dat /usr/lib/fsdl/alpha0.6.1/
Copy the reference implementation to your system:
# cp reference-implementation/fsdl/binaries/linux/64-bit/libfsdl-alpha0.6.1.so /usr/lib/
Copy the wrapper to your system:
For PHP 5.4:
# cp wrappers/php/5.4/non-zts/fsdl/binaries/linux/64-bit/libfsdl4php-alpha0.6.1.so /usr/lib/php5/20100525/
# cp wrappers/php/5.4/non-zts/upil/binaries/linux/64-bit/libupilbuffer4php-alpha0.6.1.so /usr/lib/php5/20100525/
# cp wrappers/php/5.4/non-zts/fsdl/binaries/linux/64-bit/libfsdl4php-alpha0.6.1.ini /etc/php5/mods-available/
# cp wrappers/php/5.4/non-zts/upil/binaries/linux/64-bit/libupilbuffer4php-alpha0.6.1.ini /etc/php5/mods-available/
For PHP 5.5:
# cp wrappers/php/5.5/non-zts/fsdl/binaries/linux/64-bit/libfsdl4php-alpha0.6.1.so /usr/lib/php5/20121212/
# cp wrappers/php/5.5/non-zts/upil/binaries/linux/64-bit/libupilbuffer4php-alpha0.6.1.so /usr/lib/php5/20121212/
# cp wrappers/php/5.5/non-zts/fsdl/binaries/linux/64-bit/libfsdl4php-alpha0.6.1.ini /etc/php5/mods-available/
# cp wrappers/php/5.5/non-zts/upil/binaries/linux/64-bit/libupilbuffer4php-alpha0.6.1.ini /etc/php5/mods-available/
For PHP 5.6:
# cp wrappers/php/5.6/non-zts/fsdl/binaries/linux/64-bit/libfsdl4php-alpha0.6.1.so /usr/lib/php5/20131226/
# cp wrappers/php/5.6/non-zts/upil/binaries/linux/64-bit/libupilbuffer4php-alpha0.6.1.so /usr/lib/php5/20131226/
# cp wrappers/php/5.6/non-zts/fsdl/binaries/linux/64-bit/libfsdl4php-alpha0.6.1.ini /etc/php5/mods-available/
# cp wrappers/php/5.6/non-zts/upil/binaries/linux/64-bit/libupilbuffer4php-alpha0.6.1.ini /etc/php5/mods-available/
Make the wrapper available in your system:
For the CLI:
# cd /etc/php5/cli/conf.d/
# ln -s ../../mods-available/libupilbuffer4php-alpha0.6.1.ini 20-libupilbuffer4php-alpha0.6.1.ini
# ln -s ../../mods-available/libfsdl4php-alpha0.6.1.ini 21-libfsdl4php-alpha0.6.1.ini
For Apache 2:
# cd /etc/php5/apache2/conf.d/
# ln -s ../../mods-available/libupilbuffer4php-alpha0.6.1.ini 20-libupilbuffer4php-alpha0.6.1.ini
# ln -s ../../mods-available/libfsdl4php-alpha0.6.1.ini 21-libfsdl4php-alpha0.6.1.ini
Restart Apache 2:
# service apache2 restart

Installing the sample program

Rename the Apache 2 default page
# mv /var/www/html/index.html /var/www/html/index.save.html
Create a public directory to store the public part of the sample program:
# mkdir -p /var/www/html/sample-fsdl-tool
Create a public subdirectory to store the generated images:
# mkdir -p /var/www/html/sample-fsdl-tool/generated-images
# chmod 777 /var/www/html/sample-fsdl-tool/generated-images
Create a private directory to store the private part of the sample program:
# mkdir -p /var/www/private/sample-fsdl-tool
Create a private subdirectory to store the resources:
# mkdir -p /var/www/private/sample-fsdl-tool/resource
Create a private subdirectory to store the interface files for PHP:
# mkdir -p /var/www/private/sample-fsdl-tool/for-information-only
Return to the temporary directory fsdl-software-library-alpha0.6.1/
Copy the public part of the sample program:
# cp sample-programs/web-based/php/sampleFsdlTool/index.php /var/www/html/sample-fsdl-tool
# cp sample-programs/web-based/php/sampleFsdlTool/index-with-trace.php /var/www/html/sample-fsdl-tool
Copy the private part of the sample program:
# cp sample-programs/web-based/php/sampleFsdlTool/Launch.php /var/www/private/sample-fsdl-tool
# cp sample-programs/web-based/php/sampleFsdlTool/SampleSlideDataManager.php /var/www/private/sample-fsdl-tool
# cp sample-programs/web-based/php/sampleFsdlTool/ToolException.php /var/www/private/sample-fsdl-tool
# cp sample-programs/web-based/php/sampleFsdlTool/resource/home.fsdl.tpl /var/www/private/sample-fsdl-tool/resource
# cp sample-programs/web-based/php/sampleFsdlTool/resource/slide2.fsdl.tpl /var/www/private/sample-fsdl-tool/resource
# cp sample-programs/web-based/php/sampleFsdlTool/resource/world240x240.png /var/www/private/sample-fsdl-tool/resource
Copy the interface files for PHP:
For PHP 5.4:
# cp wrappers/php/5.4/non-zts/fsdl/Fsdl.php /var/www/private/sample-fsdl-tool/for-information-only
# cp wrappers/php/5.4/non-zts/upil/UpilBuffer.php /var/www/private/sample-fsdl-tool/for-information-only
For PHP 5.5:
# cp wrappers/php/5.5/non-zts/fsdl/Fsdl.php /var/www/private/sample-fsdl-tool/for-information-only
# cp wrappers/php/5.5/non-zts/upil/UpilBuffer.php /var/www/private/sample-fsdl-tool/for-information-only
For PHP 5.6:
# cp wrappers/php/5.6/non-zts/fsdl/Fsdl.php /var/www/private/sample-fsdl-tool/for-information-only
# cp wrappers/php/5.6/non-zts/upil/UpilBuffer.php /var/www/private/sample-fsdl-tool/for-information-only

Running the sample program

Open a Web browser on your system
To run the program normally, enter the URL: http://localhost/sample-fsdl-tool/index.php
To run the program with debug information, enter the URL: http://localhost/sample-fsdl-tool/index-with-trace.php
Click on the links to change the slide or display the query fields in the URL.

The query fields in the URL are organized as follows:

applicability	field name	description	value
always	slide	slide reference	0: home slide 1: second slide
if slide=0 if slide=0 if slide=0 if slide=0 if slide=0	opacity1 text1 text2 angle4 opacity4	layer1 opacity restext1 characters restext2 characters layer4 angle layer4 opacity	between 0 and 100 UTF-8 encoded UTF-8 encoded between -180 and 180 between 0 and 100
if slide=1 if slide=1 if slide=1 if slide=1 if slide=1	color1 blur1 opacity1 pos2 pos4	resdraw1 color setshadow1 blur setshadow1 opacity layer2 position layer4 position	rrggbb (hex digits) between 0 and 32 between 0 and 100 x,y x,y x is between -640 and 1280 y is between -480 and 960

Examples:

index.php?slide=0&opacity1=75&text1=Hello%20World!&text2=Hello%20World!&angle4=0&opacity4=100
index.php?slide=1&color1=98000a&blur1=5&opacity1=80&pos2=430,240&pos4=120,240

If you want to run the sample program via CLI, use this command in order to pass query fields:
$ php -e -r 'parse_str("queryfields", $_GET); include "index.php";'

Legal information / Credits

FSDL Software Library
Version: alpha0.6.1

The FSDL Software Library (the "Software") is developed by and belongs to the OP3FT.

The archive file of the Software includes the reference implementation, its wrappers, and sample programs.

The Software must be used in compliance with the Frogans Technology User Policy, accessible at the following permanent URL: https://www.frogans.org/en/resources/ftup/access.html.

By downloading and using the Software, you agree to and undertake to be bound by the version in force of the Frogans Technology User Policy.

Sample programs included in the "sample-programs" directory in the archive file are provided by the OP3FT to help you create your own programs. You are free to use, copy, distribute, modify, adapt, or share these sample programs.

The Software uses third-party source materials which are credited in the "COPYRIGHT-AND-LICENSE" directory available in the archive file of the Software.

FSDL Software Library - Alpha 0.6.1