Types of EDAPT Objects

EDAPT Objects. What are they?


EDAPT Objects are automatically generated Symbols, which play different roles in the creation and control of Smart Magnet Rigs. Each type of EDAPT Object resides on an automatically created Service Layer. The names of these layers must not be changed.

There are five types of EDAPT Objects:

Look Type Layer name Created by Interacts with
Center Marker CenterMarker Create Magnet Target Or Center Marker Alt+`(tilda/~ key)
SMR Helpers 
FreeStyle Rigging Tool 
Smart Magnet Joint,
Clean Up
Magnet Target MagnetTargets Create Magnet Target Or Center Marker Shift+`(tilda/~ key)
SMR Helpers 
FreeStyle Rigging Tool 
Smart Magnet Joint,
Clean Up,
KineFlex (IK)
FK Extender FKExtender Create And Manage IK Objects Ctrl+Shift+F1(extender)
SMR Helpers 
 
KineFlex
SMR Effector SMR_Controllers Create And Manage IK Objects Shift+F1(effector)
SMR Helpers 
KineFlex,
Smart Magnet Joint,
SMR Helpers
SMR Brace SMR_Controllers Create And Manage IK Objects Alt+F1(brace)
SMR Helpers 
KineFlex,
Smart Magnet Joint,
SMR Helpers

Location of EDAPT Objects

All EDAPT Objects reside in a single Library Folder, called EDAPT objects.
Do not rename or move EDAPT objects folder.

Creation of EDAPT Objects

Since the EDAPT Objects are a crucial part of each Smart Magnet Rig and instrumental to the use of Forward and Inverse Kinematics, we are providing multiple ways of creating them.

The primary method would be calling the respective commands - Create Magnet Target Or Center Marker and Create And Manage IK Objects from the Commands menu - via the EDAPT Shortcuts.

Alternatively, the same functionality is available as 5 dedicated buttons in the SMR Helpers panel.

Note: If you are experiencing errors while creating EDAPT Objects, please, check the Known Issues section.

Types and functions


Center Marker (CM)

Creation
Center Markers can be created in one of three ways:

They are also automatically added by the FreeStyle Rigging tool.

Description
Center Markers are fully transparent objects, which are only visible in Outline mode.
CenterMarker layers are blue and CMs look like a blue diamond with a small cross indicating its center.

Function
Upon creation the Center Marker is automatically placed over the Registration point of the symbol and the CenterMarker layer is visible by default. This allows the location of the Registration point to be easily seen and also automatically detected from within other Symbols.

Center Markers assist the Smart Magnet Rigging process. Their location is detected by Smart Magnet Joint during the manual placement of Magnet Targets.

After the rig is complete they are no longer explicitly necessary, but can still be useful as visual aid, so good practice would suggest to keep them.
Center Markers do not carry any SMR info (metadata).

Visibility upon export
Center Markers are fully-transparent and are always invisible when animation is exported to SWF, video, GIF, PNG sequence or Html5/Canvas.

Magnet Target (MT)

Creation
Magnet Targets can be created in one of three ways:

They are also automatically added by the FreeStyle Rigging tool.

Description
Magnet Targets are fully transparent objects, which are only visible in Outline mode.
MagnetTargets layers are red and MTs look like a red circle with a small cross indicating its center.

