На ладони

Математика в скриптах Коута

2016-01-26T21:09:00.001+02:00

Всё думал, как лучше показать работу с векторами, волшебными квадратами, кватернионами и углами Эйлера в 3D-Coat... Этой цели хорошо подходит моделирование движения камеры вокруг сцены, но работа с камерой в скриптах будет позже, поэтому делаю простой обзор: наверняка Вы найдёте применение этой математике в своих скриптах.

Объекты математики могут изменять себя или возвращать изменённую копию. Методы, возвращающие копию объекта, заканчиваются на `Copy`. Например, когда ниже написано `normalize[Copy]()`, значит, класс имеет два метода:

normalize() - меняет сам объект
normalizeCopy() - возвращает изменённую копию

Векторы Хэвисайда

Vec3

// конструкторы
// все значения вектора равны 10.1
Vec3  a( 10.1 );
// инициализация XYZ
Vec3  b( 10.1, 20.2, -30.3 );
Vec3  c = { 10.1, 20.2, -30.3 };

// преобразование вектора в строку
auto  sa = string( a );

// проверка состояния
bool  stateN = a.normalized();
bool  stateZ = a.zero();

// получение элементов вектора
float  x = c[ 0 ];
float  y = c[ 1 ];
float  z = c[ 2 ];
// или
float  x = c.x();
float  y = c.y();
float  z = c.z();

// инициализация элементов
a[ 0, Значение ];
a[ 1, Значение ];
a[ 2, Значение ];
// или
a.x( Значение );
a.y( Значение );
a.z( Значение );

// арифметика
auto  negA = -a;
a += b;
a -= b;
a *= c;
a /= c;
a *= 77;
a /= 77;
Vec3  d = a + b;
Vec3  e = a - b;
Vec3  f = a * b;
Vec3  g = a / b;
Vec3  h = a * 77;
Vec3  i = a / 77;
Vec3  j = 77 * a;

// угол между двумя векторами
float  angle = a.angle( b );

// расстояние
float  distance = a.distance( b );

// скалярное произведение
float  dot = a.dot( b );

// длина вектора
float  length = c.length();

// модуль
c.abs();
auto  r = c.absCopy();
// # Далее эти две строки будут показываться как одна в виде:
//   c.abs[Copy]();

// обрезание вектора по длине
// здесь: "не короче 10 и не длиннее 20.5"
c.clamp[Copy]( 10, 20.5 );
// здесь: "ровно 10"
c.truncate[Copy]( 10 );

// векторное произведение
c.cross[Copy]( b );

// выбор макс / мин значения из этого вектора и предложенного
a.max[Copy]( b );
a.min[Copy]( b );

// нормализация вектора
a.normalize[Copy]();

// отражение
a.reflect[Copy]( b );

// преломление
a.refract[Copy]( b, angle );

Матрицы Сильвестра

Mat3

// конструкторы
Mat3  a( 1, 2, 3,
         4, 5, 6,
         7, 8, 9 );
Mat3  b = { 1, 2, 3,
            4, 5, 6,
            7, 8, 9 };

// преобразования матрицы 3x3
auto  sa = Angles( a );
auto  sm = Mat4( a );
auto  sq = Quat( a );
auto  ss = string( a );

// проверка состояния
bool  stateI = a.identity();
bool  stateO = a.orthonormal();
bool  stateS = a.symmetric();
bool  stateZ = a.zero();

// получение элементов матрицы
float  e00 = a[ 0, 0 ];
float  e01 = a[ 0, 1 ];
// ...
float  e22 = a[ 2, 2 ];

// инициализация элементов
a[ 0, 0, Значение ];
a[ 0, 1, Значение ];
// ...
a[ 2, 2, Значение ];

// арифметика
auto  negA = -a;
a += b;
a -= b;
a *= c;
a *= 77;
a /= 77;
Vec3  d = a + b;
Vec3  e = a - b;
Vec3  f = a * b;
Vec3  h = a * 77;
Vec3  i = a / 77;
Vec3  j = 77 * a;

// детерминант
float  determinant = a.determinant();

// трассировка
float  trace = a.trace();

// инверсия
a.invert[Copy]();

// нормализация
a.orthonormalize[Copy]();

// транспонирование
a.transpose[Copy]();

Mat4

// конструкторы
Mat4  a( 1,  2,  3,  4,
         5,  6,  7,  8,
         9, 10, 11, 12 );
Mat4  b = { 1,  2,  3,  4,
            5,  6,  7,  8,
            9, 10, 11, 12 };

Mat3  rotation = { 0, 0, 1,
                   1, 0, 0,
                   0, 1, 0 };
Vec3  translation = { -100, -20, 50 };
Mat4  c( rotation, translation );

Vec3  scaling = { 1, 20, 300 };
Mat4  d( scaling, translation );

// преобразования матрицы 4x4
auto  sm = Mat3( a );
auto  sq = Quat( a );
auto  ss = string( a );

// проверка состояния
bool  stateI = a.identity();
bool  stateO = a.orthonormal();
bool  stateS = a.symmetric();
bool  stateZ = a.zero();

// получение элементов матрицы
float  e00 = a[ 0, 0 ];
float  e01 = a[ 0, 1 ];
// ...
float  e33 = a[ 3, 3 ];

// инициализация элементов матрицы
a[ 0, 0, Значение ];
a[ 0, 1, Значение ];
// ...
a[ 3, 3, Значение ];

// арифметика
auto  negA = -a;
a += b;
a -= b;
a *= c;
a *= 77;
a /= 77;
Vec3  d = a + b;
Vec3  e = a - b;
Vec3  f = a * b;
Vec3  h = a * 77;
Vec3  i = a / 77;
Vec3  j = 77 * a;

// детерминант
float  determinant = a.determinant();

// трассировка
float  trace = a.trace();

// инверсия
a.invert[Copy]();

// транспонирование
a.transpose[Copy]();

Углы Эйлера

// конструкторы
Angles  a( 1, 2, 3 );
Angles  b = { -1.1, 2.2, -3.3 };

// преобразования
auto  sm = Mat3( a );
auto  sn = Mat4( a );
auto  sq = Quat( a );
auto  sa = string( a );

// проверка состояния
bool  stateZ = a.zero();

// получение элементов
float  pitch = a[ 0 ];
float  yaw   = a[ 1 ];
float  roll  = a[ 2 ];
// или
float  pitch = a.pitch();
float  yaw   = a.yaw();
float  roll  = a.roll();

// инициализация элементов
a[ 0, Значение ];
a[ 1, Значение ];
a[ 2, Значение ];
// или
a.pitch( Значение );
a.yaw( Значение );
a.roll( Значение );

// арифметика
auto  negA = -a;
a += b;
a -= b;
a *= 77;
a /= 77;
Vec3  d = a + b;
Vec3  e = a - b;
Vec3  h = a * 77;
Vec3  i = a / 77;
Vec3  j = 77 * a;

// нормализация углов
a.normalize180[Copy]();
a.normalize360[Copy]();

Кватернионы Гамильтона

// конструкторы
Quat  a( 1.1, 2.2, 3.3, 50 );
Quat  b = { 1.1, 2.2, -3.3, 50 };
Quat  c = a * 10;

// преобразования кватерниона
auto  sa = Angles( a );
auto  sm = Mat3( a );
auto  sn = Mat4( a );
auto  ss = string( a );

// проверка состояния
bool  stateN = a.normalized();
bool  stateZ = a.zero();

// получение элементов
float  x = a[ 0 ];
float  y = a[ 1 ];
float  z = a[ 2 ];
float  w = a[ 3 ];
// или
float  x = a.x();
float  y = a.y();
float  z = a.z();
float  w = a.w();

// инициализация элементов
a[ 0, Значение ];
a[ 1, Значение ];
a[ 2, Значение ];
a[ 3, Значение ];
// или
a.x( Значение );
a.y( Значение );
a.z( Значение );
a.w( Значение );

// арифметика
auto  negA = -a;
a += b;
a -= b;
a *= c;
a /= c;
a *= 77;
a /= 77;
Vec3  d = a + b;
Vec3  e = a - b;
Vec3  f = a * b;
Vec3  g = a / b;
Vec3  h = a * 77;
Vec3  i = a / 77;
Vec3  j = 77 * a;

// скалярное произведение
float  dot = a.dot( b );

// длина
float  length = c.length();

// вычисление `w`
c.calcW[Copy]();

// устанавливает `w = 0` и
// меняет знак для `xyz`, если было `w < 0`
a.compress[Copy]();

// сопряжение
a.conjugate[Copy]();

// степень
a.exp[Copy]();

// инверсия
a.invert[Copy]();

// логарифм
a.ln[Copy]();

// нормализация
a.normalize[Copy]();

Представленные выше классы соблюдают принятые для скриптинга соглашения. А именно:

Можно строить цепочки методов.

v.abs().normalize();

Объекты одного класса сравниваются оператором `==`.

if (a == b) ...

При переводе объекта в строку, получаем его состояние в формате JSON.

[10.1, 20.2, -30.3]

Как-то незаконченно получилось... Закончу списком хороших статей, которые наглядно рассказывают о векторах, матрицах и кватернионах. Где список? В этом же абзаце, см. ссылки!) И отличные видео-лекции на закуску: игры и математика.

3D-Coat, AngelScript, Debugging

2015-12-29T18:00:00.000+02:00

§ Читать по-русски →

Scripts in 3D-Coat could be complex: because they are written in AngelScript, which is a C++ like language, and many large-scale and successful projects were written, using it. In order to help programmers, I added possibility to perform debugging, including one specific to 3D-Coat. Including the code, of course:

Debug  dbg;
// text log, menu `Scripts / View execution log`
DebugLog  log = dbg.log();
// viewport log
DebugDraw  drw = dbg.draw();

Add the following three line in the beginning of each script, and we have access to text log-file (`log`) and graphic viewport elements (`drw`) of Coat.

void main() {

    log.clear();
    drw.clear().color( 0xFFFFEE00 );

    // ...
}

What can we type to log?

// the concrete value of variable
float  delta = 1.2345;
log += delta;

// math result
// @see AngelScript math functions
log += pow( a, 3 ) * sqrt( 2 ) / 12;

// note
log +=
    "This is a debug-note."
    " We do treat variables provisionally as constants.";

// all local variables
log += dbg.vars();
// or (any longe, where more one variant, write without "or")
log += dbg.variables();

// all global variables
log += dbg.gvars();
log += dbg.globalVariables();

// current callstack
log += dbg.callstack();

// mesh like text
Builder  builder;
const Mesh  a = builder.cylinder()
  .positionTop( Vec3( 0, 120, 0 ) )
  .positionBottom( Vec3( 0, 0, 0 ) )
  .radiusTop( 50 )
  .radiusBottom( 50 )
  .details( 0.1 )
  ();
log += a;

What can we display in the viewport?

// point( position, color )
drw.point( Vec3( 50, 0, 0 ) );
drw.point( Vec3( 50, 60, 0 ), Color( 0xFFAAFF33 ) );

// line( startPosition, endPosition, startColor, endColor )
drw.line( Vec3( 0, 0, 0 ), Vec3( 100, 50, 25 ) );
drw.line( Vec3( 0, 50, 0 ), Vec3( 0, 200, 25 ),
    Color( 0xFF33FF33 ) );
drw.line( Vec3( 100, 120, 0 ), Vec3( 100, 250, 25 ),
    Color( 0xFFAA0000 ), Color( 0xFF0000AA ) );

// circle( position, normal, radius, color )
drw.circle( Vec3( 0, 0, 0 ), Vec3( 100, 50, 25 ), 20 );
drw.circle( Vec3( 0, 50, 0 ), Vec3( 0, 200, 25 ), 50,
    Color( 0xFF55FFAA ) );

// sphere( position, radius, color )
drw.sphere( Vec3( 0, 0, 0 ), 15 );
drw.sphere( Vec3( 0, 50, 0 ), 45,
    Color( 0x9955FFAA ) );

// triangle( A, B, C, colorA, colorB, colorC )
const Vec3  a( 0, 0, 0 );
const Vec3  b( 80, 30, 70 );
const Vec3  c( 10, 25, 100 ) );
drw.triangle( a, b, c );
drw.triangle( a, b, c,
    Color( 0x77AA0000 ) );
drw.triangle( a, b, c,
    Color( 0xFFAA0000 ), Color( 0xFF00AA00 ), Color( 0xFF0000AA ) );

// note( position, text )
drw.note( Vec3( 0, 0, 0 ),  "Note A" );
drw.note( Vec3( 0, 30, 0 ), "Note B",
    Color( 0xFF33FF33 ) );
drw.note( Vec3( 0, 0, 20 ),  111 );
drw.note( Vec3( 0, 30, 20 ), 222.51,
    Color( 0xFF33FF33 ) );

Complex visualization can be separated to layers to show / hide them separately. This can be done easily:

drw += "My 1";
drw.layer( "My 1" );
// drawing in the layer `My 1`
// ...
drw += "My 2";
// drawing in the layer `My 2`
// ...

Vectors, matrix, boxes (know what is AABB?), etc. won't be here: obviously, typing / visualization are simple:

log += MyObject;
drw += MyObjectWhichCanBeDraw;

Lastly, a smallest example of using 3D-Coat's possibilities for quick 3D-visualization.

Debug  dbg;
DebugDraw  drw = dbg.draw();

void main() {

    drw.clear().color( 0xFFFFEE00 );
    Step( 1 );

    // parameter function
    const float  S = 10;
    const float  D = 180 * 4;
    const float  step = 0.5;
    for ( float t = -D; t <= D; t += step ) {
        const float  angle = t * 3.14 / 180;
        const float  x = t * sin( angle ) * sin( angle );
        const float  y = x * cos( angle );
        const float  z = y * cos( angle ) * cos( angle );
        const Vec3  p( x, y, z );
        drw.vector( p * S, p * S / 2,
            Color( 0xFF000000 ), Color( 0xFF1100BB ) );
        drw.sphere( p * S, 100, Color( 0xFFFFEE00 ) );
        // the script working too fast) push a pause
        if ( ceil( x * y * z * S ) % 5 == 0 ) {
            Step( 1 );
        }
    } // for ...
}

Result

3D-Coat, AngelScript, отладка

2015-12-29T15:52:00.002+02:00

§ Read in English →

Скрипты в 3D-Coat могут быть сложными: ведь они пишутся на AngelScript, а с этим языком уже связано довольно много больших и успешных проектов. Чтобы помочь программистам, добавил некоторые возможности отладки, включая специфичные для 3D-приложений. По традиции, сразу код:

Debug  dbg;
// текстовый лог, меню `Скрипты / Посмотреть журнал выполнения`
DebugLog  log = dbg.log();
// вьюпорт, графика
DebugDraw  drw = dbg.draw();

Эти три строки включаем в начало своих скриптов - и получаем доступ к текстовому лог-файлу (`log`) и графическому вьюпорту (`drw`) Коута.

void main() {

    // подготавливаем текстовый лог
    log.clear();
    // подготавливаем вьюпорт
    //   1) очищаем
    //   2) выбираем цвет кисти по умолчанию
    drw.clear().color( 0xFFFFEE00 );

    // дальше - что хотим показать / отобразить
    // ...
}

