Образовательный виртуальный мир vAcademia

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

Для того, чтобы добавить в композицию изображение существует функция imageFromServerResource, которая принимает четыре параметра:

• x, y изображения относительно левого верхнего угла композиции;
• серверный ресурс изображений (получаемый через getServerResource);
• объект композиции, к которому прикрепляется изображение.

Для того, чтобы добавить в композицию текстовый элемент существует функция createText, которая возвращает объект текстового элемента, принимая 8 параметров:

• x, y текста относительно левого верхнего угла композиции;
• название шрифта, например: Arial;
• булевый флаг, должен ли текст быть жирным;
• булевый флаг, должен ли текст быть курсивным;
• булевый флаг, должен ли текст быть подчеркнутым;
• цвет шрифта в HTML-стиле, например, #FF00FF;
• строка с текстом;
• объект композиции, к которому прикрепляется текстовый элемент.

Для того, чтобы добавить в композицию прямоугольник заданного цвета существует функция createColorRect, которая возвращает объект цветового прямоугольника, принимая 6 параметров:

• x, y прямоугольника относительно левого верхнего угла композиции;
• ширина и высота прямоугольника;
• цвет прямоугольника в HTML-стиле, например, #FF00FF;
• объект композиции, к которому прикрепляется прямоугольник.

Для того, чтобы добавить в композицию линию существует функция createLine, которая возвращает объект линии, принимая 7 параметров:

• x, y одного конца линии;
• x, y второго конца линии;
• толщина линии;
• цвет линии в HTML-стиле, например, #FF00FF;
• объект композиции, к которому прикрепляется линия.

Для того, чтобы заменить текстуру на 3D-объекте необходимо вызвать метод 3D-объекта replaceByGeneratedTexture, который возвращает объект изображения, принимая 4 параметра:

• номер текстуры в 3D-объекте;
• ширину генерируемой текстуры;
• высоту генерируемой текстуры;
• объект композиции.

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

var obj = scene.getObjectByName("uniq");
scene.img1986 = getServerResource("uo_lection_1.png");
obj.onPress = function()

{
  var c = createComposition();
  var txt = createText(5, 5, "Arial", true, true, true, "#FF0000", "MyText5", c);
  var txt2 = createText(5, 35, "Verdana", false, true, true, "#00FF00", "MyText2", c);
  var img = imageFromServerResource(30, 30, scene.img1986, c);
  this.replaceByGeneratedTexture(0, 256, 256, c);
}

У объекта изображения доступны для последующего изменения нижеперечисленные свойства:

• width, height – высота и ширина для отображения. По умолчанию равны ширине и высоте исходного изображения.

У объекта изображения и у объекта текстового элемента есть функция getMediaSize(), которая задает объект, возвращающий реальные размеры исходного элемента, например, размер текста или исходный размер изображения.

var img = imageFromServerResource(30, 30, scene.img1986, c);
var width = img.getMediaSize().width;
var height = img.getMediaSize().height;