🌀 Создание мешей из примитивов

Примитивы в 3DCoat - это фигуры в 3D, которые могут быть довольно сложными. Например, та же шестерёнка выглядит посложнее сферы или куба. Но все они называются "примитивами", потому что создавать их в 3DCoat - легко!

Начнём со сферы.

Сфера

Скопируй этот скрипт себе на комп и запусти из меню 3DCoat: "Скрипты / Запустить скрипт". Если не знаешь, как создавать скрипты, загляни сюда.

void main() {

    // подготавливаем сцену
    SculptRoom room;
    // очищаем скульпт-комнату и переводим её в сёрфейсный режим
    room.clear().toSurface();

    // строим сферу
    Builder builder;
    Mesh mesh = builder.sphere()
      .radius( 70 )
      // детализация сетки, 0 < d <= 1.0
      .details( 0.1 )
      .build();

    // добавляем сферу на сцену
    room += mesh;
}

Разберём этот код.

SculptRoom  room;

Получаем доступ из нашего скрипта к скульпт-комнате. Дальше используем `room` для формирования сцены.

Builder  builder;

C помощью `builder` будем создаём разные меши.

Mesh mesh = builder.sphere()

Говорим скрипту-строителю, что хотим создать сферу...

.radius( 70 )

с радиусом в 70 пкс...

.details( 0.1 )

и малой плотностью сетки.

.build();

Даём команду 3DCoat построить сферу по заданным параметрам.

Допустимо вместо последней расмотренной нами строки написать

();

Предупреждения

Обрати внимание, что () пишем без лидирующей точки, в отличие от .build().

Круглые скобки построят сферу также, как это делает команда build().

Построим куб.

Куб или кубоид

void main() {

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

    // строим кубоид
    Builder builder;
    Mesh mesh = builder.cuboid()
      .side( Vec3( 100, 80, 60 ) )
      // детализация сетки, 0 < d <= 1.0
      .details( 0.1 )
      .build();

    // размещаем кубоид на сцене
    room += mesh;
}

Здесь и ниже код разбирать не будем: всё необходимое для его понимания уже рассмотрели на примере сферы.

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

Цилиндр

void main() {

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

    // строим цилиндр
    Builder builder;
    Mesh mesh = builder.cylinder()
      .positionTop( Vec3( 80, 0, 0 ) )
      .positionBottom( Vec3( 0, 0, 0 ) )
      .radiusTop( 40 )
      .radiusBottom( 50 )
      // детализация сетки, 0 < d <= 1.0
      .details( 0.1 )
      .build();

    // размещаем цилиндр на сцене
    room += mesh;
}

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

Эллипсоид

void main() {

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

    // строим эллипсоид
    Builder builder;
    Mesh mesh = builder.ellipsoid()
      .radius( Vec3( 80, 60, 40 ) )
      // детализация сетки, 0 < d <= 1.0
      .details( 0.1 )
      .build();

    // размещаем эллипсоид на сцене
    room += mesh;
}

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

Конус

void main() {

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

    // строим конус
    Builder builder;
    Mesh mesh = builder.cone()
      .radius( 50 )
      .height( 120 )
      // детализация сетки, 0 < d <= 1.0
      .details( 0.1 )
      .build();

    // размещаем конус на сцене
    room += mesh;
}

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

Труба

void main() {

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

    // строим трубу
    Builder builder;
    Mesh mesh = builder.tube()
      .startPoint( Vec3( 0, 0, 0 ) )
      .endPoint( Vec3( 30, 50, 70 ) )
      // внешний радиус верхней части трубы
      .topRadius( 30 )
      // внешний радиус нижней части трубы
      // да, труба может быть в виде конуса
      .bottomRadius( 40 )
      // пустота внутри трубы,
      // здесь - 80% от среднего внешнего радиуса трубы
      // толщина трубы будет постоянной:
      //   средний радиус = (верхний радиус + нижний радиус) / 2
      .relativeHoleRadius( 0.8 )
      // детализация сетки, 0 < d <= 1.0
      .details( 0.1 )
      .build();

    // размещаем трубу на сцене
    room += mesh;
}

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