Что можем напечатать в лог?

// значения конкретных переменных
float  delta = 1.2345;
log += delta;

// результаты математических операций
// @see AngelScript math functions
log += pow( a, 3 ) * sqrt( 2 ) / 12;

// текст / заметку
log +=
    "This is a debug-note."
    " We do treat variables provisionally as constants.";

// все объявленные локальные переменные
log += dbg.vars();
// или (дальше, когда неск. вариантов, пишу без "или")
log += dbg.variables();

// все объявленные глобальные переменные
log += dbg.gvars();
log += dbg.globalVariables();

// текущий стек вызовов
log += dbg.callstack();

// меш
// да, структура меша появится в виде текста
// исключительно для осознанных жителей "Матрицы")
Builder  builder;
const Mesh  a = builder.cylinder()
  .positionTop( Vec3( 0, 120, 0 ) )
  .positionBottom( Vec3( 0, 0, 0 ) )
  .radiusTop( 50 )
  .radiusBottom( 50 )
  .details( 0.1 )
  ();
log += a;

Что можем отобразить во вьюпорт?

// точку
// point( position, color )
drw.point( Vec3( 50, 0, 0 ) );
drw.point( Vec3( 50, 60, 0 ), Color( 0xFFAAFF33 ) );

// линию
// line( startPosition, endPosition, startColor, endColor )
drw.line( Vec3( 0, 0, 0 ), Vec3( 100, 50, 25 ) );
drw.line( Vec3( 0, 50, 0 ), Vec3( 0, 200, 25 ),
    Color( 0xFF33FF33 ) );
drw.line( Vec3( 100, 120, 0 ), Vec3( 100, 250, 25 ),
    Color( 0xFFAA0000 ), Color( 0xFF0000AA ) );

// круг
// circle( position, normal, radius, color )
drw.circle( Vec3( 0, 0, 0 ), Vec3( 100, 50, 25 ), 20 );
drw.circle( Vec3( 0, 50, 0 ), Vec3( 0, 200, 25 ), 50,
    Color( 0xFF55FFAA ) );

// сферу
// sphere( position, radius, color )
drw.sphere( Vec3( 0, 0, 0 ), 15 );
drw.sphere( Vec3( 0, 50, 0 ), 45,
    Color( 0x9955FFAA ) );

// треугольник
// triangle( A, B, C, colorA, colorB, colorC )
const Vec3  a( 0, 0, 0 );
const Vec3  b( 80, 30, 70 );
const Vec3  c( 10, 25, 100 ) );
drw.triangle( a, b, c );
drw.triangle( a, b, c,
    Color( 0x77AA0000 ) );
drw.triangle( a, b, c,
    Color( 0xFFAA0000 ), Color( 0xFF00AA00 ), Color( 0xFF0000AA ) );

// надпись, число
// note( position, text )
drw.note( Vec3( 0, 0, 0 ),  "Note A" );
drw.note( Vec3( 0, 30, 0 ), "Note B",
    Color( 0xFF33FF33 ) );
drw.note( Vec3( 0, 0, 20 ),  111 );
drw.note( Vec3( 0, 30, 20 ), 222.51,
    Color( 0xFF33FF33 ) );

Сложную визуализацию можно разбросать по слоям, чтобы отображать / скрывать их по отдельности. Делается просто:

drw += "My 1";
drw.layer( "My 1" );
// теперь всё рисуется в слое `My 1`
// ...
drw += "My 2";
// а теперь - в слое `My 2`
// ...

Векторы, матрицы, боксы (ведь знаете, что такое AABB?) и пр. здесь не перечисляю: очевидно, что они печатаются / визуализируются просто:

log += МойОбъект;
drw += МойОбъектКоторыйМожноНарисовать;

Напоследок, малюсенький пример, как использовать возможности Коута для быстрой 3D-визуализации.

Debug  dbg;
DebugDraw  drw = dbg.draw();

void main() {

    drw.clear().color( 0xFFFFEE00 );
    Step( 1 );

    // параметрическая функция
    const float  S = 10;
    const float  D = 180 * 4;
    const float  step = 0.5;
    for ( float t = -D; t <= D; t += step ) {
        const float  angle = t * 3.14 / 180;
        const float  x = t * sin( angle ) * sin( angle );
        const float  y = x * cos( angle );
        const float  z = y * cos( angle ) * cos( angle );
        const Vec3  p( x, y, z );
        drw.vector( p * S, p * S / 2,
            Color( 0xFF000000 ), Color( 0xFF1100BB ) );
        drw.sphere( p * S, 100, Color( 0xFFFFEE00 ) );
        // скрипт работает слишком быстро) замедляем
        if ( ceil( x * y * z * S ) % 5 == 0 ) {
            Step( 1 );
        }
    } // for ...
}

Результат

Primitives and Scripting: what you can do already

2015-12-14T18:00:00.000+02:00

§ Читать по-русски →

Basic set of primitives have been added. Now you can create them via scripts in 3D-Coat. Moreover, you can perform some actions with them: change location, scale. That may not be much, but the foundation is laid, and new scripting approach is easier, hopefully, for mastering (old possibilities remained – previously written scripts will work too). New scripts will be available as of version 4.5.26.

Code:

const Vec3  TOWER_SHIFT( 0, 0, 200 );
const Vec3  FLOOR_SHIFT( 0, 200, 0 );
Vec3  tower = TOWER_SHIFT * (-4.5);
Vec3  floor( 0 );
Mesh  a, b, mesh;
Builder  builder;
SculptRoom  room;


void main() {

    room.clear().toSurface();

    // capsule
    {
        a = builder.capsule()
          .startPosition( Vec3( 0 ) )
          .endPosition( Vec3( 40, 50, 60 ) )
          .startRadius( 30 )
          .endRadius( 50 )
          .details( 0.1 )
          .build();
        b = builder.capsule()
          .startPosition( Vec3( 0 ) )
          .endPosition( Vec3( 20, 30, 40 ) )
          .startRadius( 20 )
          .endRadius( 30 )
          .position( Vec3( 20, 30, 40 ) )
          .details( 0.5 )
          .build();
        draw();
    }

    // cone
    {
        a = builder.cone()
          .radius( 50 )
          .height( 120 )
          .details( 0.1 )
          .build();
        b = builder.cone()
          .radius( 40 )
          .height( 80 )
          .position( Vec3( 10, 20, 30 ) )
          .details( 0.5 )
          .build();
        draw();
    }

    // cuboid
    {
        a = builder.cuboid()
          .side( Vec3( 100, 80, 60 ) )
          .details( 0.1 )
          .build();
        b = builder.cuboid()
          .side( Vec3( 30, 50, 70 ) )
          .position( Vec3( 20, 30, 40 ) )
          .details( 0.5 )
          .build();
        draw();
    }

    // cylinder
    {
        a = builder.cylinder()
          .positionTop( Vec3( 80, 0, 0 ) )
          .positionBottom( Vec3( 0, 0, 0 ) )
          .radiusTop( 40 )
          .radiusBottom( 50 )
          .details( 0.1 )
          .build();
        b = builder.cylinder()
          .positionTop( Vec3( 70, 0, 10 ) )
          .positionBottom( Vec3( 0, 0, 0 ) )
          .radiusTop( 20 )
          .radiusBottom( 30 )
          .position( Vec3( 20, 30, 40 ) )
          .details( 0.5 )
          .build();
        draw();
    }

    // ellipsoid
    {
        a = builder.ellipsoid()
          .radius( Vec3( 80, 60, 40 ) )
          .details( 0.1 )
          .build();
        b = builder.ellipsoid()
          .radius( Vec3( 20, 40, 60 ) )
          .position( Vec3( 20, 30, 40 ) )
          .details( 0.5 )
          .build();
        draw();
    }

    // gear
    {
        a = builder.gear()
          .startPoint( Vec3( 0, 0, 0 ) )
          .endPoint( Vec3( 90, 90, 90 ) )
          .topRadius( 30 )
          .bottomRadius( 50 )
          .relativeHoleRadius( 0.3 )
          .depth( 0.5 )
          .sharpness( 0.2 )
          .teeth( 3 )
          .details( 0.1 )
          .build();
        b = builder.gear()
          .startPoint( Vec3( 20, 20, 20 ) )
          .endPoint( Vec3( 50, 50, 50 ) )
          .topRadius( 50 )
          .bottomRadius( 50 )
          .relativeHoleRadius( 0.3 )
          .depth( 0.2 )
          .sharpness( 1.0 )
          .teeth( 6 )
          .details( 0.5 )
          .build();
        draw();
    }

    // ngon
    {
        a = builder.ngon()
          .startPoint( Vec3( 0, 0, 0 ) )
          .endPoint( Vec3( 90, 90, 90 ) )
          .topRadius( 30 )
          .bottomRadius( 40 )
          .relativeHoleRadius( 0.3 )
          .teeth( 3 )
          .details( 0.1 )
          .build();
        b = builder.ngon()
          .startPoint( Vec3( 20, 20, 20 ) )
          .endPoint( Vec3( 50, 50, 50 ) )
          .topRadius( 50 )
          .bottomRadius( 50 )
          .relativeHoleRadius( 0.2 )
          .teeth( 6 )
          .details( 0.5 )
          .build();
        draw();
    }

    // tube
    {
        a = builder.tube()
          .startPoint( Vec3( 0, 0, 0 ) )
          .endPoint( Vec3( 30, 50, 70 ) )
          .topRadius( 30 )
          .bottomRadius( 40 )
          .relativeHoleRadius( 0.8 )
          .topScale( 2.0 )
          .bottomScale( 1.0 )
          .details( 0.1 )
          .build();
        b = builder.tube()
          .startPoint( Vec3( 10, 20, 30 ) )
          .endPoint( Vec3( 20, 40, 60 ) )
          .topRadius( 20 )
          .bottomRadius( 20 )
          .relativeHoleRadius( 0.2 )
          .topScale( 1.5 )
          .bottomScale( 3.0 )
          .details( 0.5 )
          .build();
        draw();
    }

    // sphere
    {
        a = builder.sphere()
          .radius( 70 )
          .details( 0.1 )
          .build();
        b = builder.sphere()
          .radius( 40 )
          .position( Vec3( 30, 40, 50 ) )
          .details( 0.5 )
          .build();
        draw();
    }
}




void draw() {

    floor = Vec3( 0 );
    // add
    mesh = a | b;
    mesh.tools().transform().position( tower + floor ).run();
    room += mesh;

    floor += FLOOR_SHIFT;
    // subtract
    mesh = a - b;
    mesh.tools().transform().position( tower + floor ).run();
    room += mesh;

    floor += FLOOR_SHIFT;
    // intersect
    mesh = a & b;
    mesh.tools().transform().position( tower + floor ).run();
    room += mesh;

    tower += TOWER_SHIFT;
}

When 3D-Coat is launched, you get the following:

Pay attention to the wireframe density: it is different for each mesh and is maintained after boolean operations.

The code can be reduced, knowing that `MeshX::build()` и `ToolsX::run()` can be functors. That means we can write:

        ...
        a = builder.sphere()
          .radius( 70 )
          .details( 0.1 )
          ();
        ...

and

        ...
        mesh.tools().transform().position( tower + floor )();
        ...

with the same result.

Примитивы и скриптинг: что уже можно

2015-12-14T11:25:00.000+02:00

§ Read in English →

Добавил базовый набор примитивов: теперь в 3D-Coat их можно создавать в скриптах. Плюс, с ними уже можно кое-что делать: менять позицию на экране, масштабировать. Это немного, но заложена основа, а новый подход к скриптингу легко масштабируется и, надеюсь, проще для освоения (старые возможности - остались: написанные ранее скрипты будут работать). В версии 4.5.26 и выше это новое уже будет.

Код:

// глобальные переменные позволяют нам не заморачиваться
// с передачей параметров в методы, сделав т.о. код короче
const Vec3  TOWER_SHIFT( 0, 0, 200 );
const Vec3  FLOOR_SHIFT( 0, 200, 0 );
Vec3  tower = TOWER_SHIFT * (-4.5);
Vec3  floor( 0 );
Mesh  a, b, mesh;
// с помощью `builder` создаём разные меши
Builder  builder;
// используем `room` для формирования сцены
SculptRoom  room;


void main() {

    // подготавливаем сцену
    room.clear().toSurface();

    // капсула
    {
        // первый меш
        a = builder.capsule()
          // подготавливаем к строительству
          .startPosition( Vec3( 0 ) )
          .endPosition( Vec3( 40, 50, 60 ) )
          .startRadius( 30 )
          .endRadius( 50 )
          // плотность сетки
          .details( 0.1 )
          // строим
          .build();
        // второй меш
        b = builder.capsule()
          .startPosition( Vec3( 0 ) )
          .endPosition( Vec3( 20, 30, 40 ) )
          .startRadius( 20 )
          .endRadius( 30 )
          .position( Vec3( 20, 30, 40 ) )
          .details( 0.5 )
          .build();
        // рисуем меши `a` и `b`
        // см. реализацию draw() в конце листинга
        draw();
    }

    // конус
    {
        a = builder.cone()
          .radius( 50 )
          .height( 120 )
          .details( 0.1 )
          .build();
        b = builder.cone()
          .radius( 40 )
          .height( 80 )
          .position( Vec3( 10, 20, 30 ) )
          .details( 0.5 )
          .build();
        draw();
    }

    // кубоид
    {
        a = builder.cuboid()
          .side( Vec3( 100, 80, 60 ) )
          .details( 0.1 )
          .build();
        b = builder.cuboid()
          .side( Vec3( 30, 50, 70 ) )
          .position( Vec3( 20, 30, 40 ) )
          .details( 0.5 )
          .build();
        draw();
    }

    // цилиндр
    {
        a = builder.cylinder()
          .positionTop( Vec3( 80, 0, 0 ) )
          .positionBottom( Vec3( 0, 0, 0 ) )
          .radiusTop( 40 )
          .radiusBottom( 50 )
          .details( 0.1 )
          .build();
        b = builder.cylinder()
          .positionTop( Vec3( 70, 0, 10 ) )
          .positionBottom( Vec3( 0, 0, 0 ) )
          .radiusTop( 20 )
          .radiusBottom( 30 )
          .position( Vec3( 20, 30, 40 ) )
          .details( 0.5 )
          .build();
        draw();
    }

    // эллипсоид
    {
        a = builder.ellipsoid()
          .radius( Vec3( 80, 60, 40 ) )
          .details( 0.1 )
          .build();
        b = builder.ellipsoid()
          .radius( Vec3( 20, 40, 60 ) )
          .position( Vec3( 20, 30, 40 ) )
          .details( 0.5 )
          .build();
        draw();
    }

    // шестерёнка
    {
        a = builder.gear()
          .startPoint( Vec3( 0, 0, 0 ) )
          .endPoint( Vec3( 90, 90, 90 ) )
          .topRadius( 30 )
          .bottomRadius( 50 )
          .relativeHoleRadius( 0.3 )
          .depth( 0.5 )
          .sharpness( 0.2 )
          .teeth( 3 )
          .details( 0.1 )
          .build();
        b = builder.gear()
          .startPoint( Vec3( 20, 20, 20 ) )
          .endPoint( Vec3( 50, 50, 50 ) )
          .topRadius( 50 )
          .bottomRadius( 50 )
          .relativeHoleRadius( 0.3 )
          .depth( 0.2 )
          .sharpness( 1.0 )
          .teeth( 6 )
          .details( 0.5 )
          .build();
        draw();
    }

    // энгон
    {
        a = builder.ngon()
          .startPoint( Vec3( 0, 0, 0 ) )
          .endPoint( Vec3( 90, 90, 90 ) )
          .topRadius( 30 )
          .bottomRadius( 40 )
          .relativeHoleRadius( 0.3 )
          .teeth( 3 )
          .details( 0.1 )
          .build();
        b = builder.ngon()
          .startPoint( Vec3( 20, 20, 20 ) )
          .endPoint( Vec3( 50, 50, 50 ) )
          .topRadius( 50 )
          .bottomRadius( 50 )
          .relativeHoleRadius( 0.2 )
          .teeth( 6 )
          .details( 0.5 )
          .build();
        draw();
    }

    // труба
    {
        a = builder.tube()
          .startPoint( Vec3( 0, 0, 0 ) )
          .endPoint( Vec3( 30, 50, 70 ) )
          .topRadius( 30 )
          .bottomRadius( 40 )
          .relativeHoleRadius( 0.8 )
          .topScale( 2.0 )
          .bottomScale( 1.0 )
          .details( 0.1 )
          .build();
        b = builder.tube()
          .startPoint( Vec3( 10, 20, 30 ) )
          .endPoint( Vec3( 20, 40, 60 ) )
          .topRadius( 20 )
          .bottomRadius( 20 )
          .relativeHoleRadius( 0.2 )
          .topScale( 1.5 )
          .bottomScale( 3.0 )
          .details( 0.5 )
          .build();
        draw();
    }

    // сфера
    {
        a = builder.sphere()
          .radius( 70 )
          .details( 0.1 )
          .build();
        b = builder.sphere()
          .radius( 40 )
          .position( Vec3( 30, 40, 50 ) )
          .details( 0.5 )
          .build();
        draw();
    }
}




