more ai generated doc with human review
This commit is contained in:
@@ -43,98 +43,99 @@ public:
|
||||
PIPoint<Type> p0;
|
||||
PIPoint<Type> p1;
|
||||
|
||||
//! \~russian
|
||||
//! Пустой конструктор.
|
||||
//! \~english Default constructor.
|
||||
//! \~russian Пустой конструктор.
|
||||
//! \details
|
||||
//! При выполнении пустого конструктора координаты не изменяются.
|
||||
//! Начало и конец совпадают.
|
||||
//! \~english Creates an empty line where start and end points coincide.
|
||||
//! \~russian При выполнении пустого конструктора координаты не изменяются. Начало и конец совпадают.
|
||||
PILine() {}
|
||||
|
||||
//! \~russian
|
||||
//! Создает линию по двум принятым точкам \a PIPoint начала и конца.
|
||||
//! \~english Creates a line from two points.
|
||||
//! \~russian Создает линию по двум принятым точкам \a PIPoint начала и конца.
|
||||
PILine(const PIPoint<Type> & p0_, const PIPoint<Type> & p1_) {
|
||||
p0 = p0_;
|
||||
p1 = p1_;
|
||||
}
|
||||
|
||||
//! \~russian
|
||||
//! Создает линию по принятым координатам начала и конца.
|
||||
//! \~english Creates a line from coordinates.
|
||||
//! \~russian Создает линию по принятым координатам начала и конца.
|
||||
PILine(Type x0, Type y0, Type x1, Type y1) {
|
||||
p0.set(x0, y0);
|
||||
p1.set(x1, y1);
|
||||
}
|
||||
|
||||
//! \~russian
|
||||
//! Задать новые координаты начала и конца по двум принятым точкам \a PIPoint.
|
||||
//! \~english Set new coordinates from two points.
|
||||
//! \~russian Задать новые координаты начала и конца по двум принятым точкам \a PIPoint.
|
||||
PILine<Type> & set(const PIPoint<Type> & p0_, const PIPoint<Type> & p1_) {
|
||||
p0 = p0_;
|
||||
p1 = p1_;
|
||||
return *this;
|
||||
}
|
||||
|
||||
//! \~russian
|
||||
//! Задать новые координаты начала и конца.
|
||||
//! \~english Set new coordinates.
|
||||
//! \~russian Задать новые координаты начала и конца.
|
||||
PILine<Type> & set(Type x0, Type y0, Type x1, Type y1) {
|
||||
p0.set(x0, y0);
|
||||
p1.set(x1, y1);
|
||||
return *this;
|
||||
}
|
||||
|
||||
//! \~russian
|
||||
//! Проверить на совпадение координат начала и конца.
|
||||
//! \~english Check if start and end points coincide.
|
||||
//! \~russian Проверить на совпадение координат начала и конца.
|
||||
bool isEmpty() const { return (p0 == p1); }
|
||||
|
||||
//! \~russian
|
||||
//! Вычислить ширину прямоугольника, диагональю которого является данный отрезок.
|
||||
//! \~english Calculate width of the rectangle whose diagonal is this line.
|
||||
//! \~russian Вычислить ширину прямоугольника, диагональю которого является данный отрезок.
|
||||
Type width() const { return piAbs<Type>(p1.x - p0.x); }
|
||||
|
||||
//! \~russian
|
||||
//! Вычислить высоту прямоугольника, диагональю которого является данный отрезок.
|
||||
//! \~english Calculate height of the rectangle whose diagonal is this line.
|
||||
//! \~russian Вычислить высоту прямоугольника, диагональю которого является данный отрезок.
|
||||
Type height() const { return piAbs<Type>(p1.y - p0.y); }
|
||||
|
||||
//! \~russian
|
||||
//! Сдвинуть линию на \a x, \a y.
|
||||
//! \~english Translate line by x and y.
|
||||
//! \~russian Сдвинуть линию на \a x, \a y.
|
||||
PILine<Type> & translate(Type x, Type y) {
|
||||
p0.translate(x, y);
|
||||
p1.translate(x, y);
|
||||
return *this;
|
||||
}
|
||||
|
||||
//! \~russian
|
||||
//! Сдвинуть линию на значение координат точки \a PIPoint.
|
||||
//! \~english Translate line by point coordinates.
|
||||
//! \~russian Сдвинуть линию на значение координат точки \a PIPoint.
|
||||
PILine<Type> & translate(const PIPoint<Type> & p) {
|
||||
p0.translate(p);
|
||||
p1.translate(p);
|
||||
return *this;
|
||||
}
|
||||
|
||||
//! Создать копию отрезка и сдвинуть её на `x` и `y`.
|
||||
//! \~english Create a copy of the line and translate it by x and y.
|
||||
//! \~russian Создать копию отрезка и сдвинуть её на `x` и `y`.
|
||||
PILine<Type> translated(Type x, Type y) const {
|
||||
PILine<Type> l(*this);
|
||||
l.translate(x, y);
|
||||
return l;
|
||||
}
|
||||
|
||||
//! \~russian
|
||||
//! Создать копию отрезка и сдвинуть её на значение координат точки \a PIPoint.
|
||||
//! \~english Create a copy of the line and translate it by point coordinates.
|
||||
//! \~russian Создать копию отрезка и сдвинуть её на значение координат точки \a PIPoint.
|
||||
PILine<Type> translated(const PIPoint<Type> & p) const {
|
||||
PILine<Type> l(*this);
|
||||
l.translate(p);
|
||||
return l;
|
||||
}
|
||||
|
||||
//! \~russian
|
||||
//! Сдвинуть линию на \a x, \a y.
|
||||
//! \~english Translate line by x and y. Alias for \a translate().
|
||||
//! \~russian Сдвинуть линию на \a x, \a y.
|
||||
//! \details Является копией метода \a translate().
|
||||
PILine<Type> & move(Type x, Type y) { return translate(x, y); }
|
||||
|
||||
//! \~russian
|
||||
//! Сдвинуть линию на значение координат точки \a PIPoint.
|
||||
//! \~english Translate line by point coordinates. Alias for \a translate().
|
||||
//! \~russian Сдвинуть линию на значение координат точки \a PIPoint.
|
||||
//! \details Является копией метода \a translate().
|
||||
PILine<Type> & move(const PIPoint<Type> & p) { return translate(p); }
|
||||
|
||||
//! \~russian
|
||||
//! Создать копию отрезка и сдвинуть её на \a x, \a y.
|
||||
//! \~english Create a copy of the line and translate it by x and y. Alias for \a translated().
|
||||
//! \~russian Создать копию отрезка и сдвинуть её на \a x, \a y.
|
||||
//! \details Является копией метода \a translated().
|
||||
PILine<Type> moved(Type x, Type y) const {
|
||||
PILine<Type> l(*this);
|
||||
@@ -142,8 +143,8 @@ public:
|
||||
return l;
|
||||
}
|
||||
|
||||
//! \~russian
|
||||
//! Создать копию отрезка и сдвинуть её на значение координат точки \a PIPoint.
|
||||
//! \~english Create a copy of the line and translate it by point coordinates. Alias for \a translated().
|
||||
//! \~russian Создать копию отрезка и сдвинуть её на значение координат точки \a PIPoint.
|
||||
//! \details Является копией метода \a translated().
|
||||
PILine<Type> moved(const PIPoint<Type> & p) const {
|
||||
PILine<Type> l(*this);
|
||||
@@ -151,31 +152,40 @@ public:
|
||||
return l;
|
||||
}
|
||||
|
||||
//! \~english Translate line by x value on both coordinates.
|
||||
//! \~russian Сдвинуть линию по двум координатам на значение \a x.
|
||||
void operator+=(Type x) { translate(x, x); }
|
||||
|
||||
//! \~english Translate line by point coordinates.
|
||||
//! \~russian Сдвинуть линию по двум координатам на величину координат точки \a PIPoint.
|
||||
void operator+=(const PIPoint<Type> & p) { translate(p); }
|
||||
|
||||
//! \~english Translate line by negative x value on both coordinates.
|
||||
//! \~russian Сдвинуть линию по двум координатам на значение \a x.
|
||||
void operator-=(Type x) { translate(-x, -x); }
|
||||
|
||||
//! \~english Translate line by negative point coordinates.
|
||||
//! \~russian Сдвинуть линию по двум координатам на величину координат точки \a PIPoint.
|
||||
void operator-=(const PIPoint<Type> & p) { translate(-p); }
|
||||
|
||||
//! \~english Translate line by point coordinates.
|
||||
//! \~russian Сдвинуть линию по двум координатам на величину координат точки \a PIPoint.
|
||||
PILine<Type> operator+(const PIPoint<Type> & p) { return translated(p); }
|
||||
|
||||
//! \~english Translate line by negative point coordinates.
|
||||
//! \~russian Сдвинуть линию по двум координатам на величину координат точки \a PIPoint.
|
||||
PILine<Type> operator-(const PIPoint<Type> & p) { return translated(-p); }
|
||||
|
||||
//! \~english Check equality of two lines.
|
||||
//! \~russian Проверить равенство координат двух отрезков.
|
||||
bool operator==(const PILine<Type> & r) const { return (p0 == r.p0 && p1 == r.p1); }
|
||||
|
||||
//! \~english Check inequality of two lines.
|
||||
//! \~russian Проверить неравенство координат двух отрезков.
|
||||
bool operator!=(const PILine<Type> & r) const { return (p1 != r.p1 || p1 != r.p1); }
|
||||
};
|
||||
|
||||
//! \~english Stream output operator for PILine.
|
||||
//! \~russian Перегруженный оператор для вывода координат в \a PICout.
|
||||
template<typename Type>
|
||||
PICout operator<<(PICout & s, const PILine<Type> & v) {
|
||||
|
||||
Reference in New Issue
Block a user