Ломаная

Ломаная входит в состав группы стандартных геометрических фигур, с помощью которых Вы можете рисовать презентации Ваших моделей.

Начиная с версии 6.5 появилась возможность добавления у ломаной третьей размерности. В этом случае в режиме работы модели фигура будет отображаться как в двумерной презентации, так и в окне трехмерной анимации, с определенной высотой (см. рисунок ниже). Основание фигуры Вы рисуете в графическом редакторе, а высоту задаете в дополнительном свойстве фигуры Z-Высота.

 Чтобы нарисовать ломаную
  1. Перетащите элемент Ломаная  из палитры Презентация в то место графического редактора, где Вы хотите нарисовать ломаную. После этого Вы можете изменить созданную ломаную, как описано здесь.
  2. Однако более удобным представляется создание ломаных с помощью режима рисования. Чтобы перейти в этот режим, сделайте двойной щелчок мышью по элементу Ломаная  в палитре (при этом его значок должен поменяться на этот: ). Теперь Вы можете рисовать ломаную точка за точкой, последовательно щелкая мышью в тех точках диаграммы, куда Вы хотите поместить вершины ломаной. Чтобы завершить рисование, добавьте последнюю точку ломаной двойным щелчком мыши.
  3. Если Вы хотите увидеть также и трехмерную фигуру в 3D окне, перейдите на страницу  Основные панели Свойства и выберите опцию Отображать на 3D сцене
    Если Вы рисуете трехмерную анимацию, то мы рекомендуем добавлять фигуры на диаграмму не из палитры Презентация, а из палитры 3D - в этом случае опция Отображать на 3D сцене будет выбрана по умолчанию. 
  4. На странице свойств Дополнительные Вы можете изменить высоту фигуры в поле Z-Высота, а также координаты ее начальной точки в полях X, Y, Z.
  5. При необходимости, Вы можете задать координаты всех точек ломаной (относительно ее начальной точки) на странице свойств Точки.
Вы можете управлять количеством и местоположением точек ломаной во время выполнения модели с помощью соответствующих динамических свойств фигуры.
Основные свойства

Имя – Имя фигуры.

Отображать имя – Если опция выбрана, то имя фигуры будет отображаться в графическом редакторе.

Исключить – Если опция выбрана, то фигура будет исключена из модели.

На верхнем уровне – Если опция выбрана, то фигура будет видна на презентации класса, в который будет вложен данный активный объект.

Значок – [Доступно, только если сброшен флажок Отображать на 3D сцене] Если опция выбрана, то фигура будет считаться частью значка класса активного объекта.

Блокировать – Если опция выбрана, то фигура будет считаться заблокированной и не будет реагировать на щелчки мыши. Таким образом, Вы не сможете выбрать заблокированную фигуру в графическом редакторе до тех пор, пока Вы не снимете с нее блокировку. 
Обычно это требуется, когда у Вас есть какой-то фоновый рисунок, используемый как подложка для анимации, и Вы хотите исключить возможность случайного редактирования этого фонового рисунка при рисовании фигур поверх него. 

На презентации – Если опция выбрана, то фигура будет отображаться на презентации во время выполнения модели.

Отображать на 3D сцене – Если опция выбрана, то будет создан трехмерный аналог двумерной фигуры. Тогда в режиме запуска модели двумерная фигура будет отображаться там же, где она и была нарисована в графическом редакторе, а трехмерная будет видна в специальном элементе, предназначенном для просмотра трехмерной анимации - 3D окне.  

Цвет заливки - Задает цвет заливки фигуры. Ломаная закрашивается следующим образом: рисуется линия, соединяющая начальную и конечную точки ломаной (если ломаная уже не была сделана замкнутой), и закрашивается  область внутри образовавшейся фигуры. Щелкните мышью внутри элемента управления и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета. Если Вы не хотите, чтобы фигура была закрашена, выберите Нет заливки.

Цвет линии - Задает цвет ломаной линии. Щелкните мышью внутри элемента управления и выберите нужный цвет из списка наиболее часто используемых цветов или же выберите любой другой цвет с помощью диалога Цвета. Если Вы не хотите, чтобы ломаная была видна, выберите Нет линии.

Толщина линии - Задает толщину линии. Выберите нужную Вам толщину из выпадающего списка или же введите ее значение в пикселах в поле справа.

Стиль линии -  [Доступно, только если сброшен флажок Отображать на 3D сцене] Задает стиль линии. Выберите из выпадающего списка, хотите ли Вы, чтобы линия была сплошная, точечная или пунктирная.

Замкнутая - Если опция выбрана, то ломаная будет сделана замкнутой, то есть ее начальная и конечная точки будут соединены дополнительным отрезком.

Дополнительные

X – x-координата начальной точки ломаной.

Y – y-координата начальной точки ломаной.

Z – [Доступно, только если установлен флажок Отображать на 3D сцене] z-координата начальной точки ломаной.

Z-Высота – [Доступно, только если установлен флажок Отображать на 3D сцене] Z-высота фигуры (размерность фигуры, которая изначально расположена вдоль оси Z), в пикселах.  

Разрешить программное управление –  [Доступно, только если сброшен флажок Отображать на 3D сцене] Если опция выбрана, то фигура будет представлена в модели как Java объект, и она будет доступна из кода по имени. С помощью программного интерфейса Вы сможете изменять визуальные свойства фигуры и тем самым управлять ее внешним видом во время выполнения модели.

Динамические
Имя Тип
Описание