// выполняет булевы операции над мешами `a` и `b`
// и добавляет результат на сцену
void draw() {

    floor = Vec3( 0 );
    // объединение (add)
    mesh = a | b;
    mesh.tools().transform().position( tower + floor ).run();
    room += mesh;

    floor += FLOOR_SHIFT;
    // вычитание (subtract)
    mesh = a - b;
    mesh.tools().transform().position( tower + floor ).run();
    room += mesh;

    floor += FLOOR_SHIFT;
    // пересечение (intersect)
    mesh = a & b;
    mesh.tools().transform().position( tower + floor ).run();
    room += mesh;

    tower += TOWER_SHIFT;
}

Запустив скрипт в 3D-Coat, получаем такую картинку:

Обратите внимание на плотность сетки: она у фигур разная и сохраняется после булевых операций.

Код можно сократить, зная, что методы `MeshX::build()` и `ToolsX::run()` могут выступать функторами. Т.е. можем писать:

        ...
        a = builder.sphere()
          .radius( 70 )
          .details( 0.1 )
          ();
        ...

        ...
        mesh.tools().transform().position( tower + floor )();
        ...

с тем же результатом.

New scripting in 3D-Coat

2015-11-23T21:00:00.000+02:00

§ Читать по-русски →

The most difficult thing in programming is to understand an application's architecture. At least it should be such that the program would be handy to use correctly, and unhandy to use incorrectly. While working with scripting for 3D-Coat I try to follow that rule. (Reasonable following OOP principles – even without discussions). So here's what we get...

void main() {

    // preparing a scene
    SculptRoom  sculpt;
    sculpt.clear().toSurface();

    Mesh  a, b;
    const Vec3  dir = Vec3( 0, 1, 0 );

    // I) add
    float  delta = 0;
    Vec3  shift = dir * delta;
    {
        build( a, b, shift );
        const Mesh  ab = a | b;
        sculpt += ab;
    }

    // II) subtruct
    delta += 200;
    shift = dir * delta;
    {
        build( a, b, shift );
        const Mesh  ab = a - b;
        sculpt += ab;
    }

    // III) intersect
    delta += 200;
    shift = dir * delta;
    {
        build( a, b, shift );
        const Mesh  ab = a & b;
        sculpt += ab;
    }
}


void build( Mesh &out a, Mesh &out b, const Vec3 &in shift ) {

    Builder  builder;

    const Vec3  pa( 0 );
    a = builder.sphere()
      .radius( 90 )
      .position( pa + shift )
      .details( 0.1 )
      .build();

    const Vec3  pb( 30, 40, 50 );
    b = builder.sphere()
      .radius( 50 )
      .position( pb + shift )
      .details( 0.5 )
      .build();
}

Launching this script in 3D-Coat, we will see:

Why is such a picture understandable after reading a string of code, with its comments. Notice: the sphere's detail state remains the same after adding, subtraction and intersection.
Script can be written more compact when excluding command `Mesh ab`:

{
    build( a, b, shift );
    sculpt += a | b;
}

This is my first post with new scripting architecture. Syntax is a red thread, which I would maintain. Also there is a short presentation which demonstrates how I plan to expand 3D-Coat's possibilities. Please let me know if there is something that you need first. Old code works too, but when a proper substitute appears old code is marked as DEPRECATED.

In the near term I will add new primitives and will expand this review.

Updated 14/12/2015
See "Primitives and Scripting: what you can do already".

Новый скриптинг 3D-Coat

2015-11-23T20:28:00.002+02:00

§ Read in English →

В программировании важно продумать архитектуру приложения. Как минимум, она должна быть такой, чтобы библиотеку было удобно использовать правильно и неудобно неправильно. Работая со скриптингом для Коута, я стараюсь следовать ~~этой заповеди~~ этому принципу. (Разумное следование принципам ООП - это даже не обсуждается). И вот что получается...

// Создаём две сферы и объединяем их тремя способами.
void main() {

    // подготавливаем сцену
    SculptRoom  sculpt;
    sculpt.clear().toSurface();

    Mesh  a, b;
    const Vec3  dir = Vec3( 0, 1, 0 );

    // I) add
    float  delta = 0;
    Vec3  shift = dir * delta;
    {
        build( a, b, shift );
        const Mesh  ab = a | b;
        sculpt += ab;
    }

    // II) subtruct
    delta += 200;
    shift = dir * delta;
    {
        build( a, b, shift );
        const Mesh  ab = a - b;
        sculpt += ab;
    }

    // III) intersect
    delta += 200;
    shift = dir * delta;
    {
        build( a, b, shift );
        const Mesh  ab = a & b;
        sculpt += ab;
    }
}


void build( Mesh &out a, Mesh &out b, const Vec3 &in shift ) {

    Builder  builder;

    const Vec3  pa( 0 );
    a = builder.sphere()
      .radius( 90 )
      .position( pa + shift )
      .details( 0.1 )
      .build();

    const Vec3  pb( 30, 40, 50 );
    b = builder.sphere()
      .radius( 50 )
      .position( pb + shift )
      .details( 0.5 )
      .build();
}

Запускаем скрипт в Коте (кстати, во Вт, 24/11/15 сделаю, чтобы скрипт можно было пускать при старте 3D-Coat'а) и видим:

Почему такая картинка - понятно, если прочесть код и, может быть, комментарии к нему. Обратите внимание: детализация сфер при добавлении, вычитании и пересечении сохраняется.
Скрипт можно записать более компактно, исключив декларацию `Mesh ab`:

{
    build( a, b, shift );
    sculpt += a | b;
}

Это первая заметка с новой архитектурой скриптинга. Синтаксис - красная нить, которой буду придерживаться. Также есть небольшая презентация, в которой видно, каким образом планирую расширять возможности Coat'а. Говорите, если что-то понадобится Вам быстрее. Старый код - тоже работает, но, при появлении подходящей замены, помечается как DEPRECATED.

В ближайшее время добавлю новые примитивы и дополню этот обзор.

Updated 14/12/2015
См. "Примитивы в 3D-Coat: что уже можно".

Layers in Sculpt Room via Scripts

2015-11-10T21:00:00.000+02:00

@Christoph Werner

§ Читать по-русски →

Yes, you can operate with layers via scripts in 3D-Coat! Right now, I will show and explain everything...

In order to memorize methods faster (we want to focus on the result and not get into the habit of constantly referring to manual, right?), I will explain what I was thinking while making them. But first take a look at this tree:

Head, Body, Arms, Legs – almost a human. 3D-Coat lets you create as many layers as you like. And each of them is able to contain a complex layers tree.

In the first post I promised to be concise. So, the code itself:

void main() {

    // preparing a scene
    Vox  v;
    v.clearScene();

    // building a tree with v-layers
    v
      .appendToParent( "Head" )
      .appendToParent( "Body" )
        .append(         "Neck" )
        .appendToParent( "Left arm" )
        .appendToParent( "Right arm" )
        .appendToParent( "Heart" )
        .appendToParent( "Left leg" )
        .appendToParent( "Right leg" )

      // return to the layer "Head", switch it
      // to "Surface mode" and attach
      .to( "Head" ).toSurface()
        .append( "Eye" )
        .appendToParent( "Lamps" )
    ;

    // removing a first layer from a scene
    v.firstForRoot().remove();
}

Do you see patterns of methods? `append()`, `appendToParent()`, `appendToRoot()`, `forEach()`, `forRootEach()`, ... - as you might have noticed, the names themselves are pretty self-explanatory. Compare the code with the resulting picture. It should be easy to figure out without the need to frequently refer to documentation, which command does what.

After looking through the libraries for working with 'trees' I found that it is most intuitively done in JQuery. Are you familiar with it? Then I won't explain anything!) The only thing that should be taken into account during developing: class `Vox` works with 3D-Coat's UI, so introduced in code Vox-methods select layers before any kind of operation.

So, working on layers:

void main() {

    // creating a tree - see above
    // ...

    // #1
    // calling invert() for all v-layer
    // see below
    v.forRootEach( "invert" );

    // #2
    // moving to the "Body" and invert() for it and childs
    v.to( "Body" ).call( "invert" ).forEach( "invert" );
}


void invert() {
    Vox  v;
    v.isSurface() ? v.toVoxel() : v.toSurface();
    Wait( 50 );
}

I think that previously described methods are enough for processing any tree. But Andrew Shpagin says it is not. Here you have another variant:

    // access by index on all childs of "Head"
    v.to( "Head" ).call( "invert" );
    for ( int i = 0; i < v.count(); ++i ) {
        v.at( i ).call( "invert" ).parent();
        Wait( 100 );
    }

Also, all VoxTree options are available for 'Vox' class via scripts:

What I also would like to add is a more concise constructor. Later. I need to improve operations with primitives, and there are a lot of them...

P.S. Btw, the example tree has a "real prototype":

Слои скриптами в SculptRoom

2015-11-10T20:11:00.001+02:00

@Christoph Werner

§ Read in English →

Есть, есть работа с воксельными слоями в скриптах 3D-Coat!) Сейчас и расскажу, и покажу...

Чтобы быстрее запомнить названия методов (мы ведь хотим результат, а не вечную тягу к документации), объясню чем руководствовался, создавая их. Но вначале посмотрите на это дерево:

Голова (Head), тело (Body), руки (* arm), ноги( * leg) - почти человек) 3D-Коут позволяет создавать множество слоёв. И каждый из них способен содержать... ну, Вы поняли: даже сложное дерево можно нарисовать в Коуте.

В первой заметке обещал быть кратким. Поэтому, сразу код:

// Работа со "слоями объёма" (volume layers, сокр. v-layers)
void main() {

    // подготавливаем сцену
    Vox  v;
    v.clearScene();

    // строим дерево v-слоёв
    v
      .appendToParent( "Head" )
      .appendToParent( "Body" )
        .append(         "Neck" )
        .appendToParent( "Left arm" )
        .appendToParent( "Right arm" )
        .appendToParent( "Heart" )
        .appendToParent( "Left leg" )
        .appendToParent( "Right leg" )

      // возвращаемся к слою "Head", переводим его
      // в "Режим поверхности" и аттачим новые
      .to( "Head" ).toSurface()
        .append( "Eye" )
        .appendToParent( "Lamps" )
      // Заметили как добавились последние?
      // Верно: `S`, не `V`.
    ;

    // удаляем первый (пустой) слой со сцены
    v.firstForRoot().remove();
}

Видите группы методов? `append()`, `appendToParent()`, `appendToRoot()`, `forEach()`, `forRootEach()`, ... - говорящие названия, если понимать, что "parent" по англ. "родитель", "root" - "корень", а "for each" - "для каждого". Сравнивая код с результатом-картинкой, Вы ~~без документации~~ без труда разберётесь кто что творит.

Пересмотрев библиотеки для работы с деревьями, я нашёл, что наиболее естественно это дело реализовано в JQuery. Знакомы? Ну, значит точно объяснять ничего не надо!) Единственное что пришлось учесть при разработке: класс `Vox` работает с UI 3D-Coat, поэтому представленные в коде Vox-методы выделяют слои прежде чем что-то с ними делать. Понимая это и порисовав в Коуте (бесплатно или нет), Вы не будете бомбардировать меня вопросами: "А зачем было создавать Root-методы!?" К прочим вопросам открыт!

Так, обход слоёв:

void main() {

    // создание дерева - см. выше
    // ...

    // #1
    // проходим все слои и вызываем для каждого функцию invert()
    // см. ф. ниже
    v.forRootEach( "invert" );

    // #2
    // перемещаемся на слой "Body" и invert() для него и его деток
    v.to( "Body" ).call( "invert" ).forEach( "invert" );
}


// функция, о которой глаголилось выше
void invert() {
    Vox  v;
    v.isSurface() ? v.toVoxel() : v.toSurface();
    // добавил паузу, чтобы видеть движение в UI
    Wait( 50 );
}

Я считаю, что методов выше достаточно для обхода любого дерева. Но Андрей Шпагин убеждает, что нет. Тогда вот ещё вариант:

    // доступ по индексу для всех деток слоя "Head"
    v.to( "Head" ).call( "invert" );
    for ( int i = 0; i < v.count(); ++i ) {
        v.at( i ).call( "invert" ).parent();
        Wait( 100 );
    }

Также, из скриптов для класса `Vox` доступны все возможности из меню, которое выпадает при щелчке правой кнопки мыши на слое:

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

P.S. Кстати, рассматриваемое дерево имеет "живой прототип":

Figures draw figures

2015-11-03T19:00:00.000+02:00

§ Читать по-русски →

This post I wrote quickly. Quickly, because I wanted to understand what format is the best for examples. With each new post I will try to provide such format that will be most useful for you. Your feedback would be welcomed! In general, I want each example to not only show the principles of scripting in 3D-Coat, but also show a proper method for working with AngelScript (the AngelScript is used in many areas – so it might be helpful). Thus, from my posts there will be a kind of “set of blanks” which you could use in your workflow or just for fun.