Капсула

void main() {

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

    // строим капсулу
    Builder builder;
    Mesh mesh = builder.capsule()
      .startPosition( Vec3( 0 ) )
      .endPosition( Vec3( 40, 50, 60 ) )
      .startRadius( 30 )
      .endRadius( 50 )
      // детализация сетки, 0 < d <= 1.0
      .details( 0.1 )
      .build();

    // размещаем капсулу на сцене
    room += mesh;
}

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

Энгон

void main() {

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

    // строим энгон
    Builder builder;
    Mesh mesh = builder.ngon()
      .startPoint( Vec3( 0, 0, 0 ) )
      .endPoint( Vec3( 90, 90, 90 ) )
      .topRadius( 30 )
      .bottomRadius( 40 )
      .relativeHoleRadius( 0.3 )
      // количество сторон энгона
      .teeth( 3 )
      // детализация сетки, 0 < d <= 1.0
      .details( 0.1 )
      .build();

    // размещаем энгон на сцене
    room += mesh;
}

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

Шестерёнка

void main() {

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

    // строим шестерёнку
    Builder builder;
    Mesh mesh = builder.gear()
      .startPoint( Vec3( 0, 0, 0 ) )
      .endPoint( Vec3( 90, 90, 90 ) )
      .topRadius( 30 )
      .bottomRadius( 50 )
      .relativeHoleRadius( 0.3 )
      // насколько глубоко зубья приближаются к внутреннему радиусу
      .depth( 0.5 )
      // острота зубьев, 0 - самые колючие
      .sharpness( 0.2 )
      // количество зубьев
      .teeth( 3 )
      // детализация сетки, 0 < d <= 1.0
      .details( 0.1 )
      .build();

    // размещаем шестерёнку на сцене
    room += mesh;
}

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

По ссылкам ниже - больше о возможностях классов:

• Mesh
• SculptRoom
• Builder

Функции для построения примитивов

Можешь также воспользоваться функциями для построения примитивов:

// Reset additional transformation for low-level primitives.
DEPRECATED void ResetPrimTransform();

// Translate all further low-level primitives.
DEPRECATED void PrimTranslate(float dx,float dy,float dz);

// Scale all further low-level primitives using pivot point x,y,z.
DEPRECATED void PrimScaleAt(float x,float y,float z,float scalex,float scaley,float scalez);

// Rotate further primitives at xyz point around X-axis.
DEPRECATED void PrimRotateX(float x,float y,float z,float Angle);

// Rotate further primitives at xyz point around Y-axis.
DEPRECATED void PrimRotateY(float x,float y,float z,float Angle);

// Rotate further primitives at xyz point around Z-axis.
DEPRECATED void PrimRotateZ(float x,float y,float z,float Angle);

// Rotate further primitives around rode (x,y,z)->(xend,yend,zend)
// on given Angle.
DEPRECATED void PrimRotateAroundRode(float x,float y,float z,float xend,float yend,float zend,float Angle);

// Set special transform for further primitives.
// If you will apply primitive that is placed between points
// (0,-1,0) and (0,1,0) it will be actually applied as primitive
// stretched between points (x,y,z) and (xend,yend,zend).
DEPRECATED void PrimStretchBetweenPoints(float x,float y,float z,float xend,float yend,float zend);
// Example:
    void main(){
        ResetPrimTransform();
        // stretch between  (10,20,30) and (40,50,60)
        PrimStretchBetweenPoints(10,20,30,40,50,60);
        // starts from point (0,-1,0), radius=10, height=2
        cylinder(0,-1,0,10,10,2,0);
    }
// This code will create cylinder of radius 10 between
// points (10,20,30) and (40,50,60).

// Set additional density factor for low-level primitives.
// 1 means default density.
DEPRECATED void PrimDensity(float density);

// Store current transform for primitives as string to be kept
// for future usage.
DEPRECATED string GetPrimTransform();

