User's Manual

Interface items are: drawing, pointer, info panel, toolboxes, system and context menu, command line, logs.

Program's Architecture

Note, that pointer, menu, toolboxes, external executable's output and command line are just front-ends for the commands server and the objects server. Both servers execute given commands. Commands server performs commands immediately, objects server more friendly, it gives hints and waits for parameters.

Commands may be joined with parameters and another commands by using "|" symbol. For example, to create point you have to type in command line "point", press "Enter", then read hint from objects server, type "100 150", and hit "Enter" again; another way - simply type "point|100 150" and hit "Enter".

Parameters for commands server's have to be joined with it's command.

First Server's Commands

Commands server recieves all commands, it executes command intended for Engy properties changes or drawing rendering.

logo

Shows logo. No parameters.

cl_set_hint

Sets text for command line's hint. New text as a parameter. Intended for system use.

cl_toggle

Hides/Shows command line. No parameters.

log_toggle

Hides/Shows logs. No parameters.

info_toggle

Hides/Shows info panel. No parameters.

undo

Undo user's actions. No parameters.

redo

Redo user's actions were undone. No parameters.

_zoom_in

Zooms in. No parameters.

_zoom_out

Zooms out. No parameters.

_left

Moves drawing to the left. No parameters.

_right

Moves drawing to the right. No parameters.

_up

Moves drawing up. No parameters.

_down

Moves drawing down. No parameters.

_best_fit

Zooms drawing for window size. No parameters.

_set_show_thickness

Turnes on/off line thickness rendering. As a parameter: -1 off, 0 toggle, 1 on.

_set_segnum

Sets number of segments for lines' ends. Value 1 means rectangles, 2 rectanglish hexagonals, and so on.

_set_arcnum

Sets number of segmens for arcs, circumferences, ellipses. As a parameter number of segments for one arc is given. Recommended range of values 8-360.

_set_prec

Floating point numbers precision. As a parameter number of figures after radix character.

_set_monitor

Sets monitor resolution. Used for text rendering as a raster images. It means that for text with height 5 mm and monitor resolution 96dpi picture with height 19 pixels will be used. (5 * 96 / 25.4). As a parameter new value of monitor resolution is used.

_set_paper

Sets printer resolution. Used for images saving and printing. New value as a parameter.

_set_line_style

Sets current linestyle for shell and all selected objects. Style's name as a parameter.

_set_color

Sets current color for shell and all selected objects. New color in RGBA 4 values separated by spaces as a parameter.

_set_bg_color

Sets drawing sheet color. New color in RGBA 4 values separated by spaces as a parameter.

_set_thickness

Sets current line thickness for shell and all selected objects. thickness as a parameter.

_set_snap

Sets mouse snap. As a parameter floating point number is used. Enter 0 for no snap.

_set_line_scale

Sets current linestyle scale for shell and all selected objects. New value as a parameter.

_set_hatch_style

Sets current hatchstyle for shell. Style's name as a parameter.

_set_text_style

Sets current textstyle for shell. Style's name as a parameter.

_set_gravity

Sets current garvity for shell and all selected text and image objects. As a parameter 2-letters gravity is used, "MC" for middle-center as an example.

_set_text_height

Sets text height for all selected text objects. New value as a parameter.

_set_layer

Sets current layer for shell. Layer's name as a parameter. If there's no layer with that name, new layer will be created automatically.

_clean

Forces redraw of main window if it has video garbage artefacts. No parameters.

_exit

Exits Engy shell. No parameters.

As it was told, parameters should be joined with commands from this list. For example "_set_line_style|solid".

Objects Server's Commands Review

This server changes drawing's objects properties using commands listed. All commands are interactive.

new_drawing

New sheet creation. All objects from old drawing are inhereted.

new_layer

Interactive new layer creation.

line

Line creation.

rectangle

Rectanlgle creating.

run_script

External executable execution.

point

Point creation.

circle

Circumference creation.

arc

Arc creation.

ellipse

Ellipse creation.

earc

Ellipse arc creation.

image

Putting image from file into drawing.

text

Text insertion.

dim_h

Horizontal dimension creation.

dim_v

Vertical dimension creation.

dim_a

Aligned dimension creation.

hatch

Hatchng.

start_sel

Objects selection by rectangle. Used by system.

start_desel

Object desection by rectangle. Used by system.

select_all

To select all.

deselect_all

To deselect all.

inverse_selection

Toggle selection state for all objects.

clone

Clone selected objects.

move

Move selected objects.

rotate

Rotate selected objects.

mirror

Mirror selected objects.

trim

Trim selected objects.

array

Create array of selected objects.

polar

Create polar array of selected objects.

scale

Scale selected objects.

scale_xy

Scale selected objects by X and Y differently.

set_line_style

Set linestyle for selected objects.

set_color

Set color for selected objects.

set_thickness

Set line thickness for selected objects.

set_line_scale

Set linestyle scale for all selected objects.

set_gravity

Set garvity for all selected text and image objects.

set_text_height

Set text height for all selected text objects.

set_text

Set text content for all selected text objects.

set_image_scale

Set scale factor for all selected raster image objects.

set_layer

Set current layer.

hide_layer

Hide all objects of the current layer.

show_layer

Show all objects of the current layer.

show_layers

Show objects of all layers.

hide_layers

Hide objects of all layers.

save

Flushes data on disk. Currently makes little sence.

save_as

Makes copy of drawing database.

open

Runs new Engy shell with drawing.

copy

Sends copies of selected objects to clipboard.

cut

Sends selected objects from drawing to clipboard.

paste

Pastes objects from clipboard.

delete

Deletes selected objects. Objects may be recovered later.

save_image

Save drawing as an raster image file.

help

Opens help page.

Coordinates Entering

Single point coordinates may be given in 4 forms:

Using Pointing Device

Pointer is used for:

  1. objects selection;
  2. coordinates entering;
  3. navigation within drawing space.

Usually pointer is used for objects selection/deslection.

Pressing left button causes coordinates entering. This is useful in a set of commands. You may press Shift and in that case one of the coordinate values will be ignored and old value used.

Use middle button to drag drawing, and scroller for zooming in/out. You may use Ctrl + left/right button for zooming in/out if you have no scroller.

Menu and Toolbars Using

In order to make work more comfortable commands ranked in system menu. Offten used commands available from context menu and toolbars.



© 2002 glassy