What is going on here

Making unusual structure using 3D-Coat's scripts. In other words, a 3D-plot. You can change function and restart script to get something more interesting.

What can we learn from the code

How to clear the scene?
How to toggle Voxels / Surface mode?
How to create a 3D-model (mesh)?
How to add a sphere to a separate layer?
How to place object to a certain location with defined coordinates?
How to create 3D-plots?
How to use `for-cycles`?
What math functions are represented in AngelScript?

Code (3DCoat, AngelScript)

void main() {

    // preparing a scene
    SculptRoom  room;
    room.clear().toSurface();

    // building some structure with spheres
    Builder  builder;
    const int  IU = 4;
    const int  ITHETA = 3;
    const float  S = 5.0;
    const float  PI = 3.14159;
    for ( int iu = -IU; iu <= IU; ++iu ) {
        for ( int itheta = 0; itheta <= ITHETA; ++itheta ) {
            const float  u = 1.0 * iu / IU;
            const float  theta = 2.0 * PI * itheta / ITHETA;
            const float  x = sqrt( 1.0 - u * u ) * cos( theta );
            const float  y = sqrt( 1.0 - u * u ) * sin( theta );
            const float  z = u;
            const float  radius = (itheta + u * u) * S + 1;
            const Vec3  coord = Vec3( x, y, z ) * radius * 1.7 * S;
            const Mesh  figure = builder.sphere()
              .radius( radius )
              .position( coord )
              .details( 0.1 )
              ();
            room |= figure;
        } // itheta
    } // iu
}

Result

Your questions?

Фигуры рисуют фигуру

2015-11-03T18:10:00.000+02:00

§ Read in English →

Эту заметку я написал быстро. Быстро, потому что хочу определить, в каком виде подавать примеры. С каждой новой публикацией буду подводить оформление к виду, который принесёт Вам наибольшую пользу. Обратная связь была бы кстати! Вообще, я хочу, чтобы каждый пример не просто раскрывал принципы скриптования в 3D-Coat, но и обучал грамотной работе с AngelScript (AS много где применяется - наверняка пригодится). Т.о. из публикаций получится некий "набор заготовок", которые Вы сможете использовать в работе... или для развлечения.

Что здесь происходит

С помощью скрипта 3D-Сoat рисуем необычную структуру. Другими словами, "график в 3D". Вы можете менять функцию и тут же перезапускать скрипт, чтобы получить что-то более интересное.

Чему учит код

Как очистить сцену?
Как переключать режимы сцены: воксель / поверхность?
Как создать 3D-модель (меш)?
Как добавить сферу в отдельный слой?
Как разместить фигуру по заданным координатам?
Как строить объёмные графики?
Как использовать `for-циклы`?
Какие математические функции предоставляет AngelScript?

Код (3DCoat, AngelScript)

// Модель, заданная функцией на 3D-холсте.
void main() {

    // подготавливаем сцену
    SculptRoom  room;
    room.clear().toSurface();

    // строим некую 3D-структуру
    Builder  builder;
    const int  IU = 4;
    const int  ITHETA = 3;
    const float  S = 5.0;
    const float  PI = 3.14159;
    for ( int iu = -IU; iu <= IU; ++iu ) {
        for ( int itheta = 0; itheta <= ITHETA; ++itheta ) {
            const float  u = 1.0 * iu / IU;
            const float  theta = 2.0 * PI * itheta / ITHETA;
            const float  x = sqrt( 1.0 - u * u ) * cos( theta );
            const float  y = sqrt( 1.0 - u * u ) * sin( theta );
            const float  z = u;
            const float  radius = (itheta + u * u) * S + 1;
            const Vec3  coord = Vec3( x, y, z ) * radius * 1.7 * S;
            const Mesh  figure = builder.sphere()
              .radius( radius )
              .position( coord )
              .details( 0.1 )
              ();
            room |= figure;
        } // itheta
    } // iu
}

Результат

Ваши вопросы? (задавайте в комментариях)

Scripts in 3D-Coat: Beginning

2015-11-02T19:00:00.000+02:00

@Group VK

§ Читать по-русски →

Right now I'm working on Scripts/Scripting in 3D-Coat (appeared classes 'Angles', 'Mat3', 'Mat4', 'Mesh', 'Quat', 'Vec3') and decided to, in addition to documentation, create more visual examples. I'll start here – we'll see what will happen...

Introduction for new users

3D-Coat is a software for creating 3d models/sculptings, particular organic objects (for more information visit website). Here you also have retopology toolset, including Auto-retopology of voxel objects (video), plus PBR (video), plus UV mapping tools (video), exporting models for game engines, and many more... Yep, I love this program!)
I assume you know a programming language and know how to use documentation.
3D-Coat uses AngelScript.
Script is a text file. It is helpful to view and edit it in Notepad++ (choose "C" syntax).
Run script via file menu "Scripts / Run Script".
Free download the 3D-Coat is here.

and some accordances for me (like memo)

Short, but informative posts.
Simple code.
Comments inside the code.
Won't spoon-feed you with anything that can otherwise be found in documentation.
For each post – a picture / video / 3D-sketch.

I will maintain these rules. Have questions? Ask – the answer will be given )

First example is adding figures to a scene in "Sculpt Room" (according to 3D-Coat's terminology).

void main() {

    // preparing a scene
    SculptRoom  room;
    room.clear().toSurface();

    // initializing a random generator
    seed( 39 );

    // building some figures with random size, position and rotation
    Builder  builder;
    const int  N = 4;
    const int  A = 10;
    const int  B = 100;
    for ( int i = 0; i < N; ++i ) {
        const int  a = rand( A, B );
        const int  b = rand( A, B );
        const int  c = rand( A, B );
        Mesh  figure = builder.cube()
          .side( Vec3( a, b, c ) )
          .details( 0.1 )
          ();
        const Vec3  translation(
            rand( -B, B ) * 2,
            rand( -B, B ) * 2,
            rand( -B, B ) * 2);
        const Angles  angles(
            rand( 0, 360 ),
            rand( 0, 360 ),
            rand( 0, 360 ) );
        figure.tools().transform()
          .position( translation )
          .rotation( angles )
          ();
        room |= figure;
    } // for i
}

Result

LMB - rotate, RMB - pan, MMB - zoom.

Скрипты 3D-Coat: Начало

2015-11-02T13:54:00.000+02:00

@Группа ВК

§ Read in English →

Сейчас работаю над скриптами 3D-Coat (появились классы `Angles`, `Mat3`, `Mat4`, `Mesh`, `Quat`, `Vec3`) и решил, в дополнение к документации, создать более наглядные примеры. Начну здесь, посмотрим, что из этого получится...

Вводные моменты для новых читателей

3D-Coat - это инструмент для создания 3D-моделей, в частности органических объектов (см. сайт). Плюс автоматическая ретопология воксельных объектов (см. видео), плюс PBR (видео), плюс UV-развёртка (видео), плюс рельефное текстурирование, плюс экспорт моделей для игровых движков... Да, я люблю эту программу!)
Полагаю, что Вы знаете какой-то язык программирования и умеете пользоваться документацией.
3D-Coat понимает AngelScript.
Скрипт - это текстовый файл. Удобно создавать и просматривать в Notepad++, с подсветкой синтаксиса "C".
Запуск скрипта - из меню 3D-Coat "Скрипты / Запустить скрипт":
Бесплатно скачать 3D-Coat можно отсюда.

и соглашения для себя (чтобы помнить)

Краткие, но ёмкие публикации.
Простой код.
Комментарии в самом коде.
Не разжёвывать методы, которые можно найти в документации.
Для каждой публикации - картинка / видео / 3D-Sketch.

Буду придерживаться этих правил. Если возникнуть вопросы - задавайте, ответ будет)

Первый пример - это добавление фигур "на сцену" или, согласно терминологии 3D-Coat, в "Voxel Room" (здесь и далее используются термины из руководства).

// Фигуры, разбросанные по сцене.
void main() {

    // подготавливаем сцену
    SculptRoom  room;
    room.clear().toSurface();

    // инициализируем генератор случ. чисел
    seed( 39 );

    // создаём `N` фигур разного размера, разбрасывая их по сцене
    Builder  builder;
    const int  N = 4;
    const int  A = 10;
    const int  B = 100;
    for ( int i = 0; i < N; ++i ) {
        const int  a = rand( A, B );
        const int  b = rand( A, B );
        const int  c = rand( A, B );
        Mesh  figure = builder.cube()
          .side( Vec3( a, b, c ) )
          .details( 0.1 )
          ();
        const Vec3  translation(
            rand( -B, B ) * 2,
            rand( -B, B ) * 2,
            rand( -B, B ) * 2);
        const Angles  angles(
            rand( 0, 360 ),
            rand( 0, 360 ),
            rand( 0, 360 ) );
        figure.tools().transform()
          .position( translation )
          .rotation( angles )
          ();
        room |= figure;
    } // for i
}

Результат

Правая / левая / средняя кнопки мыши - двигайте / вращайте / масштабируйте.

Подсветка синтаксиса Graphviz для Notepad++

2013-01-29T15:57:00.000+02:00

Был несколько удивлён, когда не нашёл в Интернете подсветку синтаксиса Graphviz для Notepad++. Формально она как бы есть, но сайт, на который ссылается NpWiki недоступен уже очень давно.

Помимо стандартного dot-синтаксиса подсветка выделяет полезные для больших проектов директивы '@todo'.

Пользуйтесь на здоровье >>

Чего не хватает в NoSQL-хранилищах (на примере CouchDB) - Часть III

2012-06-30T18:43:00.001+03:00

Продолжение. Начало > "Чего не хватает в NoSQL-хранилищах": Часть I, Часть II.

Интерфейс для написания плагинов. Расширять функциональность самой CouchDB - можно. Об этом говорилось ещё в 2010 году и в документации есть парочка рабочих примеров. Можно, но... делать это - отвратительно! (Конечно, если Вы не гик и можете позволить себе жить процессом, а не результатом). Мне было не просто отладить свой плагин, лопативший базы и объединяющий их записи по определённым условиям: создавал его на JavaScript (под движок или SpiderMonkey или V8). Тем не менее, Scout, ElasticSearch, Lucene, BackBone и $.Couch (последняя пара - не совсем плагины, но очень полезные библиотеки) - показатели того, что создавать плагины можно. Этому способствует такой вот API (да, эта картинка).
Предметно-ориентированный язык программирования для создания индексов, функций проверки и т.п.. Это что-то вроде SQL. Хм... Для прикладных задач вполне годится JavaScript (или CoffeeScript - для ярых эстетов). Зачем усложнять? Впрочем, можно привести много причин "зачем"...
Гибкая система разрешения конфликтов документов. Репликация - большая головня боль для разработчиков SQL-систем. NoSQL позволяет разработчикам сосредоточиться на задаче, взяв на себя большую часть сложностей репликации. Но отдавать роботам решать всё за нас - это не правильно (пока процесс не отлажен). Например, при репликации бывают моменты, когда документ изменён одновременно несколькими пользователями и каждый желает записать свои изменения в хранилище. Хотелось бы иметь что-то более настраиваемое, чем просто "получить список конфликтующих документов и выбрать вручную нужный".
Хранение прикреплённых файлов вне базы. CouchDB хранит свои данные в одном файле. Этот файл при работе с базой никогда не становится меньше , данные никогда не перезаписываются (Вы можете только настроить периодическое сжатие файла). Это делает CouchDB очень надёжным хранилищем, но прикреплённые файлы сильно портят картину, т.к. при каждом обновлении документа, делается их полная копия... Да, места может потребоваться много. Это решается частичным обновлением документа (которого пока нет). Хранить файлы вне базы добавит сложностей в администрировании, но, видимо, есть задачи, когда без этого не обойтись: ведь этот пункт далеко не в конце списка необходимого в NoSQL.
Определение целостности базы и восстановление в случае сбоев. Здесь имеется ввиду собрать вместе утилиты для контроля целостности и организовать удобный интерфейс для работы с ними. Потому что само хранилище CouchDB по надёжности сопоставимо с файловой системой. У Вас часто повреждаются хранимые на диске офисные документы? (Надеюсь, нет; иначе - пора бы обновить компьютер). Вот, так же "часто" будет "ломаться" база CouchDB. Впрочем, и здесь есть куда расти. Например, добавить хранение информации для восстановления файла; контрольные суммы на документы, B-деревья, представления; утилиты, позволяющие "распотрошить" поломанный файл CouchDB и вытащить оттуда всё, что ещё можно вытащить. Если Вам нужна большая надёжность, подключайте кластеры с BigCouch или посмотрите в сторону CouchBase - эти проекты выросли из CouchDB и ориентированы на потребности бизнеса.

Чего не хватает в NoSQL-хранилищах (на примере CouchDB) - Часть II

2012-05-16T18:25:00.003+03:00

Продолжение. Начало > "Чего не хватает в NoSQL-хранилищах. Часть I".

Более тонкая авторизация. Заглянув в прошлое, можно увидеть: с момента официального выпуска 1-й версии CouchDB, в вопросах защиты информации от постороннего взгляда проделана большая работа. Причина в том, что одним из пунктов идеологии этой свободно распространяемой системы системы было сделать информацию общедоступной. Чудесная идея. Но войны требуют секретов. А современный рынок - это война и политика, здесь пока нет места для помощи. И разработчики пошли ~~рынку~~ реальности навстречу.
Доступность ленты изменений в представлениях. Одна из уникальных особенностей CouchDB в том, что в неё можно сразу (сразу!) положить данные в любом (в любом!) виде и получать информацию в нужной нам форме тогда, когда (когда!) в этой информации возникла потребность. В этом нам помогают представления CouchDB. Но хочется большего! И быстро трансформировать ленту изменений http://127.0.0.1:5984/database/_changes своим представлением - одно из этих "хочу".
Богатая поддержка reduce-функций. Google ввела в мир вычислений модель "Map/Reduce". CouchDB использует эту технологию... в накопительном виде: документ проходит обработку функциями map/reduce, достраивая B-деревья, только при добавлении / изменении документа. Это быстро. Так быстро, что позволяет писать map/reduce запросы на JavaScript. С одной стороны, бывает необходимо, чтобы свёртка (reduce) проходила ещё быстрее (частично это решается использованием встроенных функций); с другой, ~~не хочется~~ не эффективно создавать свёртки на JS для стандартных случаев (например, когда требуется получить список уникальных записей или сгруппировать элементы по ключу, суммируя их значения; тем более, что в MongoDB это есть).
Частичное чтение документов. Можно запросто получать часть документов и сейчас, формируя нужный View. Но счастье это будет продолжаться ровно до тех пор, пока Вы не предложите CouchDB действительно много - по теперешним меркам, более 1 млн. - документов (записей). Тут вдруг оказывается, что 100 Гб на базу - это вовсе не "немеряно места". Копаем глубже - и видим: созданные нами view-представления довольно прожорливы. Лучший (и, похоже, наиболее эффективный) способ умерить их аппетит - извлекать из хранилища минимум информации, а приложением отправлять отдельный запрос при необходимости вытянуть нужные части документа. В не таком уж далёком прошлом, когда файлы не рекомендовалось хранить в SQL-базах, желание читать часть документа (записи) ни у кого не возникало: просто получали всю запись и были счастливы. CouchDB вполне может заменить привычную файловую систему. И разработчики рекомендуют использовать эту возможность. В результате, неожиданно, ага, можем получить хранилище, в котором документы весят по сотне мегабайт. К счастью, CouchDB не отправляет бинарные файлы вместе с документом. Но если необходимо обрабатывать содержимое файлов view-выборками, хранение содержимого в поле документа оказывается единственным выходом. И тогда может спасти только чтение нужных сейчас полей, оставляя тяжёлые данные на сервере.
Расширение и рефакторинг протокола view-cервера. Для тех, кому JavaScript язык не родной, CouchDB предоставляет возможность создавать представления (view) практически на любом известном сегодня языке программирования. Мне не приходилось создавать свой view-сервер (я люблю JavaScript). Наверное, в реализации протокола действительно не всё хорошо, раз это пожелание вошло в первую десятку. Тем не менее, сейчас уже есть view-серверы для многих языков.

