1 // Created on: 2014-04-24
2 // Created by: Kirill Gavrilov
3 // Copyright (c) 2014 OPEN CASCADE SAS
5 // This file is part of Open CASCADE Technology software library.
7 // This library is free software; you can redistribute it and/or modify it under
8 // the terms of the GNU Lesser General Public License version 2.1 as published
9 // by the Free Software Foundation, with special exception defined in the file
10 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
11 // distribution for complete text of the license and disclaimer of any warranty.
13 // Alternatively, this file may be used under the terms of Open CASCADE
14 // commercial license or contractual agreement.
16 #include <AIS_ColoredShape.hxx>
18 #include <AIS_InteractiveContext.hxx>
19 #include <BRep_Builder.hxx>
20 #include <BRepTools.hxx>
21 #include <gp_Pnt2d.hxx>
22 #include <Graphic3d_AspectFillArea3d.hxx>
23 #include <Graphic3d_AspectLine3d.hxx>
24 #include <Graphic3d_Group.hxx>
25 #include <Graphic3d_StructureManager.hxx>
26 #include <Graphic3d_Texture2Dmanual.hxx>
27 #include <Precision.hxx>
29 #include <Prs3d_LineAspect.hxx>
30 #include <Prs3d_IsoAspect.hxx>
31 #include <Prs3d_Presentation.hxx>
32 #include <Prs3d_ShadingAspect.hxx>
33 #include <Prs3d_Root.hxx>
34 #include <PrsMgr_PresentationManager3d.hxx>
35 #include <Standard_ErrorHandler.hxx>
36 #include <StdPrs_ShadedShape.hxx>
37 #include <StdPrs_ToolTriangulatedShape.hxx>
38 #include <StdPrs_WFShape.hxx>
39 #include <TopExp_Explorer.hxx>
41 #include <TopoDS_Compound.hxx>
42 #include <TopoDS_Iterator.hxx>
47 IMPLEMENT_STANDARD_RTTIEXT(AIS_ColoredShape,AIS_Shape)
48 IMPLEMENT_STANDARD_RTTIEXT(AIS_ColoredDrawer,Prs3d_Drawer)
50 //=======================================================================
51 //function : AIS_ColoredShape
53 //=======================================================================
54 AIS_ColoredShape::AIS_ColoredShape (const TopoDS_Shape& theShape)
55 : AIS_Shape (theShape)
57 // disable dedicated line aspects
58 myDrawer->SetFreeBoundaryAspect (myDrawer->LineAspect());
59 myDrawer->SetUnFreeBoundaryAspect(myDrawer->LineAspect());
60 myDrawer->SetSeenLineAspect (myDrawer->LineAspect());
63 //=======================================================================
64 //function : AIS_ColoredShape
66 //=======================================================================
67 AIS_ColoredShape::AIS_ColoredShape (const Handle(AIS_Shape)& theShape)
68 : AIS_Shape (theShape->Shape())
70 // disable dedicated line aspects
71 myDrawer->SetFreeBoundaryAspect (myDrawer->LineAspect());
72 myDrawer->SetUnFreeBoundaryAspect(myDrawer->LineAspect());
73 myDrawer->SetSeenLineAspect (myDrawer->LineAspect());
74 if (theShape->HasMaterial())
76 SetMaterial (theShape->Material());
78 if (theShape->HasColor())
80 SetColor (theShape->Color());
82 if (theShape->HasWidth())
84 SetWidth (theShape->Width());
86 if (theShape->IsTransparent())
88 SetTransparency (theShape->Transparency());
92 //=======================================================================
93 //function : CustomAspects
95 //=======================================================================
96 Handle(AIS_ColoredDrawer) AIS_ColoredShape::CustomAspects (const TopoDS_Shape& theShape)
98 Handle(AIS_ColoredDrawer) aDrawer;
99 myShapeColors.Find (theShape, aDrawer);
100 if (aDrawer.IsNull())
102 aDrawer = new AIS_ColoredDrawer (myDrawer);
103 myShapeColors.Bind (theShape, aDrawer);
104 LoadRecomputable (AIS_WireFrame);
105 LoadRecomputable (AIS_Shaded);
110 //=======================================================================
111 //function : ClearCustomAspects
113 //=======================================================================
114 void AIS_ColoredShape::ClearCustomAspects()
116 if (myShapeColors.IsEmpty())
120 myShapeColors.Clear();
121 LoadRecomputable (AIS_WireFrame);
122 LoadRecomputable (AIS_Shaded);
125 //=======================================================================
126 //function : UnsetCustomAspects
128 //=======================================================================
129 void AIS_ColoredShape::UnsetCustomAspects (const TopoDS_Shape& theShape,
130 const Standard_Boolean theToUnregister)
132 if (!myShapeColors.IsBound (theShape))
137 LoadRecomputable (AIS_WireFrame);
138 LoadRecomputable (AIS_Shaded);
141 myShapeColors.UnBind (theShape);
145 myShapeColors.ChangeFind (theShape) = new AIS_ColoredDrawer (myDrawer);
148 //=======================================================================
149 //function : SetCustomColor
151 //=======================================================================
152 void AIS_ColoredShape::SetCustomColor (const TopoDS_Shape& theShape,
153 const Quantity_Color& theColor)
155 if (theShape.IsNull())
160 const Handle(AIS_ColoredDrawer)& aDrawer = CustomAspects (theShape);
161 setColor (aDrawer, theColor);
162 aDrawer->SetOwnColor (theColor);
163 LoadRecomputable (AIS_WireFrame);
164 LoadRecomputable (AIS_Shaded);
167 //=======================================================================
168 //function : SetCustomWidth
170 //=======================================================================
171 void AIS_ColoredShape::SetCustomWidth (const TopoDS_Shape& theShape,
172 const Standard_Real theLineWidth)
174 if (theShape.IsNull())
179 const Handle(AIS_ColoredDrawer)& aDrawer = CustomAspects (theShape);
180 setWidth (CustomAspects (theShape), theLineWidth);
181 aDrawer->SetOwnWidth (theLineWidth);
182 LoadRecomputable (AIS_WireFrame);
183 LoadRecomputable (AIS_Shaded);
186 //=======================================================================
187 //function : SetColor
189 //=======================================================================
191 void AIS_ColoredShape::SetColor (const Quantity_Color& theColor)
193 setColor (myDrawer, theColor);
194 myOwnColor = theColor;
195 hasOwnColor = Standard_True;
196 LoadRecomputable (AIS_WireFrame);
197 LoadRecomputable (AIS_Shaded);
198 for (AIS_DataMapOfShapeDrawer::Iterator anIter (myShapeColors); anIter.More(); anIter.Next())
200 const Handle(AIS_ColoredDrawer)& aDrawer = anIter.Value();
201 if (aDrawer->HasOwnColor())
206 if (aDrawer->HasOwnShadingAspect())
208 aDrawer->ShadingAspect()->SetColor (theColor, myCurrentFacingModel);
210 if (aDrawer->HasOwnLineAspect())
212 aDrawer->LineAspect()->SetColor (theColor);
214 if (aDrawer->HasOwnWireAspect())
216 aDrawer->WireAspect()->SetColor (theColor);
221 //=======================================================================
222 //function : SetWidth
224 //=======================================================================
226 void AIS_ColoredShape::SetWidth (const Standard_Real theLineWidth)
228 setWidth (myDrawer, theLineWidth);
229 myOwnWidth = theLineWidth;
230 LoadRecomputable (AIS_WireFrame);
231 LoadRecomputable (AIS_Shaded);
232 for (AIS_DataMapOfShapeDrawer::Iterator anIter (myShapeColors); anIter.More(); anIter.Next())
234 const Handle(AIS_ColoredDrawer)& aDrawer = anIter.Value();
235 if (aDrawer->HasOwnWidth())
240 if (aDrawer->HasOwnLineAspect())
242 aDrawer->LineAspect()->SetWidth (theLineWidth);
244 if (aDrawer->HasOwnWireAspect())
246 aDrawer->WireAspect()->SetWidth (theLineWidth);
251 //=======================================================================
252 //function : SetTransparency
254 //=======================================================================
256 void AIS_ColoredShape::SetTransparency (const Standard_Real theValue)
258 setTransparency (myDrawer, theValue);
259 myTransparency = theValue;
260 LoadRecomputable (AIS_WireFrame);
261 LoadRecomputable (AIS_Shaded);
262 for (AIS_DataMapOfShapeDrawer::Iterator anIter (myShapeColors); anIter.More(); anIter.Next())
264 const Handle(Prs3d_Drawer)& aDrawer = anIter.Value();
265 if (aDrawer->HasOwnShadingAspect())
267 aDrawer->ShadingAspect()->SetTransparency (theValue, myCurrentFacingModel);
272 //=======================================================================
273 //function : SetMaterial
275 //=======================================================================
277 void AIS_ColoredShape::SetMaterial (const Graphic3d_MaterialAspect& theMaterial)
279 setMaterial (myDrawer, theMaterial, HasColor(), IsTransparent());
280 //myOwnMaterial = theMaterial;
281 hasOwnMaterial = Standard_True;
282 LoadRecomputable (AIS_Shaded);
283 for (AIS_DataMapOfShapeDrawer::Iterator anIter (myShapeColors); anIter.More(); anIter.Next())
285 const Handle(AIS_ColoredDrawer)& aDrawer = anIter.Value();
286 //if (aDrawer->HasOwnMaterial()) continue;
287 if (aDrawer->HasOwnShadingAspect())
289 setMaterial (aDrawer, theMaterial, aDrawer->HasOwnColor(), Standard_False); // aDrawer->IsTransparent()
294 //=======================================================================
297 //=======================================================================
298 void AIS_ColoredShape::Compute (const Handle(PrsMgr_PresentationManager3d)& ,
299 const Handle(Prs3d_Presentation)& thePrs,
300 const Standard_Integer theMode)
305 thePrs->SetInfiniteState (Standard_True);
308 if (theMode == AIS_Shaded)
310 if (myDrawer->IsAutoTriangulation())
312 // compute mesh for entire shape beforehand to ensure consistency and optimizations (parallelization)
313 StdPrs_ToolTriangulatedShape::ClearOnOwnDeflectionChange (myshape, myDrawer, Standard_True);
315 // After this call if type of deflection is relative
316 // computed deflection coefficient is stored as absolute.
317 Standard_Boolean wasRecomputed = StdPrs_ToolTriangulatedShape::Tessellate (myshape, myDrawer);
319 // Set to update wireframe presentation on triangulation.
320 if (myDrawer->IsoOnTriangulation() && wasRecomputed)
322 SetToUpdate (AIS_WireFrame);
326 else // WireFrame mode
328 StdPrs_ToolTriangulatedShape::ClearOnOwnDeflectionChange (myshape, myDrawer, Standard_True);
330 // After this call if type of deflection is relative
331 // computed deflection coefficient is stored as absolute.
332 Prs3d::GetDeflection (myshape, myDrawer);
335 TopoDS_Compound anOpened, aClosed;
336 BRep_Builder aBuilder;
337 aBuilder.MakeCompound (aClosed);
338 aBuilder.MakeCompound (anOpened);
339 if (theMode == AIS_Shaded && myshape.ShapeType() <= TopAbs_SOLID)
341 StdPrs_ShadedShape::ExploreSolids (myshape, aBuilder, aClosed, anOpened, Standard_False);
345 aBuilder.Add (anOpened, myshape);
348 // myShapeColors + anOpened --> array[TopAbs_ShapeEnum] of map of color-to-compound
349 DataMapOfShapeCompd aDispatchedOpened [(size_t)TopAbs_SHAPE];
350 dispatchColors (anOpened, myShapeColors, aDispatchedOpened);
351 addShapesWithCustomProps (thePrs, aDispatchedOpened, theMode, StdPrs_Volume_Opened);
353 if (theMode == AIS_Shaded)
355 if (isShapeEntirelyVisible())
357 // myShapeColors + aClosed --> array[TopAbs_ShapeEnum] of map of color-to-compound
358 DataMapOfShapeCompd aDispatchedClosed [(size_t)TopAbs_SHAPE];
359 dispatchColors (aClosed, myShapeColors, aDispatchedClosed);
360 addShapesWithCustomProps (thePrs, aDispatchedClosed, theMode, StdPrs_Volume_Closed);
364 for (TopoDS_Iterator aSolidIter (aClosed); aSolidIter.More(); aSolidIter.Next())
366 DataMapOfShapeCompd aDispatchedClosed [(size_t)TopAbs_SHAPE];
367 dispatchColors (aSolidIter.Value(), myShapeColors, aDispatchedClosed);
368 addShapesWithCustomProps (thePrs, aDispatchedClosed, theMode,
369 isShapeEntirelyVisible (aDispatchedClosed) ? StdPrs_Volume_Closed : StdPrs_Volume_Opened);
375 //=======================================================================
376 //function : addShapesWithCustomProps
378 //=======================================================================
379 void AIS_ColoredShape::addShapesWithCustomProps (const Handle(Prs3d_Presentation)& thePrs,
380 DataMapOfShapeCompd* theDispatched,
381 const Standard_Integer theMode,
382 const StdPrs_Volume theVolume)
384 Handle(AIS_ColoredDrawer) aCustomDrawer;
385 for (size_t aShType = 0; aShType < (size_t )TopAbs_SHAPE; ++aShType)
387 DataMapOfShapeCompd& aKeyshapeDrawshapeMap = theDispatched[aShType];
388 for (DataMapOfShapeCompd::Iterator aMapIter (aKeyshapeDrawshapeMap);
389 aMapIter.More(); aMapIter.Next())
391 const TopoDS_Shape& aShapeKey = aMapIter.Key(); // key shape with detailed color or a base shape
392 const TopoDS_Compound& aShapeDraw = aMapIter.Value(); // compound of subshapes with <aShType> type
393 Handle(Prs3d_Drawer) aDrawer;
394 if (myShapeColors.Find (aShapeKey, aCustomDrawer))
396 aDrawer = aCustomDrawer;
397 if (aCustomDrawer->IsHidden())
407 // It is supposed that absolute deflection contains previously computed relative deflection
408 // (if deflection type is relative).
409 // In case of CustomDrawer it is taken from Link().
410 Aspect_TypeOfDeflection aPrevType = aDrawer->TypeOfDeflection();
411 aDrawer->SetTypeOfDeflection (Aspect_TOD_ABSOLUTE);
413 // Draw each kind of subshapes and personal-colored shapes in a separate group
414 // since it's necessary to set transparency/material for all subshapes
415 // without affecting their unique colors
416 if (theMode == AIS_Shaded
417 && aShapeDraw.ShapeType() <= TopAbs_FACE
420 StdPrs_ShadedShape::Add (thePrs, aShapeDraw, aDrawer, theVolume);
424 StdPrs_WFShape::Add (thePrs, aShapeDraw, aDrawer);
426 aDrawer->SetTypeOfDeflection (aPrevType);
431 //=======================================================================
432 //function : dispatchColors
434 //=======================================================================
435 Standard_Boolean AIS_ColoredShape::dispatchColors (const TopoDS_Shape& theBaseKey,
436 const TopoDS_Shape& theSubshapeToParse,
437 const DataMapOfShapeShape& theSubshapeKeyshapeMap,
438 const TopAbs_ShapeEnum theParentType,
439 DataMapOfShapeCompd* theTypeKeyshapeDrawshapeArray)
441 TopAbs_ShapeEnum aShType = theSubshapeToParse.ShapeType();
442 if (aShType == TopAbs_SHAPE)
444 return Standard_False;
447 // check own setting of current shape
448 TopoDS_Shape aKeyShape = theBaseKey;
449 Standard_Boolean isOverriden = theSubshapeKeyshapeMap.Find (theSubshapeToParse, aKeyShape);
451 // iterate on sub-shapes
452 BRep_Builder aBBuilder;
453 TopoDS_Shape aShapeCopy = theSubshapeToParse.EmptyCopied();
454 aShapeCopy.Closed (theSubshapeToParse.Closed());
455 Standard_Boolean isSubOverride = Standard_False;
456 Standard_Integer nbDef = 0;
457 for (TopoDS_Iterator it (theSubshapeToParse); it.More(); it.Next())
459 if (dispatchColors (theBaseKey, it.Value(),
460 theSubshapeKeyshapeMap, aShType,
461 theTypeKeyshapeDrawshapeArray))
463 isSubOverride = Standard_True;
467 aBBuilder.Add (aShapeCopy, it.Value());
471 if (aShType == TopAbs_FACE || !isSubOverride)
473 aShapeCopy = theSubshapeToParse;
477 return isOverriden || isSubOverride; // empty compound
480 // if any of styles is overridden regarding to default one, add rest to map
482 || (isSubOverride && theParentType != TopAbs_WIRE // avoid drawing edges when vertex color is overridden
483 && theParentType != TopAbs_FACE) // avoid drawing edges of the same color as face
484 || (theParentType == TopAbs_SHAPE && !(isOverriden || isSubOverride))) // bind original shape to default color
486 TopoDS_Compound aCompound;
487 DataMapOfShapeCompd& aKeyshapeDrawshapeMap = theTypeKeyshapeDrawshapeArray[(size_t )aShType];
488 if (!aKeyshapeDrawshapeMap.FindFromKey (aKeyShape, aCompound))
490 aBBuilder.MakeCompound (aCompound);
491 aKeyshapeDrawshapeMap.Add (aKeyShape, aCompound);
493 aBBuilder.Add (aCompound, aShapeCopy);
495 return isOverriden || isSubOverride;
498 //! Function to check if specified compound is sub-shape of another one
499 inline Standard_Boolean isFirstCmpContainSecondOne (const TopoDS_Shape& theFirstCmp,
500 const TopoDS_Shape& theSecondCmp)
502 if (theFirstCmp.ShapeType() != TopAbs_COMPOUND
503 || theSecondCmp.ShapeType() != TopAbs_COMPOUND)
505 return Standard_False;
508 for (TopoDS_Iterator aFirstCmpIter (theFirstCmp); aFirstCmpIter.More(); aFirstCmpIter.Next())
510 if (aFirstCmpIter.Value().ShapeType() != TopAbs_COMPOUND)
514 else if (aFirstCmpIter.Value() == theSecondCmp
515 || isFirstCmpContainSecondOne (aFirstCmpIter.Value(), theSecondCmp))
517 return Standard_True;
520 return Standard_False;
523 //=======================================================================
524 //function : dispatchColors
526 //=======================================================================
527 void AIS_ColoredShape::dispatchColors (const TopoDS_Shape& theBaseShape,
528 const AIS_DataMapOfShapeDrawer& theKeyshapeColorMap,
529 DataMapOfShapeCompd* theTypeKeyshapeDrawshapeArray)
531 // Extract <theShapeColors> map (KeyshapeColored -> Color)
532 // to subshapes map (Subshape -> KeyshapeColored).
533 // This needed when colored shape is not part of <theBaseShape>
534 // (but subshapes are) and actually container for subshapes.
535 DataMapOfShapeShape aSubshapeKeyshapeMap;
536 for (AIS_DataMapOfShapeDrawer::Iterator aKeyShapeIter (theKeyshapeColorMap);
537 aKeyShapeIter.More(); aKeyShapeIter.Next())
539 const TopoDS_Shape& aKeyShape = aKeyShapeIter.Key();
540 bindSubShapes (aSubshapeKeyshapeMap, theBaseShape, aKeyShape, aKeyShape);
543 // Fill the array of maps per shape type
544 dispatchColors (theBaseShape, theBaseShape,
545 aSubshapeKeyshapeMap, TopAbs_SHAPE,
546 theTypeKeyshapeDrawshapeArray);
549 //=======================================================================
550 //function : isShapeEntirelyVisible
552 //=======================================================================
553 Standard_Boolean AIS_ColoredShape::isShapeEntirelyVisible (DataMapOfShapeCompd* theDispatched) const
555 Handle(AIS_ColoredDrawer) aCustomDrawer;
556 for (size_t aShType = (size_t )TopAbs_COMPOUND; aShType <= (size_t )TopAbs_FACE; ++aShType)
558 const DataMapOfShapeCompd& aKeyshapeDrawshapeMap = theDispatched[aShType];
559 for (DataMapOfShapeCompd::Iterator aMapIter (aKeyshapeDrawshapeMap); aMapIter.More(); aMapIter.Next())
561 if (myShapeColors.Find (aMapIter.Key(), aCustomDrawer)
562 && !aCustomDrawer.IsNull()
563 && aCustomDrawer->IsHidden())
565 return Standard_False;
569 return Standard_True;
572 //=======================================================================
573 //function : isShapeEntirelyVisible
575 //=======================================================================
576 Standard_Boolean AIS_ColoredShape::isShapeEntirelyVisible() const
578 for (AIS_DataMapOfShapeDrawer::Iterator aMapIter (myShapeColors); aMapIter.More(); aMapIter.Next())
580 if (aMapIter.Value()->IsHidden())
582 return Standard_False;
585 return Standard_True;
588 //=======================================================================
589 //function : bindSubShapes
591 //=======================================================================
592 void AIS_ColoredShape::bindSubShapes (DataMapOfShapeShape& theSubshapeKeyshapeMap,
593 const TopoDS_Shape& theBaseShape,
594 const TopoDS_Shape& theShapeWithColor,
595 const TopoDS_Shape& theColorKeyShape)
597 TopAbs_ShapeEnum aShapeWithColorType = theShapeWithColor.ShapeType();
598 if (aShapeWithColorType == TopAbs_COMPOUND)
600 if (isFirstCmpContainSecondOne (theBaseShape, theShapeWithColor))
602 if (!theSubshapeKeyshapeMap.IsBound (theShapeWithColor))
604 theSubshapeKeyshapeMap.Bind (theShapeWithColor, theColorKeyShape);
609 for (TopoDS_Iterator aSubShapeIter (theShapeWithColor); aSubShapeIter.More(); aSubShapeIter.Next())
611 bindSubShapes (theSubshapeKeyshapeMap, theBaseShape, aSubShapeIter.Value(), theColorKeyShape);
615 else if (aShapeWithColorType == TopAbs_SOLID || aShapeWithColorType == TopAbs_SHELL)
617 for (TopExp_Explorer anExp (theShapeWithColor, TopAbs_FACE); anExp.More(); anExp.Next())
619 if (!theSubshapeKeyshapeMap.IsBound (anExp.Current()))
621 theSubshapeKeyshapeMap.Bind (anExp.Current(), theColorKeyShape);
625 else if (aShapeWithColorType == TopAbs_WIRE)
627 for (TopExp_Explorer anExp (theShapeWithColor, TopAbs_EDGE); anExp.More(); anExp.Next())
629 if (!theSubshapeKeyshapeMap.IsBound (anExp.Current()))
631 theSubshapeKeyshapeMap.Bind (anExp.Current(), theColorKeyShape);
637 // bind single face, edge and vertex
638 // force rebind if required due to the color of single shape has
639 // higher priority than the color of "compound" shape (wire is a
640 // compound of edges, shell is a compound of faces) that contains
641 // this single shape.
642 theSubshapeKeyshapeMap.Bind (theShapeWithColor, theColorKeyShape);