Количество int
Количество экземпляров данной фигуры. Если Вы оставите это поле пустым, то будет создана только одна такая фигура.

Видимость boolean
Видимость фигуры. Фигура будет видна, если заданное здесь выражение будет истинно (true), в противном случае фигура отображаться не будет.

X double
X-координата начальной точки ломаной.

Y double
Y-координата начальной точки ломаной.

Z double [Доступно, только если установлен флажок Отображать на 3D сцене]   Z-координата начальной точки ломаной.
Цвет заливки java.awt.Color
Цвет заливки ломаной линии. Ломаная закрашивается следующим образом: рисуется линия, соединяющая начальную и конечную точки ломаной (если ломаная уже не была сделана замкнутой), и закрашивается  область внутри образовавшейся фигуры.

Z-Высота double [Доступно, только если установлен флажок Отображать на 3D сцене] Z-высота фигуры (размерность фигуры, которая изначально расположена вдоль оси Z), в пикселах.  
Действие по щелчку -
Код, который будет выполняться при каждом щелчке пользователя мышью по фигуре во время выполнения модели.

Поворот (Z), рад double
Угол поворота фигуры (в радианах).

Масштаб по оси X double
Коэффициент масштабирования фигуры вдоль оси X.

Масштаб по оси Y double
Коэффициент масштабирования фигуры вдоль оси Y.

Масштаб по оси Z double [Доступно, только если установлен флажок Отображать на 3D сцене] Коэффициент масштабирования фигуры вдоль оси Z.
Цвет линии java.awt.Color
Цвет линии.

Толщина линии int
Толщина линии.

Стиль линии int
[Доступно, только если сброшен флажок Отображать на 3D сцене]  Стиль линии. Используйте одну из трех констант:
  • LINE_STYLE_SOLID - сплошная линия.
  • LINE_STYLE_DOTTED - точечная линия.
  • LINE_STYLE_DASHED - пунктирная линия.
Количество точек int
Количество точек ломаной линии.

dX[indexPt] double
Смещение по оси X точки ломаной с номером  indexPt относительно начальной точки. Номер текущей точки доступен как indexPt. Нумерация начинается с нуля.

dY[indexPt] double
Смещение по оси Y точки ломаной с номером  indexPt относительно начальной точки. Номер текущей точки доступен как indexPt. Нумерация начинается с нуля.

dZ[indexPt] double [Доступно, только если установлен флажок Отображать на 3D сцене] Смещение по оси Z точки ломаной с номером  indexPt относительно начальной точки. Номер текущей точки доступен как indexPt. Нумерация начинается с нуля.
Точки

На странице свойств Точки расположена таблица относительных координат точек ломаной.

Первая точка всегда имеет координаты (0,0,0), и они не редактируются.

В остальных строках таблицы задаются координаты последующих точек ломаной. Координаты каждой точки представляют собой смещения этой точки от начальной по оси X, Y и Z соответственно.

И если координаты точек в двумерном пространстве XY Вы можете изменить и в графическом редакторе, то расположение точек ломаной относительно оси Z можно изменить только в этой таблице.

Редактирование внешнего вида ломаной

Вы можете редактировать ломаную путем изменения количества и местоположения ее точек изгиба.

Чтобы перейти в режим редактирования точек ломаной
  1. Сделайте двойной щелчок мышью по ломаной или
    Щелкните правой кнопкой мыши по ломаной и выберите Редактирование точек из контекстного меню.
  2. Точки изгиба ломаной будут выделены с помощью маленьких кружков - это будет означать, что Вы перешли в режим редактирования точек изгиба.
 Чтобы передвинуть точку изгиба ломаной
  1. Перейдите в режим редактирования точек ломаной.
  2. Перетащите точку с помощью мыши.
 Чтобы добавить новую точку изгиба
  1. Перейдите в режим редактирования точек ломаной.
  2. Сделайте двойной щелчок мышью по тому отрезку ломаной, куда Вы хотите добавить новую точку.
 Чтобы удалить точку изгиба
  1. Перейдите в режим редактирования точек ломаной.
  2. Сделайте двойной щелчок мышью по той точке, которую Вы хотите удалить.

Функции ломаной

Вы можете динамически изменять свойства фигуры во время работы модели с помощью программного интерфейса соответствующего класса. Для фигуры, отображающейся в трехмерной анимации это будет класс  Shape3DPolyLine, для отображающейся только в двумерной презентации -  ShapePolyLine.

Ниже мы приведем список лишь некоторых наиболее важных методов ломаной:

Тип возвращаемого значения

Имя

Описание

double

length()

Вычисляет и возвращает длину  (немасштабированной) ломаной, с учетом ее замкнутости.

Для 3D ломаной также учитывает z-координаты точек.

Point

randomPointInside()

Возвращает случайно выбранную точку из области заливки ломаной (как если бы она была замкнутой).

double

getXMax()

Возвращает x-координату нижнего правого угла ограничивающего ломаную прямоугольника.

double

getXMin()

Возвращает x-координату верхнего левого угла ограничивающего ломаную прямоугольника.

double

getYMax()

Возвращает y-координату нижнего правого угла ограничивающего ломаную прямоугольника.

double

getYMin()

Возвращает y-координату верхнего левого угла ограничивающего ломаную прямоугольника.


См. также

 Перемещение фигуры

 Изменение размера фигуры

 Вращение фигуры

 Изменение цвета фигуры

 Изменение внешнего вида линии контура фигуры

 Изменение уровня расположения фигуры при наложении фигур

 Управление видимостью фигур

 Выравнивание фигур