Продолжение (чит. дальше) >>

Чего не хватает в NoSQL-хранилищах (на примере CouchDB) - Часть I

2012-05-10T19:02:00.000+03:00

На днях завершился опрос о плюшках, которых не хватает в NoSQL-хранилище CouchDB. С этой базой я знаком уже года два, последний - активно. И, читая новости, вижу, что много вопросов по NoSQL могло быть не задано, не пытайся люди ~~одеть рубашку, не сняв пальто~~ применить свои знания SQL-парадигмы к тому, что к SQL отношения не имеет. Пример? Oracle у многих ассоциируется с SQL. Да, сам сервер, в отличии от сервиса, хорош. Но тот NoSQL что они сваяли выглядит хилым зародышем по сравнению с тем, что уже давно есть в бесплатных системах. Новое лучше воспринимать с пустой головой.

Оказалось, больше всего ~~жгут~~ ждут (прокомментирую некоторые пункты, опираясь на собственный опыт работы с CouchDB):

Мощный язык запросов. Наверное, ожидают что-то типа SQL, но, если задуматься, так ли горячо он нужен для прикладных задач? А ведь на решение таких задач и нацелены NoSQL-решения. Новый язык - значит, больше времени на изучение, более дорогая поддержка готового продукта (много в мире окажется специалистов по этому языку?), выше "порог входа"... Японский мобильный оператор NTT DoCoMo (на март 2012 г. почти 60 млн. абонентов) почему-то выбрал CouchDB не заморачиваясь вопросом об эскьюэль-подобном языке.
Ждут документацию. Что странно, т.к. информации в Интернете и в списках рассылки CouchDB - крайне много. И разработчики - грамотные люди - ждать ответа не заставляют.
Цепочки map/reduce. Да, получить "в коробке" такую функциональность было бы неплохо. С другой стороны, как отдельный "плагин", она давно есть.
Частичное обновление документов. Небольшой экскурс. CouchDB при обновлении делает копию документа (близкая аналогия документа в SQL - запись). Документ копируется целиком. Это быстро. Но бывает накладно; особенно, когда документы большие и обновляются часто. В общем-то, всегда можно спроектировать хранилище так, что о частичном обновлении вспоминать не будете. Но проектирование = время. А чем мне нравится CouchDB, это возможностью за две-три недели создать продукт, который "уже можно дать пощупать". Признаюсь, после Lisp, Java, [T-]SQL, PHP, JavaScript и С++ скорость NoSQL-разработки меня очень впечатлила.
API для управления фоновыми процессами. У NoSQL-баз есть интересная особенность: они выдают результат мгновенно... если им дали время подготовить его. Иначе, к примеру, при миллионе записей, временем на кофе / почитать / поспать (всё это вместе - не редкое исключение) Вы себя обеспечили. Бывает полезно отключить тяжёлые процессы, ускорив тем самым "нужные сейчас вычисления". Например, отменить репликацию или сжатие базы, т.к. вдруг узнали что "много клиентов, а компьютеры сегодня очень тормозят"... Нужное требование. Но вверху списка? Нет, далеко не для всех.

Здесь ещё более 20-ти пунктов. Бооольшой список...

Скриншот (см. ниже) и продолжение (чит. дальше) >>

Потоки C++: boost::thread error LNK2001 boost::exception_ptr

2012-02-29T14:11:00.001+02:00

Непонятный заголовок, т.к. речь пойдёт о такой же ~~непонятной~~ ошибке С++, возникающей при работе с потоками (нитями) boost::thread.

Компилятор MS Visual C++ 2010, Boost 1.49.

В Интернете встречаются обсуждения, но решения проблемы я не нашёл. Как выглядит, пример:

1>World.obj : error LNK2001: неразрешенный внешний символ
    public: static class boost::exception_ptr const \
        boost::exception_detail\
        ::exception_ptr_static_exception_object::e \
        (?e@?$exception_ptr_static_exception_object\
         @Ubad_alloc_@exception_detail@boost\
         @@@exception_detail@boost@@2Vexception_ptr@3@B)

Как исправить.

Вариант I. Не использовать предварительно откомпилированный заголовок. Это удобное решение для маленького проекта. Когда проект большой, заметны последствия: время компиляции значительно увеличивается.

Вариант II. Переместить

#include <boost/thread.hpp>

из файла предварительно откомпилированного заголовка в файлы, где используются потоки. Больше движений, но без последствий для проектов любого размера.

Число. Обрезать до байта? Быстро? Легко!

2011-12-16T11:01:00.001+02:00

Когда выполняются вычисления на графических картах (GPU), создаются текстуры, или, например, данные готовятся к серилизации, бывает, нужно привести поток данных к жёстко фиксированному диапазону. Хорошо, если мы активно используем OpenCL: тогда есть готовая инструкция

gentype clamp(
    gentype x,
    gentype minval,
    gentype maxval)

Но никто в здравом уме не будет городить тяжеловесный OpenCL, чтобы привести int к unsigned char.

Обычно, для приведения числа к [0; 255] на CPU я пользовался таким кодом (С++):

char byteN = (intN > 255) ? 255 : (intN < 0) ? 0 : intN;

Оказывается, есть более быстрый способ. Когда-нибудь компиляторы C++ научатся лучше понимать, чего от них хотят. Ну а пока такой вот код для приведения целого числа к беззнаковому байту - самый-самый:

unsigned char clamp( int n ) {
    int a = 255;
    a -= n;
    a >>= 31;
    a |= n;
    n >>= 31;
    n = ~n;
    n &= a;
    return n;
}

Мне этот код не нравится. Но если он понравился Вам, наверняка, понравится и содержимое этой страницы >http://graphics.stanford.edu/~seander/bithacks.html
Крайне быстро. Крайне непонятно. Крайне эффективно. C++)

Ленивое сравнение для boost::any()

2011-12-03T01:46:00.001+02:00

Понадобилось мне быстро распарсить много данных из XML-файла. Возможность хранить всё, предлагаемая boost::any, как бы предполагает возможность это "всё" сравнивать... Ан нет! Выяснилось, что для boost::any (в который собирались xml-данные) готового сравнения нет. В общем-то, если задуматься, это логично. Но я так привык работать с нестрого типизированными языками, что просто не мог смириться. C++ - злой язык :) Время на написание довольно скучного кода было потрачено. И если Вам нужен equals() для boost::any() - код ниже.

Метод equals( boost::any, boost::any ) возвращает пару булевых значений:

(1) проверка на равенство типов
(2) проверка собственно самих значений

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

Типами метод чрезмерно не нагружал, т.к. каждая проверка - это процессорное время. Вы можете запросто добавить в код свои типы и/или исключить имеющиеся. Ведь код должен эффективно решать поставленную задачу и (в идеале) быть лёгким для понимания. Остальное - от лукавого!

/**
* Сравнивает два значения boost::any.
*
* (!) Может возвращать ( false, true ), т.к. числа разных типов
* сравниваются как числа.
*
* @param precision Точность для сравнения значений с плавающей точкой.
*/
inline std::pair<
    // типы совпадают?
    bool,
    // содержимое совпадает?
    bool
> lazyEquals(
    const boost::any& a,
    const boost::any& b,
    double precision = 1e-8
) {
    using namespace boost;

    // Быстрая оценка на равенство
    const type_info& at = a.type();
    const type_info& bt = b.type();
    std::pair< bool, bool >  r = std::make_pair(
        (at == bt),
        false
    );
    
    // double
    if (at == typeid( double )) {
        const auto ca = any_cast< double >( a );
        double cb = numeric_limits< double >::infinity();
        if (bt == typeid( double )) {
            cb = any_cast< double >( b );
        } else if (bt == typeid( float )) {
            cb = (double)any_cast< float >( b );
        } else if (bt == typeid( int )) {
            cb = (double)any_cast< int >( b );
        } else if (bt == typeid( size_t )) {
            cb = (double)any_cast< size_t >( b );
        } else if (bt == typeid( string )) {
            cb = numberCast( any_cast< string >( b ) );
            // Получим infinity(), если не число
        }
        if (cb != numeric_limits< double >::infinity()) {
            r.second = (precision > std::abs( ca - cb ));
        }

    // float
    } else if (at == typeid( float )) {
        const auto ca = any_cast< float >( a );
        float cb = numeric_limits< float >::infinity();
        if (bt == typeid( double )) {
            cb = (float)any_cast< double >( b );
        } else if (bt == typeid( float )) {
            cb = any_cast< float >( b );
        } else if (bt == typeid( int )) {
            cb = (float)any_cast< int >( b );
        } else if (bt == typeid( size_t )) {
            cb = (float)any_cast< size_t >( b );
        } else if (bt == typeid( string )) {
            cb = (float)numberCast( any_cast< string >( b ) );
            // Получим infinity(), если не число
        }
        if (cb != numeric_limits< float >::infinity()) {
            r.second = (precision > std::abs( ca - cb ));
        }

    // int
    } else if (at == typeid( int )) {
        const auto ca = any_cast< int >( a );
        if (bt == typeid( double )) {
            r.second = (ca == (int)any_cast< double >( b ));
        } else if (bt == typeid( float )) {
            r.second = (ca == any_cast< float >( b ));
        } else if (bt == typeid( int )) {
            r.second = (ca == any_cast< int >( b ));
        } else if (bt == typeid( size_t )) {
            r.second = (ca == (int)any_cast< size_t >( b ));
        } else if (bt == typeid( string )) {
            const double temp = numberCast( any_cast< string >( b ) );
            // Получим infinity(), если не число
            if (temp != numeric_limits< double >::infinity()) {
                r.second = (ca == (int)temp);
            }
        }

    // size_t
    } else if (at == typeid( size_t )) {
        const auto ca = any_cast< size_t >( a );
        if (bt == typeid( double )) {
            r.second = (ca == (size_t)any_cast< double >( b ));
        } else if (bt == typeid( float )) {
            r.second = (ca == (size_t)any_cast< float >( b ));
        } else if (bt == typeid( int )) {
            r.second = (ca == (size_t)any_cast< int >( b ));
        } else if (bt == typeid( size_t )) {
            r.second = (ca == any_cast< size_t >( b ));
        } else if (bt == typeid( string )) {
            const double temp = numberCast( any_cast< string >( b ) );
            // Получим infinity(), если не число
            if (temp != numeric_limits< double >::infinity()) {
                r.second = (ca == (size_t)temp);
            }
        }

    // string
    } else if (at == typeid( string )) {
        const string ca = any_cast< string >( a );
        if (bt == typeid( string )) {
            r.second = (ca == any_cast< string >( b ));
        }
        // Может, число представлено строкой? Строки переведём
        // в числа и сравним числа согласно их типу.
        const double nca = numberCast( ca );
        if (nca != numeric_limits< double >::infinity()) {
            if (bt == typeid( double )) {
                const auto ncb = any_cast< double >( b );
                r.second = (precision > std::abs( nca - ncb ));
            } else if (bt == typeid( float )) {
                const auto ncb = any_cast< float >( b );
                r.second = (precision > std::abs( (float)nca - ncb ));
            } else if (bt == typeid( int )) {
                const auto ncb = any_cast< int >( b );
                r.second = ((int)nca == ncb);
            } else if (bt == typeid( size_t )) {
                const auto ncb = any_cast< size_t >( b );
                r.second = ((size_t)nca == ncb);
            }
            // string посмотрели выше
        }

    } // if-else ...

    return r;
}

В методе используется вот такая функция, которая ~~кастует~~ преобразует строку в число:

/**
* @return Распознанное число или numeric_limits< double >::infinity().
*/
inline double numberCast( const string& s ) {
    try {
        const double number = boost::lexical_cast< double >( s );
        return number;
    }
    catch ( boost::bad_lexical_cast& ) {
        return numeric_limits< double >::infinity();
    }
}

И, конечно же, тесты! Без них любой код смотрится подозрительно. Используем googletest. Надо говорить, что все t. - зелёные?

/**
* Фикстура.
*/
class DTest : public ::testing::Test {
  protected:
    inline DTest() {
    }

    virtual inline ~DTest() {
    }

    virtual inline void SetUp() {
    }

    virtual void TearDown() {
    }
};

Одинаковые типы данных

TEST_F( DTest, IntEqualsInt_LazyEquals ) {
    const auto a = boost::any( (int)100 );
    const auto b = boost::any( (int)100 );
    const auto r = d::lazyEquals( a, b );
    EXPECT_TRUE( r.first );
    EXPECT_TRUE( r.second );
}


TEST_F( DTest, IntNotEqualsInt_LazyEquals ) {
    const auto a = boost::any( (int)100 );
    const auto b = boost::any( (int)200 );
    const auto r = d::lazyEquals( a, b );
    EXPECT_TRUE( r.first );
    EXPECT_FALSE( r.second );
}


TEST_F( DTest, SizeTEqualsSizeT_LazyEquals ) {
    const auto a = boost::any( (size_t)100 );
    const auto b = boost::any( (size_t)100 );
    const auto r = d::lazyEquals( a, b );
    EXPECT_TRUE( r.first );
    EXPECT_TRUE( r.second );
}


TEST_F( DTest, SizeTNotEqualsSizeT_LazyEquals ) {
    const auto a = boost::any( (size_t)100 );
    const auto b = boost::any( (size_t)200 );
    const auto r = d::lazyEquals( a, b );
    EXPECT_TRUE( r.first );
    EXPECT_FALSE( r.second );
}


TEST_F( DTest, FloatEqualsFloat_LazyEquals ) {
    const auto a = boost::any( (float)100 );
    const auto b = boost::any( (float)100 );
    const auto r = d::lazyEquals( a, b );
    EXPECT_TRUE( r.first );
    EXPECT_TRUE( r.second );
}


TEST_F( DTest, FloatNotEqualsFloat_LazyEquals ) {
    const auto a = boost::any( (float)100 );
    const auto b = boost::any( (float)200 );
    const auto r = d::lazyEquals( a, b );
    EXPECT_TRUE( r.first );
    EXPECT_FALSE( r.second );
}


