1С:Математический конструктор

Библиотечные функции

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

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

Функция

Описание

Использование

ФУНКЦИИ ИЗМЕРЕНИЯ

dist

Расстояние

Вычисляет расстояние между двумя точками.

dist(точка1; точка2);

точка1: ID первой точки
точка2: ID второй точки

length

Длина отрезка, окружности, дуги

Вычисляет длину отрезка, окружности или дуги.

length(кривая);

кривая: ID отрезка, окружности или дуги

angle

Угол по трём точкам (градусы)

Вычисляет угол, образованный тремя точками, в градусах.

angle(точка1; точка2; точка3);

точка1: ID первой точки
точка2: ID второй точки – вершины угла
точка3: ID третьей точки

angle

Угол между векторами, лучами, прямыми (градусы)

Вычисляет угол между двумя векторами, лучами или прямыми в градусах.

angle(прямая1; прямая2);

прямая1: ID первой линии
прямая2: ID второй линии

signedAngle

Угол (со знаком) по трём точкам (градусы)

Вычисляет угол со знаком, образованный тремя точками, в градусах. Знак зависит от ориентации угла.

signedAngle(точка1; точка2; точка3);

точка1: ID первой точки
точка2: ID второй точки – вершины угла
точка3: ID третьей точки

signedAngle

Угол (со знаком) по трём точкам (радианы)

Вычисляет угол со знаком, образованный тремя точками, в радианах. Знак зависит от ориентации угла.

signedAngle(точка1; точка2; точка3; RADIAN);

точка1: ID первой точки
точка2: ID второй точки – вершины угла
точка3: ID третьей точки

signedAngle

Угол (со знаком) между векторами, лучами, прямыми (градусы)

Вычисляет угол со знаком между двумя векторами, лучами или прямыми в градусах. Знак зависит от ориентации угла.

signedAngle(прямая1; прямая2);

прямая1: ID первой линии
прямая2: ID второй линии

signedAngle

Угол (со знаком) между векторами, лучами, прямыми (радианы)

Вычисляет угол со знаком между двумя векторами, лучами или прямыми в радианах. Знак зависит от ориентации угла.

signedAngle(прямая1; прямая2; RADIAN);

прямая1: ID первой линии
прямая2: ID второй линии

arc

Угловая величина дуги (градусы)

Вычисляет угловую величину дуги в градусах.

arc(дуга);

дуга: ID дуги

getX

Координата X

Вычисляет координату точки по X.

getX(точка);

точка: ID точки

getY

Координата Y

Вычисляет координату точки по Y.

getY(точка);

точка: ID точки

parameter

Параметр на кривой

Вычисляет параметр точки, лежащей на кривой.

parameter(точка);

точка: ID точки, лежащей на кривой

area

Площадь многоугольника, круга, сектора или сегмента

Вычисляет площадь многоугольника, круга, сектора или сегмента.

area(многоугольник);

многоугольник: ID многоугольника, круга, сектора или сегмента

areaOri

Ориентированная площадь многоугольника

Вычисляет площадь многоугольника с учетом ориентации.

areaOri(многоугольник);

многоугольник: ID многоугольника

area

Площадь (по точкам)

Вычисляет площадь многоугольника с вершинами в указанных точках.

area(точка1; точка2; точка3; точка4; точка5; точка6);

точка1: точка 1
точка2: точка 2
точка3: точка 3
и т.д.

areaOri

Ориентированная площадь (по точкам)

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

areaOri(точка1; точка2; точка3; точка4; точка5; точка6);

точка1: точка 1
точка2: точка 2
точка3: точка 3
и т.д.

integral

Определённый интеграл от функции одной переменной

Вычисляет определённый интеграл от функции одной переменной на заданном отрезке и при заданном количестве узлов.

integral(функция; нижний_предел; верхний_предел; количество_узлов);

функция: интегрируемая функция, без скобок и заполнителя аргумента
нижний_предел: нижний предел интегрирования
верхний_предел: верхний предел интегрирования
количество_узлов: количество узлов интегрирования на данном отрезке

radius

Радиус окружности или дуги

Вычисляет радиус окружности или дуги.

radius(окружность);

окружность: ID окружности

perimeter

Периметр многоугольника или длина окружности

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

perimeter(многоугольник);

многоугольник: ID многоугольника, окружности или дуги

ratios

Отношение трёх точек AB/BC

