[Main topics] [Navigation]

FMgraph – Graphics and diagrams in FrameMaker

FMgraph is an ExtendScript package which provides functions for creating graphics and diagrams in FrameMaker.
This library was designed to bypass the dysfunction of the ES functions as well as most implementation flaws (Only the most severe were corrected in FM 15.0.3.):

Note: This page does not describe all features of FMgraph. See the full documentation (pdf).

Use cases of FMgraph
Functions of FMgraph
Downloading and installing FMgraph

[To top/bottom of page] Use cases of FMgraph

[To top/bottom of page] Functions of FMgraph

You may wish to read the full documentation.

The script installs a menu item: Graphics > Graphic Library with the sub-menu:
-
Documentation [ESC q g d]
- Search/name object [ESC q g t]

User scripts are set up in ESTK. They act on the open document at the current cursor location:
screenshot of MFgraph usage

The dialogue to identify or find a table or an anchored frame is a palette which stays open while you manipulate the document:
FMgraph panel to identify or find graphic objects

The dialogue to inspect an object or anchored frame is a palette which stays open while you manipulate the document:
FMgraph panel to identify or find graphic objects

[To top/bottom of page] Downloading and installing FMgraph

Note: All software from D+DD is Donationware - if you find it helpful for your work, think about supporting also my work.

  1. Close FrameMaker if necessary.
  2. Download the installation file
  3. FM version Date Version Date Installation file(s) Latest changes

    12 and later

    (older versions miss object property app.UserSettingsDir)

    2019-05-16 1.0 2019-05-16 Inst-FMgraph.zip
    FMgraph-examples.zip
    • First issue of FMgraph
    2019-05-22 1.01 2019-05-22
    • Code comments, colour names de/fr, handling of penSize 0
    • Test scripts amended
    • Documentation revised
    2019-06-19 1.10 2019-06-19
    • Palette "Inspect/assign properties" added
    • Order of objects when traversing document is now in apparent order
    2019-09-11 1.20 2019-09-11
    • Default background colour defined internally, minor bug fixes.
    2019-12-13 1.30 2019-12-13
    • Bypass for error FRMAKER-6610 (grouping purely vertical lines includes the container-origin) implemented for FM < 15.0.5
    2020-03-07 1.40 2020-03-07
    • Bypass for error FRMAKER-2406 (Distributing purely vertical lines enlarges the object area) implemented for FM < 15.0.6
    2020-08-14 1.50 2020-08-14
    • Correcting an error in DrawPolygon; Warning concerning FRMAKER-9134 (FM-16 does not show correct object properties for polygons).
    • Some corrections in sample scripts and documentation.
    • Allow to define FM-version for which to install.
    2021-01-14 1.60 2021-01-14
    • Correcting an error in DrawPolarLine; It didn't do anything due to wrong check for initialisation.
    • Correcting wrong OR statements which caused tilt of FM after successful executing scripts.
    2021-04-30 2.00 2021-04-30  
    • Localisation now uses XML files
    • Correction: errors in colour handling in non-en FM
    • Correction: Assign properties for TextLine did not work as intended. only character format can be applied → to be done with standard methods by user.
    • Find/identify objects: first object was not identified on refresh
    • Correction: error in CollectFramesInBody suppressed the panel Identify Object to appear.
    2021-05-06 2.10 2021-05-06  
    • Correction concerning Help file
    • Change of message handling
    • Before installing a new (updated) version, uninstall the current version: start the installation program from the short cut in the Start-menu > D+DD. Then use the Un-Install button.
    • UnZip the file to the desktop (you get a file and a directory).
    • Execute the file PrepareInstallation.exe (run as Administrator)
      The language of the installation dialogues adapts to the UI language of your current FM installation (de, en, fr).
      This program modifies some values in the file InstallThis\config.ini.
    • All FM-versions present in your %appdata%/Adobe/FrameMaker/ are listed in the dialogue (on your system there may be only one).
      Prepare installlation of FMgraph
    • Select the FM-version for which you want to install FMgraph.
    • Use Continue. This opens the installation program:
      FMgraph installation dialogue
    • Select the appropriate option(s):
    • With Install the script and associated files will be transferred into the relevant locations.
      In maker.ini a section D+DD is established
    • A message indicates the end of the installation. The desktop icons will be removed.
    • You may download FMgraph-examples.zip with the test scripts. They were used for the documentation. Document _FMGraph-tpl.mif therein provides the character formats and background colour defined in the global variables. See Installation and usage of FMgraph > Adaptation of global variables.

    Un-install the script

    To uninstall the script, start the installation program from the short cut in the Start-menu > D+DD; set the option(s) to define what to uninstall; then use the Un-Install button.

    You can later use the installation program again.

    To get completely rid of the script you need to remove the following in addition to the un-installation:

    Caveat

    Any software from D+DD is provided by the author and contributor "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed.

    [Main topics] [Navigation]
     URL:  Created: 2019-05-16  Updated:
    © Docu+Design Daube, Zürich    
      Business of Docu + Design Daube Documentation issues Sharing information Klaus Daube's personal opinions Guests on this site Home of Docu + Design Daube To main page in this category To first page in series To previous page in series To next page in series To bottom of page To top of page Search this site Site map Mail to webmaster To bottom of page To top of page