TEST_F( DTest, DoubleEqualsDouble_LazyEquals ) {
    const auto a = boost::any( (double)100 );
    const auto b = boost::any( (double)100 );
    const auto r = d::lazyEquals( a, b );
    EXPECT_TRUE( r.first );
    EXPECT_TRUE( r.second );
}


TEST_F( DTest, DoubleNotEqualsDouble_LazyEquals ) {
    const auto a = boost::any( (double)100 );
    const auto b = boost::any( (double)200 );
    const auto r = d::lazyEquals( a, b );
    EXPECT_TRUE( r.first );
    EXPECT_FALSE( r.second );
}


TEST_F( DTest, StringLatinEqualsStringLatin_LazyEquals ) {
    const auto a = boost::any( (string)"abcd" );
    const auto b = boost::any( (string)"abcd" );
    const auto r = d::lazyEquals( a, b );
    EXPECT_TRUE( r.first );
    EXPECT_TRUE( r.second );
}


TEST_F( DTest, StringLatinNotEqualsStringLatin_LazyEquals ) {
    const auto a = boost::any( (string)"abcd" );
    const auto b = boost::any( (string)"abcdefgh" );
    const auto r = d::lazyEquals( a, b );
    EXPECT_TRUE( r.first );
    EXPECT_FALSE( r.second );
}


TEST_F( DTest, StringUnicodeEqualsStringUnicode_LazyEquals ) {
    const auto a = boost::any( (string)"Юникод" );
    const auto b = boost::any( (string)"Юникод" );
    const auto r = d::lazyEquals( a, b );
    EXPECT_TRUE( r.first );
    EXPECT_TRUE( r.second );
}


TEST_F( DTest, StringUnicodeNotEqualsStringUnicode_LazyEquals ) {
    const auto a = boost::any( (string)"Юникод" );
    const auto b = boost::any( (string)"Юникод тоже" );
    const auto r = d::lazyEquals( a, b );
    EXPECT_TRUE( r.first );
    EXPECT_FALSE( r.second );
}

Разные типы данных

TEST_F( DTest, IntEqualsSizeT_LazyEquals ) {
    auto a = boost::any( (int)100 );
    auto b = boost::any( (size_t)100 );
    auto r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (size_t)100 );
    b = boost::any( (int)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );
}


TEST_F( DTest, IntNotEqualsSizeT_LazyEquals ) {
    auto a = boost::any( (int)100 );
    auto b = boost::any( (size_t)200 );
    auto r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (size_t)100 );
    b = boost::any( (int)200 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );
}


TEST_F( DTest, IntEqualsFloat_LazyEquals ) {
    auto a = boost::any( (int)100 );
    auto b = boost::any( (float)100 );
    auto r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (float)100 );
    b = boost::any( (int)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );
}


TEST_F( DTest, IntNotEqualsFloat_LazyEquals ) {
    auto a = boost::any( (int)100 );
    auto b = boost::any( (float)200 );
    auto r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (float)100 );
    b = boost::any( (int)200 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );
}


TEST_F( DTest, IntEqualsDouble_LazyEquals ) {
    auto a = boost::any( (int)100 );
    auto b = boost::any( (double)100 );
    auto r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (double)100 );
    b = boost::any( (int)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );
}


TEST_F( DTest, IntNotEqualsDouble_LazyEquals ) {
    auto a = boost::any( (int)100 );
    auto b = boost::any( (double)200 );
    auto r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (double)100 );
    b = boost::any( (int)200 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );
}

Строки - Равенство