Вычисляет отношение расстояний AB/BC для трёх точек.

ratios(точка1; точка2; точка3);

точка1: точка A
точка2: точка B
точка3: точка C

ratios

Отношение двух отрезков

Вычисляет отношение длин двух отрезков.

ratios(отрезок1; отрезок2);

отрезок1: первый отрезок
отрезок2: второй отрезок

ФУНКЦИИ ДЛЯ РАБОТЫ С ТАБЛИЦАМИ

colAvg

Среднее значение в столбце

Вычисляет среднее значение в указанном столбце таблицы.

colAvg(столбец);

столбец: столбец таблицы

colMode

Мода в столбце

Вычисляет моду в указанном столбце таблицы.

colMode(столбец);

столбец: столбец таблицы

colMedian

Медиана в столбце

Вычисляет медиану в указанном столбце таблицы.

colMedian(столбец);

столбец: столбец таблицы

colVar

Дисперсия в столбце

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

colVar(столбец);

столбец: столбец таблицы

colStDev

Стандартное отклонение в столбце

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

colStDev(столбец);

столбец: столбец таблицы

colFreq

Частота значения в столбце

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

colFreq(столбец; значение);

столбец: столбец таблицы
значение: число

colCount

Количество значений в столбце

Вычисляет, сколько раз заданное значение встречается в указанном столбце таблицы.

colCount(столбец; значение);

столбец: столбец таблицы
значение: число

colSum

Сумма в столбце

Вычисляет сумму значений величин в указанном столбце таблицы.

colSum(столбец);

столбец: столбец таблицы

colSumSq

Сумма квадратов в столбце

Вычисляет сумму квадратов значений величин в указанном столбце таблицы.

colSumSq(столбец);

столбец: столбец таблицы

rowCount

Количество строк в столбце

Подсчитывает количество строк в указанном столбце таблицы.

rowCount(столбец);

столбец: столбец таблицы

colMin

Минимум в столбце

Находит минимальное значение в указанном столбце таблицы.

colMin(столбец);

столбец: столбец таблицы

colMax

Максимум в столбце

Находит максимальное значение в указанном столбце таблицы.

colMax(столбец);

столбец: столбец таблицы

colCovariance

Ковариация двух столбцов

Находит ковариацию двух столбцов, принадлежащих одной таблице или двум разным таблицам.

colCovariance(столбец1; столбец2);

столбец1: первый столбец
столбец2: второй столбец

colCorrelation

Коэффициент корреляции двух столбцов

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

colCorrelation(столбец1; столбец2);

столбец1: первый столбец
столбец2: второй столбец

ФУНКЦИИ СТАТИСТИКИ

random

Случайное число из (0;1)

Возвращает псевдослучайное число между нулем и единицей.

random();

gauss

Плотность нормального распределения

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

gauss(аргумент);

аргумент: число

itemsCount

Количество повторений заданного значения в испытании

Вычисляет, сколько раз в испытании возникает данное значение.

itemsCount(испытание; значение);

испытание: испытание, в результатах которого производится подсчёт
значение: число

itemsSum

Сумма значений в испытании

Вычисляет сумму значений, получившихся в испытании.

itemsSum(испытание);

испытание: испытание, в результатах которого производится подсчёт

itemsMin

Минимальное значение в испытании

Находит минимальное значение из получившихся в испытании.

itemsMin(испытание);

испытание: испытание, в результатах которого производится подсчёт

itemsMax

Максимальное значение в испытании

Максимальное значение из получившихся в испытании.

itemsMax(испытание);

испытание: испытание, в результатах которого производится подсчёт

itemsValue

Значение k-го элемента испытания

Находит значение k-го по счёту элемента испытания.

itemsValue(испытание; номер);

испытание: испытание, в результатах которого производится подсчёт
номер: целое число от 1 до количества элементов в испытании

itemsDifferent

Число различных значений в испытании

Находит количество различных значений, полученных в данном испытании.

itemsDifferent(испытание);

испытание: испытание, в результатах которого производится подсчёт

СИСТЕМНЫЕ ФУНКЦИИ

alert

Сообщение

Выдает сообщение с указанным текстом.

alert('текст');

текст: текст сообщения

confirm

Подтверждение

Выдает сообщение с указанным текстом и кнопками "OK" и "Cancel". Возвращает значение true, если пользователь выбирает "OK", или false, если пользователь выбирает "Cancel".