Function
Upon creation the Magnet Target is placed at the center of view. It should then be positioned to match the Center Marker (i.e. the Registration point) of a child Symbol.
This is done by moving the MT with the Transform or Free Transform tools in close proximity to a Center Marker and pressing `(tilda/~ key to the left of 1/! and below Esc). Smart Magnet Joint (SMJ) will take care of the rest and position the MT exactly over the CM in the other Symbol.

MagnetTargets layer is guided by default to reduce visual clutter at joints, but can be unguided and made visible if the user prefers so. Defaults can be set in the command's preferences in EDAPT Control Panel or Quick Settings F12.

Magnet Targets are an important element of the Smart Magnet Rig system. They indicate the active magnetic points of joints.
During the process of SM Rigging, Magnet Targets are tagged with SMR info.
This SMR info is then processed by Smart Magnet Joint, Clean Up and KineFlex while creating IK chains.

Magnet Targets can be copied from frame to frame. They can also be tweened. If necessary multiple MagnetTargets layers can be present so that there is only one MT per layer and Classic tweening is possible.

The SMR info (metadata) in MTs can be inspected and manually edited if necessary, by using Edit Magnet Targets from the drop-down menu in Smart Magnet Rig panel or the dedicated button in SMR Helpers.

Visibility upon export
Magnet Targets are fully-transparent and are always invisible when animation is exported to SWF, video, GIF, PNG sequence or Html5/Canvas.

FK Extender (Extender)*

Creation
FK Extenders can be created in one of three ways:

  • Holding down the Ctrl+Shift keys while choosing Create And Manage IK Objects from the Commands menu.
  • Using the EDAPT Shortcut Ctrl+Shift+F1(extender) or a user assigned shortcut involving Ctrl+Shift modifiers.
  • Pressing the dedicated button in SMR Helpers panel.

*Please note: FK Extender is only available in EDAP Tools Premium.

Description
FK Extenders appear as a light blue circle.
FKExtender layers should only be unlocked while adjusting the position and size of the Extender and kept locked at all other times.

Function
Upon creation the Extender is placed some distance away from the Reg point of the symbol. FKExtender layer is automatically locked. Leaving it unlocked can interfere with the work of the FreeStyle Rigging tool.

FK Extender is used as a convenient extension handle in all cases when an element is too short to be comfortably manipulated by KineFlex.

As shown in the illustration FK Extender is placed inside the neck symbol, which allows it to be controlled much more precisely and comfortably with KineFlex.

Visibility upon export
FK Extenders will not be visible while publishing SWF previews, but will show up on video, GIF, PNG sequence in AS3 or Html5/Canvas documents. Before exporting to any of these formats, double-click the FK Extender Library item in Library > EDAPT objects and guide the layer. All Extenders will disappear. If you unguide the layer later they will reappear in their places. In Flash CS if the document type is AS2 they do not export.

Note: FK Extender will not be visible if Control > Enable Simple Buttons is checked for the current document.

SMR Effector (Effector, IK Effector)*

Creation
SMR Effectors can be created in one of three ways:

  • Holding down the Shift key while choosing Create And Manage IK Objects from the Commands menu.
  • Using the EDAPT Shortcut Shift+F1(effector) or a user assigned shortcut involving Shift as modifier.
  • Pressing the dedicated button in SMR Helpers panel.

*Please note: SMR Effectors are only available in EDAP Tools Premium.

Description
Attached SMR Effectors are black circles with a clockwise or counter-clockwise arrow indicating direction. Detached SMR Effectors are black circles.

Upon creation Effectors are placed on a guided layer called SMR_Controllers. This layer should not be renamed. Users can manually create more SMR_Controllers layers if they want to organize their Controllers into groups for convenience.

Function
SMR Effectors are used as handles to manipulate IK chains via SMR KineFlex.
To function they should always reside on a service layer called SMR_Controllers.

Detached Effectors can be attached to suitable elements of a Smart Magnet Rig by Shift-dragging and dropping them over the element. Upon release the Effector will snap into position over the element's Magnet Target. (When multiple MTs are present one of them needs to be isolated on a separate (top) MagnetTargets layer. Read below.**)
Attached Effectors can be detached by Shift-dragging them away from their controlled element.

Attached Effectors can be flipped horizontally to change their direction.
They also have two different states – RIK Active and RIK Inactive. Switching between the two can be done by Alt-Shift-clicking on an Effector with KineFlex or by using the dedicated button in SMR Helpers panel.

Attached Effectors contain metadata. They know the IK chain they belong to and may also hold information about IK joint range constraints. Effector Properties dialog can be called by pressing Alt+G(effector properties) or via the dedicated button in SMR Helpers panel.

SMR Effectors can be snapped to their controlled elements at any time either by pressing `(tilda/~ key to the left of 1/! and below Esc) when there is nothing selected or when only Effectors are selected. They will also snap back when SMR_Controllers layer is set to visible F1(visibility). This can also be achieved via the dedicated button in SMR Helpers panel.

