Manipulation エクステンション¶
Manipulationエクステンションは、ホストDCCアプリケーション及びカスタムツールから伝達されるイベント群に基づいたカスタムユーザーインタラクションモデルを定義するためのツール群を提供します。
マニピュレーションシステムは、柔軟性のある低レベルなAPIを提供します。そのため、提供されるイベントを元にどのようなカスタムツールでも作成可能です。構築されるツールの型またはマニピュレーションの定義方法について条件(想定)はありません。一方、既存の主要DCCでは柔軟性を著しく制限されたAPIが提供されています。なぜならプロダクションのTDが「どのようなツールを必要とするか」についてDCC側が予断をもっているからです。
イベント群¶
マニピュレーションシステムはカスタムイベントの処理を中心に定義されます。イベントは、通常MAYAのようなDCC内で実行するファブリックから送られ、カスタムイベントハンドラーを経由して処理されます。
Fabric Engine内のイベント群はQtによって生成されたイベント群の後に作られます。これらはQtイベントと類似したメソッドを持った KeyEvent や MouseEvent 、 MouseWheelEvent オブジェクトを備えます。これはQtイベントシステムを使用するアプリケーションにマニピュレーションシステムを統合することを容易にします。例えばMAYAはウィンドウ管理のためにQtを使用するので、QtイベントはFabric Engineのイベントに容易に移動でき、 EventDispatcherHandle を経由して EventDispatcher へ送ります。
各Fabric Engineインテグレーションは、ツールのAPIをKLの EventDispatcher に公開したツールからイベントへ変換します。各DCCから送信されるイベント群を確保するためにあらゆる努力を行ってきたのですが、すべてのイベントを伝達することが不可能ないつかのケースがあります。
Mayaではメインウィンドウに直接イベントフィルターがフックされており、全てのQtイベントをKLの EventDispatcher に伝達することができます。Softimageではイベントフィルターをインストールする機能をもっておらず、SoftimageカスタムツールAPIから送られたイベント群に限定されます。
マニピュレータ群¶
一度にアクティブにできるマニュピレータは常に１つだけです。DCCより送られる全てのイベントは、アクティブなマニュピレータに伝搬し処理されます。
イベントがマニピュレーターに送られてもマニピュレーターがイベントを処理しない場合は、イベントはホストDCCアプリケーションに返されます。
Undo Redo¶
マニュピレータがイベント群を処理するとき、Fabric Engineデータの変更を生成できます。これらの変更は、 Host.addUndoRedoCommand メソッドを介してホストDCCのundo & redoスタックに格納できます。これはKLで定義したカスタムマニピュレーターでundo & redoを使用するこを可能にします。
目次¶
None
- Manipulation Extension’s Files
- BaseCmd.kl
- BaseColorAttributePaintTool.kl
- BaseEvent.kl
- BaseGizmoHandler.kl
- BaseHandler.kl
- BaseHandlerDispatcher.kl
- BasePaintTarget.kl
- BasePaintTool.kl
- BaseSRTTarget.kl
- BaseSRTTool.kl
- BaseScalarAttributePaintTool.kl
- BaseSculptTool.kl
- BaseSelectionTool.kl
- BaseSliderTarget.kl
- BaseSliderTool.kl
- BaseTool.kl
- BaseToolDispatcher.kl
- BaseToolTarget.kl
- CameraManipulator.kl
- CameraTool.kl
- Cmd.kl
- CmdManager.kl
- DFGSRTTarget.kl
- DFGSliderTarget.kl
- DFGToolData.kl
- DFGToolTarget.kl
- Event.kl
- EventConstants.kl
- EventDispatcher.kl
- EventDispatcherHandle.kl
- EventHandler.kl
- GizmoHandler.kl
- GizmoManipulationCallback.kl
- GizmoManipulator.kl
- HandlerConstants.kl
- HandlerDescription.kl
- HandlerDispatcher.kl
- Host.kl
- KeyEvent.kl
- ManipHandle.kl
- Manipulator.kl
- MouseEvent.kl
- MouseWheelEvent.kl
- OrientationAxisGizmoHandler.kl
- OrientationAxisGizmoManager.kl
- OrientationGizmosManager.kl
- OrientationSphericalGizmoHandler.kl
- OrientationSphericalGizmoManager.kl
- PaintTool.kl
- PaintToolAttributeStrokeData.kl
- PositionAxisGizmoHandler.kl
- PositionAxisGizmoManager.kl
- PositionGizmoHandler.kl
- PositionGizmosManager.kl
- PositionPlanarGizmoHandler.kl
- PositionPlanarGizmoManager.kl
- RootDispatcher.kl
- SelectionTool.kl
- SliderGizmoHandler.kl
- SurfaceAttributePaintManipulator.kl
- SurfacePaintManipulator.kl
- SurfaceSculptManipulator.kl
- Tool.kl
- ToolConstants.kl
- ToolDispatcher.kl
- ToolTarget.kl
- TransformManipulationCallback.kl
- TransformManipulationCommand.kl
- TransformManipulator.kl
- Weightmap.kl
- Manipulation Extension’s Types
- BaseCmd (object)
- BaseColorAttributePaintTool (object)
- BaseEvent (object)
- BaseGizmoHandler (object)
- BaseHandler (object)
- BaseHandlerDescription (object)
- BaseHandlerDispatcher (object)
- BasePaintTarget (object)
- BasePaintTool (object)
- BaseSRTTarget (object)
- BaseSRTTool (object)
- BaseScalarAttributePaintTool (object)
- BaseSculptTool (object)
- BaseSelectionTool (object)
- BaseSliderTarget (object)
- BaseSliderTool (object)
- BaseTool (object)
- BaseToolDispatcher (object)
- BaseToolTarget (object)
- CameraManipulator (object)
- CameraTool (object)
- CmdManager (object)
- DFGSRTTarget (object)
- DFGSliderTarget (object)
- DFGToolData (struct)
- DispatcherDescription (object)
- EventDispatcher (object)
- EventDispatcherHandle (object)
- GizmoManipulator (object)
- Host (object)
- KeyEvent (object)
- ManipHandle (object)
- MouseEvent (object)
- MouseWheelEvent (object)
- OrientationAxisGizmoHandler (object)
- OrientationAxisGizmoManager (object)
- OrientationGizmosManager (object)
- OrientationSphericalGizmoHandler (object)
- OrientationSphericalGizmoManager (object)
- PaintToolAttributeStrokeData (object)
- PositionAxisGizmoHandler (object)
- PositionAxisGizmoManager (object)
- PositionGizmoHandler (object)
- PositionGizmosManager (object)
- PositionPlanarGizmoHandler (object)
- PositionPlanarGizmoManager (object)
- RootDispatcher (object)
- SliderGizmoHandler (object)
- SurfaceAttributePaintManipulator (object)
- SurfaceAttributePaintManipulator_PaintData (struct)
- SurfacePaintManipulator (object)
- SurfacePaintManipulator_PointCollection (struct)
- SurfacePaintManipulator_StrokePoint (object)
- SurfaceSculptManipulator (object)
- ToolDescription (object)
- ToolModeDescription (object)
- TransformManipulationCallback (object)
- TransformManipulationCommand (object)
- TransformManipulator (object)
- Weightmap (object)
- Manipulation Extension’s Free Functions