confirm('текст');

текст: текст сообщения

prompt

Приглашение

Выдает сообщение с указанным текстом и полем ввода. Значение, введенное пользователем в поле, будет возвращено. Если указано значение_по_умолчанию, то оно будет выведено в поле ввода. Иначе используется значение undefined.

prompt('текст'; значение_по_умолчанию);

текст: текст сообщения
значение_по_умолчанию: значение по умолчанию для поля ввода

setInterval

Создать таймер

Создает таймер, периодически выполняющий указанную функцию, с указанным периодом (в миллисекундах). Опциональный аргумент `дляАнимации` может использоваться, чтобы указать, что вызываемая функция выполняет какую-либо анимацию, и необходимо оптимизировать прорисовку для более плавного движения. Возвращает объект, идентифицирующий созданный таймер.

setInterval(период; функция[; дляАнимации]);

период: период запуска таймера в миллисекундах
функция: исполняемая функция
дляАнимации: включить оптимизацию для анимации (необязательно)

clearInterval

Остановить таймер

Останавливает таймер, созданный вызовом setInterval.

clearInterval(таймер);

таймер: объект, созданный вызовом setInterval

setTimeout

Создать однократный таймер

Создает таймер, однократно выполняющий указанную функцию через указанный период времени (в миллисекундах). Возвращает объект, идентифицирующий созданный таймер.

setTimeout(функция; задержка);

функция: исполняемая функция
задержка: задержка (в миллисекундах) перед запуском функции

clearTimeout

Остановить однократный таймер

Останавливает таймер, созданный вызовом setInterval.

clearTimeout(таймер);

таймер: объект, созданный вызовом setTimeout

eval

Выполнить строку

Интерпретирует и выполняет строку.

eval(строка);

строка: исполняемый код

МАТЕМАТИЧЕСКИЕ ФУНКЦИИ

abs

Модуль

Возвращает абсолютное значение аргумента.

abs(аргумент);

аргумент: число

sqrt

Квадратный корень

Возвращает квадратный корень аргумента.

sqrt(аргумент);

аргумент: число

exp

Экспонента

Возвращает экспоненту аргумента.

exp(аргумент);

аргумент: число

pow

Степень

Возвращает результат возведения основания в указанную степень.

pow(основание; степень);

основание: число
степень: число

Натуральный логарифм

Возвращает логарифм аргумента по основанию e.

ln(аргумент);

аргумент: число

Десятичный логарифм

Возвращает десятичный логарифм аргумента.

lg(аргумент);

аргумент: число

Факториал

Возвращает факториал от аргумента.

F(аргумент);

аргумент: число

Кол-во сочетаний из N по k

Возвращает количество сочетаний из N объектов по k.

C(N; k);

N: число
k: число

Кол-во размещений из N по k

Возвращает количество размещений из N объектов по k.

A(N; k);

N: число
k: число

sign

Знак

Возвращает -1, 0 или 1, если аргумент соответственно отрицательный, равен 0, положительный.

sign(аргумент);

аргумент: число

round

Округление до целого

Округление аргумента до ближайшего целого числа.

round(аргумент);

аргумент: число

floor

Целая часть

Возвращает целую часть аргумента.

floor(аргумент);

аргумент: число

toDegrees

Из радиан в градусы

Переводит заданную величину угла из радиан в градусы.

toDegrees(аргумент);

аргумент: число

toRadians

Из градусов в радианы

Переводит заданную величину угла из градусов в радианы.

toRadians(аргумент);

аргумент: число

sin

Синус

Возвращает синус аргумента, заданного в радианах.

sin(аргумент);

аргумент: число

cos

Косинус

Возвращает косинус аргумента, заданного в радианах.

cos(аргумент);

аргумент: число

tg (tan)

Тангенс

Возвращает тангенс аргумента, заданного в радианах.

tg(аргумент);

аргумент: число

ctg

Котангенс

Возвращает котангенс аргумента, заданного в радианах.

ctg(аргумент);

аргумент: число

arcsin (asin)

Арксинус

Возвращает арксинус аргумента в диапазоне от –p/2 до p/2.

arcsin(аргумент);

аргумент: число от –1 до 1

arccos (acos)

Арккосинус

Возвращает арккосинус аргумента в диапазоне от 0 до p.

arccos(аргумент);

аргумент: число от –1 до 1

arctg (atan)

Арктангенс