Default size and opacity of SMR Controllers can be set in the Create And Manage IK Objects preferences in EDAPT Control Panel or Quick Settings F12.

Visibility upon export
SMR Effectors are always placed on guided layers which do not export to SWF, video, GIF, PNG sequence or Html5/Canvas.

**Attaching a SMR Effector to an element which has more than one Magnet Target inside

When an element has multiple MTs inside, the user has to specify one which will become the Primary MT for SMR IK interactions, i.e. the MT to which the Effector will attach and snap.
To do so this Magnet Target has to be isolated from the rest on a separate MagnetTargets layer above the existing MagnetTargets layer(s) that hold all other MTs.

When you Shift-drop a SMR Effector over an element that has more than one MT inside, you will be automatically taken inside the symbol to specify which will be the Primary MT for IK purposes.

A blank new MagnetTargets layer will be created above the existing one(s).
All you need to do is choose which will be your Primary MT, select it, Cut it and Paste it In Place on the new MagnetTargets layer.

Then exit the Symbol and Shift-drop the Effector over it. This time it will snap over the Primary Magnet Target. 

Video demonstration - Defining Primary Magnet Target

SMR Brace (Brace, IK Brace)*

Creation
SMR Braces can be created in one of three ways:

  • Holding down the Alt key while choosing Create And Manage IK Objects from the Commands menu.
  • Using the EDAPT Shortcut Alt+F1(brace) or a user assigned shortcut involving Alt as modifier.
  • Pressing the dedicated button in SMR Helpers panel.

*Please note: SMR Braces are only available in EDAP Tools Premium.

Description
SMR Braces are black X-s with circular handles at the ends of the diagonal lines.

Upon creation Braces are placed on a guided layer called SMR_Controllers. This layer should not be renamed. Users can manually create more SMR_Controllers layers if they want to organize their Controllers into groups for convenience.

Function
SMR Braces are reserved objects for additional SMR IK functionality which will be added in future versions of EDAP Tools.

Visibility upon export
SMR Braces are always placed on guided layers which do not export to SWF, video, GIF, PNG sequence or Html5/Canvas.

Known Issues


System Clipboard interference

A known issue with all versions of Flash and Animate is that data stored temporarily in the System Clipboard can be exposed to interference by other programs running at the same time as Flash/Animate. This can cause an error during EDAPT Object creation or insertion.

If on the background you are running OpenOffice, Oracle VM VirtualBox or Macromedia Director, the commands may fail to create or insert EDAPT Objects, resulting in an error message:

Another possible manifestation of the Clipboard issue:

If you see any of the above messages while in the process of creating a Magnet Target, Center Marker, FK Extender, SMR Effector or SMR Brace, or while using the FreeStyle Rigging tool or changing the Master Parent, you need to take some steps to prevent Clipboard interruptions.

You have the following options:

  1. Press OK when you see the first warning dialog. It will switch on EDAPT Objects Compatibility mode, explained below.
  2. Switch on EDAPT Objects Compatibility mode from EDAPT Control Panel > Miscellaneous Alt+0

    Note that compatibility mode will most likely be Clipboard error proof, but will also remove some flexibility from EDAPT Object creation, for example, MTs and Controllers in Compatibility mode will be placed near the Registration Point and not in the center of the visible area, which can be disorientating.

  3. Determine by trial and error which program* that you run in the background interferes with your System Clipboard and keep it closed while rigging. If you see an error message, it is usually enough to just close the interfering software and you would be able to continue rigging without restarting Flash/Animate.
    Only in very rare occasions the creation or insertion of an EDAPT Object can be so badly broken that you will need to restart Flash/Animate.

*This is a list of the programs which we have identified as interfering with the System Clipboard:

  • OpenOffice
  • Oracle VM VirtualBox
  • Macromedia Director

Avoid having them open in the background while you are rigging and actively creating EDAPT Objects.

The list is most likely incomplete.

If you identify another piece of software causing the same problems, please, post in the comments below or let us know via email. 

 
Comments

No comments yet.

Leave a Reply