TEST_F( DTest, NumberEqualsString_LazyEquals ) {
    // int
    auto a = boost::any( (int)100 );
    auto b = boost::any( (string)"100" );
    auto r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (string)"100" );
    b = boost::any( (int)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (int)100 );
    b = boost::any( (string)"100.0" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (string)"100.0" );
    b = boost::any( (int)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    // size_t
    a = boost::any( (size_t)100 );
    b = boost::any( (string)"100" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (string)"100" );
    b = boost::any( (size_t)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (size_t)100 );
    b = boost::any( (string)"100.0" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (string)"100.0" );
    b = boost::any( (size_t)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (size_t)100 );
    b = boost::any( (string)"100.1" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (string)"100.1" );
    b = boost::any( (size_t)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    // float
    a = boost::any( (float)100 );
    b = boost::any( (string)"100" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (string)"100" );
    b = boost::any( (float)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (float)100 );
    b = boost::any( (string)"100.0" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (string)"100.0" );
    b = boost::any( (float)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (float)100.1 );
    b = boost::any( (string)"100.1" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (string)"100.1" );
    b = boost::any( (float)100.1 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    // double
    a = boost::any( (double)100 );
    b = boost::any( (string)"100" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (string)"100" );
    b = boost::any( (double)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (double)100 );
    b = boost::any( (string)"100.0" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (string)"100.0" );
    b = boost::any( (double)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (double)100.1 );
    b = boost::any( (string)"100.1" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

    a = boost::any( (string)"100.1" );
    b = boost::any( (double)100.1 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_TRUE( r.second );

}

Строки - Не равенство

TEST_F( DTest, NumberNotEqualsString2_LazyEquals ) {
    // int
    auto a = boost::any( (int)100 );
    auto b = boost::any( (string)"200" );
    auto r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"200" );
    b = boost::any( (int)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (int)100 );
    b = boost::any( (string)"200.0" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"200.0" );
    b = boost::any( (int)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    // size_t
    a = boost::any( (size_t)100 );
    b = boost::any( (string)"200" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"200" );
    b = boost::any( (size_t)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (size_t)100 );
    b = boost::any( (string)"200.0" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"200.0" );
    b = boost::any( (size_t)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    // float
    a = boost::any( (float)100 );
    b = boost::any( (string)"200" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"200" );
    b = boost::any( (float)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (float)100 );
    b = boost::any( (string)"200.0" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"200.0" );
    b = boost::any( (float)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    // double
    a = boost::any( (double)100 );
    b = boost::any( (string)"200" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"200" );
    b = boost::any( (double)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (double)100 );
    b = boost::any( (string)"200.0" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"200.0" );
    b = boost::any( (double)100 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );
}


TEST_F( DTest, Number2NotEqualsString_LazyEquals ) {
    // int
    auto a = boost::any( (int)200 );
    auto b = boost::any( (string)"100" );
    auto r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"100" );
    b = boost::any( (int)200 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (int)200 );
    b = boost::any( (string)"100.0" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"100.0" );
    b = boost::any( (int)200 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    // size_t
    a = boost::any( (size_t)200 );
    b = boost::any( (string)"100" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"100" );
    b = boost::any( (size_t)200 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (size_t)200 );
    b = boost::any( (string)"100.0" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"100.0" );
    b = boost::any( (size_t)200 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    // float
    a = boost::any( (float)200 );
    b = boost::any( (string)"100" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"100" );
    b = boost::any( (float)200 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (float)200 );
    b = boost::any( (string)"100.0" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"100.0" );
    b = boost::any( (float)200 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    // double
    a = boost::any( (double)200 );
    b = boost::any( (string)"100" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"100" );
    b = boost::any( (double)200 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (double)200 );
    b = boost::any( (string)"100.0" );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );

    a = boost::any( (string)"100.0" );
    b = boost::any( (double)200 );
    r = d::lazyEquals( a, b );
    EXPECT_FALSE( r.first );
    EXPECT_FALSE( r.second );
}

Библиотека усатых шаблонов для C++

2011-11-03T08:35:00.001+02:00

Появилась необходимость использовать шаблоны в своём (инди-)проекте на C++. Т.к. я работаю c CouchDB, мне очень привычно использовать Mustache. К счастью, этот замечательный и крайне быстрый шаблонизатор доступен практически для всех известных на сегодня языков программирования. C++ - известный язык :) и Mustache для него называется Plustache.

Я почему решил об этом написать? Потому что работаю с C++ уже полгода (не считаю себя классным специалистом, нет), успел его и возненавидеть, и полюбить. Порог входа в этот язык - довольно высок: шишок у начинающих C++ изучать - мама не горюй! И здесь речь не о первой программе типа "Hello world!", хотя и это в C++ - уже достижение :) Собрать проект из исходного кода - то, без чего ни один серьёзный программист сегодня не выживет. И если человек не знает... нет, даже не основ, а (!) подноготной C++, изучение языка может замедлиться (ведь придётся писать и отлаживать свой велосипед) или даже остановиться. Надеюсь, описание процесса сборки проекта от "А" до "Я" поможет Вам в дальнейшем смело включать сторонние библиотеки в свои проекты.

Если бы Daniel Schauenberg - автор Plustache, огромное ему спасибо за труд! - попробовал собрать свой проект под Windows, он бы, наверное, внёс изменения в код. Хотя вряд ли: поддерживать несколько операционных систем - та ещё радость! Тем более, что проект - маленький и с лёгкостью переносится на любые ОС. Прекрасно подходит для обучения.

Итак, соберём Plustache как статическую библиотеку (*.lib) на MS Visual C++ 2010.

I. Получение исходного кода проекта.

Это самый простой этап. Зайдите на https://github.com/mrtazz/plustache, скачайте ZIP-архив проекта, распакуйте содержимое.

II. Подготовка проекта для VC++.

Не было бы печали, если бы rake работал под Windows также, как для OS X. Это не так. Хотя - клянусь! - я поставил для этой цели Ruby.

1. Создание пустого проекта.

Выбираем в меню VC++ "Создать проект / Пустой проект "...

... и в свойствах проекта делаем след. изменения:

Общие / Тип конфигурации = "Статическая библиотека (.lib)"
C++ / Общие / Обрабатывать предупреждения как ошибки = "Да" или "Нет" (см. заметку ниже).

2. Копирование файлов.

VC++ поощряет создание проектов, которые заставят помучаться желающих скомпилировать их в другой IDE. Я говорю о файлах *.h и *.cpp, которые при создании из IDE VC++ бросаются в общую папку и т.н. "фильтрах", которыми VC++ мило позволяет пользоваться, но которые не являются папками файловой системы. Файлы Plustache лежат в папках "include", "src" и "tests". Можно пойти на поводу у Microsoft, но здесь вовсе не тот случай, когда мы вынуждены это делать. Поэтому

Целиком скопируйте папки "include", "src" и "tests" в папку нашего проекта, воспользовавшись Проводником Windows.
Добавим в VC++ / plustache файлы, (!) за исключением "main.cpp". Будем аккуратны: h-файлы поместим в "Заголовочные файлы", cpp-файлы - в "Файлы исходного кода".

3. Настройка проекта, разрешение зависимостей.

Настроек, сделаных в п.1, недостаточно для сборки, если проект имеет зависимости. Мало какой проект на C++ их не имеет. У Plustache зависимостей две:

Boost

За время изучения C++ я понял, что без Boost'а программиста ждёт безрадостное существование. Если Boost у Вас на компьютере ещё не установлен, сделайте это. Благо, создатели этого фреймворка пошли по пути упрощения и последние версии работают без компиляции. Вообще говоря, когда Вы начали серьёзно работать с C++, существует два ответа на вопрос "Нужно ли устанавливать Boost?": (а) да, сейчас; (б) да, позже.

(!) После установки Boost'а, убедитесь, что переменная окружения "BOOST_ROOT" - открываем Мой компьютер / Свойства / Дополнительно / Переменные среды - установлена и указывает на нужную папку. Например, это может быть папка "C:\boost_Версия".
Если внимательно следовали инструкции по установке, так оно и будет.

Заходим в свойства проекта Plustache и дорисовываем:

Каталоги VC++ / Каталоги включения / Изменить / Добавить = "$(BOOST_ROOT)"

GoogleTest

Если уже используете эту библиотеку unit-тестирования в других своих проектах (в Boost свой модуль тестирования тоже есть, но также есть жалобы, что библиотека на развивается) - просто добавьте пути к заголовочным файлам, как сделали выше для Boost'а.

Но для Plustache от GoogleTest можно отказаться. Библиотека используется в файлах папки "test". Поэтому просто не добавляйте эти файлы в проект.

4. Устранение ошибок компиляции.

Запускаем компиляцию.

Первая ошибка - компилятор VC++ 2010 не найдёт пути к некоторым своим же файлам включения (#include "include/*.hpp"). Можно Устраняется в свойствах проекта:

Каталоги VC++ / Каталоги включения / Изменить / Добавить = "Путь к папке, где лежит проект". Например, такой > "D:\Projects\utils\plustache".

Опция "Обрабатывать предупреждения как ошибки" (см. выше) заставляет программиста писать более чистый, быстрый и надёжный код. Для больших библиотек устанавливать эту опцию - лишняя головная боль, т.к. свободный код программисты на Windows пишут редко. Иначе, почему в больших проектах количество предупреждений компилятора - зашкаливает!?

Т.к. Plustache - очень маленькая библиотека, ошибок много исправлять не придётся.

try {
    // ...
} catch ( int i ) {
    // ...
}

исправляем на

try {
    // ...
} catch ( ... ) {
    // ...
}

Компилятор покажет где.

В общем-то, на этом всё. Статическая библиотека plustache.lib создана (компилятор показывает путь, куда её положил) и готова к работе в других проектах под MS Windows. Благодаря тому, что Вы читали внимательно и не добавили в проект Visual C++ файл "main.cpp", не появится предупреждение LNK4006 при использовании plustache.lib в других проектах :)

А если в CouchDB View на View надо позарез?

2011-10-28T20:19:00.000+03:00

Когда уже на "ты" с CouchDB, почти всегда оказывается, что чего-то не хватает: нет полнотекстового поиска "из коробки", хранилище растёт как на дрожжах и приходится самому следить за его размером и т.д.. С поиском вопрос решается подключением сторонних модулей. С пугающим ростом базы данных в след. релизах вопрос уже решён. Но вот такая хитрая штука как обработка результатов другого представления - этого в ближайших планах разработчиков CouchDB не предвидится. Хотя вещь, безусловно, полезная.

Например, мы можем держать в хранилище сырые данные - скажем, список фактических адресов, забитых ~~кем~~ как попало - и создать для них представление (view), результатом которого будет чёткая структура с разбивкой по стране / городу / индексу / улице / номеру дома и пр.. Чем хорош такой подход? Написать идеальный парсер вручную введённых адресов - дело не одного дня и даже месяца (спорить с этим может только тот, кто с подобной задачей в промышленных масштабах не сталкивался). А вот достаточный для начала работы парсер адресов - дело 1 часа. И это позволит начать разработку след. этапов системы без необходимости ждать полностью готового списка структурированных адресов и (!) даже когда-либо возвращаться к сырым адресам. Непробиваемые аргументы, когда работает команда и/или требуется видимый результат "уже завтра". Мало? Тогда представьте, что каждый день добавляется сотня новых адресов... Потом к парсеру можно возвращаться, делая его всё лучше. Но структурированные данные благодаря созданному представлению уже на руках! И, раз уж начали представлять, предположим, что проект - большой и было принято решение оставить это живое представление (живое - потому что формирует адреса из сырого потока) как источник для других модулей системы. Т.е. менять его вывод - ни-ни!

И вот, хотим некоторым адресатам что-то сами доставлять. Для этой цели хорошо бы группировать адреса по индексам, чтобы раздать списки водителям, сэкономив и бензин, и время (Вы ведь знаете, что такое почтовый индекс). И тут CouchDB оказывается не на высоте, т.к. живой список адресов (в виде гранитного представления) - есть, а вот работать с ним - не можем: CouchDB не поддерживает создание представления для другого представления.

В общем-то, задачу подобную задачу можно решить, периодически копируя результаты работы представления в новую базу; или создав новое представление, которое помимо структурирования адресов (copy / paste здесь поможет) будет делать необходимую нам выборку и группировку по почтовым индексам. Оба решения усложнят дальнейшее сопровождение системы. А ведь как красиво задача решается простым созданием нового представления... на готовые результаты другого!

К счастью, на этой неделе появилась разработка, позволяющая создавать цепочки представлений, благодаря которым изложенная выше задача решается и просто, и красиво > https://github.com/afters/Couch-Incarnate

Для своей работы требует Node.js.

P.S. Строго говоря, couch-incarnate не является единственной альтернативой реализовать представление по результатам другого map/reduce. Активно ведётся разработка целой системы - CloudAnt - на базе CouchDB, где, помимо прочего, поддерживается view на view что называется "из коробки". CloudAnt, безусловно, заслуживает отдельного внимания, но это - не тот CouchDB.

Специфические JavaScript-функции CouchDB

2011-10-26T16:14:00.000+03:00

CouchDB - платформа для разработки приложений. Об этом вначале забывают веб-мастера, когда обнаруживают, что весь код пишется на JavaScript (и которые ещё не знакомы с Node.js, ага). Как и на любой платформе, здесь присутствуют функции, которых не найдёте в JavaScript-документации. Ниже - все они в алфавитном порядке.

emit() В map-функции формирует результат в виде пар ключ-значение.
getRow() В list-функции позволяет обработать результат, получаемый из view.
JSON.parse() Преобразует строку в объект JSON.
JSON.stringify() Преобразует объект JSON в строку.
log() Выводит в лог сообщения / значения переменных. Полезная для отладки функция.
provides() Метод, пришедший на замену respondWith(). Переопределяет заголовок перед отправкой результата клиента в show / view.
registerType() Добавляет новый тип, который может быть возвращён в заголовке ответа. Посмотреть предустановленные типы Вы можете в <ПапкеCouchDB>/share/couchdb/server/main.js
require() Подключает указанный JavaScript-файл (стандарт CommonJS).
send() Отправляет клиенту пакет или часть пакета. Используется в list-функции.
start() Задаёт заголовок для пакета в list-функции. Всегда должна идти раньше send().
sum() Суммирует значения в reduce-функции.
toJSON() Псевдоним для JSON.stringify().

Ссылался я на страницы, которые посчитал наиболее удачными для понимания работы описываемых функций. Поэтому, если в первом абзаце не найдёте ожидаемое упоминание функции, просто посмотрите ниже: непременно обнаружите примеры / пояснения.

CouchDB 1.1.1: Релиз близок!

2011-10-19T22:11:00.002+03:00

Сегодня собран пререлиз CouchDB 1.1.1.
(Последняя официальная версия CouchDB - 1.1.0 - была выпущена 30-05-2011 г.)

Добавлена функциональность

Наконец-то, CouchDB дружит со SpiderMonkey 1.8.5!
Добавлена настройка (размер результата в байтах) в файл конфигурации для http://localhost/_log
Модулю CommonJS разрешено быть пустым.
Etag'и для представлений стали умнее.
Улучшен обработчик, определяющий количество открытых баз (параметр конфигурации max_dbs_open_limit).
В ответе для JSONP теперь передаётся "Content-Type": "text/javascript".
Обработчик обновлений может возвращать HTTP-код в ответе клиенту.
При очистке представлений (сжатии), удаляются все индексные файлы, если в базе отсутствует ddoc.
Для параметра конфигурации max_replication_retry_count теперь можно указать "бесконечность". См. прим. в файле конфигурации.

Исправлены ошибки

Запускалась validate_doc_update функция, даже если она была удалена.
В _changes попадались дубликаты.
Обработчик обновлений прекращал работу после разрешения конфликта.
Включение фильтра в _replicator могло повредить базу.
Сжатие большого представления завершалось с ошибкой.
При каждом вызове _log создавался новый дескриптор файла.
Терялись записи при вызове _changes?style=all_docs
В системе оставались жить процессы couchjs, которые завершались с ошибкой reduce_overflow.
Метод provides() не корректно работал в show. CouchDB-1272.
Репликация прекращалась, когда в базе-источнике встречался документ с пустым UID.
Процесс couchjs мог зависать при обслуживании некоторых запросов.
Исправлены ошибки в multipart PUT API.

Прочие мелочи

Минимальная версия Erlang'а - R13B02.
Для Windows-версии добавлена ссылка на ICU 4.2
Путь для функций обновления может начинаться со слешей.

Couchbase Server 2.0 > Общие вопросы и ответы (по итогам вебинара)

2011-10-16T19:12:00.000+03:00

Перевод итогов вебинаров Couchbase, которые на этой неделе опубликовал Perry Krug. Источник.

I just finished up a nine-week technical webinar series highlighting the features of our upcoming release of Couchbase Server 2.0. It was such a blast interacting with the hundreds of participants, and I was blown away by the level of excitement, engagement and anticipation for this new product.

Я (чит. - Пэри Круг) только что закончил 9-недельную серию вебинаров, освещающих новые возможности предстоящего релиза Couchbase Server 2.0. Это были яркие беседы с сотнями участников и я просто обалдел от волнения, рассказывая о новом продукте и ожидая его выпуска.

(By the way, if you missed the series, all nine sessions are available for replay).

(Если Вы пропустили серии, записи всех вебинаров находятся здесь).

There were some great questions generated by users throughout the webinar series, and my original plan was to use this blog entry to highlight them all. I quickly realized there were too many to expect anyone to read through all of them, so I’ve taken a different tack. This blog will feature the most common/important/interesting questions and answer them here for everyone’s benefit. Before diving in, I’ll answer the question that was by far the most commonly asked: “How long until the GA of Couchbase Server 2.0?” We are currently on track to release it before the end of the year. In the meantime, please feel free to experiment with the Developer Preview that is already available. As for the rest of the questions, here goes!
Участники задавали хорошие вопросы и цель этого текста - собрать вопросы и ответы вместе, в этом блоге. Что я и сделал довольно быстро. Здесь будут освещены наиболее общие / важные / интересные вопросы и ответы на них. Но вначале, я отвечу на самый общий вопрос: "Когда появится официальная Couchbase Server 2.0?" Мы ожидаем её появления до конца года. Тем временем, пожалуйста, свободно эксперементируйте с версией для разработчиков, она уже доступна. Приступим!

Q: What are the primary benefits of incorporating Membase and CouchDB into a single product?
В> Какие основные преимущества включения Membase и CouchDB в один проект?

A: Membase is a super fast, highly scalable key value store known for its performance and scalability. CouchDB on the other hand is a great document database, with powerful indexing and querying capabilities. Combining these two products brings together the best of both worlds to create a high-performance, highly elastic NoSQL database that scales out linearly while providing querying, indexing and document-oriented features.

О> Membase - очень быстрое, масштабируемое хранилище "Ключ-Значение". CouchDB - великолепная документоориентированная база данных, с мощными возможностями индексации и построения выборок. Объединение этих двух продуктов позволяет создать высокопроизводительное, гибкое NoSQL-хранилище, обеспечивающее нас линейной сложностью при масштабировании плюс возможностями индексации и выборки документов.

Q: Does Couchbase speed up access to a database document by automatically caching it in memory?

В> Действительно ли увеличивается скорость работы с документами при кешировании данных в памяти?

A: Absolutely! That’s one of the great feature of Couchbase Server 2.0, and comes from the vast experience we have with memcached. All access to documents goes through our integrated RAM caching layer (built out of memcached) to provide extremely low and, more importantly, predictable, latency under extremely heavy loads. For instance, we regularly see customers well over 100k operations/sec across a cluster and have taken single nodes to over 200k operations/sec in our own testing environments. This RAM caching layer also allows us to handle spikes in write (and read) load without affecting the performance of the application.

О> Так и есть! Это одно из больших достижений Couchbase Server 2.0, и пришло оно благодаря нашему огромному опыту работы с Membase. Любой доступ к документам происходит через интегрированный кеш, RAM-слой (строится с помощью 'memcached'), что даёт крайне низкую и, что более важно, предсказуемую задержку в высоконагруженных системах. Например, мы сейчас получаем более чем 100K операций/сек на целом кластере, а в нашей тестовой среде смогли достичь производительности до 200K операций/сек для одного узла. Слой кеширования также позволяет нам обходить проблемы при записи (и чтении) без потери производительности приложения.

Q: I see in your forums that Couchbase Server 2.0 uses the memcached protocol for accessing data as this is compatible for existing Membase users and also for the much higher performance. Is there a way to use REST APIs akin to CouchDB’s to access the documents in Couchbase Server 2.0?

В> Я вижу на вашем форуме, что Couchbase Server 2.0 использует протокол memcached для доступа к данным для совместимости с уже существующими Membase-клиентами плюс для увеличения производительности. Как же тогда пользоваться REST API, который предоставляет CouchDB для доступа к документам?

A: The first version of Couchbase Server 2.0 uses the memcached protocol for document access, and the CouchDB HTTP protocol for accessing views. Over time, these two will merge even closer. In the meantime, we have provided a number of client libraries that abstract these two access methods away from the developer.

О> Первая версия Couchbase Server 2.0 использует memcached-протокол для доступа к документам и HTTP-протокол для доступа к представлениям CouchDB. Со временем это будет объединено. Пока что мы создали библиотеки, которые объединяют эти два метода доступа к данным.

Q: Is Couchbase Server 2.0 going to be open source?

В> Couchbase Server 2.0 будет OpenSource-проектом?

A: It already is! As a company, Couchbase is fully committed to the furthering of the open source communities that exist and are being built around our various products. While our focus is on providing enterprise-class software to our paying customers, we embrace the free-flow of ideas and wide adoption that an open source project allows for and believe very strongly that there is a place for both.

О> Он уже им является! Как организация, Couchbase полностью представлена в сообществе OpenSource и на основе Couchbase Server 2.0 могут создаваться свои вариации продукта. Несмотря на то, что мы сосредоточены на приложениях класса предприятия, мы открыты для идей и верим, что благодаря OpenSource система будет адаптирована и для других областей.

Indexing/Querying
Индексация / Выборка

Q: All I need is a simple secondary index, not map/reduce...how do I do that?

В> Всё что мне нужно, это просто вторичный индекс, не map/reduce... Как мне быть?

A: Currently, all of our indexes are built using a map function (the reduce is totally optional and can be ignored here). This is really just another syntax for creating an index and there are a variety of examples avialable discussing how to create very simple indexes. The very simplest form would involve just putting "emit(doc.)" in your map function where is what you want to index off of. This will create a list of all documents containing that field, sorted by that field. Of course there are more complex scenarios, but it can be made quite simple if that is what is needed.

О> В настоящее время все индексы строятся используя map-функцию (reduce можно игнорировать). Это просто другой синтаксис для создания индекса и есть множество разных примеров, как создать очень простые индексы. Самое простое - поместить emit( doc.field ) в Вашу map-функцию. Это создаст список всех документов, содержащих поле 'field'; список будет сразу отсортирован по этому полю. Конечно, в действительности приходится сталкиваться с более сложными сценариями, но строится индекс всегда очень просто, если знаете, что Вам нужно.

Q: How does dealing with Couchbase Server 2.0 views differ from CouchDB and Couchbase Single Server?

В> Чем представления Couchbase Server 2.0 отличаются от CouchDB и Couchbase Single Server?

A: Not at all...the format, the syntax, everything is the same. Additionally, all the options for querying are supported. You can literally copy-paste the view code from one to another. Multiple design docs are also supported.

О> Ничем... Формат, синтаксис, всё остальное - одинаково. В дополнение, все опции запросов поддерживаются. Вы можете буквально копировать код представления из одной системы в другую. Множество дизайн-документов также поддерживается.

Q: Does Couchbase Server 2.0 support ad-hoc querying?

В> Couchbase Server 2.0 поддерживает запросы по требованию (ad-hoc запросы)?

A: At the moment, all querying to Couchbase Server (like CouchDB) must be done against pre-materialized views. In general, this is the only way of providing reliable performance when making those queries. We also understand the need to for more on-demand/ad-hoc querying and are working diligently to provide that as well. Couchbase has already begun to take an industry-leader approach to creating a language specifically for unstructured data that can be used across the NoSQL landscape. Take a look at http://unqlspec.org to see what we're working on!

О> В данный момент все запросы к Couchbase Server (аналогично - к CouchDB) должны быть предварительно воплощены в представлениях. В общем, это только способ получить надёжную работу этих запросов. Мы также понимаем необходимость создания запросов по требованию и старательно работаем, чтобы это тоже было. Couchbase уже начали воспринимать как отраслевого лидера, создающего язык специально для работы с неструктурированными данными. Взгляните по http://unqlspec.org - и увидите, что работы идут полным ходом!

SDKs/Client Libraries
Среды разработки / Клиентские библиотеки

Q: Which SDK's and client libraries are supported?

В> Какие SDK и клиентские библиотеки поддерживаются?

A: At a base level, Couchbase Server 2.0 supports any library that implements the memcached protocol (and there are MANY of those). For the additional functionality that we have added (extended protocol commands and view access) Couchbase provides client libraries for a variety of languages (Java, .NET, PHP, Python, Ruby, C/C++) as well as instructions for how to extend libraries for other languages.
О> На базовом уровне, Couchbase Server 2.0 поддерживаются библиотеки, которые реализуют протокол Memcached (и таких много). Для расширения функциональности, мы добавили библиотеки на разных языках программирования (Java, .NET, PHP, Python, Ruby, C/C++) а также руководства, как создать библиотеку на других языках.

Q: Is there any chance of dogpiling with stale=update_after? If you get 30 requests simultaneously for a view with stale=update_after, will they generate several requests simultaneously for updating the index?

В> Есть возможность создать беспорядок при использовании stale=update_after? Если вы получаете одновременно 30 запросов для обновления с включённым stale=update_after, тогда будут генерироваться разные запросы при обновлении индекса?

A: To recap, “stale” tells the server that this query request should be returned as quickly as possible, knowing that some data that has already been written may not be included in the view. By putting “update_after” in the request as well, the client is telling the server to rematerialize the index in the background…after returning the initial request as quickly as possible. Once this rematerialization is started, subsequent requests will not cause anything different to happen so there’s no worry of “dogpiling” or “stampeding herd” issues.

О> Вспомним, 'stale' говорит серверу что ответ на этот запрос должен быть возвращён так быстро, насколько возможно. Это означает, что некоторые данные, которые были записаны в хранилище, могут не попасть в представление. Поставив 'update_after' в запрос, клиент говорит серверу перестраивать индекс в фоне... после возвращения начального запроса так быстро, насколько возможно. Раз построение индекса началось, последующие запросы не вызовут ничего. Так что не волнуйтесь о беспорядке в базе (в ориг. - dogpilling or stampeding herd, "собачей кучи" или "панического бегства стада").

Q: How does the client know when to pull updated the server/vbucket maps?

В> Как клиент узнает, что обновление на сервере завершилось?

A: All clients (whether they be our “smart” clients or are going through our Moxi process) will maintain a streaming connection to a Couchbase Server. When the topology of the cluster changes (add/remove/failover nodes), the clients will be automatically updated with a new vbucket map over this connection. The clients can also request this map on-demand, and do so everytime they startup. Additionally, each node of the cluster knows which vbuckets it is responsible for and will only return data for those vbuckets. This way, even if a client is temporarily out of sync with the cluster, it will never be vulnerable to inconsistent data.

О> Все клиенты (будь это наши "умные" клиенты или идущие через наш Moxi-процесс) будут поддерживать потоковое соединение с Couchbase Server. Когда топология кластера изменится (добавятся / удалятся / откажут узлы), клиент будет автоматически извещён по этому соединению получение новой vbucket-карты. Клиенты также могут самостоятельно отправить запрос этой карты и делать это каждый раз при подключении. Кроме того, каждый узел кластера знает какие vbacket за что отвечают и может вернуть данные для конкретных vbucket. Т.о., даже если клиент временно не синхронизирован с кластером, он никогда не будет уязвим к получению противоречивых данных.

Development/Production View Usage
Использование представлений при разработке / в производстве

Q: Why the extra effort of creating a view in “development” mode and then pushing it to production?

В> Почему нужны дополнительные усилия для создания представлений в режиме "разработки" и когда внедряем представления на стадии "производства"?

A: We wanted to provide the ability to do view development on a live dataset, but didn’t want to have that development impact the currently running application. Thus, a “development” mode was created so that users could create and edit views on “real” data. In order to speed up the iterations of development, the default is to materialize a view over a subset of the data. When the development is complete, the user can opt to materialize the view over the whole cluster right before pushing it to production. This gives the added benefit of materializing the view so that it is immediately ready for the application to use. Lastly, this “development” mode can be used to edit views that are currently in production , without affecting the application’s access to them (by making a copy). When the edits are complete, the view can then be materialized and swapped with the original into production.

О> Мы хотели бы предоставить возможность строить представления на живых наборах данных, но не хотим влиять при разработке на работающее сейчас приложение. Т.о., режим "разработки" был создан: так пользователи могли бы создавать и редактировать представления на "реальных" данных. В целях ускорения итераций разработки, по умолчанию представления создаются над подмножеством данных. Когда разработка завершена, пользователь может разместить представление на целом кластере прямо перед запуском на живых данных. Это даёт дополнительное преимущество: представление готово к немедленному использованию в приложении. Наконец, этот режим "разработки" может быть использован для редактирования представлений, находящихся в "производстве", без затрагивания самого приложения (сделав копию). Когда редактирование завершено, новое представление может заменить оригинал на "производстве".

Q: How do you control what the development data set is?

В> Как контролировать, что работаем с "данными для разработки"?

A: Currently, the development dataset is automatically decided by the software depending on how much data exists. For small datasets, the software will actually materialize the view across the whole thing. As that gets larger, the software will automatically scale it down to provide a quicker response time while developing. Once the view is finalized, the user has the option to run it over the whole dataset manually (by clicking the tab “Full Cluster Dataset”) both for the purposes of final verification and to prepare it for production use.

О> На сегодня, набор данных для разработки автоматически определяется приложением в зависимости от объёма существующих данных. Для малых наборов, приложение будет создавать представление, включив все данные. Для больших наборов, приложение автоматически масштабирует наборы, опираясь на время отклика при их получении. По завершении разработки представления, пользователь имеет возможность вручную запустить код для всего набора (щёлкнув по вкладке "Full Cluster Dataset") с целью окончательной проверки и подготовки представления для использования в "производстве".

Clustering
Кластеризация

Q: For a bucket with replica and auto-failover, will a server failure without rebalance causing retrieval/update errors on that bucket?

В> Для пакета (bucket) с репликой и при включённой "автоматической отказоусточивости", сбой пройдёт без перебалансировки кластера в случае ошибки выборки / обновления в пакете?

A: When a server initially fails (for whatever reason: hardware, network, software) the application will briefly get errors for any data which that server was responsible for. Requests for data on other servers will not be impacted. These errors will continue until the node is “failed over” which activates the replica data (vbuckets) elsewhere in the cluster. The amount of time will vary depending on whether you are using automatic or manual failover…but once the failover is triggered there is no more delay. You might ask “but why can’t I read from the replica data that already exists.” The answer is two-fold. First, we specifically disallow access to the replica data (while it is “replica”) to preserve the very strong consistency that our system provides. Under normal operation, you are guaranteed to “read your own writes” and this is done by only providing one location for accessing any given piece of data. By allowing unrestricted reading of replicas, you might have a situation where one client writes a piece of data to the active copy and another client immediately tries to read that data from the replica…leading to possible inconsistency. Now, the second part of this answer is that we are currently working on feature to allow for reading from these replicas. It will be a new operation that is explicitly invoked by the application so that there won’t be any confusion about which copy is being read from. You’ll still want to failover the node as quickly as possible since writes will continue to fail. This is one example of the many features we have added as a direct response to our customers’ and users’ demands…you speak, and we listen (and then do something about it too)!

О> Когда произошёл сбой на сервере (по любой причине: оборудование, сеть, программа) приложение будет получать ошибки при запросе любых данных с этого сервера. Запрошенные с других серверов данные останутся прежними. Эти ошибки будут идти до узла, который активировал репликацию данных (vbuckets). Продолжительность будет варьироваться в зависимости от использованного режима отказоустойчивости - ручного или автоматического... Вы можете спросить: "Но почему я не могу прочесть данные из реплики, которая уже существует?" Ответ складывается из двух частей. Во-первых, мы специально запретили доступ к реплике, чтобы сохранить строгую согласованность данных в нашей системе. При нормальной работе вам гарантируется возможность "читать собственные данные". Позволив неограниченное чтение реплик, можно получить ситуацию, когда один клиент записывает часть данных в активную копию, а другой в это же время пытается прочитать данные из реплики... что, возможно, приведёт к несогласованности. Вторая часть ответа касается возможности чтения из этих реплик. Это должна быть новая операция, в которой приложение ясно говорит, что прочитанные данные не внесут путаницы в работу. Вы до сих пор получаете быстрый отказоустойчивый узел, но запись в него вызовет сбой. Это лишь один пример, как много возможностей мы добавили, выслушав наших заказчиков и пользователей... Вы говорите, мы слушаем (и делаем)!

Q: Is there any effect/risk/time when rebalancing a system under heavy write loads? Is it best to add nodes during quite times?
В> Действия / риски / время при восстановлении равновесия (перебалансировки) системы при большом частоте записей в неё.

A: By design, the rebalance operation is done asynchronously so as to have as minimal-as-possible an impact on the performance of the cluster. However, the reality is that rebalancing puts an increased load on the cluster and requires resources in order to do so (network, disk, RAM, CPU). If the cluster is already close to capacity, any increased load may impact the application’s performance. While safe to do at anytime, we highly recommend performing your own tests in your own environment to characterize what, if any, impact will be had by a rebalance. Typically our customers perform these at low or quiet times, but the main advantage is that you don’t need to take the application completely offline as you continue to scale.

О> По замыслу, операция перебалансировки производится асинхронно, так что имеем минимальное влияние на производительность кластера. Однако, в реальности перебалансировка увеличивает нагрузку на кластер и требует ресурсов (сеть, диск, память, процессор). Если кластер уже наполнен до отказа, любая загрузка в него может влиять на производительность приложения. Хотя это безопасно, мы очень рекомендуем провести свои собственные тесты, чтобы определить степень влияния перебалансировки на вашу систему. Обычно наши клиенты уделяют этому вопросу мало времени, но основное преимущество перебалансировки - вам не нужно останавливать работу системы, чтобы ускорить её работу.

Q: What’s a vbucket?

В> Что такое vbucket?

A: A vbucket is our way of logically partitioning data so that it can be spread across all the nodes within a cluster. Every Couchbase-type bucket that gets created on the cluster is automatically (and transparently) split up into a static set of slices (the vbuckets). These are then “mapped” to individual servers. When a node is added or removed, it is these slices that get moved around and re-mapped to provide linear and non-disruptive scaling. While totally abstracted from the application and user, it’s important to realize that vbuckets exist “under-the-hood” to provide much of the wonderful capabilities that Couchbase Server has. You can learn more about the vbucket concept here: http://www.couchbase.org/wiki/display/membase/vBuckets

О> vbucket - это наш вариант логического деления данных, которые могут передаваться между узлами кластера. Каждый пакет (bucket) в кластере автоматически (и прозрачно) разбивает наборы данных на куски (vbucket). Пакеты затем "проецируются" на отдельные серверы. Когда узел добавляется или убирается, части данных перемещаются и перепроецируются. Это происходит без прерывания работы системы. Пакеты не затрагивают приложение и пользователя. Вы можете узнать больше о концепции vbucket здесь > http://www.couchbase.org/wiki/display/membase/vBuckets

Monitoring
Отслеживание

Q: Is the Couchbase Server Web UI the only method of monitoring a Couchbase Server cluster?

В> Веб-интерфейс Couchbase Server - единственный способ наблюдать за работой кластера?

A: Not necessarily, no. All that you see and can do in the Web UI is actually driven by our REST interface (http://www.couchbase.org/wiki/display/membase/Membase+Management+REST+API) that is programmatically accessible externally. Additionally, each individual server (and each individual bucket on that server) provides its own “raw” statistics that are used by the REST API. These raw statistics are available externally as well: http://www.couchbase.org/wiki/display/membase/Monitoring+Membase. It is our goal to provide as much information as possible about the system so that our users can effectively monitor it both from a capacity planning perspective and a diagnostic/troubleshooting perspective when things start to go wrong (or to prevent things from going wrong in the first place.

О> Вовсе нет. Всё, что вы видите и можете делать в веб-интерфейсе Couchbase Server, управляется нашим REST-интерфейсом, доступным внешним программам. Также, каждый конкретный сервер (и каждый конкретный пакет на сервере) предоставляет по REST API собственную "сырую" статистику. Эта сырая статистика также доступна извне. Наша цель - предоставить информацию о системе так много, насколько возможно, чтобы наши пользователи могли эффективно наблюдать работу кластера, планирую т.о. наращивание мощностей и диагностирую/исправляя проблемы, как только они возникнут (или предупреждать их возниконовение).

Q: What kind of alerting does Couchbase Server provide?

В> Какие виды оповещения предоставляет Couchbase Server?

A: Technically, we are not a company that makes alerting software. In our minds, our job is to provide an interface for other systems to make use of. Most larger organizations would not want each piece of technology in their stack sending out a differently formatted set of alerts. That is why we have made it so easy to plug our statistics and monitoring data into any other system. However, we also realize that some smaller environments may in fact want our software to provide this out of the box. We are working on extending our capabilities here and already provide alerts for when nodes go down.

О> Технически, мы не компания, что создаёт приложения для оповещения. По нашему мнению, наша работа - предоставить интерфейс для других систем. Большинство организаций не хотят собирать по кусочкам оповещения, отправленные в разных форматах. Однако, мы реализуем небольшую среду окружения, которая может использоваться "из коробки" (без необходимости подключения других приложений). Мы работаем над расширением возможностей и уже передаём оповещения об узлах, которые "упали".

Autocompaction
Автоматическое сжатие

Q: If you abort the compaction at the end of the timeperiod, is the compaction done up until that point still saved or is all compaction done thus far lost?

В> Если прервать процесс сжатия базы, последующий запуск сжатия продолжится с сохранённой точки или начнётся сначала?

A: Normally, a compaction is all-or-nothing and so aborting it will lose the progress that has been made so far. However, within Couchbase Server, we are performing the compaction on a per-vbucket (see above) basis and so the whole dataset can actually be compacted incrementally without losing all of the progress it has made when aborted.

О> Нормально, когда сжатие проходит по принципу "всё или ничего" и прерывание сжатия приводит к необходимости начать его сначала. Однако, с Couchbase Server мы выполняем сжатие по пакетам (vbucket, см. выше) и целый набор данных в действительности сжимается инкрементно, без потери прогресса в случае отмены сжатия.

Autofailover
Автоматическая отказоустойчивость

Q: Why is a delay imposed before the cluster will automatically failover a downed node?

В> Почему введена задержка до того как кластер автоматически отключит упавший узел?

A: By default, the software is configured with a 30-second minimum before automatic failover will kick in. This is designed to prevent the software from doing the “wrong thing”. For example, if a node is simply slow to respond, or there is a brief network hiccup, you wouldn’t want it to be failed over and so the cluster will wait to ensure that the node is actually down. There are a few other situations to be taken into consideration and you can read more about these and our design decisions to handle them here.

О> По умолчанию, приложение сконфигурировано с 30-секундным минимум до автоматического исправления проблемы. Это защищает приложение от "неправильного поведения". Например, если узел просто медленно отвечает или в сети небольшой сбой, вы не хотите получить сигнал об ошибке и поэтому кластер будет ждать, чтобы быть уверенным, что узел действительно упал. Существует и несколько других ситуаций, достойных рассмотрения и вы можете прочитать больше о них и о наших проектных решения здесь.

To get even more information, you can view the 25-30 minute videos of each week's webinar by going here. And the authoritative place for all information regarding Couchbase Server 2.0 can be found here. While this series may have come to a conclusion, we are already planning on starting up another one to highlight not only the features of Couchbase Server 2.0, but also Couchbase Mobile, our SDKs/client libraries and more! Some of the topics will include:

Cross-cluster synchronization (aka cross-data center replication)
Backup/Restore with Couchbase Server 2.0
Upgrading from Membase 1.7
And more!

Чтобы получить больше информации, вы можете посмотреть 25-30-минутное видео каждой недели вебинара. Авторитетный источником информации о Couchbase Server 2.0 - здесь. Хотя эта серия вебинаров завершилась, мы уже планируем начать следующую, осветив не только возможности Couchbase Server 2.0, но также Couchbase Mobile, наши SDK, клиентские библиотеки и многое другое! Вот некоторые темы:

Синхронизация кластеров (ака репликация между дата-центрами)
Резервное копирование / восстановление с помощью Couchbase Server 2.0
Обновление Membase 1.7

To make it even better, I'm asking you to help participate! Please comment here (or send me an email directly at perry@couchbase.com) with any topics that think we need to cover more and we’ll do our best to include them in an upcoming webinar.

Чтобы сделать это лучше, я прошу вас помочь своим участием! Пожалуйста, комментируйте здесь (или отправьте email на perry@couchbase.com) с любой темой, которую, думаете, надо раскрыть больше - и мы сделаем всё возможное, чтобы включить их в предстоящий вебинар.