Возвращает арктангенс аргумента в диапазоне от –p/2 до p/2.

arctg(аргумент);

аргумент: число

arcctg

Арккотангенс

Возвращает арккотангенс аргумента в диапазоне от 0 до p.

arcctg(аргумент);

аргумент: число

det

Определитель матрицы

Возвращает определитель заданной квадратной матрицы.

det(аргумент);

аргумент: матрица

min

Минимальное из значений

Возвращает минимальное из двух заданных значений.

min(значение1; значение2);

значение1: число
значение2: число

max

Максимальное из значений

Возвращает максимальное из двух заданных значений.

max(значение1; значение2);

значение1: число
значение2: число

ФУНКЦИИ ДЛЯ РАБОТЫ С ОБЪЕКТАМИ

movePointTo

Двигать точку (мгновенно)

Мгновенно двигает одну точку к другой.

movePointTo(точка; цель);

точка: двигаемая точка
цель: точка, к которой двигаться

smoothMovePointTo

Двигать точку (плавно)

Плавно двигает одну точку к другой с указанной скоростью.

smoothMovePointTo(точка; цель; скорость);

точка: двигаемая точка
цель: точка, к которой двигаться
скорость: скорость в долях необходимого пути

setParameterTo

Задать параметр (мгновенно)

Мгновенно изменяет значение параметра.

setParameterTo(параметр; значение);

параметр: ID изменяемого параметра
значение: новое значение параметра

changeParameterTo

Изменить параметр (плавно)

Плавно изменяет значение параметра с заданной скоростью.

changeParameterTo(параметр; значение; скорость; кадров-в-секунду);

параметр: ID изменяемого параметра
значение: конечное значение параметра
скорость: скорость в долях необходимого изменения
кадров-в-секунду: желаемое количество кадров в секунду (по умолчанию - 50)

showObjeсts

Показать объекты

Показывает спрятанные объекты.

showObjects(объект1; объект2; объект3);

объект1: объект 1
объект2: объект 2
объект3: объект 3
и т.д.

hideObjeсts

Скрыть объекты

Скрывает объекты.

hideObjects(объект1; объект2; объект3);

объект1: объект 1
объект2: объект 2
объект3: объект 3
и т.д.

toggleObjectsVisibility

Переключить видимость объектов

Переключает видимость объектов на противоположную.

toggleObjectsVisibility(объект1; объект2; объект3);

объект1: объект 1
объект2: объект 2
объект3: объект 3
и т.д.

enableTracing

Включить рисование следа

Включить рисование следа для указанных объектов.

enableTracing(объект1; объект2; объект3);

объект1: объект 1
объект2: объект 2
объект3: объект 3
и т.д.

disableTracing

Выключить рисование следа

Выключить рисование следа для указанных объектов.

disableTracing(объект1; объект2; объект3);

объект1: объект 1
объект2: объект 2
объект3: объект 3
и т.д.

toggleTracing

Включить/отключить след объектов

Включает/отключает след для указанных объектов.

toggleTracing(объект1; объект2; объект3);

объект1: объект 1
объект2: объект 2
объект3: объект 3
и т.д.

clearTraces

Удалить все следы

Удаляет все следы.

clearTraces();

animate

Создать анимацию

Создает анимацию точки на кривой.

аниматор = animate(точка; скорость; начало; конец; тип; аниматор);

точка: анимируемая точка
скорость: приращение параметра точки на кривой
начало: начальный параметр точки на кривой
конец: конечный параметр точки на кривой
тип: тип анимации (WIGWAG, CYCLIC, ONCE)
аниматор: объект-аниматор

stopAllAnimations

Остановить все анимации

Останавливает все анимации на листе.

stopAllAnimations();

presentation

Создать презентацию

Создает презентацию из действий, определяемых перечисленными кнопками.

presentation(действие1; интервал1; действие2; интервал2);

действие1: ID первой кнопки
интервал1: интервал между первым и вторым действиями (в мс)
действие2: ID второй кнопки
интервал2: интервал между вторым и третьим действиями (в мс)
и т.д.

setActiveSheet

Выбрать текущий лист

Делает указанный лист текущим.

setActiveSheet(лист);

лист: номер (начиная с 0) или имя листа, который нужно сделать текущим

reloadSheet

Перезагрузить чертёж на листе

Перезагружает чертёж на активном листе.

reloadSheet();

reloadWorkbook