// Restore current primitives transform from string that was
// previously kept using `GetPrimTransform()`.
DEPRECATED void SetPrimTransform(string& in M);
// Example:
SetPrimTransform(
    "1.0 2.0 3.0 1.0\n"
    "4.0 5.0 6.0 1.0\n"
    "7.0 8.0 9.0 1.0\n"
    "1.1 2.2 3.3 1.0" );

// Create sphere with radius `r`.
// `x`, `y`, `z` means a center of figure.
// \param mode 0 - add, 1 - subtract, 2 - intersect with scene.
DEPRECATED void sphere(float x,float y,float z,float r,int mode);

// Create ellipse.
// `x`, `y`, `z` means a center of figure.
// \param mode 0 - add, 1 - subtract, 2 - intersect with scene.
DEPRECATED void ellipse(float x,float y,float z,float rx,float ry,float rz,int mode);

// Create parallelepiped.
// `x`, `y`, `z` means a center of figure.
// \param mode 0 - add, 1 - subtract, 2 - intersect with scene.
DEPRECATED void cube(float x,float y,float z,float sizex,float sizey,float sizez,int mode);

// Create cylinder.
// `x`, `y`, `z` means a center of figure.
// \param mode 0 - add, 1 - subtract, 2 - intersect with scene.
DEPRECATED void cylinder(float x,float y,float z,float topradius,float bottomradius,float height,int mode);

// Create cone.
// `x`, `y`, `z` means a center of figure.
// \param mode 0 - add, 1 - subtract, 2 - intersect with scene.
DEPRECATED void cone(float x,float y,float z,float radius,float height,int mode);

// Create N-gon.
// `x`, `y`, `z` means a center of figure.
// \param mode 0 - add, 1 - subtract, 2 - intersect with scene.
DEPRECATED void ngon(float x,float y,float z,int sides,float topradius,float bottomradius,float height,int mode);

// Create tube.
// `x`, `y`, `z` means a center of figure.
// \param mode 0 - add, 1 - subtract, 2 - intersect with scene.
DEPRECATED void tube(float x,float y,float z,float topradius,float bottomradius,float height,float wallthickness,int mode);

// Create n-gonal tube.
// `x`, `y`, `z` means a center of figure.
// \param mode 0 - add, 1 - subtract, 2 - intersect with scene.
DEPRECATED void ngontube(float x,float y,float z,int sides,float topradius,float bottomradius,float height,float wallthickness,int mode);

// Creates capsule between points.
// Where `xstart`, `ystart`, `zstart` means coords of first half-sphere;
// `xend`, `yend`, `zend` means coords of second half-sphere.
// \param mode 0 - add, 1 - subtract, 2 - intersect with scene.
DEPRECATED void capsule(float xstart,float ystart,float zstart,float xend,float yend,float zend,float startradius,float endradius,int mode);

Посмотри также этот набор функций для полной картины возможностей 3DCoat:

// Returns whole command line.
string getCommandLine();

// Stores some string as global value that may be read later in
// the session. The value will be stored in 3B file and you will
// be able to read in further work with this scene. 
DEPRECATED void SetGlobalVar(string& Name,string& Value)

// Returns value previously stored using SetGlobalVar.
DEPRECATED string GetGlobalVar (string& Name)

// Returns scene filename (last saved or opened as 3B file).
DEPRECATED string GetSceneFileName()

// Sets scene filename for further saving.
DEPRECATED void SetSceneFileName(string& Name) 

// Highlight element with red rectangle.
// Pass the `time` in seconds.
void HighlightUIElement(string &ID, float time);

// Goes to one of previous dialogs in call stack.
DEPRECATED void back(int steps=1);

// Opens window described by xml-file pointed by Path.
// If Path contains .3b file will be opened as 3B file.
DEPRECATED void open(string &Path);

// Opens model for PPP, if path is empty, shows open dialog.
DEPRECATED void ppp(string &path);

// Opens model for MV painting, if path is empty, shows open dialog.
DEPRECATED void mv(string &path);

// Opens model for Ptex, if path is empty, shows open dialog.
DEPRECATED void ptex(string &path);

// Import image as mesh, dialog will be shown.
DEPRECATED void imagemesh();

// Import mesh as reference, if path is empty dialog will be shown.
DEPRECATED void refmesh(string &path);

