summaryrefslogtreecommitdiff
path: root/src/Graphic2d/Graphic2d_SetOfSegments.cdl
blob: 654ec49de1b406e1ad66711df20967cf88350ed7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

-- File:	Graphic2d_SetOfSegments.cdl
-- Created:	Thu April 13 16:36:51 1993
-- Author:	Gerard GRAS
--		<gg@stylox>		

---Copyright:	 Matra Datavision 1993

class SetOfSegments from Graphic2d inherits Line from Graphic2d

	---Version:

	---Purpose: The primitive SetOfSegments
        --  Warning: This primitive must be use as possible for performance
        --         improvment but is drawn with a global line attributes 
        --         for all the set. 
	--	    But when the set contains a lot of contigous segments
	--	   with a line attrib different to the default,it's
	--	   more preferable to use a SetOfPolylines for to insure
	--	   a better quality.
        --         NOTE: than the method PickedIndex() permits to known 
        --              the last picked segment in the set. 
	---References:

uses
	Drawer			from Graphic2d,
	GraphicObject		from Graphic2d,
	Length			from Quantity,
	SequenceOfShortReal	from TShort,
	FStream			from Aspect,
	IFStream		from Aspect

raises
	SegmentDefinitionError	from Graphic2d,
	OutOfRange from Standard

is
	-------------------------
	-- Category: Constructors
	-------------------------

	Create (aGraphicObject: GraphicObject from Graphic2d)
	returns mutable SetOfSegments from Graphic2d;
	---Level: Public
	---Purpose: Creates an empty set of segments in the graphic 
	--         object <aGraphicObject>.
	---Category: Constructors

	Add(me : mutable; X1, Y1, X2, Y2: Length from Quantity)
	---Level: Public
	---Purpose: Add a segment in the set 
	--	    The first point is <X1>, <Y1>.
	--	    The second point is <X2>, <Y2>.
	--  Trigger: Raises SegmentDefinitionError if the
	--          first point and the second point are identical.
	raises SegmentDefinitionError from Graphic2d;
	---Category: Update method

	Length(me) returns Integer from Standard;
	---Level: Public
	---Purpose: Returns the number of segments in the set.
	---Category: Inquiry method

	Values( me; 
            aRank: Integer from Standard;
		    X1, Y1, X2, Y2: out Length from Quantity )
	---Level: Public
	---Purpose: Returns the segment of rank <aRank> from the set.
	--  Trigger: Raises OutOfRange if <aRank> is <1 or >Length()
	raises OutOfRange from Standard;
	---Category: Inquiry method

	--------------------------
	-- Category: Draw and Pick
	--------------------------

	Draw (me : mutable; aDrawer: Drawer from Graphic2d)
	is static protected;
	---Level: Internal
	---Purpose: Draws the set of segments <me>.

    DrawElement( me : mutable; aDrawer: Drawer from Graphic2d;
                 anIndex: Integer from Standard)
        is redefined protected;
    	---Level: Internal
    	---Purpose: Draws element <anIndex> of the set <me>.

    DrawVertex( me : mutable; aDrawer: Drawer from Graphic2d;
                anIndex: Integer from Standard)
        is redefined protected;
    	---Level: Internal
    	---Purpose: Draws vertex <anIndex> of the set <me>.

	Pick (me : mutable; X, Y: ShortReal from Standard;
		aPrecision: ShortReal from Standard;
		aDrawer: Drawer from Graphic2d)
	returns Boolean from Standard
	is static protected;
	---Level: Internal
        ---Purpose: Returns Standard_True if one segment of the set <me> 
	--	    is picked, Standard_False if not.
	--  Warning: The PickIndex() method returns the rank of the picked
	--	    segment if any.

	----------------------------------------------------------------------

	Save( me; aFStream: in out FStream from Aspect ) is virtual;
--	Retrieve( me; aIFStream: in out IFStream from AIS2D ) is virtual;

fields

	myX1:	SequenceOfShortReal from TShort;
	myY1:	SequenceOfShortReal from TShort;
	myX2:	SequenceOfShortReal from TShort;
	myY2:	SequenceOfShortReal from TShort;

end SetOfSegments from Graphic2d;