Перезагрузить чертёжи на всех листах

Перезагружает чертёжи на всех листах открытого документа.

reloadWorkbook();

ФУНКЦИИ ДЛЯ ПРОВЕРКИ ПОСТРОЕНИЙ

check

Проверить объект

Проверяет построение для данного объекта.

check(лист; объект);

лист: лист с проверяемым объектом
объект: проверяемый объект

checkPoint

Проверить точку

Проверяет построение для данной точки.

checkPoint(лист; точка);

лист: лист с проверяемой точкой
точка: проверяемая точка

checkSegment

Проверить отрезок

Проверяет построение для данного отрезка.

checkSegment(лист; отрезок);

лист: лист с проверяемым отрезком
отрезок: проверяемый отрезок

checkLine

Проверить прямую

Проверяет построение для данной прямой.

checkLine(лист; прямая);

лист: лист с проверяемой прямой
прямая: проверяемая прямая

checkCircle

Проверить окружность

Проверяет построение для данной окружности.

checkCircle(лист; окружность);

лист: лист с проверяемой окружностью
окружность: проверяемая окружность

checkArc

Проверить дугу

Проверяет построение для данной дуги.

checkArc(лист; дуга);

лист: лист с проверяемой дугой
дуга: проверяемая дуга

isCongruent

Проверка конгруэнтности двух фигур

Проверяет, конгруэнтны ли две геометические фигуры.

isCongruent(фигура1; фигура2);

фигура1: первая фигура
фигура2: вторая фигура

existCongruent

Проверка существования конгруэнтной фиигуры

Проверяет, существует ли фигура, конгруэнтная данной.

existCongruent(фигура);

фигура: ID фигуры

areAligned

Проверка коллинеарности трёх точек или параллельности двух отрезков/лучей/прямых

Проверяет коллинеарность трёх указанных точек или параллельность двух прямых, лучей, отрезков.

areAligned(точка1; точка2; точка3);

точка1: первая точка
точка2: вторая точка
точка3: третья точка

или

areAligned(прямая1; прямая2);

прямая1: первая линия
прямая2: вторая линия

checkInputField

Проверить поле ввода

Проверяет значение для поля ввода.

checkInputField(поле; значение; значение2; значение3);

поле: проверяемое поле ввода
значение: допустимое значение
значение2: другое допустимое значение
значение3: другое допустимое значение
и т.д.

checkCheckbox

Проверить чекбокс

Проверяет значение для чекбокса.

checkCheckbox(чекбокс; значение);

чекбокс: проверяемый чекбокс
значение: допустимое значение

ФУНКЦИИ ДЛЯ РАБОТЫ СО SCORM-СИСТЕМАМИ

SCORM.isAvailable

Проверка соединения с платформой

Возвращает true/false, в зависимости от того, доступно ли сейчас соединение с SCORM-системой. Если возвращаемое значение false, никакие другие методы объекта SCORM вызывать не имеет смысла.

SCORM.isAvailable();

SCORM.getDataValue

Получение значения

Получает значение по имени name.

SCORM.getDataValue(name);

name: имя

SCORM.setDataValue

Установка значения

Сохраняет значение value под именем name.

SCORM.setDataValue(name; value);

name: имя
value: значение

SCORM.commitData

Подтверждение данных

Подтверждает все сохраненные значения.

SCORM.commitData();

SCORM.getLearnerID

Идентификатор пользователя

Возвращает идентификатор ученика (пользователя системы).

SCORM.getLearnerID();

SCORM.getLearnerName

Имя пользователя

Возвращает имя ученика (пользователя системы).

SCORM.getLearnerName();

SCORM.getScore

Получение оценки

Возвращает текущую оценку ученика (от 0 до 1).

SCORM.getScore();

SCORM.setScore

Установка оценки

Устанавливает текущую оценку ученика (от 0 до 1).

SCORM.getScore(оценка);

оценка: устанавливаемая оценка (число от 0 до 1)

SCORM.setSuspendData

Сохранение данных

Сохраняет произвольные строковые данные, необходимые программе (например, ее текущее состояние). Размер до 1000 символов.

SCORM.setSuspendData(данные);

данные: сохраняемые данные

SCORM.getSuspendData

Получение данных

Возвращает данные, сохраненные ранее методом setSuspendData().

SCORM.getSuspendData();

Руководство пользователя

динамической программной среды «Математический конструктор»

Библиотечные функции