|
Similar to STATE_group_rotate_to_match_polygon()
with the difference that here we have an auxiliary line (going through points p1 and p2)
To make things clearer let's say we have a square polygon_in_the_group
and a square reference_polygon, there are four final position for the group
so that polygon_in_the_group points to the same direction as reference_polygon.
(each one of the four edges of one group polygon can be aligned with an edge of the
reference polygon). STATE_group_rotate_to_match_polygon() rotates so it will make
the minimal rotation. This is usually what we want. So usually we will use
STATE_group_rotate_to_match_polygon(). We will use this function when we want
to turn around a specific line. All the rest is exactly like in STATE_group_rotate_to_match_polygon()
Returns OK or VR_ERROR.
|