// Import mesh for vertex painting, if path is empty dialog will be shown.
DEPRECATED void vertexpaint(string &path);

// Perform autopo over the mesh chosen in dialog.
DEPRECATED void autopo(string &path);

// Opens mesh for repairing. If id contains "vox" then model will be
// voxelized, if there is substring "shell" then mesh will be imported
// as thin shell. Mesh Opening dialog will be shown.
DEPRECATED void repair(string &id);

// Activate bas-relief tool.
DEPRECATED void bass();

// Activale remove undercuts mode.
DEPRECATED void undercut();

// Activate special voxel tool. id may be found in English.xml between
// ... if you will find name of tool between
// ... tags.
DEPRECATED void activate(string &id);

// Activate retopo tool.
DEPRECATED void retopo();

// Open mesh using dialog and merge as retopo mesh.
DEPRECATED void retopopen();

// Activate any room - name is one of "Paint", "Tweak", "UV",
// "Voxels", "Retopo", "Render".
DEPRECATED void ToRoom(string &name);

// Check if you are in specified room - name is one of "Paint",
// "Tweak", "UV", "Voxels", "Retopo", "Render".
DEPRECATED bool IsInRoom(string &name);

// Add new volume in voxel room. If name is empty name will be
// assigned automatically.
DEPRECATED void AddNewVolume(string &name);

// Activate UV room.
DEPRECATED void uv();

// Activate voxel room and add new volume.
DEPRECATED void vox();

// Create sphere of radius R in voxel room in current object.
// \param mode 0 - add, 1 - subtract, 2 - intersect with scene.
DEPRECATED void sphere(float x,float y,float z,float r,int mode);

// Create cube in voxel room in current object.
// \param mode 0 - add, 1 - subtract, 2 - intersect with scene.
// \param sizex Size by X-axis.
// \param sizey Size by Y-axis.
// \param sizez Size by Z-axis.
DEPRECATED void cube(float x,float y,float z,float sizex,float sizey,float sizez,int mode);

// Turn all volumes to surface mode.
DEPRECATED void surf();

// Turn current volume to the surface mode.
DEPRECATED void cursurf();

// Turn current volume to voxel mode, voxelize if need.
DEPRECATED void voxelize();

// Sets merging options in voxel room. opt is just set of substrings
// with different options. Possible values are:
// [voxelize=true]
// [voxelize=false]
// [separate=true]
// [separate=false]
// [respectneg=true]
// [respectneg=false]
// [as_skin=true]
// [as_skin=false]
// [skin=....] - to set skin thickness.
DEPRECATED void mergeopt(string &opt);
// Example:
mergeopt( "[voxelize=true][as_skin=true][skin=4.5]" );

// Merge model in voxel room. Empty string means that dialog will be shown.
DEPRECATED void merge(string &model);

// Activate voxel primitives tool. Possible primitives:
// cube, cylinder, sphere, tube, cone, ellipse, n-gon, gear.
DEPRECATED void prim(string &id);

// Apply in current tool (same as press enter).
DEPRECATED void apply();

// Apply in Merge tool without asking "Keep scale?".
// Scale will not be kept and scene scale will not be changed.
DEPRECATED void ApplyAndKeepScale();

// Apply in current tool (same as press enter) wint one difference -
// in Merge tool scale of merged object sill be automatically kept and
// scene scale changed if this merge is first.
DEPRECATED void mapply();

// Open recent 3B-file.
DEPRECATED void recent3b();

// Print text to MyDocuments/3D-CoatV4/log.txt.
DEPRECATED void Log(string &line);

// Generate integer random number min..max.
int rand(int min,int max);

// Generate floating random number min..max.
float randF(float min,float max);

// Set random generator seed.
void seed(int val);

// Show progress bar pos = 0..100.
DEPRECATED void ProgressBar(const string& message,int pos);

// Set orthogonal (true) or perspective (false) view mode.
DEPRECATED void SetOrthoMode(bool value);

См. также

🌀 Математика для 3D-графики

🌀 Преобразование мешей

🌀 Булевы операции над мешами