Jeszra
   →

Jeszra

Design by Gestalt

Arndt Roger Schneider

Copyright © 2009, 2010 Arndt Roger Schneider

This book is published under the Creative Common License.

The copyright holders make no representation about the suitability of this software for any purpose. It is provided “as is” without expressed or implied warranty.

Trademark Notice

Microsoft, Microsoft Windows, Windows 95 are trademarks of Microsoft Corporation.

Apple Inc., MacOS, OS X, AQUA, Xcode, iTunes are tradmarks of Apple Inc.

Bitstream, Bitstream Vera are trademarks of Bitstream Inc.

Jeszra is an advanced vector graphics application written in Tcl/Tk.

It generates source code for Tcl/Tk, Ruby, Python and Lisp.

Supportive editing macros for Emacs and Apple® Xcode.

Scalable Vector Graphics import and export.

Generates DocBook reference manuals.

Table of Contents

Preface
Revision Control
Software License
1. Introduction
How this Book is Organized
The Gestalt of Software
Through the Looking Glasses
Software Design and Construction
Purpose of a GUI-Builder
Jeszra in Particular
Installation and Using Jeszra
Installation
Starting Jeszra
Jeszra Environment
Generated Files
Tcl/Tk
TkZinc 3.3.4
Images
tDOM
Fonts
Scalable Vector Graphics
DocBook
Jeszra Functionality
Mission
Geometry Management
Supported Window Libraries
Vector Graphics
Contents
The Jeszra Round-Trip
New Project
Composing
Automation
Navigation
Manipulation
Utilities
2. Building Blocks
Tcl/Tk Geometry Managers
Introduction
All-Purpose Geometry Manager
Windows
Introduction
Canvas, Text, Panedwindow
Actors
The Tk Palette
Gestalt Items
Runtime Library
Allerlei
3. Using Help lines
Introduction
Dynamic Help lines
TkZinc 3.3.4 and Canvas
Introduction
Snap to Help lines During Creation
Normal placed Help lines
Embedded Help lines
Grid Points
Place Geometry Manager
Grid Manager and Grid Lines
4. Design
Visual Complexity and White Space
Internal and External White Space
Text and Icons
Colours, Gradients and Pattern
Group Boxes
Focus Frame
Experimental Layout using Pack
Pack at a Glance
A Simple Gridwin using Pack
Summary Pack Layout
Abridged Chapter
5. Design Examples Explained
Introduction
Jeszra on AQUA®
Bright Designs under X Window System
LightX11
GrayX11
WhiteX11
Dark Designs under X Window System
SafariX11
BlackX11
Miscellaneous Designs
SeaX11
Minor Designs
Inside Documentation
6. Vector Graphics
Introduction
Graphic Palettes
Tk Canvas
TkPath
TkZinc 3.3.4
Creating Graphical Objects
Introduction
Creating an Graphical Object
Interactive Object Creation
Using Splines
Abridged Chapter
Importing Scalable Vector Graphics
Requirements
Import
Limitations
7. Template Interfaces
Introduction
Option Database
Shapes
Colour
Contents
Tile
Functional Aspects
8. Events
bindtags
Bind
Abridged Chapter
Events inside of Windows
9. Documentation
Introduction
DocBook
DocBook Overview
refentry and Entities
XAE Emacs Commentary Block
Creating Documents
Standard Properties
Specific Properties
Commands (Messages)
Modules
Packages
Multi Language Documentation
Commenting Wrappers
Manual Pages for Lisp
Manual Pages for Ruby
Manual Pages for Python
API Documentation
10. Documentation Generation
Introduction
Abridged Chapter
Commands and Commentary
Packages
Module
11. Custom Jeszra
Introduction
Preferences
Common
Advanced
Environment Variables
Settings Variables
Unknown Geometry Manager
Customize Palettes
Creating and modifying Palettes
Modify a Palette and its Items
Inspector Customization
Global Filters
Local Filter
Property Context Menus
Sub Editors
Conditions
Scripts
Introduction
The Script Tool
Customize the Script Tool
Bundled DocBook Files
A. Technical Notes
Abridged Chapter
WWW
Gestalt Items and Runtime Library
Hugelist
TkPath
TkZinc 3.3.4
DocBook
Bitmaps
Scalable Vector Graphics
tDOM
TclSplines
Emacs
Glossary
Index

List of Figures

