Fpvectorial - Text Document Support

This is an old revision of Fpvectorial - Text Document Support, edited by Mike.cornflake at . The current revision is 93286.

(This page is currently under construction. I can't find how to hide this page while I'm working on it, so if you have accidentally stumbled across it: move along, move along, nothing to see here :-) )

FPVectorial - Document Support

Background

The fpvectorial library can be used to create formatted text files in a variety of file formats. Current file support includes Open Document XML (odt) and Open Office XML (docx). The files can be opened in a variety of products including Microsoft Office, OpenOffice and LibreOffice.

As the name suggests, the FPVectorial library was originally created solely as a vector based image library. Support for creating documents was added to FPVectorial as the existing architecture already had the concept of a Document containing Pages, and it's architecture was easily extendable. Document support was added beside the existing image handling classes. Vector based images are differentiated from office documents by the type of page added to TvVectorialDocument. At this time, two different pages can be added to TvVectorialDocument:

Currently there are two Office Document writers.

Instead of focusing on the requirements of each individual file format, Office Document support inside FPVectorial was added by creating and implementing a Document Class Hierarchy. It is then up to each individual reader and writer to interpret this class hierarchy. Alternative Library - fpOdf
If you want to produce an ODT file by concentrating on the File Format, then the fpOdf library implemented by dgaspary and made available on the forums is recommended. This allows fine control when creating an ODT file, including many options not provided by FPVectorial - Document Support. A deeper understanding of the file format specification is required when using fpOdf, this complexity is hidden when using FPVectorial. Forum Link: Topic: fpOdf - Creating and modifying OpenDocument ODF files with freepascal

Download

fpvectorial comes in the Lazarus SVN, in the directory components/fpvectorial:

svn co http://svn.freepascal.org/svn/lazarus/trunk/components/fpvectorial fpvectorial

See also fpvectorial

Roadmap

Functionality OpenDocument (ODT) Office Open XML (DOCX)
File Version ODT 1.2 with extensions ECMA-376 1st Edition (2006)
Supported Style Types Paragraph and Text-Span Paragraph and Text
Table Support Yes Yes
List Support Partially Implemented (Bullets only) Partially Implemented (Bullets only)
Multiple Headers/Footers Not yet Yes
Tables in Header/Footer Not yet Not tested
Image Support Not yet Not yet
Images in Header/Footer Not yet Not yet
FPVectorial Image Support Not yet Not yet
Tab Stops Not yet Not yet
Document Fields Not yet Not yet
Meta Data Partially Implemented Not yet
Table of contents Not yet Not yet
Footnotes Not planned Not planned
Review/Revision Not planned Not planned
Bookmarks / Hyperlinks Not planned not planned
Comments Not planned Not planned

Hello World Example

The following code will produce a "Hello World" document. As no styles are defined, it is entirely up to the program used to open the resulting files (Microsoft Word, LibreOffice Write etc) to determine font and font size...

Program HelloWorld;

{$mode objfpc}{$H+}

Uses
  fpvectorialpkg, fpvectorial;

Var
  Document: TvVectorialDocument;
  Page: TvTextPageSequence;
  Paragraph: TvParagraph;

Begin
  Document := TvVectorialDocument.Create;
  Try
    Page := Document.AddTextPageSequence;
    Paragraph := Page.AddParagraph;
    Paragraph.AddText('Hello World!');

    Document.WriteToFile('Hello_World.docx', vfDOCX);
    Document.WriteToFile('Hello_World.odt', vfODT);
  Finally
    Document.Free;
  End;
End.

Basic Concepts

Code Examples

Styles

This example uses both the default styles that can be added to TvVectorialDocument via AddStandardTextDocumentStyles, and a Text-Span style added specifically to TvVectorialDocument. Text-Span styles should not be applied to Paragraphs, only to individual Text Spans within a Paragraph.

Uses
  fpvectorialpkg, fpvectorial;

Var
  Document: TvVectorialDocument;
  Page: TvTextPageSequence;
  Paragraph: TvParagraph;
  BoldTextStyle: TvStyle;

Begin
  Document := TvVectorialDocument.Create;
  Try
    //  Adds the defaut Paragraph Styles
    //    StyleTextBody, StyleHeading1,
    //    StyleHeading2 & StyleHeading3
    Document.AddStandardTextDocumentStyles(vfUnknown);

    // Add our own Style
    BoldTextStyle := Document.AddStyle();

    BoldTextStyle.Kind := vskTextSpan;
    BoldTextStyle.Name := 'Bold';
    BoldTextStyle.Font.Bold := True;
    BoldTextStyle.SetElements := BoldTextStyle.SetElements + [spbfFontBold];

    // Create the Document
    Page := Document.AddTextPageSequence;
    Paragraph := Page.AddParagraph;
    Paragraph.Style := Document.StyleTextBody;

    // Add Hello World as two text spans within the same paragraph,
    // and make 'World' bold
    Paragraph.AddText('Hello ');
    Paragraph.AddText('World!').Style := BoldTextStyle;

    Document.WriteToFile('Hello_World.docx', vfDOCX);
    Document.WriteToFile('Hello_World.odt', vfODT);
  Finally
    Document.Free;
  End;
End.

Output of extended Hello World! program

Simple Table

Table with Merged Cells

Known Issues

TODO

General

New Code

See Roadmap above...

Partially complete

ODTWriter