DiagramIDE
DiagramIDE logo

DiagramIDE

Technical Information Sheet

DIDE 1.0

Working Draft

DiagramIDE

Diagrams as source files.

General Description

DiagramIDE is a small workspace for writing Pikchr diagrams, previewing the rendered result, and keeping related source fragments in one place.

The system is intended for users who prefer diagrams to remain inspectable as text.

A diagram may be written directly, assembled from named fragments, or generated from a small program.

Primary input is Pikchr. Generated input may be produced with Prolog DCGs, Tcl, or Ruby.

Rendered output may be exported as SVG, PNG, transparent PNG, or copied as Pikchr source.

1 Source

Pikchr editor, plain text fragments, named editors

1.1

2 Generation

Prolog DCG, Tcl, Ruby output to Pikchr

1.2

3 Composition

!!name!! includes raw source

1.3.1

$$name$$ includes generated output

1.3.2

4 Workspaces

Related editors, render windows, snippets, and experiments

1.4

5 Export

SVG, PNG, transparent PNG, generated Pikchr source

1.5

Operating Sequence

  1. Write. Create the diagram in Pikchr, or generate Pikchr when the structure is repetitive.
  2. Inspect. Keep the source and rendered diagram visible at the same time.
  3. Reuse. Move repeated shapes, labels, or layout fragments into named editors.
  4. Export. Produce an image or copy the generated source when the diagram is ready.

Specimens

The examples below show the editor and rendered output as working windows. They are included as product specimens, not decorative illustrations.

  1. Pikchr may be written directly
  2. Ruby may generate Pikchr
  3. Prolog may generate Pikchr
  4. TCL may generate Pikchr

Finished diagrams may be exported in several forms.

Pikchr code window connected to rendered diagram output
Fig. 1.1 Direct Pikchr source and paired render window.
Ruby code window above rendered diagram output
Fig. 1.2 Ruby output used to generate Pikchr.
DiagramIDE export menu with SVG, PNG, transparent PNG, and Pikchr code options
Fig. 1.3 Export formats.

1.0