2 Copyright (C) 2001-2006, William Joseph.
5 This file is part of GtkRadiant.
7 GtkRadiant is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 GtkRadiant is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GtkRadiant; if not, write to the Free Software
19 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
23 ///\brief Represents any Doom3 entity which does not have a fixed size specified in its entity-definition (e.g. func_static).
25 /// This entity behaves as a group only when the "model" key is empty or is the same as the "name" key. Otherwise it behaves as a model.
26 /// When behaving as a group, the "origin" key is the translation to be applied to all brushes (not patches) grouped under this entity.
27 /// When behaving as a model, the "origin", "angle" and "rotation" keys directly control the entity's local-to-parent transform.
28 /// When either the "curve_Nurbs" or "curve_CatmullRomSpline" keys define a curve, the curve is rendered and can be edited.
30 #include "doom3group.h"
33 #include "renderable.h"
35 #include "modelskin.h"
37 #include "selectionlib.h"
38 #include "instancelib.h"
39 #include "transformlib.h"
40 #include "traverselib.h"
41 #include "entitylib.h"
43 #include "eclasslib.h"
44 #include "stream/stringstream.h"
47 #include "targetable.h"
53 #include "namedentity.h"
54 #include "keyobservers.h"
57 #include "modelskinkey.h"
61 inline void PointVertexArray_testSelect(PointVertex* first, std::size_t count, SelectionTest& test, SelectionIntersection& best)
65 reinterpret_cast<VertexPointer::pointer>(&first->vertex),
68 IndexPointer::index_type(count),
77 EntityKeyValues m_entity;
78 KeyObserverMap m_keyObservers;
79 TraversableNodeSet m_traverse;
80 MatrixTransform m_transform;
82 SingletonModel m_model;
83 OriginKey m_originKey;
86 RotationKey m_rotationKey;
89 ClassnameFilter m_filter;
92 TraversableObserverPairRelay m_traverseObservers;
93 Doom3GroupOrigin m_funcStaticOrigin;
94 RenderablePivot m_renderOrigin;
95 RenderableNamedEntity m_renderName;
96 mutable Vector3 m_name_origin;
100 NURBSCurve m_curveNURBS;
101 SignalHandlerId m_curveNURBSChanged;
102 CatmullRomSpline m_curveCatmullRom;
103 SignalHandlerId m_curveCatmullRomChanged;
105 mutable AABB m_curveBounds;
107 Callback m_transformChanged;
108 Callback m_evaluateTransform;
111 CopiedString m_modelKey;
114 scene::Traversable* m_traversable;
118 default_rotation(m_rotation);
120 m_keyObservers.insert("classname", ClassnameFilter::ClassnameChangedCaller(m_filter));
121 m_keyObservers.insert(Static<KeyIsName>::instance().m_nameKey, NamedEntity::IdentifierChangedCaller(m_named));
122 m_keyObservers.insert("model", Doom3Group::ModelChangedCaller(*this));
123 m_keyObservers.insert("origin", OriginKey::OriginChangedCaller(m_originKey));
124 m_keyObservers.insert("angle", RotationKey::AngleChangedCaller(m_rotationKey));
125 m_keyObservers.insert("rotation", RotationKey::RotationChangedCaller(m_rotationKey));
126 m_keyObservers.insert("name", NameChangedCaller(*this));
127 m_keyObservers.insert(curve_Nurbs, NURBSCurve::CurveChangedCaller(m_curveNURBS));
128 m_keyObservers.insert(curve_CatmullRomSpline, CatmullRomSpline::CurveChangedCaller(m_curveCatmullRom));
129 m_keyObservers.insert("skin", ModelSkinKey::SkinChangedCaller(m_skin));
131 m_traverseObservers.attach(m_funcStaticOrigin);
133 m_nameKeys.setKeyIsName(keyIsNameDoom3Doom3Group);
136 m_entity.attach(m_keyObservers);
140 m_entity.detach(m_keyObservers);
151 m_traverseObservers.detach(m_funcStaticOrigin);
156 m_traversable = &m_model.getTraversable();
157 m_model.attach(&m_traverseObservers);
162 m_model.detach(&m_traverseObservers);
164 void attachTraverse()
166 m_traversable = &m_traverse;
167 m_traverse.attach(&m_traverseObservers);
169 void detachTraverse()
172 m_traverse.detach(&m_traverseObservers);
180 void setIsModel(bool newValue)
182 if(newValue && !m_isModel)
187 m_nameKeys.setKeyIsName(Static<KeyIsName>::instance().m_keyIsName);
188 m_model.modelChanged(m_modelKey.c_str());
190 else if(!newValue && m_isModel)
195 m_nameKeys.setKeyIsName(keyIsNameDoom3Doom3Group);
197 m_isModel = newValue;
203 setIsModel(!string_equal(m_modelKey.c_str(), m_name.c_str()));
206 // vc 2k5 compiler fix
211 void nameChanged(const char* value)
216 typedef MemberCaller1<Doom3Group, const char*, &Doom3Group::nameChanged> NameChangedCaller;
218 void modelChanged(const char* value)
224 m_model.modelChanged(value);
228 m_model.modelChanged("");
231 typedef MemberCaller1<Doom3Group, const char*, &Doom3Group::modelChanged> ModelChangedCaller;
233 void updateTransform()
235 m_transform.localToParent() = g_matrix4_identity;
238 matrix4_translate_by_vec3(m_transform.localToParent(), m_origin);
239 matrix4_multiply_by_matrix4(m_transform.localToParent(), rotation_toMatrix(m_rotation));
241 m_transformChanged();
244 m_funcStaticOrigin.originChanged();
247 typedef MemberCaller<Doom3Group, &Doom3Group::updateTransform> UpdateTransformCaller;
251 m_origin = m_originKey.m_origin;
254 typedef MemberCaller<Doom3Group, &Doom3Group::originChanged> OriginChangedCaller;
256 void rotationChanged()
258 rotation_assign(m_rotation, m_rotationKey.m_rotation);
261 typedef MemberCaller<Doom3Group, &Doom3Group::rotationChanged> RotationChangedCaller;
267 scene::Node* node = m_model.getNode();
270 Node_modelSkinChanged(*node);
274 typedef MemberCaller<Doom3Group, &Doom3Group::skinChanged> SkinChangedCaller;
277 Doom3Group(EntityClass* eclass, scene::Node& node, const Callback& transformChanged, const Callback& boundsChanged, const Callback& evaluateTransform) :
279 m_originKey(OriginChangedCaller(*this)),
280 m_origin(ORIGINKEY_IDENTITY),
281 m_rotationKey(RotationChangedCaller(*this)),
282 m_filter(m_entity, node),
284 m_nameKeys(m_entity),
285 m_funcStaticOrigin(m_traverse, m_origin),
286 m_renderName(m_named, m_name_origin),
287 m_name_origin(g_vector3_identity),
288 m_skin(SkinChangedCaller(*this)),
289 m_curveNURBS(boundsChanged),
290 m_curveCatmullRom(boundsChanged),
291 m_transformChanged(transformChanged),
292 m_evaluateTransform(evaluateTransform),
297 Doom3Group(const Doom3Group& other, scene::Node& node, const Callback& transformChanged, const Callback& boundsChanged, const Callback& evaluateTransform) :
298 m_entity(other.m_entity),
299 m_originKey(OriginChangedCaller(*this)),
300 m_origin(ORIGINKEY_IDENTITY),
301 m_rotationKey(RotationChangedCaller(*this)),
302 m_filter(m_entity, node),
304 m_nameKeys(m_entity),
305 m_funcStaticOrigin(m_traverse, m_origin),
306 m_renderName(m_named, g_vector3_identity),
307 m_skin(SkinChangedCaller(*this)),
308 m_curveNURBS(boundsChanged),
309 m_curveCatmullRom(boundsChanged),
310 m_transformChanged(transformChanged),
311 m_evaluateTransform(evaluateTransform),
321 InstanceCounter m_instanceCounter;
322 void instanceAttach(const scene::Path& path)
324 if(++m_instanceCounter.m_count == 1)
326 m_filter.instanceAttach();
327 m_entity.instanceAttach(path_find_mapfile(path.begin(), path.end()));
328 m_traverse.instanceAttach(path_find_mapfile(path.begin(), path.end()));
330 m_funcStaticOrigin.enable();
333 void instanceDetach(const scene::Path& path)
335 if(--m_instanceCounter.m_count == 0)
337 m_funcStaticOrigin.disable();
339 m_traverse.instanceDetach(path_find_mapfile(path.begin(), path.end()));
340 m_entity.instanceDetach(path_find_mapfile(path.begin(), path.end()));
341 m_filter.instanceDetach();
345 EntityKeyValues& getEntity()
349 const EntityKeyValues& getEntity() const
354 scene::Traversable& getTraversable()
356 return *m_traversable;
358 Namespaced& getNamespaced()
362 Nameable& getNameable()
366 TransformNode& getTransformNode()
370 ModelSkin& getModelSkin()
375 void attach(scene::Traversable::Observer* observer)
377 m_traverseObservers.attach(*observer);
379 void detach(scene::Traversable::Observer* observer)
381 m_traverseObservers.detach(*observer);
384 const AABB& localAABB() const
386 m_curveBounds = m_curveNURBS.m_bounds;
387 aabb_extend_by_aabb_safe(m_curveBounds, m_curveCatmullRom.m_bounds);
388 return m_curveBounds;
391 void renderSolid(Renderer& renderer, const VolumeTest& volume, const Matrix4& localToWorld, bool selected) const
393 if(isModel() && selected)
395 m_renderOrigin.render(renderer, volume, localToWorld);
398 renderer.SetState(m_entity.getEntityClass().m_state_wire, Renderer::eWireframeOnly);
399 renderer.SetState(m_entity.getEntityClass().m_state_wire, Renderer::eFullMaterials);
401 if(!m_curveNURBS.m_renderCurve.m_vertices.empty())
403 renderer.addRenderable(m_curveNURBS.m_renderCurve, localToWorld);
405 if(!m_curveCatmullRom.m_renderCurve.m_vertices.empty())
407 renderer.addRenderable(m_curveCatmullRom.m_renderCurve, localToWorld);
411 void renderWireframe(Renderer& renderer, const VolumeTest& volume, const Matrix4& localToWorld, bool selected, const AABB& childBounds) const
413 renderSolid(renderer, volume, localToWorld, selected);
417 // draw models as usual
420 // don't draw the name for worldspawn
421 if(!strcmp(m_entity.getEntityClass().name(), "worldspawn"))
424 // place name in the middle of the "children cloud"
425 m_name_origin = childBounds.origin;
428 renderer.addRenderable(m_renderName, localToWorld);
432 void testSelect(Selector& selector, SelectionTest& test, SelectionIntersection& best)
434 PointVertexArray_testSelect(&m_curveNURBS.m_renderCurve.m_vertices[0], m_curveNURBS.m_renderCurve.m_vertices.size(), test, best);
435 PointVertexArray_testSelect(&m_curveCatmullRom.m_renderCurve.m_vertices[0], m_curveCatmullRom.m_renderCurve.m_vertices.size(), test, best);
438 void translate(const Vector3& translation)
440 m_origin = origin_translated(m_origin, translation);
442 void rotate(const Quaternion& rotation)
444 rotation_rotate(m_rotation, rotation);
446 void snapto(float snap)
448 m_originKey.m_origin = origin_snapped(m_originKey.m_origin, snap);
449 m_originKey.write(&m_entity);
451 void revertTransform()
453 m_origin = m_originKey.m_origin;
454 rotation_assign(m_rotation, m_rotationKey.m_rotation);
455 m_curveNURBS.m_controlPointsTransformed = m_curveNURBS.m_controlPoints;
456 m_curveCatmullRom.m_controlPointsTransformed = m_curveCatmullRom.m_controlPoints;
458 void freezeTransform()
460 m_originKey.m_origin = m_origin;
461 m_originKey.write(&m_entity);
462 rotation_assign(m_rotationKey.m_rotation, m_rotation);
463 m_rotationKey.write(&m_entity);
464 m_curveNURBS.m_controlPoints = m_curveNURBS.m_controlPointsTransformed;
465 ControlPoints_write(m_curveNURBS.m_controlPoints, curve_Nurbs, m_entity);
466 m_curveCatmullRom.m_controlPoints = m_curveCatmullRom.m_controlPointsTransformed;
467 ControlPoints_write(m_curveCatmullRom.m_controlPoints, curve_CatmullRomSpline, m_entity);
469 void transformChanged()
472 m_evaluateTransform();
474 m_curveNURBS.curveChanged();
475 m_curveCatmullRom.curveChanged();
477 typedef MemberCaller<Doom3Group, &Doom3Group::transformChanged> TransformChangedCaller;
480 class ControlPointAddBounds
484 ControlPointAddBounds(AABB& bounds) : m_bounds(bounds)
487 void operator()(const Vector3& point) const
489 aabb_extend_by_point_safe(m_bounds, point);
493 class Doom3GroupInstance :
494 public TargetableInstance,
495 public TransformModifier,
497 public SelectionTestable,
498 public ComponentSelectionTestable,
499 public ComponentEditable,
500 public ComponentSnappable
504 InstanceTypeCastTable m_casts;
508 m_casts = TargetableInstance::StaticTypeCasts::instance().get();
509 InstanceContainedCast<Doom3GroupInstance, Bounded>::install(m_casts);
510 InstanceStaticCast<Doom3GroupInstance, Renderable>::install(m_casts);
511 InstanceStaticCast<Doom3GroupInstance, SelectionTestable>::install(m_casts);
512 InstanceStaticCast<Doom3GroupInstance, ComponentSelectionTestable>::install(m_casts);
513 InstanceStaticCast<Doom3GroupInstance, ComponentEditable>::install(m_casts);
514 InstanceStaticCast<Doom3GroupInstance, ComponentSnappable>::install(m_casts);
515 InstanceStaticCast<Doom3GroupInstance, Transformable>::install(m_casts);
516 InstanceIdentityCast<Doom3GroupInstance>::install(m_casts);
518 InstanceTypeCastTable& get()
524 Doom3Group& m_contained;
525 CurveEdit m_curveNURBS;
526 CurveEdit m_curveCatmullRom;
527 mutable AABB m_aabb_component;
530 typedef LazyStatic<TypeCasts> StaticTypeCasts;
533 Bounded& get(NullType<Bounded>)
538 STRING_CONSTANT(Name, "Doom3GroupInstance");
540 Doom3GroupInstance(const scene::Path& path, scene::Instance* parent, Doom3Group& contained) :
541 TargetableInstance(path, parent, this, StaticTypeCasts::instance().get(), contained.getEntity(), *this),
542 TransformModifier(Doom3Group::TransformChangedCaller(contained), ApplyTransformCaller(*this)),
543 m_contained(contained),
544 m_curveNURBS(m_contained.m_curveNURBS.m_controlPointsTransformed, SelectionChangedComponentCaller(*this)),
545 m_curveCatmullRom(m_contained.m_curveCatmullRom.m_controlPointsTransformed, SelectionChangedComponentCaller(*this))
547 m_contained.instanceAttach(Instance::path());
548 m_contained.m_curveNURBSChanged = m_contained.m_curveNURBS.connect(CurveEdit::CurveChangedCaller(m_curveNURBS));
549 m_contained.m_curveCatmullRomChanged = m_contained.m_curveCatmullRom.connect(CurveEdit::CurveChangedCaller(m_curveCatmullRom));
551 StaticRenderableConnectionLines::instance().attach(*this);
553 ~Doom3GroupInstance()
555 StaticRenderableConnectionLines::instance().detach(*this);
557 m_contained.m_curveCatmullRom.disconnect(m_contained.m_curveCatmullRomChanged);
558 m_contained.m_curveNURBS.disconnect(m_contained.m_curveNURBSChanged);
559 m_contained.instanceDetach(Instance::path());
561 void renderSolid(Renderer& renderer, const VolumeTest& volume) const
563 m_contained.renderSolid(renderer, volume, Instance::localToWorld(), getSelectable().isSelected());
565 m_curveNURBS.renderComponentsSelected(renderer, volume, localToWorld());
566 m_curveCatmullRom.renderComponentsSelected(renderer, volume, localToWorld());
568 void renderWireframe(Renderer& renderer, const VolumeTest& volume) const
570 m_contained.renderWireframe(renderer, volume, Instance::localToWorld(), getSelectable().isSelected(), Instance::childBounds());
572 m_curveNURBS.renderComponentsSelected(renderer, volume, localToWorld());
573 m_curveCatmullRom.renderComponentsSelected(renderer, volume, localToWorld());
575 void renderComponents(Renderer& renderer, const VolumeTest& volume) const
577 if(GlobalSelectionSystem().ComponentMode() == SelectionSystem::eVertex)
579 m_curveNURBS.renderComponents(renderer, volume, localToWorld());
580 m_curveCatmullRom.renderComponents(renderer, volume, localToWorld());
584 void testSelect(Selector& selector, SelectionTest& test)
586 test.BeginMesh(localToWorld());
587 SelectionIntersection best;
589 m_contained.testSelect(selector, test, best);
593 Selector_add(selector, getSelectable(), best);
597 bool isSelectedComponents() const
599 return m_curveNURBS.isSelected() || m_curveCatmullRom.isSelected();
601 void setSelectedComponents(bool selected, SelectionSystem::EComponentMode mode)
603 if(mode == SelectionSystem::eVertex)
605 m_curveNURBS.setSelected(selected);
606 m_curveCatmullRom.setSelected(selected);
609 void testSelectComponents(Selector& selector, SelectionTest& test, SelectionSystem::EComponentMode mode)
611 if(mode == SelectionSystem::eVertex)
613 test.BeginMesh(localToWorld());
614 m_curveNURBS.testSelect(selector, test);
615 m_curveCatmullRom.testSelect(selector, test);
619 void transformComponents(const Matrix4& matrix)
621 if(m_curveNURBS.isSelected())
623 m_curveNURBS.transform(matrix);
625 if(m_curveCatmullRom.isSelected())
627 m_curveCatmullRom.transform(matrix);
631 const AABB& getSelectedComponentsBounds() const
633 m_aabb_component = AABB();
634 m_curveNURBS.forEachSelected(ControlPointAddBounds(m_aabb_component));
635 m_curveCatmullRom.forEachSelected(ControlPointAddBounds(m_aabb_component));
636 return m_aabb_component;
639 void snapComponents(float snap)
641 if(m_curveNURBS.isSelected())
643 m_curveNURBS.snapto(snap);
644 m_curveNURBS.write(curve_Nurbs, m_contained.getEntity());
646 if(m_curveCatmullRom.isSelected())
648 m_curveCatmullRom.snapto(snap);
649 m_curveCatmullRom.write(curve_CatmullRomSpline, m_contained.getEntity());
653 void evaluateTransform()
655 if(getType() == TRANSFORM_PRIMITIVE)
657 m_contained.translate(getTranslation());
658 m_contained.rotate(getRotation());
662 transformComponents(calculateTransform());
665 void applyTransform()
667 m_contained.revertTransform();
669 m_contained.freezeTransform();
671 typedef MemberCaller<Doom3GroupInstance, &Doom3GroupInstance::applyTransform> ApplyTransformCaller;
673 void selectionChangedComponent(const Selectable& selectable)
675 GlobalSelectionSystem().getObserver(SelectionSystem::eComponent)(selectable);
676 GlobalSelectionSystem().onComponentSelection(*this, selectable);
678 typedef MemberCaller1<Doom3GroupInstance, const Selectable&, &Doom3GroupInstance::selectionChangedComponent> SelectionChangedComponentCaller;
681 class Doom3GroupNode :
682 public scene::Node::Symbiot,
683 public scene::Instantiable,
684 public scene::Cloneable,
685 public scene::Traversable::Observer
689 NodeTypeCastTable m_casts;
693 NodeStaticCast<Doom3GroupNode, scene::Instantiable>::install(m_casts);
694 NodeStaticCast<Doom3GroupNode, scene::Cloneable>::install(m_casts);
695 NodeContainedCast<Doom3GroupNode, scene::Traversable>::install(m_casts);
696 NodeContainedCast<Doom3GroupNode, Snappable>::install(m_casts);
697 NodeContainedCast<Doom3GroupNode, TransformNode>::install(m_casts);
698 NodeContainedCast<Doom3GroupNode, Entity>::install(m_casts);
699 NodeContainedCast<Doom3GroupNode, Nameable>::install(m_casts);
700 NodeContainedCast<Doom3GroupNode, Namespaced>::install(m_casts);
701 NodeContainedCast<Doom3GroupNode, ModelSkin>::install(m_casts);
703 NodeTypeCastTable& get()
711 InstanceSet m_instances;
712 Doom3Group m_contained;
716 m_contained.attach(this);
720 m_contained.detach(this);
724 typedef LazyStatic<TypeCasts> StaticTypeCasts;
726 scene::Traversable& get(NullType<scene::Traversable>)
728 return m_contained.getTraversable();
730 Snappable& get(NullType<Snappable>)
734 TransformNode& get(NullType<TransformNode>)
736 return m_contained.getTransformNode();
738 Entity& get(NullType<Entity>)
740 return m_contained.getEntity();
742 Nameable& get(NullType<Nameable>)
744 return m_contained.getNameable();
746 Namespaced& get(NullType<Namespaced>)
748 return m_contained.getNamespaced();
750 ModelSkin& get(NullType<ModelSkin>)
752 return m_contained.getModelSkin();
755 Doom3GroupNode(EntityClass* eclass) :
756 m_node(this, this, StaticTypeCasts::instance().get()),
757 m_contained(eclass, m_node, InstanceSet::TransformChangedCaller(m_instances), InstanceSet::BoundsChangedCaller(m_instances), InstanceSetEvaluateTransform<Doom3GroupInstance>::Caller(m_instances))
761 Doom3GroupNode(const Doom3GroupNode& other) :
762 scene::Node::Symbiot(other),
763 scene::Instantiable(other),
764 scene::Cloneable(other),
765 scene::Traversable::Observer(other),
766 m_node(this, this, StaticTypeCasts::instance().get()),
767 m_contained(other.m_contained, m_node, InstanceSet::TransformChangedCaller(m_instances), InstanceSet::BoundsChangedCaller(m_instances), InstanceSetEvaluateTransform<Doom3GroupInstance>::Caller(m_instances))
785 scene::Node& clone() const
787 return (new Doom3GroupNode(*this))->node();
790 void insert(scene::Node& child)
792 m_instances.insert(child);
794 void erase(scene::Node& child)
796 m_instances.erase(child);
799 scene::Instance* create(const scene::Path& path, scene::Instance* parent)
801 return new Doom3GroupInstance(path, parent, m_contained);
803 void forEachInstance(const scene::Instantiable::Visitor& visitor)
805 m_instances.forEachInstance(visitor);
807 void insert(scene::Instantiable::Observer* observer, const scene::Path& path, scene::Instance* instance)
809 m_instances.insert(observer, path, instance);
811 scene::Instance* erase(scene::Instantiable::Observer* observer, const scene::Path& path)
813 return m_instances.erase(observer, path);
817 void Doom3Group_construct()
819 CurveEdit::Type::instance().m_controlsShader = GlobalShaderCache().capture("$POINT");
820 CurveEdit::Type::instance().m_selectedShader = GlobalShaderCache().capture("$SELPOINT");
823 void Doom3Group_destroy()
825 GlobalShaderCache().release("$SELPOINT");
826 GlobalShaderCache().release("$POINT");
829 scene::Node& New_Doom3Group(EntityClass* eclass)
831 return (new Doom3GroupNode(eclass))->node();