Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Profiles can have arbitrary (nonemptySee the following videos to illuminate editing of the Selector profiles.

AddTextToHandle.mp4

CreatingNewControl_FlatGrid3x3.mp4

glassbox1.mp4

glassbox2.mp4

glassbox3.mp4

 

Profiles can have an arbitrary (non zero) number of handles, with which can access any available transformations, including non-interactive (for example, coordinate axes). Filtering of the handles in the current profile can be done by using filters by type of transformation from the selector settings dialog.

Filtering          Filtering handles of the current profile by type of transformation


User A user can create his own profiles or modify existing ones. There are, however, certain specific characteristics of profile loading that need to be observed. To save time on reading the TCW file, profiles are unloaded only when the application is closed. Otherwise they would have to be opened/closed upon each activation of the corresponding dragger (for example, selector)tool. This would have slowed down the work significantly. So if a profile is already uploaded to memory, reloading it (for instance, after editing) is possible only after restarting the application. New A new profile can be set up without an application restart. When we give user the ability to develop profiles, it is desirable to also provide a set of development tools. For example, 'Reload profile' button and the ability to create current profile report, which would show the number of handles, loading errors, etc. I hope this will be added in future.

...

Samples

The Samples folder contains several examples of different profiles. It makes sense to start all new templates from by using the template.tcw, which contains the minimum set of handles and also includes all required variables (graphic`s custom properties).

Template                      Template.TCW profile

Defined custom properties.
AnchorOLE_LINK27OLE_LINK27 AnchorOLE_LINK28OLE_LINK28 in the Database Define Fields dialog


The MoveRotate2D.TCW sample demonstrates the possibility to create of creating a selector in a "protractor" style. It contains 12 handles for movement along axis, positioned at every 30 degrees, and a handle for rotating around the Z axis.

AnchorOLE_LINK25OLE_LINK25 AnchorOLE_LINK26OLE_LINK26 AnchorOLE_LINK33OLE_LINK33                      MoveRotate2D.TCW profile

 
The FlatGrid3x3.TCW example demonstrates the possibility to create a flat 5x5 grid from handles for accurate movement in the XY plane (reference point). Grid spacing is AnchorOLE_LINK31OLE_LINK31 AnchorOLE_LINK32OLE_LINK32 1 is 1 in. A specific feature of this grid is that the distance between handles (1 in) does not change when zooming in/out. Ability to set fixed values of coordinates (in a selector coordinate system) allows for placing selector handles in at critical points for drawing objects (for example, focal plane of the lens or focuses of an ellipse).

AnchorOLE_LINK34OLE_LINK34 AnchorOLE_LINK35OLE_LINK35 AnchorOLE_LINK29OLE_LINK29 AnchorOLE_LINK30OLE_LINK30 FlatGrid3x3.TCW profile
Image Removed
AnchorOLE_LINK52OLE_LINK52 AnchorOLE_LINK53OLE_LINK53 FlatGrid3x3.TCW profile, shown dynamically. Animated GIF (Animation only in HTML version)

...

AnchorOLE_LINK5OLE_LINK5 AnchorOLE_LINK6OLE_LINK6                       FlatGrid3x3.TCW profile  



Layers

All profiles that are distributed with TurboCAD have a certain system of layers. Each handle has its own layer. This provides a way to hide unnecessary handles.
AnchorOLE_LINK46OLE_LINK46 AnchorOLE_LINK47OLE_LINK47
Layers whose names have the "handle_") prefix  prefix are used for handles. For example, the "handle_MoveX" AnchorOLE_LINK50OLE_LINK50 AnchorOLE_LINK51OLE_LINK51 layer  layer contains the handle for movement along the X axis.
Layers whose names have the " AnchorOLE_LINK48OLE_LINK48 AnchorOLE_LINK49OLE_LINK49part_") prefix are used for parts of handles. For example, the "part_MouseIn" layer contains the geometry that becomes visible when the cursor hovers over the handle.

Fragment of layer table from a profile.

It should be noted that this system of layers exists only as an added convenience for profile development. When a profile is uploaded into the application, layer 0 is assigned to all handles.

...

When a profile is uploaded into the application, the loader analyzes graphics and uses certain criteria to identify handles. A handle is a 'group' graphic that has a certain set of subgroups and a set of custom properties. Graphics that do not meet these criteria are ignored.
anchor

OLE_LINK65OLE_LINK65 AnchorOLE_LINK66OLE_LINK66A handle has to have several mandatory AnchorOLE_LINK56OLE_LINK56 custom properties (of text type) mandatory custom properties, of the 'text', type that define its name, position, transformation type, etc.

In addition to mandatory custom AnchorOLE_LINK57OLE_LINK57 propertiescustom properties, there are optional properties. These properties are used by the program to determine the purpose, behavior, appearance of the handle, and its response to mouse movement. User A user can set other admissible values and change the handle behavior that way.

AnchorOLE_LINK60OLE_LINK60Set of variables for AnchorOLE_LINK58OLE_LINK58 AnchorOLE_LINK59OLE_LINK59                         Set of variables for the Boundary Box handle.

                              Set of variables for AnchorOLE_LINK94OLE_LINK94 AnchorOLE_LINK95OLE_LINK95 MoveX handle.


The current set of variables is not final as of this writing, it can may be changed and expanded.
A handle has to include a certain set of subgroups.

Each of the subgroups is responsible either for drawing of for the behavior of the handle. Type

The type of the subgroup is set by the AnchorOLE_LINK67OLE_LINK67 AnchorOLE_LINK68OLE_LINK68 handle_the handle_part variable:

                                     'handle_part variable'

This variable can have one of the following values: AnchorOLE_LINK92OLE_LINK92 AnchorOLE_LINK93OLE_LINK93mouseout AnchorOLE_LINK73OLE_LINK73 AnchorOLE_LINK74OLE_LINK74

  • mouseout - visible geometry when the cursor is outside the handle

...

  • mouseover - visible geometry when the cursor is over the handle

...

  • active - visible geometry while

...

  • dragging (optional)
  • static-

...

  •  visible geometry (optional)

...

  • coordsystem - invisible geometry, defining the coordinate system of the handle
  • highlight_area - invisible geometry, turns on mouseover, when the cursor is over it. If this part is absent, mouseout (optional) is used instead.
  • visibility_area - reserved (optional)



Parts                              Parts of MoveX handle