1.1. Main Window
1.2. Inspector
2.1. Built-In Managers in Hierarchy View
2.2. Window embedded in a Canvas
2.3. Text Managed Window
2.4. Paned Managed Window
2.5. The Built-In Layout
2.6. Tk Canvas Palette
2.7. Tags, formatted Text
2.8. Inspector: Tag Ranges
2.9. General Preferences
2.10. Striped Button Family
2.11. Red-coloured Window Relations
2.12. Menu Palette
2.13. The Tk Palette
2.14. Gestalt Items
2.15. Runtime Library
2.16. Allerlei Palette
2.17. Hugelist
3.1. Jeszra Menubar
3.2. Enable Dynamic Help lines
3.3. Using Dynamic Help lines
3.4. Moving Along Help lines
3.5. The different Help lines Types
3.6. Snap to Help lines During Creation
3.7. Created Object
3.8. Context Menu
3.9. Customize Help lines
3.10. Shell: Insert Help lines
3.11. TkZinc 3.3.4 Help lines before Move
3.12. TkZinc 3.3.4 Help lines after Move
3.13. Edit Embedded Help lines
3.14. Filtered Place Properties
3.15. New Y-Help lines
3.16. Align multiple Buttons
3.17. Gridded Buttons
3.18. Grid lines after dragging a Button
3.19. Column Resize
3.20. Grid after Resize
4.1. Filtered Pack Properties
4.2. Pack is Spatial Oriented
4.3. Options Menu
4.4. Black Re-packed
4.5. Gray padX set to »0 20«
4.6. Read-only Properties
4.7. Unfiltered Pack Properties
4.8. Relevant Gray Pack Properties
4.9. Relevant Red Pack Properties
5.1. Aqua under AQUA®
5.2. LightX11
5.3. WhiteX11
5.4. SafariX11
5.5. BlackX11
5.6. Aquaish General Preferences
5.7. Champagne Coloured
5.8. Recycled Paper
6.1. The Tk Canvas Palette
6.2. The TkPath 0.2 Palette
6.3. Editing the TkPath 0.3 Palette
6.4. The TkZinc 3.3.4 Palette
6.5. Indicated Coordinates
6.6. Salomon’s Star
6.7. Inspector Coordinates
6.8. Smooth Star
6.9. Direct Modified Coordinates
6.10. A Path... Object
6.11. Path with Splines
6.12. Open Curve with Splines
7.1. Preferences: Option DB
7.2. Force And Ignore
7.3. Message Catalog Preferences
7.4. Hugelist
7.5. Hugelist Entries
7.6. Substitution Preferences
8.1. Define an Event
8.2. Modify an Event-Script
8.3. Place holders from the Context Menu
8.4. The Tags Property
9.1. Template Interface Page
9.2. Advanced Preferences
9.3. Local Filter
9.4. Interface DocBook Editor
9.5. DocBook Browser
11.1. The General Preferences
11.2. Jeszra Editing Jeszra
11.3. Advanced Settings
11.4. Palettes
11.5. Modify a Palette
11.6. Modify a Palette Item
11.7. Global Filters
11.8. Script Tool Preferences
11.9. Script Editor

List of Tables

1.1. Major Files generated by Jeszra
1.2. Minor Files generated by Jeszra
1.3. Editor support generate by Jeszra
1.4. Internal Files generate by Jeszra
1.5. Index Files generated by Jeszra
1.6. Vector Graphics
1.7. Vector Graphics continued ...
6.1. Convert a Point into a Cubic Bézier Curve
6.2. Path Coordinates
6.3. Path Coordinates continued...
6.4. Curve Coordinates
7.1. Ttk versus Tk Button Properties

List of Examples

1.1. Customized Code
1.2. Using tDOM
1.3. Standard Configuration
1.4. X Window System Fonts
1.5. AQUA® Fonts
1.6. Microsoft® Windows® Fonts
2.1. Tcl/Tk pathnames
2.2. Tooltip and Status Bar
3.1. Insert Help lines
3.2. Inserting Embedded Help lines
3.3. Snap to Embedded Help lines
3.4. Create Grid Points
3.5. Place Managing two Buttons
4.1. Indicator in Gstripes
4.2. Gstripes using Gradients
4.3. Pattern
4.4. Uniform Gradients in Jeszra
4.5. Multi-Colour Uniform Gradients
4.6. Query Size before Management
5.1. Option Database Code
5.2. Command Line Code
5.3. Using tk scaling
5.4. BigFonts highlightThickness
5.5. BigFonts Fonts
5.6. TkPath Specific Resources
5.7. Jeszra Specific Resources
5.8. The Aquaish Resources
5.9. Excerpt from Champagne Coloured
6.1. Predefined Coordinates
7.1. Classes and Instances
7.2. Command Line Property
7.3. Option Database Properties
7.4. Dominant Properties
7.5. Details of Property background
7.6. Generated Option Database Entries
7.7. Excerpt from .Xresources
7.8. Colour Hue
7.9. Mixing Colours
7.10. Message Catalog Usage
7.11. button versus tk::button
7.12. button versus ttk::button
7.13. Published Background
7.14. SVG Screen Shot
8.1. Event Handler Sets
8.2. Event Handler
8.3. break inside Events
8.4. Other Tags
9.1. Entity Reference
9.2. Using an Entity
9.3. DOCTYPE and Entity.
9.4. DocBook Mode in Emacs
9.5. Property activestyle.xml
9.6. ... XAE activestyle.xml Comments
9.7. Emacs Skeleton for »activeStyle«
9.8. Proc Commentary
9.9. Emacs Skeleton for »proc«
9.10. Emacs Skeleton for DocBook »example«
9.11. »example« used in DocBook
9.12. Template Description
9.13. Generated XML
9.14. rtl_tree module Description
9.15. Injecting DocBook during Extraction
9.16. Entity Definition
9.17. Dependencies
9.18. Lisp Wrapper Commented
9.19. Customized Lisp Refentry
9.20. Generated Ruby
9.21. API Documentation
9.22. Pseudo Project for API-Documentation
10.1. describeProperty
10.2. ...describeProperty, continued
10.3. startproc
10.4. endproc
10.5. startcommentary
10.6. endcommentary
10.7. entities
10.8. Embedded Code
10.9. Generated XML
10.10. allowTags
10.11. Referenced Examples
10.12. The Dependencies Section
11.1. opset
11.2. Alternative Coding Model
11.3. Prototypes
11.4. Include an Unknown Manager
11.5. Code generation for Pack
11.6. ...Code generation for Pack
11.7. Scale Default Set in tcledit.tcl
11.8. History Set in tcledit.tcl
11.9. The Default Sub Editor
11.10. Transparent Colour Condition
11.11. Transparent Colour Registration
11.12. Toolbar Editor from the Shell
11.13. Gfilter DocBook Files
A.1. emacsMode
   →
   Preface
SourceForge Logo

Copyright © 2009–2010 Arndt Roger Schneider