3DCoat Core API
The 3DCoat API documentation.
Loading...
Searching...
No Matches
CoreAPI.h
1#pragma once
2#include <stdafx.h>
3#ifdef PYBIND11_DEF
4#include <Python.h>
5#include <pybind11/pybind11.h>
6#include <pybind11/numpy.h>
7#endif
8
9
21class ItemsTree;
22class ItemsFolder;
23class ClusteredMesh;
24
25#ifndef PY_PARSER
26#ifdef PYBIND11_DEF
27
28#define PY_BYTE_ARRAY pybind11::array_t<unsigned char, pybind11::array::c_style>
29#define PY_WORD_ARRAY pybind11::array_t<WORD, pybind11::array::c_style>
30#define PY_DWORD_ARRAY pybind11::array_t<dword, pybind11::array::c_style>
31#define PY_INT_ARRAY pybind11::array_t<int, pybind11::array::c_style>
32#define PY_FLOAT_ARRAY pybind11::array_t<float, pybind11::array::c_style>
33#define PY_DOUBLE_ARRAY pybind11::array_t<double, pybind11::array::c_style>
34
35#endif
36#endif
37
38#pragma pack(push, 1)
43namespace coat {
44 class Model;
45 class Volume;
47 typedef comms::cVec4 vec4;
48
50 typedef comms::cVec3 vec3;
51
53 typedef comms::cVec3i vec3i;
54
56 typedef comms::cVec2 vec2;
57
59 typedef comms::cMat4 mat4;
60
62 typedef comms::cMat3 mat3;
63
64 typedef comms::cMath math;
65
67 typedef comms::cStr str;
68
70 template <class X> using list = comms::cList<X>;
71
73 typedef comms::cRect rect;
74
75 typedef comms::cQuat quat;
76
77 typedef comms::cRotation rotation;
78
79 typedef comms::cAngles angles;
80
81 // axis-aligned bound box
82 typedef comms::cBounds boundbox;
83
97 class prim;
98
99
104 void start_main_menu(const char* id);
105
111 void menu_item(const char* id);
112
117 void menu_info(const char* id);
118
124 bool menu_submenu(const char* id);
125
129 void menu_exit();
130
135
143 void menu_hotkey(const char* id, int Shift, int Ctrl, int Alt);
144
151 bool iconic_submenu(const char* id, int size);
152
158
164
170
175 bool is_ppp();
176
181 bool is_proxy();
182
188
194
200 bool IsInRoom(const char* name);
201
207 bool RoomExists(const char* name);
208
214 bool CheckIfExists(const char* path);
215
216
222
223
228 bool is_mv();
229
234 bool is_ptex();
235
240
246 void show_space_panel(const char* Subset, int NumColumns);
247
253
259
264 void menu_insert_extensions(const char* id);
265
270
275
281
286 void SetAutoSnapDefaults(bool value);
287
293 bool menu_property(const char* id);
294
299 void tools_section(const char* id);
300
305 void tools_item(const char* id);
306
311 void page_suffix(const char* suffix);
312
317 void default_tool(const char* tool);
318
323 bool IsDebug();
324
329
333 void menu_sort();
334
340
346 bool IsInTool(const char* ToolID);
347
353
359
365
371
377 int GetCurrentToolSubmode(const char* id);
378
383 void tools_comment(const char* id);
384
389 bool doc_mode();
390
395
401
402
408
412 class APICALL Mesh {
413 protected:
414 friend class Model;
415 static std::vector<std::pair<comms::cMeshContainer*, int>> allocated_meshes;
416 comms::cMeshContainer* allocate();
417 void inc_ref(comms::cMeshContainer* m);
418 void dec_ref(comms::cMeshContainer* m);
419
420 comms::cMeshContainer* MeshData;
421 list<int> raw_start;
422 int raw_count;
423 void validate_raws();
424 public:
425 Mesh();
426 ~Mesh();
427
428 Mesh(const Mesh& m);
429 Mesh(const Model& m);
430 Mesh& operator = (const Mesh& m);
431 Mesh& operator = (const Model& m);
432 Mesh MakeCopy();
433
439 bool Read(const char* name);
440
446 bool Write(const char* name);
447
452 bool valid() const;
453
458 comms::cMeshContainer* geometry();
459
460 comms::cMeshContainer* geometry() const;
461
465 void clear();
466
471 Mesh& operator +=(const Mesh& m);
472
477 Mesh& operator +=(const Model& m);
478
484 void addTransformed(const Mesh& m, const mat4& t);
485
490 void boolean(const Mesh& m, BoolOpType op);
491
496 void transform(const mat4& transform);
497
503 void rotateToXYAxis(const vec3& axisX, const vec3& axisY);
504
510 void rotateToYZAxis(const vec3& axisY, const vec3& axisZ);
511
517 void rotateToZXAxis(const vec3& axisZ, const vec3& axisX);
518
523 int vertsCount() const;
524
529 int vertsUvCount() const;
530
535 int vertsNormalCount() const;
536
542
548 vec3 getVertex(int idx) const;
549
555 void setVertex(int idx, const vec3& v);
556
562 int createNewVertex(const vec3& position);
563
569 vec2 getVertexUV(int idx) const;
570
576 void setVertexUV(int idx, const vec2& v);
577
584
590 vec3 getVertexNormal(int idx) const ;
591
597 void setVertexNormal(int idx, const vec3& v);
598
603
608
614 int getFaceVertsCount(int face);
615
621 int getFaceUvVertsCount(int face);
622
629 int getFaceVertex(int faceIndex, int faceVertexIndex);
630
636 std::vector<int> getFaceVerts(int face);
637 void getFaceVerts(int face, list<int>& vertices);
638
644 void setFaceVerts(int face, const std::vector<int>& vertices);
645 void setFaceVerts(int face, const list<int>& vertices);
646
653 int getFaceUvVertex(int faceIndex, int faceVertexIndex);
654
661 void setFaceUvVertex(int faceIndex, int faceVertexIndex, int uvVertexIndex);
662
669 int getFaceNormalVertex(int faceIndex, int faceVertexIndex);
670
677 void setFaceNormalVertex(int faceIndex, int faceVertexIndex, int normalVertexIndex);
678
684 std::vector<int> getFaceUvVerts(int face);
685 void getFaceUvVerts(int face, list<int>& vertices);
686
692 int getFaceObject(int faceIndex);
693
699 void setFaceObject(int faceIndex, int objectIndex);
700
706 int getFaceMaterial(int faceIndex);
707
713 void setFaceMaterial(int faceIndex, int materialIndex);
714
720
726 std::string getObjectName(int idx);
727
733 void setObjectName(int idx, const std::string& name);
734
740 int addObject(const char* name);
741
746 void removeObject(int idx);
747
752 void unifyAllObjects(const std::string& name = "");
753
759
765 int addMaterial(const char* name);
766
771 void removeMaterial(int idx);
772
778 std::string getMaterialName(int idx);
779
785 void setMaterialName(int idx, const std::string& name);
786
793 std::string getMaterialTexture(int idx, int texture_layer);
794
801 void setMaterialTexture(int idx, int texture_layer, const std::string& texture_path);
802
809 void fromVolume(Volume& v, bool with_subtree = false, bool all_selected = false);
810
818 void fromReducedVolume(Volume& v, float reduction_percent, bool with_subtree = false, bool all_selected = false);
819
827 void fromVolumeWithMaxPolycount(Volume& v, int max_polycount, bool with_subtree = false, bool all_selected = false);
828
835 void toVolume(Volume& v, const mat4& transform = mat4::Identity, BoolOpType op = BOOL_MERGE);
836
842 void insertInVolume(Volume& v, const mat4& transform = mat4::Identity);
843
849 void addToVolume(Volume& v, const mat4& transform = mat4::Identity);
850
856 void subtractFromVolume(Volume& v, const mat4& transform = mat4::Identity);
857
863 void intersectWithVolume(Volume& v, const mat4& transform = mat4::Identity);
864
869
874
879 void reduceToPolycount(int destination_triangles_count);
880
885
891 void booleanOp(Mesh& With, BoolOpType op);
892
897 std::vector<vec3> getMeshVertices();
898
903 std::vector<vec3> getMeshNormals();
904
909 std::vector<vec2> getMeshUVs();
910
915 void setMeshVertices(const std::vector<vec3>& positions);
916
921 void setMeshNormals(const std::vector<vec3>& normals);
922
927 void setMeshUVs(const std::vector<vec2>& uvs);
928
936 void setMeshFaces(const std::vector<int>& faces);
937
942 void addMeshVertices(const std::vector<vec3>& positions);
943
948 void addMeshNormals(const std::vector<vec3>& normals);
949
954 void addMeshUVs(const std::vector<vec2>& uvs);
955
963 void addMeshFaces(const std::vector<int>& faces);
964
969
974
979
984
989 void removeFaces(const std::vector<int>& faces);
990
995
1000
1005
1011 int addObject(const std::string& name);
1012
1018 int addMaterial(const std::string& name);
1019
1024
1029
1034
1040 void cutByPlane(const vec3& start, const vec3& NormalDirection);
1041
1050 void cutByDistortedPlane(const vec3& start, const vec3& NormalDirection, float noise_degree, float noise_scale, int seed = 0);
1051
1059 void distortByPerlinNoise(float noise_degree, float noise_scale, bool anisotropic = false, int seed = 0);
1060
1065 std::vector<Mesh> splitDisconnectedParts();
1066
1073 void symmetry(const vec3& start, const vec3& NormalDirection, bool resultInQuads);
1074
1079 std::vector<comms::cPlane> autodetectSymmetryPlanes();
1080
1085 void weld(float minimal_relative_distance = 0.0001f);
1086
1091 boundbox getBounds() const;
1092
1097 float getVolume() const;
1098
1105 float getOpenSurfaceVolume(const vec3& start, const vec3& dir) const;
1106
1111 float getSquare() const;
1112
1118 float getFaceSquare(int face);
1119
1125 float getFaceUVSquare(int face);
1126
1133
1140 void relax(float degree, bool tangent, float crease_angle = 180);
1141
1156 static Mesh box(const vec3& center = vec3::Zero, const vec3& size = vec3::One, const vec3& xAxis =vec3::Zero, const vec3& yAxis = vec3::Zero, const vec3& zAxis = vec3::Zero, float detail_size = 1, float fillet = 0.0f, int nx=0, int ny=0, int nz=0);
1157
1165 static Mesh sphere(const vec3& center = vec3::Zero, float radius = 1.0f, float detail_size = 1);
1166
1179 static Mesh cylinder(const vec3& center = vec3::Zero, float radius = 1, float height = 2, float detail_size = 1, int slices = 0, int caps = 0, int rings = 0, float fillet = 0);
1180
1190 static Mesh cone(const vec3& center = vec3::Zero, float radius = 1, float height = 2, float detail_size = 1, const vec3& topAxis = vec3::AxisY);
1191
1203 static Mesh plane(const vec3& center = vec3::Zero, float sizeX = 2, float sizeY = 2, int divisionsX = 2, int divisionsY = 2, const vec3& xAxis = vec3::AxisX, const vec3& yAxis = vec3::AxisY);
1204
1216 static Mesh hexagonal_plane(const vec3& center = vec3::Zero, float sizeX = 2, float sizeY = 2, int divisionsX = 2, int divisionsY = 2, const vec3& xAxis = vec3::AxisX, const vec3& yAxis = vec3::AxisY);
1217
1230 static Mesh text(const char* string, const char* font = "tahoma", float height = 10.0f, const vec3 & center = vec3::Zero, const vec3& text_direction = vec3::AxisX, const vec3& text_normal = vec3::AxisY, float thickness = 1, int align = 1);
1231
1242 void createVDM(int side, const char* path_to_exr, const vec3& center = vec3::Zero, float radius = 1, const vec3& up = vec3::AxisZ, const vec3& x = vec3::AxisX, const vec3& y = vec3::AxisY);
1243
1250 void shell(float thickness_out, float thickness_in, int divisions = 1);
1251
1258 std::vector<int> extrudeOpenEdges(float distance, vec3 direction = vec3::Zero);
1259
1265 std::vector<int> expandOpenEdges(float distance);
1266
1271 std::vector<int> getOpenEdges();
1272
1278 float getLengthAlongDirection(const vec3& dir) const;
1279
1285
1286
1287 protected:
1288 void setMesh(const comms::cMeshContainer& mesh) {
1289 if (MeshData) {
1290 MeshData->Clear();
1291 MeshData->Copy(mesh);
1292 }
1293 else {
1294 MeshData = new comms::cMeshContainer(mesh);
1295 inc_ref(MeshData);
1296 }
1297 }
1298 friend class prim;
1299 };
1300
1304 class APICALL Image : public comms::cImage {
1305 public:
1306 Image();
1307 Image(const Image& im);
1313 bool Read(const char* name);
1314
1320 bool Write(const char* name);
1321
1327 bool FromTexture(int texture_id);
1328
1334#ifdef PYBIND11_DEF
1347 int Paste(PY_BYTE_ARRAY src_data, int pasteLeft = 0, int pasteTop = 0, int cropLeft = 0, int cropTop = 0, int cropRight = 0, int cropBottom = 0, bool flipY = false);
1348
1353 size_t Pointer();
1354
1360 bool FromArray(PY_BYTE_ARRAY src_data);
1361 bool FromArray(PY_DWORD_ARRAY src_data);
1362 bool FromArray(PY_FLOAT_ARRAY src_data);
1363
1364 pybind11::buffer_info _py_buffer_info();
1365#endif
1366 };
1367
1368 class Volume;
1369
1370 class APICALL symm {
1371 public:
1377 static symm& enable(bool _enable = true);
1378
1379 static bool enabled();
1380
1385 static symm& disable();
1386
1394 static symm& xyz(bool x, bool y, bool z);
1395
1400 static bool is_xyz();
1401
1406 static bool& x();
1407
1412 static bool& y();
1413
1418 static bool& z();
1419
1427 static symm& axial(int n, bool extraMirror = false, bool stepSymmetry = false);
1428
1433 static bool is_axial();
1434
1439 static int& axialOrder();
1440
1445 static bool& extraMirror();
1446
1451 static bool& stepSymmetry();
1459 static symm& axialMirror(int n, bool extraMirror = false, bool stepSymmetry = false);
1460
1465 static bool isAxialMirror();
1466
1477 static symm& translation(int numX, float stepX, int numY, float stepY, int numZ, float stepZ);
1478
1483 static bool is_translation();
1484
1489 static int& numX();
1490
1495 static float& stepX();
1496
1501 static int& numY();
1502
1507 static float& stepY();
1508
1513 static int& numZ();
1514
1519 static float& stepZ();
1520
1526
1532
1537 static symm& toGeneral();
1538
1544 static symm& set_start(const vec3& pos);
1545
1550 static vec3& start();
1551
1557 static symm& set_end(const vec3& pos);
1558
1563 static vec3& end();
1564
1570 static symm& showSymmetryPlane(bool show = true);
1571
1577 static symm& setCustomSymetryTransforms(list<mat4>& symmetryTransforms);
1578#ifdef PYBIND11_DEF
1584 static symm& setCustomSymetryTransforms(pybind11::list& symmetryTransforms);
1585#endif
1586
1591 static bool isCustomSymmetry();
1592
1597 static symm& getCurrentTransforms(list<mat4>& symmetryTransforms);
1598
1603 static std::vector<mat4> getCurrentTransforms();
1604
1610
1615 static std::vector<comms::cPlane> getCurrentPlanes();
1616
1620 static void disableGlobally();
1621
1625 static void enableGlobally();
1626
1627
1628 };
1632 class APICALL SceneElement {
1633 protected:
1634 ItemsTree* el;
1635 VoxTreeBranch* tb() const;
1636 OneCurveObject* cu() const;
1637 friend class Scene;
1638 friend class Curve;
1639 friend class Volume;
1640 public:
1641 SceneElement();
1642 SceneElement(VolumeObject* vo);
1643 SceneElement(ItemsTree* c);
1644 SceneElement(const SceneElement& other);
1645
1646 ~SceneElement();
1647
1648 const bool operator==(const SceneElement& other) const;
1649 const bool operator!=(const SceneElement& other) const;
1650
1656
1661 int childCount() const;
1662
1668 SceneElement child(int index) const ;
1669
1674 bool isSculptObject() const;
1675
1680 bool isCurve() const;
1681
1687 const SceneElement& setTransform(const mat4& Transform) const ;
1688
1694 const SceneElement& transform(const mat4& Transform) const ;
1695
1700 const SceneElement& density(float density_value) const;
1701
1707 const SceneElement& transform_single(const mat4& Transform) const;
1708
1714
1719 const SceneElement& clear() const ;
1720
1725 const char* name() const;
1726
1731 const char* getLinkedPath(int id) const;
1732
1738
1743 void addLinkedPath(const char* path) const;
1744
1750 const SceneElement& rename(const char* name) const;
1751
1757 SceneElement addChild(const char* name) const;
1758
1764 SceneElement findInSubtree(const char* name) const;
1765
1771 bool iterateSubtree(const std::function<bool(SceneElement)>& fn) const;
1772#ifdef PYBIND11_DEF
1785 bool iterateSubtree(const pybind11::object& fn) const;
1786#endif
1787
1793 bool iterateVisibleSubtree(const std::function<bool(SceneElement)>& fn) const;
1794#ifdef PYBIND11_DEF
1807 bool iterateVisibleSubtree(const pybind11::object& fn) const;
1808#endif
1809
1815 void mergeSubtree(bool booleanMerge = false) const;
1816
1822 void mergeTo(const SceneElement& dest, BoolOpType op);
1823
1830
1834 void removeSubtree() const;
1835
1840 void removeSubtreeItem(int index) const;
1841
1845 void remove() const;
1846
1852
1858
1863 void changeParent(SceneElement newParent) const;
1864
1870 bool isParentOf(SceneElement child) const;
1871
1876 bool& visible() const;
1877
1882 void setVisibility(bool visible) const;
1883
1888 bool ghost() const;
1889
1894 void setGhost(bool ghost) const;
1895
1901
1906 void setReferenceColor(const vec4& color);
1907
1910
1912 void select() const;
1913
1915 void selectOne() const;
1916
1918 void unselectAll() const;
1919
1921 bool selected();
1922
1925
1927 std::vector<SceneElement> collectSelected();
1928 };
1929
1931 public:
1932 VolumeCache();
1933 tri_DWORD CellID;
1934 VolumeCell* pCell;
1935 };
1936
1940 class APICALL Volume {
1941 protected:
1942 VoxTreeBranch* tb;
1943 VolumeObject* Obj;
1944 friend class SceneElement;
1945 public:
1946 Volume();
1947 Volume(VoxTreeBranch* tb);
1948 Volume(VolumeObject* vo);
1949 Volume(const Volume& vol);
1954 bool valid() const;
1955
1960 bool isSurface() const;
1961
1966 bool isVoxelized() const;
1967
1972
1976 void toVoxels();
1977
1982 static void enableVoxelsColoring(bool enable = true);
1983
1987 static void color(DWORD CL);
1988
1996 static void color(float r, float g, float b, float a);
1997
2004 static void color(float r, float g, float b);
2005
2011 static void color(const char* colorid);
2012
2017 static void gloss(float value);
2018
2023 static void roughness(float value);
2024
2029 static void metal(float value);
2030
2037 void mergeMesh(Mesh& mesh, const mat4& transform = mat4::Identity, BoolOpType op = BOOL_MERGE);
2038
2044 void insertMesh(Mesh& mesh, const mat4& transform = mat4::Identity);
2045
2051 void addMesh(Mesh& mesh, const mat4& transform = mat4::Identity);
2052
2058 void subtractMesh(Mesh& mesh, const mat4& transform = mat4::Identity);
2059
2065 void intersectWithMesh(Mesh& mesh, const mat4& transform = mat4::Identity);
2066
2073 void mergeMeshWithTexture(Mesh& mesh, const mat4& transform = mat4::Identity, BoolOpType op = BOOL_MERGE);
2074
2086 Volume& makeVoxelFigure(std::function<float(vec3)> densityFunction, const list<vec3>& growCenters, bool Subtract = false, bool useTempLocation = false, bool overHidden = false, bool useColor = false);
2087
2097 float getExactDencity(int x, int y, int z, bool fromBackup, VolumeCache& cache_ref);
2098
2105 float getInterpolatedValue(const vec3& pos, bool fromBackup);
2106
2112 void scanCells(const std::function<void(VolumeCell* vc)>& fn, bool multithreaded = false);
2113
2119 void scanCells(const std::function<void(VolumeCellAttrib* vc)>& fn, bool multithreaded = false);
2120
2126 void scanCells(const std::function<void(VolumeCellAttrib* vc, const tri_DWORD& T)>& fn, bool multithreaded = false);
2127
2133 void scanCells(const std::function<void(VolumeCell* vc, const tri_DWORD& T)>& fn, bool multithreaded = false);
2134
2140 void scanTriangles(const std::function<void(const MCVertex& v1, const MCVertex& v2, const MCVertex& v3)>& fn, bool multithreaded = false);
2141
2147 void scanTriangles(const std::function<void(const Vector3D& v1, const Vector3D& v2, const Vector3D& v3)>& fn, bool multithreaded = false);
2148
2154
2159 float getVolume();
2160
2165 float getSquare();
2166
2172
2178
2183 VoxTreeBranch* tree();
2184
2189 VolumeObject* vo();
2190
2200 VolumeCell* cell(int cx, int cy, int cz, bool create, bool backup);
2201
2211 VolumeCellAttrib* attributes(int cx, int cy, int cz, bool create, bool backup);
2212
2219 void dirty(int cx, int cy, int cz);
2220
2225 void setOpacity(float Opacity);
2226
2233 void relaxGpu(const vec3& center, float Radius, float degree);
2234
2239 void relaxVoxels(int count);
2240
2247 void relaxSurface(float degree, bool tangent = false, bool keep_sharp_boolean_edges = false);
2248
2253 void relaxOpenEdges(int nTimes);
2254
2260
2264 void clear();
2265
2270
2275 void assignShader(const char* shaderName);
2276
2277 void setBoolShaderProperty(const char* property, bool value);
2278 void setFloatShaderProperty(const char* property, float value);
2279 void setColorShaderProperty(const char* property, DWORD value);
2280
2286 void removeFacesByWeight(std::function<float(const vec3&)> weight);
2287
2292 void closeHoles(int maxSize);
2293
2299
2308 static void setMoldingParams(const vec3& direction, float tapering_angle = 0, float undercuts_density = 1.0f, float decimation_limit_millions = 10, bool perform_subtraction = true);
2309
2314
2319 void basRelief(const vec3& start_point = vec3::Zero);
2320
2325
2332 static void setMoldingBox(float width, float length, float thickness);
2333
2338 static void setMoldingBorder(float width = 0);
2339
2344
2349
2354
2359
2365
2371
2377
2383
2388
2393 void assignLiveBooleans(int operation);
2394
2399 };
2400
2401 inline coat::VolumeCache::VolumeCache() {
2402 pCell = nullptr;
2403 CellID.V1 = CellID.V2 = CellID.V3 = 100000;
2404 }
2405
2406 class APICALL settings {
2407 public:
2413 static bool valueExists(const char* ID);
2414
2420 static bool getBool(const char* ID);
2421
2427 static std::string getString(const char* ID);
2428
2434 static float getFloat(const char* ID);
2435
2441 static int getInt(const char* ID);
2442
2449 static bool setBool(const char* ID, bool value);
2450
2457 static bool setString(const char* ID, const char* value);
2458
2465 static bool setFloat(const char* ID, float value);
2466
2473 static bool setInt(const char* ID, int value);
2474
2478 static void saveSettings();
2479
2490 static void resetSettings(bool ResetGeneralSettings = true, bool ResetHiddenSet = true, bool ResetHotkeys = true, bool RestNavigation = true, bool ResetPresets = true, bool ResetTheme = true, bool ResetWindows = true);
2491
2496 static std::vector<std::string> listAllSettings();
2497
2502 static void pressButton(const char* button_name);
2503 };
2504
2508 class APICALL Scene {
2509 public:
2514 static void clearScene(bool askUser = false);
2520
2526
2532
2539 static int getLayer(const char* name, bool addIfNotExists = true);
2540
2546 static const char* getLayerName(int LayerID);
2547
2553 static void setLayerName(int LayerID, const char* name);
2554
2560 static int getLayerBlending(int LayerID);
2561
2567 static void setLayerBlending(int LayerID, int mode);
2568
2573 static int getCurrentLayer();
2574
2579 static void setCurrentLayer(int LayerID);
2580
2584 static void mergeVisibleLayers();
2585
2590 static void mergeLayerDown(int LayerID);
2591
2596 static void applyLayerBlending(int LayerID);
2597
2602 static void invalidateLayer(int LayerID);
2603
2608 static void setActiveLayer(int LayerID);
2609
2614 static void removeLayer(int LayerID);
2615
2621 static bool layerIsEmpty(int layerID);
2622
2626 static void removeEmptyLayers();
2627
2631 static bool layerVisible(int LayerID);
2632
2637 static void setLayerVisibility(int LayerID, bool Visible);
2638
2644 static void setLayerColorOpacity(int LayerID, float Opacity);
2645
2651 static void setLayerDepthOpacity(int LayerID, float Opacity);
2652
2658 static void setLayerMetalnessOpacity(int LayerID, float Opacity);
2659
2665 static void setLayerGlossOpacity(int LayerID, float Opacity);
2666
2672 static int assignLayerMask(int LayerID);
2673
2678 static void removeLayerMask(int LayerID);
2679
2684 static void extractMaskAsLayer(int LayerID);
2685
2691 static void setMaskForTheLayer(int LayerID, int MaskLayerID);
2692
2698 static void enableLayerMask(int LayerID, bool enable);
2699
2705 static bool isLayerMaskEnabled(int LayerID);
2706
2711 static void invertLayerMask(int LayerID);
2712
2718 static int getLayerMaskLayer(int LayerID);
2719
2724 static void disableLayerMask(int LayerID);
2725
2730 static void enableLayerMask(int LayerID);
2731
2737 static bool maskEnabled(int LayerID);
2738
2743 static void setClippingLayer(int LayerID);
2744
2749 static void disableClippingLayer(int LayerID);
2750
2751
2756 static int PaintObjectsCount();
2757
2763
2768 static int PaintUVSetsCount();
2769
2774 static void RemovePaintObject(int idx);
2775
2780 static void RemovePaintMaterial(int idx);
2781
2786 static void RemoveUVSet(int idx);
2787
2793 static const char* PaintObjectName(int idx);
2794
2800 static const char* PaintMaterialName(int idx);
2801
2807 static const char* PaintUVSetName(int idx);
2808
2814 static SceneElement importMesh(const char* filename, const mat4& transform = mat4::Identity);
2815
2820 static void ScaleSceneVisually(float scale);
2821
2826 static void ScaleSceneUnits(float scale);
2827
2832 static float GetSceneScale();
2833
2838 static const char* GetSceneUnits();
2839
2845 static bool setSceneUnits(const char* units);
2846
2852
2857 static void setSceneShift(const vec3& shift);
2858
2863 static std::vector<std::string> getAvailableUnits();
2864
2870 static bool convertSceneUnits(const char* destination_unit_name);
2871 };
2872
2873 class APICALL RenderRoom {
2874 public:
2878 static void toRenderRoom();
2879
2883 static void restartRendering();
2884
2890 static void setCustomRenderSize(int width, int height);
2891
2896 static void setRenderResult(const char* filename);
2897
2901 static void renderFrame();
2902
2907 static void enableRealtimeRendering(bool enable);
2908
2914
2919 static void setExposure(float exposure);
2920
2925 static float getExposure();
2926
2931 static void setEnvironmentLight(float envlight);
2932
2937 static float getEnvironmentLight();
2938
2943 static void setDOFDegree(float degree);
2944
2949 static float getDOFDegree();
2950
2955 static int getLightsCount();
2956
2961 static int addLight();
2962
2967 static void removeLight(int idx);
2968
2972 static void removeAllLights();
2973
2979 static void setLightDirection(int idx, const vec3& dir);
2980
2986 static vec3 getLightDirection(int idx);
2987
2993 static void setLightScattering(int idx, float scattering);
2994
3000 static float getLightScattering(int idx);
3001
3007 static void setLightColor(int idx, const vec3& color = vec3::One);
3008
3014 static vec3 getLightColor(int idx);
3015
3021 static void setLightIntensity(int idx, float intensity);
3022
3028 static float getLightIntensity(int idx);
3029
3034 static void setRaysPerFrame(int count);
3035
3040 static int getRaysPerFrame();
3041
3046 static void setAA(bool AA);
3047
3052 static bool getAA();
3053
3054 };
3055
3056 class APICALL Curve:public SceneElement {
3057 OneCurveObject* cu;
3058 bool allocated;
3059 friend class SceneElement;
3060 void validate();
3061 public:
3066 ~Curve();
3067
3072 Curve(OneCurveObject* ob);
3073
3079 Curve& operator = (SceneElement& el);
3080
3086
3092 OneSelPoint* point(int idx);
3093
3099 void removePoints(int index, int count);
3100
3105 OneCurveObject* curve();
3106
3112
3118 OneSelPoint* renderPoint(int idx);
3119
3125
3130 bool& closed();
3131
3138 void add(const Vector3D& p, const Vector3D& normal, float Radius);
3139
3146 void addSharp(const Vector3D& p, const Vector3D& normal, float Radius);
3147
3154 void addSmooth(const Vector3D& p, const Vector3D& normal, float Radius);
3155
3164 void addBothTangents(const Vector3D& p, const Vector3D& normal, const Vector3D& inTangent, const Vector3D& outTangent, float Radius);
3165
3173 void addWithTangent(const Vector3D& p, const Vector3D& normal, const Vector3D& inOutTangent, float Radius);
3174
3180 void tubeToMesh(Mesh& mesh, bool hemisphere);
3181
3187 std::tuple<vec3, vec3, vec3, vec3, float> getPoint(int idx);
3188
3194 void setPointPosition(int idx, const vec3& p);
3195
3201 void setPointNormal(int idx, const vec3& n);
3202
3209 void setPointTangents(int idx, const vec3& t1, const vec3& t2);
3210
3216 void setPointRadius(int idx, float r);
3217
3221 bool isOpen();
3222
3226 void setOpen();
3227
3232
3237
3242 void selectPoint(int idx);
3243
3252 void fill(Mesh& mesh, float thickness, float relax_count = 0, float details_level = 1, float extrusion = 0);
3253 };
3254
3259 class APICALL SphericalCollision {
3260 list<vec4> spheres;
3261 uni_hash<int, tri_int> cells;
3262 float unit;
3263 public:
3265
3270 SphericalCollision(float cellsize);
3271
3273
3278 void setUnit(float u);
3279
3283 void clear();
3284
3291 int addSphere(const vec3& p, float radius);
3292
3299 vec3 collides(const vec3& p, float radius);
3300
3306 vec4 sphere(int idx);
3307 };
3308
3312 class APICALL ui {
3313 public:
3324 static bool cmd(const char* id, std::function<void()> process_in_modal_dialog = 0);
3325#ifdef PYBIND11_DEF
3340 static bool cmd(const char* id, pybind11::object fn = pybind11::none());
3341#endif
3348 static bool wait(const char* id, float max_seconds);
3349
3355 static bool presentInUI(const char* id);
3356
3362 static void highlight(const char* id, float milliseconds);
3363
3369 static void enablePenChannel(int i, bool enabled);
3370
3376 static bool isEnabledPenChannel(int i);
3377
3384 static bool setSliderValue(const char* id, float value);
3385
3391 static float getSliderValue(const char* id);
3392
3399 static bool setEditBoxValue(const char* id, const char* value);
3400
3407 static bool setEditBoxValue(const char* id, int value);
3408
3415 static bool setEditBoxValue(const char* id, float value);
3416
3423 static bool getEditBoxValue(const char* id, str& result);
3424 static const char* getEditBoxValue(const char* id);
3425
3429 static void apply();
3430
3438 static void setFileForFileDialog(const char* filename);
3439
3445 static bool getBoolField(const char* id);
3446
3453 static bool setBoolValue(const char* id, bool value);
3454
3459 static const char* currentRoom();
3460
3466 static bool isInRoom(const char* name);
3467
3473 static void toRoom(const char* name, bool Force = false);
3474
3479 static int roomsCount();
3480
3486 static const char* roomName(int index);
3487
3493 static const char* roomID(int index);
3494
3499 static void toolParam(BaseClass* B);
3500
3505 static void removeToolParam(BaseClass* B = nullptr);
3506
3512 static const char* getOption(const char* id);
3513
3520 static bool setOption(const char* id, const char* value);
3521 static bool setOption(const char* id, bool value);
3522 static bool setOption(const char* id, float value);
3523
3528 static void hideDontShowAgainMessage(const char* id);
3529
3535 static void showInfoMessage(const char* infoID, int milliseconds);
3536
3545 static void insertInMenu(const char* Menu, const char* ID_in_menu, const char* script_path);
3546
3559 static void insertInToolset(const char* roomID, const char* section, const char* toolID, const char* script_path = "");
3560
3565 static void removeCommandFromMenu(const char* ID_in_menu);
3566
3572 static bool checkIfMenuItemInserted(const char* ID_in_menu);
3573
3574#ifdef PYBIND11_DEF
3583 static void addExtension(const char* roomID, const char* section, pybind11::object& obj);
3584#endif
3590 static bool checkIfExtensionPresent(const char* extension_ID);
3591
3597 static void addTranslation(const char* id, const char* text);
3598
3604 static const std::string getIdTranslation(const char* id);
3605
3610 static const std::string getCurrentLanguage();
3611
3616 static void switchToLanguage(const char* language);
3617
3622 static float scale();
3623
3630 static std::string inputString(const char* text, int min_length = 0);
3631
3637 static int inputInt(int initial_value);
3638
3644 static float inputFloat(float initial_value);
3645 };
3646
3647 class APICALL Camera
3648 {
3649 public:
3654 static void rotateToGradually(const vec3& destination_dir);
3655
3661
3666 static vec3 getUp();
3667
3672 static vec3 getRight();
3673
3678 static bool isOrtho();
3679
3684 static void setOrtho(bool ortho);
3685
3690 static vec3 getPivot();
3691
3696 static void setPivot(const vec3& pivot);
3697
3703
3709 static vec3 getWorldToScreenSpace(const vec3& world_pos);
3710
3716 static vec3 getScreenToWorldSpace(const vec3& screen_pos);
3717
3726 static void setCamera(const vec3& position, const vec3& lookAt, float fovY, const vec3& up = vec3::Zero);
3727 };
3728
3732 class APICALL dialog {
3733#ifndef DOXYGEN_SHOULD_SKIP_THIS
3734 bool _modal;
3735 bool _topright;
3736 str _buttons;
3737 std::function<void()> _process;
3738 std::function<void(int)> _press;
3739 int _width;
3740 int _icon;
3741 bool _undoWorks;
3742 bool _dontshowagain;
3743 BaseClass* _bc;
3744 str _text;
3745 str _caption;
3746 bool _transparentbg;
3747 BaseWidget* _widget;
3748#endif //DOXYGEN_SHOULD_SKIP_THIS
3749 public:
3750 dialog();
3756 dialog& text(const char* id);
3757
3763 dialog& caption(const char* id);
3764
3770 dialog& width(int w);
3771
3777
3783
3789 dialog& buttons(const char* list);
3790
3796
3802
3808
3814
3820
3826
3832
3838
3844
3850
3856
3863#ifdef PYBIND11_DEF
3869 dialog& params(pybind11::object params);
3870
3876 dialog& process(pybind11::object callback);
3877#endif
3883 dialog& process(std::function<void()> process);
3884
3890 dialog& onPress(std::function<void(int)> press);
3891#ifdef PYBIND11_DEF
3902 dialog& onPress(pybind11::object press);
3903#endif
3904
3909 int show();
3910
3911 dialog& widget(BaseWidget* w);
3912 };
3913
3917 class APICALL resource {
3918 ItemsFolder* folder;
3919 public:
3926 resource(const char* id);
3927
3932 static std::vector<std::string> listAllResourcesTypes();
3933
3938 std::vector<std::string> listFolders();
3939
3944 std::string currentFolder();
3945
3951
3956 std::string rootPath();
3957
3962 std::vector<std::string> supportedExtensions();
3963
3968 void setCurrentFolder(const char* folder);
3969
3974 void createFolder(const char* folderName);
3975
3980 void removeFolder(const char* folderName);
3981
3986 std::vector<std::string> listCurrentFolderItems();
3987
3992 void addItem(const char* itemPath);
3993
3998 void removeItem(const char* itemName);
3999
4004 void selectItem(const char* itemName);
4005
4011 void moveItemToFolder(const char* itemName, const char* destFolderName);
4012
4017 std::string getCurrentItem();
4018 };
4019
4023 class APICALL io {
4024 public:
4029 static const char* installPath();
4030
4035 static const char* dataPath();
4036
4042 static const char* documents(const char* path);
4043
4050 static bool fileExists(const char* path);
4051
4057 static void copyFile(const char* src, const char* dest);
4058
4064 static void copyFolder(const char* src, const char* dest);
4065
4071 static void removeFile(const char* filename);
4072
4077 static void removeFolder(const char* folder);
4078
4085 static std::string toFullPathInDataFolder(const char* path);
4086 static void toFullPathInDataFolder(str* path);
4087
4094 static std::string toFullPathInInstallFolder(const char* path);
4095 static void toFullPathInInstallFolder(str* path);
4096
4102 static std::string convertToWritablePath(const char* path);
4103 static void convertToWritablePath(str* path);
4104
4111 static std::string convertToWritablePathIfFileExists(const char* path);
4112 static void convertToWritablePathIfFileExists(str* path);
4113
4119 static std::string getExtension(const char* filepath);
4120
4126 static std::string getFileName(const char* filepath);
4127
4133 static std::string getFilePath(const char* filepath);
4134
4140 static std::string getFileNameWithoutExtension(const char* filepath);
4141
4148 static std::string strFromFile(const char* filename);
4149
4155 static void strToFile(const char* text, const char* filename);
4156
4162 static size_t getFileSize(const char* filename);
4163
4168 static vec2 cursorPos();
4169
4175
4181
4186 static rect workArea();
4187
4194 static void progressBar(float stage, float max_stage, const char* message);
4195
4202 static void progressBarInWindowHeader(float stage, float max_stage, const char* message);
4203
4209 static void setWindowTitle(const char* text, float seconds);
4210
4215 static void step(int count = 1);
4216
4222 static void exec(const char* command, const char* arguments = nullptr);
4223
4230 static const char* execAndWait(const char* command, const char* arguments = nullptr);
4231
4232
4237 static void updateCoatPyi(const char* folderOrFile);
4238
4246 static void ListFiles(const char* folder, const char* mask, coat::list<coat::str>& result, bool recursive = true);
4247
4255 static std::vector<std::string> ListFiles(const char* folder, const char* mask, bool recursive = true);
4256
4262 static void ListFolders(const char* startFolder, coat::list<coat::str>& result);
4263
4269 static std::vector<std::string> ListFolders(const char* startFolder);
4270
4275 static const char* supportedImagesFormats();
4276
4281 static const char* supportedMeshesFormats();
4282
4289 static bool openFileDialog(const char* extensions, str& fileName);
4290 static std::string openFileDialog(const char* extensions);
4291
4298 static bool openFilesDialog(const char* extensions, list<str>& fileNames);
4299
4305 static std::vector<std::string> openFilesDialog(const char* extensions);
4306
4313 static bool saveFileDialog(const char* extensions, str& fileName);
4314 static std::string saveFileDialog(const char* extensions);
4315
4319 static const char* currentSceneFilepath();
4320
4325 static void pipInstall(const char* requirements);
4326 static void pipUninstall(const char* requirements);
4327
4332 static std::string pythonPath();
4333
4337 static void showPythonConsole();
4338
4343 static void executeScript(const char* path);
4344
4345
4350 static void installRequirements(const char* path_to_requirements_txt);
4351#ifdef PYBIND11_DEF
4358 static std::string toJson(const pybind11::object& obj, const char* filename = "");
4359
4365 static void fromJsonFile(pybind11::object& obj, const char* filename);
4366
4372 static void restoreObjectFormJsonString(pybind11::object& obj, const char* data);
4373#endif
4374
4382 static void createRedistributablePackageFromFolder(const char* folder, const char* package_name, const char* excluded_folders_names = "", const char* excluded_extensions = "");
4383
4389 static void download(const char* url, std::function<void(const char*, const char*)> report_success);
4390
4396
4405 static void post_request(const char* url, const char* data, const char* headers, const std::function<void(const char*)>& report_success = nullptr, const std::function<void(const char*)>& report_error = nullptr);
4406
4414 static void get_request(const char* url, const char* headers, const std::function<void(const char*)>& report_success = nullptr, const std::function<void(const char*)>& report_error = nullptr);
4415
4420 static std::vector<std::string> listBlenderInstallFolders();
4421
4430 static void saveScreenshot(const char* filename, int x = 0, int y = 0, int width = 0, int height = 0);
4431
4432 static void removeBackground(const char* image1, const char* image2, const char* result);
4433 };
4434
4435 class APICALL utils {
4436 public:
4442 static vec4 dwordToVec4(unsigned int d);
4443
4449 static unsigned vec4ToDword(const vec4& v);
4450
4455 static void randomize(int seed);
4456
4461 static float random01();
4462
4469 static float random(float min, float max);
4470
4476
4483 static vec3 perlin3d(vec3 p, float seed = 0);
4484
4491 static float perlin(vec3 p, float seed = 0);
4492
4499 static const char* getEnumValueByIndex(const char* enumID, int index);
4500
4507 static int getEnumValue(const char* enumID, const char* key);
4508
4515 static int getEnumValueIndex(const char* enumID, const char* key);
4516
4522 static int getEnumValuesCount(const char* enumID);
4523
4528 static void clearEnum(const char* enumID);
4529
4536 static void addEnumValue(const char* enumID, const char* key, int value = - 1);
4537
4541 static void quit();
4542
4546 static void testSuccessful();
4547
4552 static void testFailed(const char* message);
4553
4558 static void signal(const char* message);
4559
4564 static std::vector<std::string>& last_signals();
4565
4570 static float getFPS();
4571
4576 static float getFrameTimeMs();
4577
4582 static bool inRenderProcess();
4583
4589 static void set(const char* key, const char* value);
4590
4596 static const char* get(const char* key);
4597 };
4598
4602 class APICALL uv {
4603 public:
4608 static int uvSetsCount();
4609
4614 static void setUnwrapIslandsDistance(float distance);
4615
4621
4626 static int currentUvSet();
4627
4633 static int islandsCount(int uv_set);
4634
4641 static Mesh islandToMesh(int uv_set, int island_index);
4642
4649 static Mesh islandToMeshInSpace(int uv_set, int island_index);
4650
4657 static std::vector<int> getIslandVertexMapping(int uv_set, int island_index);
4658
4665 static std::vector<int> getIslandBorder(int uv_set, int island_index);
4666
4675 static std::vector<int> getBorderBetweenIslands(int uv_set1, int island_index1, int uv_set2, int island_index2);
4676
4684 static vec2 getIslandVertexUv(int uv_set, int island_index, int vertex_index);
4685
4694 static Mesh flattenSingleIsland(const Mesh& mesh, int method, bool optimize_rotation = true, bool scale_to_geometry = true);
4695
4702 static void meshToIsland(const Mesh& mesh, int uv_set, int island_index);
4703
4710 static void pack(int uv_set, bool rotate, bool shuffle);
4711
4716 static void unwrap(int uv_set);
4717
4723 static void toAbf(int uv_set, int island_index);
4724
4730 static void toLscm(int uv_set, int island_index);
4731
4737 static void toGu(int uv_set, int island_index);
4738
4744 static void toPlanar(int uv_set, int island_index);
4745
4751 static void toStripe(int uv_set, int island_index);
4752
4759 static void toUvSet(int uv_set, int island_index, int destination_uv_set);
4760
4766
4772
4777 static std::vector<int> getSeams();
4778
4784 static void addSeam(DWORDS2 start_vertex_index, int end_vertex_index);
4785
4791 static void removeSeam(int start_vertex_index, int end_vertex_index);
4792
4797 static std::vector<int> getSharpEdges();
4798
4804 static void addSharpEdge(int start_vertex_index, int end_vertex_index);
4805
4811 static void removeSharpEdge(int start_vertex_index, int end_vertex_index);
4812
4816 static void unwrapUnassigned();
4817
4821 static void applyUVSet();
4822 };
4823
4824
4829 {
4830 Uniform_Scaling = 0,
4831 Axial_Normal = 1,
4832 Axial_X = 2,
4833 Axial_Y = 3,
4834 Axial_Z = 4,
4835 Radial_Normal = 5,
4836 Radial_X = 6,
4837 Radial_Y = 7,
4838 Radial_Z = 8
4839 };
4845 class APICALL Model {
4846 protected:
4847 friend class Mesh;
4848 ClusteredMesh* _mesh;
4849 bool _from_retopo;
4850 bool _from_uv;
4851 ClusteredMesh& _mctx();
4852 ClusteredMesh* _pmctx() const;
4853 static void inc_ref(ClusteredMesh* m);
4854 static void dec_ref(ClusteredMesh* m);
4855 static bool has_ref(ClusteredMesh* m);
4856 static ClusteredMesh* allocate();
4857 static ClusteredMesh* allocate(ClusteredMesh* src);
4858 static std::vector<std::pair<ClusteredMesh*, int>> allocated_meshes;
4859 public:
4864
4869 Model(const Model& source);
4870
4875 Model(const Mesh& source);
4876
4882 Model & operator=(const Model& source);
4883
4884 Model & operator=(const Mesh& source);
4885
4886 Model & operator += (const Model& source);
4887
4888 Model & operator += (const Mesh& source);
4889
4896
4901
4906
4912
4918
4923 static Model fromUv();
4924
4933 void displayOptions(bool showWireframe = true, bool showColored = true, bool showSeams = true, bool showSharpEdges = true, bool smoothView = false);
4934
4940
4946
4951 void setCurrentObject(int index);
4952
4958 const char* getObjectName(int group_index);
4959
4963 void removeObject(int group_index);
4964
4970 void setObjectName(int index, const char* name);
4971
4977 void setObjectVisibility(int index, bool visible);
4978
4984 bool getObjectVisibility(int index);
4985
4991 int addObject(const char* name);
4992
4998 int addMaterial(const char* name);
4999
5004
5011
5017 void setObjectReferenceColor(int group_index, vec4 color);
5018
5023 void selectedToObject(int group_index);
5024
5030
5036
5042
5051 void addTransformed(const Mesh& mesh, const mat4& Transform = mat4::Identity, BoolOpType b = BOOL_MERGE, bool select = false, bool snap_to_existing = false);
5052
5058 Mesh getObjectMesh(int group_index);
5059
5066 void setObjectMesh(int group_index, Mesh& mesh, const mat4& transform = mat4::Identity);
5067
5076 int duplicateObject(int group_index, const char* name = nullptr, const mat4& transform = mat4::Identity, bool select = false);
5077
5083 std::string generateName(const char* base);
5084
5089 void clearObjectMesh(int group_index);
5090
5094 void clear();
5095
5099 void dropUndo();
5100
5105 std::vector<int> getSelectedFaces();
5106 void getSelectedFaces(list<int>& faces);
5107
5112 void setSelectedFaces(std::vector<int>& faces);
5113 void setSelectedFaces(list<int>& faces);
5114
5119 void selectFace(int face);
5120
5125 void selectObject(int group_index, bool add_to_selected = true);
5126
5132 std::vector<int> getObjectFaces(int group_index);
5133 void getObjectFaces(int group_index, list<int>& faces);
5134
5140 bool isFaceSelected(int face);
5141
5146
5151
5156
5161
5166
5171
5176 std::vector<int> getSelectedEdges();
5177 void getSelectedEdges(list<int>& edges);
5178
5183 void setSelectedEdges(std::vector<int>& edges);
5184 void setSelectedEdges(list<int>& edges);
5185
5191 void selectEdge(int vertex1, int vertex2);
5192
5199 bool isEdgeSelected(int vertex1, int vertex2);
5200
5205
5210 std::vector<int> getSelectedVertices();
5211 void getSelectedVertices(list<int>& vertices);
5212
5217 std::vector<float> getSelectedVerticesWeights();
5218
5224 void setSelectedVertices(const std::vector<int>& vertices, const std::vector<float>& weights);
5225 void setSelectedVertices(const list<int>& vertices, const list<float>& weights);
5226
5232 void selectVertex(int vertex, float weight = 1.0f);
5233
5239 bool isVertexSelected(int vertex);
5240
5245
5251
5257
5263
5268 void removeFace(int face);
5269
5276 int createNewFace(int Group, int UVSet);
5277
5283 int getFaceVertsCount(int face);
5284
5291 int getFaceVertex(int face, int vertex_index);
5292
5298 std::vector<int> getFaceVerts(int face);
5299 void getFaceVerts(int face, list<int>& vertices);
5300
5306 void setFaceVerts(int face, const std::vector<int>& vertices);
5307 void setFaceVerts(int face, const list<int>& vertices);
5308
5314 bool getFaceVisibility(int face);
5315
5321 void setFaceVisibility(int face, bool visibility);
5322
5328 float getFaceSquare(int face);
5329
5335 float getFaceUVSquare(int face);
5336
5343
5349 int getFaceObject(int face);
5350
5356 void setFaceObject(int face, int group);
5357
5363 int getFaceMaterial(int face);
5364
5370 void setFaceMaterial(int face, int uv_set);
5371
5377 int getFaceUvVertsCount(int face);
5378
5385 int getFaceUvVertex(int face, int vertex_index);
5386
5392 std::vector<int> getFaceUvVerts(int face);
5393 void getFaceUvVerts(int face, list<int>& vertices);
5394
5400 void setFaceUvVerts(int face, const std::vector<int>& vertices);
5401 void setFaceUvVerts(int face, const list<int>& vertices);
5402
5408 vec3 getVertex(int vertex);
5409
5415 void setVertex(int vertex, const vec3& position);
5416
5422 int createNewVertex(const vec3& position);
5423
5429 vec2 getVertexUV(int uv_vertex);
5430
5436 void setVertexUV(int uv_vertex, const vec2& uv);
5437
5444
5451
5456 void updateNormals(bool for_snapping = true);
5457
5462
5466 void cleanup();
5467
5473 std::vector<int> getVertsNearVertex(int vertex);
5474 void getVertsNearVertex(int vertex, list<int>& vertices);
5475
5481 std::vector<int> getFacesNearVertex(int vertex);
5482 void getFacesNearVertex(int vertex, list<int>& faces);
5483
5489 std::vector<int> getFaceNeighbors(int face);
5490 void getFaceNeighbors(int face, list<int>& faces);
5491
5498 std::vector<int> getFacesNearEdge(int vertex1, int vertex2);
5499 void getFacesNearEdge(int vertex1, int vertex2, list<int>& faces);
5500
5507 bool isOpenEdge(int vertex1, int vertex2);
5508
5515 bool isSharpEdge(int vertex1, int vertex2);
5516
5523 void setEdgeSharpness(int vertex1, int vertex2, bool sharp);
5524
5531 bool isSeam(int vertex1, int vertex2);
5532
5539 void setEdgeSeam(int vertex1, int vertex2, bool seam);
5540
5546 void collapseEdge(int vertex1, int vertex2);
5547
5553 int islandsCount(int uv_set);
5554
5561 Mesh islandToMesh(int uv_set, int island_index);
5562
5569 Mesh islandToMeshInSpace(int uv_set, int island_index);
5570
5577 std::vector<int> getIslandVertexMapping(int uv_set, int island_index);
5578
5585 std::vector<int> getIslandBorder(int uv_set, int island_index);
5586
5595 std::vector<int> getBorderBetweenIslands(int uv_set1, int island_index1, int uv_set2, int island_index2);
5596
5604 vec2 getIslandVertexUv(int uv_set, int island_index, int vertex_index);
5605
5614 static Mesh flattenSingleIsland(const Mesh& mesh, int method, bool optimize_rotation = true, bool scale_to_geometry = true);
5615
5622 void meshToIsland(const Mesh& mesh, int uv_set, int island_index);
5623
5630 void pack(int uv_set, bool rotate, bool shuffle);
5631
5636 void unwrap(int uv_set);
5637
5643 void toAbf(int uv_set, int island_index);
5644
5650 void toLscm(int uv_set, int island_index);
5651
5657 void toGu(int uv_set, int island_index);
5658
5664 void toPlanar(int uv_set, int island_index);
5665
5671 void toStripe(int uv_set, int island_index);
5672
5677
5682 void moveSelectedFacesAlongFacesNormals(float displacement);
5683
5688 void moveSelectedFacesAlongVertexNormals(float displacement);
5689
5694 void subdivideSelectedFaces(bool apply_catmull_clark = false);
5695
5700 void subdivide(bool apply_catmull_clark = true);
5701
5707 void transformSelected(const mat4& transform, bool apply_symmetry);
5708
5713 void scaleSelectedFacesClusters(float scale, ClusterScale method = Uniform_Scaling);
5714
5720
5726 void bevelOverSelectedEdges(float size, int segments = 1, bool OldVariant = false);
5727
5735 int splitEdge(int vertex1, int vertex2, float position);
5736
5743 bool connect(int vertex1, int vertex2);
5744
5751 bool checkConnectivity(int vertex1, int vertex2);
5752
5757
5762
5766 void inset(float distance);
5767
5772 void shell();
5773
5778 void intrude();
5779
5784
5790 void selectPath(int vertex1, int vertex2);
5791
5797 std::vector<int> getPath(int vertex1, int vertex2);
5798
5799 };
5800 class APICALL logger {
5801 FILE* out;
5802 void* tempTimer;
5803 str filename;
5804 str _accum;
5805 int precission;
5806 void append(const char*);
5807 void close();
5808
5809 public:
5815
5820 logger(const char* filename);
5821
5822
5823 ~logger();
5827 void open();
5828
5833
5839 logger& directTo(const char* filename);
5840
5846
5851 logger& operator << (const char*);
5852
5857 logger& operator << (str&);
5858
5863 logger& operator << (const wchar_t*);
5864
5869 logger& operator << (int);
5870
5875 logger& operator << (float);
5876
5881 logger& operator << (double);
5882
5887 logger& operator << (const vec2&);
5888
5893 logger& operator << (const vec3&);
5894
5899 logger& operator << (const vec4&);
5900
5905 logger& operator << (BaseClass*);
5906
5913 logger& format(const char* format, ...);
5914
5920
5926
5932
5938
5944
5949 logger& floatPrecission(int signs = 2);
5950 };
5951}
5952
5953
5954#include "CorePrimAPI.h"
5955#pragma pack(pop)
5956
5957#ifdef COMMS_OPENGL
5958#include <ui.h>
5959#include <ui_definition.h>
5960#define EXPORT(x) \
5961 static int Main();\
5962 __defineui(xxx) {\
5963 ui_element(#x, Main);\
5964 } static
5965#define EXPORT_COMMAND(x) \
5966 static void x();\
5967 __defineui(x) {\
5968 ui_element(#x, x);\
5969 } static void x()
5970#define EXPORT_EXTENSION(x) __defineui(___##x)
5971void executeCoreScript(const char* filename, bool build, bool clean);
5972#endif //COMMS_OPENGL
Use this class for build a class for UI or serialization. see class_reg.h for details about the class...
Definition BaseClass.h:91
Definition CoreAPI.h:3648
static vec3 getWorldToScreenSpace(const vec3 &world_pos)
convert the world position to the screen position
static vec3 getScreenToWorldSpace(const vec3 &screen_pos)
convert the screen position to the world position
static void rotateToGradually(const vec3 &destination_dir)
align the camera along the view
static vec3 getPivot()
get the camera pivot position
static bool isOrtho()
return true if the camera is in the ortho mode
static void setPivot(const vec3 &pivot)
set the camera pivot position
static vec3 getForward()
get the forward direction
static vec3 getRight()
get the camera right direction
static void setOrtho(bool ortho)
switch the camera to the ortho or perspective mode
static vec3 getUp()
get the camera up direction
static void setCamera(const vec3 &position, const vec3 &lookAt, float fovY, const vec3 &up=vec3::Zero)
static vec3 getPosition()
get the camera position
Definition CoreAPI.h:3056
void setPointTangents(int idx, const vec3 &t1, const vec3 &t2)
set the point tangents
void add(const Vector3D &p, const Vector3D &normal, float Radius)
add the point to the curve without the direct options the tangents
int pointsCount()
get the base points cout in the curve
void unselectPoints()
unselect all curve points
void removePoints(int index, int count)
remove the points out of the curve base points list
OneCurveObject * curve()
get the low-level ObjeCurveObject pointer
void setClosed()
set the curve to be closed
void setOpen()
set the curve to be open
void addWithTangent(const Vector3D &p, const Vector3D &normal, const Vector3D &inOutTangent, float Radius)
add the point with the opposite tangents
Curve(OneCurveObject *ob)
create Curve based on low-level object OneCurveObject
void setPointNormal(int idx, const vec3 &n)
set the point normal
void addSmooth(const Vector3D &p, const Vector3D &normal, float Radius)
add the smooth B-spline-like point to the curve
bool isOpen()
check if the curve is open
void setPointRadius(int idx, float r)
set the point radius
void addSharp(const Vector3D &p, const Vector3D &normal, float Radius)
add the sharp point to the curve
OneSelPoint * point(int idx)
get the base point pointer
bool & closed()
returns the reference to the closed state of the curve to get or set the value
Curve()
the default constructor, creates the curve without insertion into the scene, it is good for the tempo...
void setPointPosition(int idx, const vec3 &p)
set the point position
Curve(SceneElement &el)
create the curve object based on the SceneElement, it is valid only is scene element is curve
int renderPointsCount()
returns the visual points count. Visual points used to render the curve in the viewport as set of str...
void updatePoints()
update the visual points if need. Use this function if you cahnge the curve. Change the multiple para...
void tubeToMesh(Mesh &mesh, bool hemisphere)
create the solid tube around the curve using the points radius
void addBothTangents(const Vector3D &p, const Vector3D &normal, const Vector3D &inTangent, const Vector3D &outTangent, float Radius)
add the point with two independent tangents.
void fill(Mesh &mesh, float thickness, float relax_count=0, float details_level=1, float extrusion=0)
Create the curved surface around the curve.
void selectPoint(int idx)
select the curve point
std::tuple< vec3, vec3, vec3, vec3, float > getPoint(int idx)
get the point of the curve
OneSelPoint * renderPoint(int idx)
returns the visual point reference
The image references. Look the cImage for the list of allowed operations.
Definition CoreAPI.h:1304
int ToTexture()
Create texture from image.
bool Read(const char *name)
Read the image from the file.
bool Write(const char *name)
Write the image to file.
bool FromArray(PY_BYTE_ARRAY src_data)
Get image from texture.
bool FromTexture(int texture_id)
Get image from texture.
int Paste(PY_BYTE_ARRAY src_data, int pasteLeft=0, int pasteTop=0, int cropLeft=0, int cropTop=0, int cropRight=0, int cropBottom=0, bool flipY=false)
paste image to image
size_t Pointer()
Pointer to the data.
The mesh reference.
Definition CoreAPI.h:412
void subtractFromVolume(Volume &v, const mat4 &transform=mat4::Identity)
boolean subtraction of the mesh from the volume
std::vector< vec2 > getMeshUVs()
get the list of all UV vertices of the mesh
int facesCount()
returns the faces amount
std::vector< vec3 > getMeshVertices()
get the list of all positional vertices of the mesh
void setMaterialTexture(int idx, int texture_layer, const std::string &texture_path)
set the texture layer filename of the material
void shell(float thickness_out, float thickness_in, int divisions=1)
add some thickness to the mesh (intrude a bit)
float getOpenSurfaceVolume(const vec3 &start, const vec3 &dir) const
calculate the volume even if the mesh is not closed, in this case we define plane that limits the int...
void addMeshUVs(const std::vector< vec2 > &uvs)
add the list of all UV vertices for the mesh
void reduceToPolycount(int destination_triangles_count)
reduce the mesh to the given polycount, mesh will be triangulated
void removeObject(int idx)
remove object from the mesh
void distortByPerlinNoise(float noise_degree, float noise_scale, bool anisotropic=false, int seed=0)
distort the mesh by the Perlin noise
void setMeshFaces(const std::vector< int > &faces)
set the complete list of faces for the mesh
std::string getMaterialName(int idx)
get the name of the material
static Mesh cone(const vec3 &center=vec3::Zero, float radius=1, float height=2, float detail_size=1, const vec3 &topAxis=vec3::AxisY)
create the cone mesh
void fromVolume(Volume &v, bool with_subtree=false, bool all_selected=false)
extract the mesh from the volume
void rotateToYZAxis(const vec3 &axisY, const vec3 &axisZ)
rotate the mesh so that Y axis will be aligned with axisY, Z axis will be aligned with axisZ
std::vector< int > getOpenEdges()
get the list of open edges
void addToVolume(Volume &v, const mat4 &transform=mat4::Identity)
boolean add to volume
vec3 getCenterMass() const
calculate the center mass of the mesh
vec3 getFaceNormal(int face)
get the face normal
void weld(float minimal_relative_distance=0.0001f)
weld the mesh, remove all vertices that are closer than minimal_relative_distance*mesh_bound_box_diag...
std::string getMaterialTexture(int idx, int texture_layer)
get the texture name of the material
void clearVerts()
clear all positional vertices of the mesh
void rotateToXYAxis(const vec3 &axisX, const vec3 &axisY)
rotate the mesh so that X axis will be aligned with axisX, Y axis will be aligned with axisY
int createNewVertex(const vec3 &position)
create the positional vertex
void setMaterialName(int idx, const std::string &name)
set material name
int getFaceVertex(int faceIndex, int faceVertexIndex)
get the positional vertex index over the face
void addMeshNormals(const std::vector< vec3 > &normals)
add the list of all normal vertices for the mesh
void clearUvVerts()
clear all uv vertices of the mesh
std::vector< int > getFaceVerts(int face)
get the list of UV vertex indices over the face, pay attention UV vertices are not same as position v...
void clearFaces()
clear all faces of the mesh
void removeMaterial(int idx)
remove the material (and corresponding faces) from the mesh
vec3 getVertex(int idx) const
get the vertex coordinate
static Mesh cylinder(const vec3 &center=vec3::Zero, float radius=1, float height=2, float detail_size=1, int slices=0, int caps=0, int rings=0, float fillet=0)
create the cylinder mesh
static Mesh plane(const vec3 &center=vec3::Zero, float sizeX=2, float sizeY=2, int divisionsX=2, int divisionsY=2, const vec3 &xAxis=vec3::AxisX, const vec3 &yAxis=vec3::AxisY)
create the single-side plane mesh, the faces normals are put toward the vec3.Cross(xAxis,...
int vertsCount() const
returns the amount of verts in the mesh
void addTransformed(const Mesh &m, const mat4 &t)
concatenate the transformed mesh with the current one
void calcNormals()
re-calculate normals over the mesh
void toVolume(Volume &v, const mat4 &transform=mat4::Identity, BoolOpType op=BOOL_MERGE)
merge this mesh to the volume object
void intersectWithVolume(Volume &v, const mat4 &transform=mat4::Identity)
boolean intersection of the mesh with the volume
void fromReducedVolume(Volume &v, float reduction_percent, bool with_subtree=false, bool all_selected=false)
extract the mesh from the volume and reduce it by the given percent
void setVertexNormal(int idx, const vec3 &v)
set the normal of the vertex, pay attention position verts and normal verts are different,...
void fromVolumeWithMaxPolycount(Volume &v, int max_polycount, bool with_subtree=false, bool all_selected=false)
extract the mesh from the volume and reduce to the given polycount
vec2 getVertexUV(int idx) const
get the UV coordinate of the vertex, pay attention position verts and UV verts are different,...
int getFaceVertsCount(int face)
get the amount of vertices over the face
float getVolume() const
get the volume of the mesh
void addMeshVertices(const std::vector< vec3 > &positions)
add the list of all positional vertices for the mesh
int getFaceNormalVertex(int faceIndex, int faceVertexIndex)
get the normal vertex index over the face
std::vector< comms::cPlane > autodetectSymmetryPlanes()
Detect the symmetry planes of the mesh.
void transform(const mat4 &transform)
transform the mesh
void boolean(const Mesh &m, BoolOpType op)
boolean operation
void calcNormalsIgnoreSharpEdges()
re-calculate normals over the mesh, ignore the sharp edges
void clearObject()
clear all objects
void setFaceMaterial(int faceIndex, int materialIndex)
set the material index over the face, see the getMaterialsCount(), getMaterialName()
int addObject(const char *name)
add new object to the mesh
float getFaceSquare(int face)
get the squareof the face
void addMeshFaces(const std::vector< int > &faces)
add the list of faces for the mesh, pay attention, all vertex indices are global over the whole mesh!
void setFaceObject(int faceIndex, int objectIndex)
set the object index for the face, see the getObjectsCount(), getObjectName()
int getFaceUvVertsCount(int face)
get the amount of UV vertices over the face
void rotateToZXAxis(const vec3 &axisZ, const vec3 &axisX)
rotate the mesh so that Z axis will be aligned with axisZ, X axis will be aligned with axisX
void removeUnusedFaces()
remove all faces that contain zero vertices
int getFaceObject(int faceIndex)
get the object index over the face, see the getObjectsCount(), getObjectName()
int getMaterialsCount()
get the materials count in the mesh
void fromRetopo()
take the whole mesh from the retopo room
void setVertexUV(int idx, const vec2 &v)
set the UV coordinate of the vertex, pay attention position verts and UV verts are different,...
void insertInVolume(Volume &v, const mat4 &transform=mat4::Identity)
insert without boolean operation, if the volume is not in surface mode (volumetric) the boolean ADD w...
float getLengthAlongDirection(const vec3 &dir) const
get the mesh size along some axis
bool valid() const
Check if mesh is valid.
void clearMaterials()
clear all materials
int getObjectsCount()
returns the objects count in the mesh
int createNewUvVertex(const vec2 &uv)
create new UV vertex to be used for faces
void booleanOp(Mesh &With, BoolOpType op)
Perform the boolean operation with the given mesh.
void fromPaintRoom()
get the mesh from the paint room
void setFaceNormalVertex(int faceIndex, int faceVertexIndex, int normalVertexIndex)
set the normal vertex index over the face
void setMeshNormals(const std::vector< vec3 > &normals)
set the list of all normal vertices for the mesh
boundbox getBounds() const
get the mesh bound box
int addMaterial(const char *name)
add new material to the mesh
void relax(float degree, bool tangent, float crease_angle=180)
relax the mesh, keep the vertices count
void setFaceVerts(int face, const std::vector< int > &vertices)
set the list of positional vertex indices over the face
std::string getObjectName(int idx)
get the name of the object
void unifyAllObjects(const std::string &name="")
unify all objects in the mesh, i.e. make one object
void removeUnusedVerts()
remove all unused vertices
void setObjectName(int idx, const std::string &name)
set object name
vec3 getVertexNormal(int idx) const
get the normal of the vertex, pay attention position verts and normal verts are different,...
int getFaceUvVertex(int faceIndex, int faceVertexIndex)
get the UV vertex index over the face
bool Read(const char *name)
Load the mesh from the file.
void cutByDistortedPlane(const vec3 &start, const vec3 &NormalDirection, float noise_degree, float noise_scale, int seed=0)
Cut off the mesh by the distorted plane (using the Perlin noise), the result is stored in the current...
void clearNormals()
clear all normal vertices of the mesh
static Mesh hexagonal_plane(const vec3 &center=vec3::Zero, float sizeX=2, float sizeY=2, int divisionsX=2, int divisionsY=2, const vec3 &xAxis=vec3::AxisX, const vec3 &yAxis=vec3::AxisY)
create the single-side triangular plane mesh that consists mostly of quasi equally-sided triangles
static Mesh text(const char *string, const char *font="tahoma", float height=10.0f, const vec3 &center=vec3::Zero, const vec3 &text_direction=vec3::AxisX, const vec3 &text_normal=vec3::AxisY, float thickness=1, int align=1)
Create the text mesh.
int vertsNormalCount() const
returns the amount of normal - verts in the mesh
float getFaceUVSquare(int face)
get the face square in UV space
void setVertex(int idx, const vec3 &v)
set the vertex coordinate
void removeFaces(const std::vector< int > &faces)
remove the set of vertices from the mesh
void setMeshVertices(const std::vector< vec3 > &positions)
set the list of all positional vertices for the mesh
void setFaceUvVertex(int faceIndex, int faceVertexIndex, int uvVertexIndex)
set the UV vertex index over the face
float getSquare() const
get square of the mesh
int addObject(const std::string &name)
add the named object
void triangulate()
triangulate the mesh
void cutByPlane(const vec3 &start, const vec3 &NormalDirection)
Cut off the mesh by the plane, the result is stored in the current mesh, the part of the mesh that is...
void clear()
clear the mesh
std::vector< int > expandOpenEdges(float distance)
extrude open edges of the mesh
static Mesh box(const vec3 &center=vec3::Zero, const vec3 &size=vec3::One, const vec3 &xAxis=vec3::Zero, const vec3 &yAxis=vec3::Zero, const vec3 &zAxis=vec3::Zero, float detail_size=1, float fillet=0.0f, int nx=0, int ny=0, int nz=0)
create the box mesh
int getFaceMaterial(int faceIndex)
get the material index over the face, see the getMaterialsCount(), getMaterialName()
void symmetry(const vec3 &start, const vec3 &NormalDirection, bool resultInQuads)
apply symmetry to the mesh
void removeUnusedObjectsAndMaterials()
remove all unused objects and materials
int vertsUvCount() const
returns the amount of UV - verts in the mesh
std::vector< int > extrudeOpenEdges(float distance, vec3 direction=vec3::Zero)
extrude open edges of the mesh
std::vector< int > getFaceUvVerts(int face)
get the list of UV vertices indices over the face
std::vector< vec3 > getMeshNormals()
get the list of all normal vertices of the mesh
comms::cMeshContainer * geometry()
The low-level mesh reference allows to create, operate over individual faces, vertices,...
void setMeshUVs(const std::vector< vec2 > &uvs)
set the list of all UV vertices for the mesh
static Mesh sphere(const vec3 &center=vec3::Zero, float radius=1.0f, float detail_size=1)
create the sphere mesh
void ensureMaterialsAndObjectsExist()
ensure that at least one material and one object exist in the mesh
void createVDM(int side, const char *path_to_exr, const vec3 &center=vec3::Zero, float radius=1, const vec3 &up=vec3::AxisZ, const vec3 &x=vec3::AxisX, const vec3 &y=vec3::AxisY)
Create the vector displacement map from the mesh and save it as EXR file. The mesh is put on plane at...
int addMaterial(const std::string &name)
add the named material
bool Write(const char *name)
Save the mesh to file.
std::vector< Mesh > splitDisconnectedParts()
split the mesh into disconnected parts
The class that corresponds to the retopo/modeling rooms meshes. This is advanced version of the Mesh ...
Definition CoreAPI.h:4845
void setSelectedEdges(std::vector< int > &edges)
set the selected edges list
void relaxSelected()
relax selected vergtices
std::vector< int > getFacesNearEdge(int vertex1, int vertex2)
get the list of faces that are adjacent to the edge
int getFaceVertsCount(int face)
get the vertices count over the face
void setFaceMaterial(int face, int uv_set)
set the UV set for the face
void unselectAllEdges()
unselect all edges
void toGu(int uv_set, int island_index)
unwrap the island using the GU (Globally Uniform) approach
void invertSelectedFacesTopoplogically()
invert selected faces only within the connective area, if some objects has no selected faces,...
int vertsUvCount()
get the uv vertices count
std::vector< int > getIslandVertexMapping(int uv_set, int island_index)
get the mapping from the vertex index in the mesh that was got by islandToMesh to the vertex index in...
void setEdgeSharpness(int vertex1, int vertex2, bool sharp)
set the sharpness state for the edge
void setEdgeSeam(int vertex1, int vertex2, bool seam)
set or clear the seam state for the edge
int getCurrentObject()
get the index of the current group
Mesh getObjectMesh(int group_index)
get the mesh from some retopo group
void setVertexUV(int uv_vertex, const vec2 &uv)
set the UV for the UV vertex
std::vector< int > getFacesNearVertex(int vertex)
get the list of faces that are adjacent to the vertex
vec3 getFaceNormal(int face)
get the face normal
void bevelOverSelectedVertices(float size)
perform the bevel over the selected vertices. As result, new faces will be selected
void inset(float distance)
perform the inset over the selected faces
int getFaceMaterial(int face)
get the UV set index for the face
void dropUndo()
Drop the whole mesh to the undo queue, it is important if you want allow the user to undo your mesh c...
void pack(int uv_set, bool rotate, bool shuffle)
pack the islands in the current uv-set
void toLscm(int uv_set, int island_index)
unwrap the island using the LSCM approach
void removeUnusedMaterials()
remove all unused UV sets (not referred within the mesh)
int duplicateObject(int group_index, const char *name=nullptr, const mat4 &transform=mat4::Identity, bool select=false)
duplicate the object (retopo group)
void setSelectedVertices(const std::vector< int > &vertices, const std::vector< float > &weights)
set the selected vertices list
void unselectAllVertices()
unselect all vertices
void setSelectedFaces(std::vector< int > &faces)
set the selected faces list
int getFaceObject(int face)
get the group index of the face
void scaleSelectedFacesClusters(float scale, ClusterScale method=Uniform_Scaling)
scale each selection cluster separately, to own center mass
int splitEdge(int vertex1, int vertex2, float position)
split existing edge somewhere between vertices.
void toPlanar(int uv_set, int island_index)
unwrap the island using the Planar approach
void subdivideSelectedFaces(bool apply_catmull_clark=false)
subdivide the selected faces
bool isOpenEdge(int vertex1, int vertex2)
check if the edge is open
std::vector< int > getSelectedFaces()
get the list of selected faces
void intrude()
perform the intrude operation over the selected faces. After calling the intrude() you should call th...
void subdivide(bool apply_catmull_clark=true)
subdivide the whole mesh
~Model()
destroy the mesh reference (the mesh itself will not be destroyed if it is the reference to retopo/mo...
Mesh visibleToMesh()
get the visible faces as the Mesh object
std::vector< int > getFaceVerts(int face)
get the list of UV vertex indices over the face, pay attention UV vertices are not same as position v...
void toStripe(int uv_set, int island_index)
try to uwrap the island as the regular stripe
int createNewFace(int Group, int UVSet)
create empty face, you need to call setFaceVertices to set the vertices, setFaceUVVerts to set the UV...
void selectedToEdges()
convert faces/vertices selection to edges selection
void setFaceObject(int face, int group)
set the group index of the face
Mesh islandToMesh(int uv_set, int island_index)
get the mesh that contains the island, xy of each point is the UV coordinate. The mesh contains only ...
Model & operator=(const Model &source)
the assignment operator. No new Mesh allocated! Use MakeCopy if you need to make a copy of the mesh
void moveSelectedFacesAlongVertexNormals(float displacement)
move selected faces along the vertex normals, each vertex displace on the same distance
void selectPath(int vertex1, int vertex2)
select all edges on the path from vertex1 to vertex2 (add to existing edges selection)
bool getFaceVisibility(int face)
get the face visibility
void bevelOverSelectedEdges(float size, int segments=1, bool OldVariant=false)
perform the bevel over the selected edges.
std::vector< int > getVertsNearVertex(int vertex)
get the list of vertices that are adjacent to the vertex
static Mesh flattenSingleIsland(const Mesh &mesh, int method, bool optimize_rotation=true, bool scale_to_geometry=true)
Flatten the mesh that consists of the single island.
int getObjectsCount()
get the retopo groups count
bool isVertexSelected(int vertex)
check if the vertex is selected
Model(const Model &source)
make a reference to the source mesh. No new Mesh allocated! Use MakeCopy if you need to make a copy o...
void selectedToObject(int group_index)
move the selected faces to the group
std::vector< float > getSelectedVerticesWeights()
get the soft selection weights of the selected vertices, 1 is maximum value
int createNewUvVertex(const vec2 &uv)
create new UV vertex to be used for faces
void setObjectMesh(int group_index, Mesh &mesh, const mat4 &transform=mat4::Identity)
replace the retopo layer with mesh
void updateNormals(bool for_snapping=true)
update the vertex normals
Model(const Mesh &source)
construct model from the Mesh object.
void selectObject(int group_index, bool add_to_selected=true)
select all feces in the group
void contractSelection()
contract the faces/vertices/edges selection to the connected geometry
const char * getObjectName(int group_index)
get the retopo group name
int getFaceUvVertex(int face, int vertex_index)
get the UV vertex index over the face
vec3 getVertexNormal(int vertex)
get vertex normal, calculated as average of adjacent faces normals
void setObjectVisibility(int index, bool visible)
set the group visibility
int addMaterial(const char *name)
add the new UV set/Material
void cleanup()
complete cleanul from non-manifolds or other problems, some faces may be removed
vec3 getVertex(int vertex)
get the vertex position in space
bool isSeam(int vertex1, int vertex2)
check if edge is seam
std::vector< int > getFaceNeighbors(int face)
get the list of faces that are adjacent to the face
void setObjectReferenceColor(int group_index, vec4 color)
set the group reference color
void selectedToFaces()
convert edges/vertices selection to faces selection
bool isEdgeSelected(int vertex1, int vertex2)
check if the edge is selected, order of vertices has no matter
void updateTopology()
update the connectivity information, it should be called sometimes if you feel that the connectivity ...
float getFaceUVSquare(int face)
get the face square in UV space
int getFaceUvVertsCount(int face)
get the amount of UV vertices over the face
void setFaceVisibility(int face, bool visibility)
set the face visibility
void meshToIsland(const Mesh &mesh, int uv_set, int island_index)
use the mesh (that was previously got by islandToMesh) to replace the island in the current uv-set
int createNewVertex(const vec3 &position)
create the positional vertex
std::vector< int > getBorderBetweenIslands(int uv_set1, int island_index1, int uv_set2, int island_index2)
get the border between two islands
void addTransformed(const Mesh &mesh, const mat4 &Transform=mat4::Identity, BoolOpType b=BOOL_MERGE, bool select=false, bool snap_to_existing=false)
insert the mesh to the retopo/modeling room, each object of the mesh treated as the new retopo layer
Model & transform(const mat4 &m)
transform the whole Model with the matrix
std::string generateName(const char *base)
generate unique name for the object, it will start as the string in base base
int getFaceVertex(int face, int vertex_index)
get the vertex index over the face
void expandSelection()
expand the faces/vertices/edges selection to the connected geometry
std::vector< int > getSelectedVertices()
get the list of selected vertices
void collapseEdge(int vertex1, int vertex2)
collapse the edge to the middle of the edge
std::vector< int > getPath(int vertex1, int vertex2)
get all vertices on the path from vertex1 to vertex2
void extrudeSelected()
Extrude the selected edges or selected faces without the actual moving of the extruded elements....
void selectedToVertices()
convert faces/edges selection to vertices selection
vec4 getObjectReferenceColor(int group_index)
get the group reference color
void transformSelected(const mat4 &transform, bool apply_symmetry)
apply the transformation to the selected elements
void toAbf(int uv_set, int island_index)
unwrap the island using the ABF approach
void displayOptions(bool showWireframe=true, bool showColored=true, bool showSeams=true, bool showSharpEdges=true, bool smoothView=false)
Set the display options for the retopo/modeling/uv meshes.
void setFaceUvVerts(int face, const std::vector< int > &vertices)
set the UV vertices for the face
void selectEdge(int vertex1, int vertex2)
select the edge by vertex indices (add to selection)
void moveSelectedFacesAlongFacesNormals(float displacement)
move selected faces along the faces normals, trying to keep faces parallel to the original direction
std::vector< int > getIslandBorder(int uv_set, int island_index)
get unsorted list of edges on the border of the island
Mesh islandToMeshInSpace(int uv_set, int island_index)
get the mesh that contains the island, each point is the coordinate in space (not the uv coordinate!...
Mesh getWholeMesh()
get the whole mesh from the retopo room
void setObjectName(int index, const char *name)
rename the group by index
vec2 getIslandVertexUv(int uv_set, int island_index, int vertex_index)
get the uv coordinate of the positional vertex in the island
void clearObjectMesh(int group_index)
remove all faces from the group
void unwrap(int uv_set)
unwrap the current uv-set
bool connect(int vertex1, int vertex2)
split existing edge somewhere between vertices.
bool isSharpEdge(int vertex1, int vertex2)
check if the edge is sharp
static Model fromModeling()
get the reference to the mesh in the modeling room, currently it is the same mesh as in the retopo ro...
bool getObjectVisibility(int index)
get the group visibility
Model()
construct the lowpoly mesh, it is completely independent on retopo/modeling/uv workspace....
void connectSelectedVerts()
connect selected vertices in smart way
bool isFaceSelected(int face)
check if the face selected
std::vector< int > getFaceUvVerts(int face)
get the list of UV vertices indices over the face
Model MakeCopy() const
make a copy of the source mesh. Pay attention, if you taken it from the retopo/uv context,...
void shell()
perform the shell operation over the selected faces. After calling the shell() you should call the mo...
bool checkConnectivity(int vertex1, int vertex2)
check if connecting the two vertices is possible
void clear()
clear the whole mesh
int vertsCount()
get the positional vertices count
int addObject(const char *name)
add new retopo group
void removeObject(int group_index)
remove the group by index
int islandsCount(int uv_set)
get the islands count over the current uv-set
void setFaceVerts(int face, const std::vector< int > &vertices)
set the list of positional vertex indices over the face
void selectVertex(int vertex, float weight=1.0f)
add the vertex to the selection
std::vector< int > getObjectFaces(int group_index)
get the list of faces in the group
int facesCount()
get the faces count
float getFaceSquare(int face)
get the face square
void setCurrentObject(int index)
set the current group index
static Model fromRetopo()
get the reference to the mesh in the retopo room
Mesh selectedToMesh()
get the selected faces as the Mesh object
void unselectAllFaces()
unselect all faces
void selectFace(int face)
select the face by index
std::vector< int > getSelectedEdges()
returns even amount of vertex indices, pairs os start and end vertices of the selected edges
void setVertex(int vertex, const vec3 &position)
set the vertex position in space
static Model fromUv()
get the reference to the mesh in the uv room, pay attention that topology changes to that mesh may le...
vec2 getVertexUV(int uv_vertex)
get the UV coordinates of the UV vertex
void removeFace(int face)
remove the face by index
Definition CoreAPI.h:2873
static void setExposure(float exposure)
set the exposure value for the rendering (in render room)
static void setDOFDegree(float degree)
set the depth of field (DOF) degree
static vec3 getLightColor(int idx)
get the light color for the additional light
static float getLightIntensity(int idx)
get the light intensity for the additional light
static void removeLight(int idx)
remove the additional directional light
static void setLightIntensity(int idx, float intensity)
set the light intensity for the additional light
static void enableRealtimeRendering(bool enable)
enable or disable the realtime rendering
static void setCustomRenderSize(int width, int height)
set the render output width
static int getRaysPerFrame()
get rays per frame for the rendering
static void setRenderResult(const char *filename)
set the render output filename
static void setAA(bool AA)
set the anti-aliasing (AA) rendering state
static vec3 getLightDirection(int idx)
get the direction for the additional light
static void removeAllLights()
remove all additional directional lights
static void restartRendering()
if the realtime render enabled the command will restart the rendering from scratch
static void setLightScattering(int idx, float scattering)
set the light scattering for the additional light
static void setEnvironmentLight(float envlight)
set the brightness of the environment light (spherical environment)
static void setRaysPerFrame(int count)
set rays per frame for the rendering
static void toRenderRoom()
get to the render room to be able to render
static void setLightColor(int idx, const vec3 &color=vec3::One)
set the light color for the additional light
static void setLightDirection(int idx, const vec3 &dir)
set the direction for the additional light
static float getEnvironmentLight()
get the brightness of the environment light (spherical environment)
static bool isRealtimeRenderingEnabled()
get the realtime rendering state
static float getExposure()
get the exposure value for the rendering (in render room)
static float getDOFDegree()
get the depth of field (DOF) degree
static void renderFrame()
render to the output file
static float getLightScattering(int idx)
get the light scattering for the additional light
static int getLightsCount()
get the amount of additional directional lighte
static int addLight()
add the additional directional light
static bool getAA()
get the anti-aliasing (AA) rendering state
The scene element, like sculpt object or curve.
Definition CoreAPI.h:1632
SceneElement duplicate() const
diplicate the item
void selectOne() const
unselect all similar elements and select this one
SceneElement findInSubtree(const char *name) const
find the element in subtree by name
bool iterateVisibleSubtree(const std::function< bool(SceneElement)> &fn) const
iterate over the visible subtree
SceneElement child(int index) const
returns child element by index
mat4 getTransform() const
get the scene element transform
void removeSubtreeItem(int index) const
remove one child from the subtree
bool ghost() const
returs the state of ghosting (if available)
void removeSubtree() const
remove the whole subtree
bool isParentOf(SceneElement child) const
check if the element is parent of another one
const SceneElement & density(float density_value) const
this command useful if you use voxels, it sets the scale for the volume so that there will be density...
void collectSelected(list< SceneElement > &elemList)
Collect the selected elements in the subtree (including this element if selected)
void setVisibility(bool visible) const
set the visibility of the element
const char * getLinkedPath(int id) const
get the linked file path
int childCount() const
returns the child elements count
bool iterateSubtree(const pybind11::object &fn) const
iterate over the subtree
const char * name() const
get the element name
void unselectAll() const
unselect all similar objects
const SceneElement & rename(const char *name) const
rename the element
void setGhost(bool ghost) const
sets the ghosting state (if available)
void select() const
add the object to selected
void changeParent(SceneElement newParent) const
change the parent element for the current one
void setReferenceColor(const vec4 &color)
set the reference color for the element
void mergeSubtree(bool booleanMerge=false) const
merge all subtree volumes into this
vec4 getReferenceColor()
get the reference color for the element
void addLinkedPath(const char *path) const
set the linked file path
bool & visible() const
returns own visibility state reference. It does not take into account that parent may be invisible.
const SceneElement & transform(const mat4 &Transform) const
Additional transform over the object.
SceneElement duplicateAsInstance() const
create the instance of the object if instancing supported
void copyMergeTo(SceneElement &dest, BoolOpType op)
copy and merge the volume to another one, delete this volume
SceneElement parent() const
get the parent scene graph element
bool iterateSubtree(const std::function< bool(SceneElement)> &fn) const
iterate over the subtree
Volume Volume() const
returns the volume object to operate over voxels or surface
bool selected()
Check if the scene element is selected.
const SceneElement & setTransform(const mat4 &Transform) const
Set the transform matrix.
std::vector< SceneElement > collectSelected()
Collect the selected elements in the subtree (including this element if selected)
void mergeTo(const SceneElement &dest, BoolOpType op)
merge the volume to another one, delete this volume
void remove() const
remove this item and all child objects from the scene
bool iterateVisibleSubtree(const pybind11::object &fn) const
iterate over the visible subtree
bool isSculptObject() const
Check if it is the sculpt object.
bool isCurve() const
Check if the element is curve.
const SceneElement & clear() const
Clear the element content.
int linkedObjectCount() const
get the linked file path
const SceneElement & transform_single(const mat4 &Transform) const
Additional transform over the object, not applied to child objects.
SceneElement addChild(const char *name) const
add the child element of the same nature
referes the roots of the scene graph
Definition CoreAPI.h:2508
static void setLayerBlending(int LayerID, int mode)
set the layer blending mode
static void RemoveUVSet(int idx)
Remove the UV-set (texture)
static SceneElement importMesh(const char *filename, const mat4 &transform=mat4::Identity)
import mesh into scene, it is the same as File->Import->Import mesh for vertex painting/reference ....
static void invertLayerMask(int LayerID)
invert the layer mask (if assigned)
static void setActiveLayer(int LayerID)
activate the layer
static const char * getLayerName(int LayerID)
get the layer name
static void mergeVisibleLayers()
merge all visible layers
static bool setSceneUnits(const char *units)
Set the scene units without actual scaling the scene to new units, just name change.
static vec3 getSceneShift()
get the scene shift value, look the Edit->Scale master->X,Y,Z
static void setLayerVisibility(int LayerID, bool Visible)
set the layer visibility
static void setLayerMetalnessOpacity(int LayerID, float Opacity)
set the layer metalness opacity
static int getLayerBlending(int LayerID)
get the layer blending mode
static void setCurrentLayer(int LayerID)
set the current layer
static void RemovePaintObject(int idx)
Remove the paint object.
static void ScaleSceneUnits(float scale)
Keep the scene visial size in scene, but scale the export size.
static float GetSceneScale()
the length of 1 scene unit when you export the scene
static const char * PaintMaterialName(int idx)
Get the reference to the material mane.
static void disableLayerMask(int LayerID)
disable the mask for the layer
static int getLayerMaskLayer(int LayerID)
get the mask identifier assigned to the layer
static void setSceneShift(const vec3 &shift)
set the scene shift value, look the Edit->Scale master->X,Y,Z
static void enableLayerMask(int LayerID)
enable the mask for the layer
static void ScaleSceneVisually(float scale)
Scale the whole scene visually but keep the export size.
static void mergeLayerDown(int LayerID)
merge the layer down
static void removeEmptyLayers()
remove all unused layers
static void setLayerGlossOpacity(int LayerID, float Opacity)
set the layer gloss/roughness opacity
static void extractMaskAsLayer(int LayerID)
If the layer has the mask attached, the mask will be extracted as a new layer and the masking disable...
static bool maskEnabled(int LayerID)
check if the mask is enabled for the layer
static void invalidateLayer(int LayerID)
refresh the layer appearance in scene
static int getCurrentLayer()
get current layer identifier
static void applyLayerBlending(int LayerID)
apply layer blending
static SceneElement current()
returns the current sculpt object
static const char * GetSceneUnits()
get the name of the current scene units
static void setMaskForTheLayer(int LayerID, int MaskLayerID)
set the MaskLayerID to be used as mask for the LayerID. The MaskLayerID will disappear among the laye...
static void enableLayerMask(int LayerID, bool enable)
enable or disable the layer mask
static void RemovePaintMaterial(int idx)
Remove the paint material.
static bool layerIsEmpty(int layerID)
Check if the layer is empty.
static const char * PaintObjectName(int idx)
Get the reference to the object name.
static int PaintUVSetsCount()
Get the paint UV-sets (textures) count.
static void setLayerName(int LayerID, const char *name)
set the layer name
static void clearScene(bool askUser=false)
clear the whole scene
static int assignLayerMask(int LayerID)
assign the mask to the layer if it is not assigned before
static bool convertSceneUnits(const char *destination_unit_name)
Convert the scene units to the new units, the scene scale will be changed, visual size will be kept.
static void setClippingLayer(int LayerID)
set this layer as clipping layer
static void removeLayerMask(int LayerID)
remove the layer mask
static std::vector< std::string > getAvailableUnits()
Get the list of all available units.
static void removeLayer(int LayerID)
remove the layer
static int getLayer(const char *name, bool addIfNotExists=true)
get the Layer ID by name, add the layer if not exists
static SceneElement sculptRoot()
get the root of all sculpt objects
static int PaintMaterialCount()
Get the count of paint materials.
static int PaintObjectsCount()
Get the count of paint objects in scene.
static SceneElement curvesRoot()
get the root of all curves
static bool isLayerMaskEnabled(int LayerID)
check if the mask is enabled for the layer
static const char * PaintUVSetName(int idx)
Get the reference to the UV set name.
static void disableClippingLayer(int LayerID)
disable the clipping layer
static void setLayerColorOpacity(int LayerID, float Opacity)
set the layer opacity
static bool layerVisible(int LayerID)
return the layer visibility
static void setLayerDepthOpacity(int LayerID, float Opacity)
set the layer depth opacity
The class intended to place spheres in space and identify if there are spheres around....
Definition CoreAPI.h:3259
int addSphere(const vec3 &p, float radius)
add the sphere into the space
void setUnit(float u)
set the cell size, the cell space should be empty
SphericalCollision(float cellsize)
create the collision space
void clear()
remove all spheres
vec3 collides(const vec3 &p, float radius)
check if sphere intersects other spheres in the space
vec4 sphere(int idx)
get the sphere parameters by index
Definition CoreAPI.h:1930
The class allows to operate over voxels/surface on the relatively low-level.
Definition CoreAPI.h:1940
static void roughness(float value)
assign the roughness for the voxel operations, it will work only if the color already assigned
void subtractMesh(Mesh &mesh, const mat4 &transform=mat4::Identity)
subtract the mesh from volume (boolean)
void removeFacesByWeight(std::function< float(const vec3 &)> weight)
Remove all faces where all the function returns the value < 0 for all the vertices over the face.
VolumeCell * cell(int cx, int cy, int cz, bool create, bool backup)
get the cell by cell coordinates, each cell is 8*8*8
float getInterpolatedValue(const vec3 &pos, bool fromBackup)
returns interolated voxels density
void scanCells(const std::function< void(VolumeCellAttrib *vc)> &fn, bool multithreaded=false)
run through all volume cells
void clearNoUndo()
Clear quickly, without affecting the Undo queue.
boundbox calcLocalSpaceAABB()
Calculate the Axis - Aligned Bound Box of the object in local space.
void relaxGpu(const vec3 &center, float Radius, float degree)
fast voxel-based relax within the sphere with the gradual falloff. It works only in voxel mode.
void relaxSurface(float degree, bool tangent=false, bool keep_sharp_boolean_edges=false)
relax the object in surface mode
static void gloss(float value)
assign the gloss for the voxel operations, it will work only if the color already assigned
SceneElement generateMoldingTest()
generate the figure that fills the gap between the molding shapes
static void setMoldingParams(const vec3 &direction, float tapering_angle=0, float undercuts_density=1.0f, float decimation_limit_millions=10, bool perform_subtraction=true)
set the parameters for the molding
static void enableVoxelsColoring(bool enable=true)
enable or disable the voxel-based coloring. It is applied wherever possible - merging models,...
float getVolume()
get the volume of this object in world coordinates
Volume & makeVoxelFigure(std::function< float(vec3)> densityFunction, const list< vec3 > &growCenters, bool Subtract=false, bool useTempLocation=false, bool overHidden=false, bool useColor=false)
This function is fast (generally realtime) way to fill the volume with voxels. Voxel Brush Engune com...
SceneElement findMoldingTop()
find the top molding shape (that was previously generated)
void mergeMesh(Mesh &mesh, const mat4 &transform=mat4::Identity, BoolOpType op=BOOL_MERGE)
merge the mesh into scene
void mergeMeshWithTexture(Mesh &mesh, const mat4 &transform=mat4::Identity, BoolOpType op=BOOL_MERGE)
merge the mesh with facture, the volume polygons will be hidden, just the texture will be shown (like...
float getSquare()
reg the square of this object in world coordinates
void toVoxels()
turn to voxels, auto-voxelize
void scanTriangles(const std::function< void(const MCVertex &v1, const MCVertex &v2, const MCVertex &v3)> &fn, bool multithreaded=false)
run through all triangles
void removeUndercuts()
remove undercuts for the current volume
VoxTreeBranch * tree()
returns the low-level object (VoxTreeBranch) for all low-level operations
void intersectWithMesh(Mesh &mesh, const mat4 &transform=mat4::Identity)
intersect the volume with the mesh (boolean)
void curveBasedMolding()
perform the curve-based mold
static void color(float r, float g, float b)
assign the color for the voxel operations
void setOpacity(float Opacity)
set the volume opacity
bool isVoxelized() const
Check if in voxel mode.
void assignShader(const char *shaderName)
set the shader for the Volume
void scanCells(const std::function< void(VolumeCellAttrib *vc, const tri_DWORD &T)> &fn, bool multithreaded=false)
run through all volume cells
void closeHoles(int maxSize)
Close the holes.
void scanCells(const std::function< void(VolumeCell *vc, const tri_DWORD &T)> &fn, bool multithreaded=false)
run through all volume cells
void addMesh(Mesh &mesh, const mat4 &transform=mat4::Identity)
add the mesh to volume (boolean)
VolumeCellAttrib * attributes(int cx, int cy, int cz, bool create, bool backup)
get the cell attributes by cell coordinates, each cell is 8*8*8, generally it is kept as VolumeCell::...
void scanTriangles(const std::function< void(const Vector3D &v1, const Vector3D &v2, const Vector3D &v3)> &fn, bool multithreaded=false)
run through all triangles
void generateMoldingCurves()
generate the automatic molding curves
void removeMoldingShapes()
remove all molding intermediate shapes, tests, etc.
static void color(float r, float g, float b, float a)
assign the color for the voxel operations
void clear()
Clear and pass to the Undo queue.
void relaxOpenEdges(int nTimes)
relax the open edges of the mesh, it is applicable only to the surface mode
void toSurface()
turn to surface mode, the triangles will be tangentially relaxed
static void setMoldingBox(float width, float length, float thickness)
set the molding bound box to be user-defined, not automatic
void assignLiveBooleans(int operation)
Apply the live booleans over the sculpt mesh, it is available for voxels only.
boundbox calcWorldSpaceAABB()
Calculate the Axis - Aligned Bound Box of the object in world space.
int getPolycount()
get the volume triangles count
void dirty(int cx, int cy, int cz)
mark the cell as dirty. This is required if you
static bool checkIfMoldingLicenseAvailable()
check if molding allowed
bool isSurface() const
Check if in surface mode.
void subtractWithoutUndecuts()
subtract the current undercutted object from the preliminary generated molding shapes
static void color(DWORD CL)
set the default color to fill voxels if the voxel coloring enabled
void basRelief(const vec3 &start_point=vec3::Zero)
perform the bas-relief for the current volume
SceneElement findMoldingTest()
find the test molding test shape (that was previously generated)
void relaxVoxels(int count)
relax the whole volume, works only for voxels
bool valid() const
checks if object is valid
void collapseBollTree()
collapse the boolean tree, it is available for this volume
void scanCells(const std::function< void(VolumeCell *vc)> &fn, bool multithreaded=false)
run through all volume cells
float getExactDencity(int x, int y, int z, bool fromBackup, VolumeCache &cache_ref)
returns the exact voxel density in local space at the exact integer location
void insertMesh(Mesh &mesh, const mat4 &transform=mat4::Identity)
insert the mesh into the volume, in case of voxels this is identical to addMesh, in case of surface,...
void automaticMolding()
perform the automatic molding
static void color(const char *colorid)
assign the color for the voxel operations
static void metal(float value)
the metalliclty value for the voxel operations, it will work only if the color already assigned
static void setAutomaticMoldingBox()
set the molding bound box to be automatic
SceneElement findMoldingBottom()
find the bottom molding shape (that was previously generated)
VolumeObject * vo()
returns the low-level object (VolumeObject) for all low-level operations
static void setMoldingBorder(float width=0)
set the molding border around the parting line to fade to the plane, if it is zero,...
SceneElement inScene()
Get the Volume placement in the scene.
the rich dialog. You may customize it, show your custom parameters and custom buttons.
Definition CoreAPI.h:3732
dialog & transparentBackground()
the background will not be faded
dialog & no()
add No button
dialog & process(std::function< void()> process)
pass the function/lambda that will be called each frame. But there is better way - override the Proce...
dialog & dontShowAgainCheckbox()
show the checkbox "Don't show again". If user checks if the dialog will net be shown next time and sh...
dialog & modal()
dialog will be modal. Generally, it is modal by default. Execution will be paused at show() till the ...
dialog & params(BaseClass *params)
The important core feature. BaseClass allows to create the custom controls in the dialog....
dialog & width(int w)
change the default width
dialog & noModal()
dialog will be no modal. Execution will continue after you will call the show()
dialog & onPress(std::function< void(int)> press)
pass the function/lambda that will be called when the button will be pressed. The button index (start...
dialog & undoWorks()
allow undo (CTR-Z) act even in modal dialog
dialog & ok()
add Ok button
dialog & cancel()
add Cancel button
dialog & warn()
add Warning icon
dialog & process(pybind11::object callback)
pass the function/lambda that will be called each frame.
int show()
Show the dialog. This is usually the last command in the chain.
dialog & caption(const char *id)
pass the caption of the dialog
dialog & question()
add Question icon
dialog & topRight()
place the dialog at the top-right position of the viewport
dialog & yes()
add Yes button
dialog & buttons(const char *list)
pass the list of buttons for the dialog
dialog & text(const char *id)
pass the header text of the dialog
dialog & params(pybind11::object params)
The important core feature. Pass the object to display object parameters in UI. Look the dialog examp...
static bool & fadeDialogsBackground()
returns the reference to the global property - fade modal dialogs background (true) or not (false)
General I/O access.
Definition CoreAPI.h:4023
static vec2 snappedCursorPos()
returns the snapped cursor position
static void showPythonConsole()
Show the python console, clear it and pop up.
static void pipInstall(const char *requirements)
install one or multiple python packages
static std::vector< std::string > openFilesDialog(const char *extensions)
open multiple files dialog
static void ListFiles(const char *folder, const char *mask, coat::list< coat::str > &result, bool recursive=true)
list files in the folder
static std::string toJson(const pybind11::object &obj, const char *filename="")
Store the object to the file or string as json.
static std::string strFromFile(const char *filename)
read string from file.
static bool openFilesDialog(const char *extensions, list< str > &fileNames)
open multiple files dialog
static std::string getFileName(const char *filepath)
get the file name from the path
static std::string getExtension(const char *filepath)
get the file extension (without .)
static void createRedistributablePackageFromFolder(const char *folder, const char *package_name, const char *excluded_folders_names="", const char *excluded_extensions="")
Create the 3dcpack file from the folder placed in Documents.
static std::string toFullPathInDataFolder(const char *path)
convert the relative path to full path in documents folder. If the path is full and placed in the ins...
static void step(int count=1)
perform rendering cycles
static void restoreObjectFormJsonString(pybind11::object &obj, const char *data)
Restore the object from the json string.
static void progressBarInWindowHeader(float stage, float max_stage, const char *message)
Show the progress bar only in the 3DCoat's window header.
static void exec(const char *command, const char *arguments=nullptr)
execute command. It may be exe file, URL, batch command
static void executeScript(const char *path)
execute python (.py file) or angelscript (c++ like), or CoreAPI (native C++) script
static void post_request(const char *url, const char *data, const char *headers, const std::function< void(const char *)> &report_success=nullptr, const std::function< void(const char *)> &report_error=nullptr)
send the post request to the url
static const char * supportedImagesFormats()
returns the currently supported mesh export formats
static std::vector< std::string > listBlenderInstallFolders()
list the blender install folders
static void fromJsonFile(pybind11::object &obj, const char *filename)
Restore the object from the json file.
static void copyFolder(const char *src, const char *dest)
copy the whole folder from src to dest. If the src or dest is relative, it is relative to the documen...
static std::string getFileNameWithoutExtension(const char *filepath)
remove the file extension from the filename
static const char * currentSceneFilepath()
returns the current scene filename, empty if the scene was not saved/opened
static std::string getFilePath(const char *filepath)
get the file path without the filename
static std::vector< std::string > ListFolders(const char *startFolder)
list folders within the folder, non-recursive, just plain list
static void setWindowTitle(const char *text, float seconds)
Override the 3DCoat's window title for some amount of time.
static rect wholeScreen()
get the whole screen rectangle
static bool openFileDialog(const char *extensions, str &fileName)
show the file dialog
static void get_request(const char *url, const char *headers, const std::function< void(const char *)> &report_success=nullptr, const std::function< void(const char *)> &report_error=nullptr)
send the get request to the url
static std::string convertToWritablePath(const char *path)
If the path is relative or points into some file in the install folder, it will be converted to the p...
static void ListFolders(const char *startFolder, coat::list< coat::str > &result)
list folders within the folder, non-recursive, just plain list
static int getDownloadProgress()
returns the overall download progress
static void removeFolder(const char *folder)
remove the folder. If the folder is relative, it is relative to the documents folder....
static void saveScreenshot(const char *filename, int x=0, int y=0, int width=0, int height=0)
save the screenshot to the file
static rect workArea()
get the work area rectangle
static std::vector< std::string > ListFiles(const char *folder, const char *mask, bool recursive=true)
list files in the folder
static std::string pythonPath()
get the python libraries folder
static vec2 cursorPos()
returns the current cursor position
static void copyFile(const char *src, const char *dest)
copy the file from src to dest. If the src or dest is relative, it is relative to the documents folde...
static void installRequirements(const char *path_to_requirements_txt)
Install all the requirements for the python script execution.
static std::string convertToWritablePathIfFileExists(const char *path)
If the path is relative or points into some file in the install folder, it will be converted to the p...
static bool fileExists(const char *path)
check if file exists
static size_t getFileSize(const char *filename)
get the file size
static void download(const char *url, std::function< void(const char *, const char *)> report_success)
download the file from the url
static bool saveFileDialog(const char *extensions, str &fileName)
show the save file dialog
static void updateCoatPyi(const char *folderOrFile)
update the .pyi file for the given folder or py file
static const char * dataPath()
the 3DCoat data path
static void removeFile(const char *filename)
remove the file. If the filename is relative, it is relative to the documents folder....
static const char * execAndWait(const char *command, const char *arguments=nullptr)
execute and wait till finished, the console output will be returned as string
static const char * documents(const char *path)
convert the relative path to the path in documents, if the path is absolute, just return the original...
static const char * installPath()
the 3DCoat installation path
static std::string toFullPathInInstallFolder(const char *path)
convert the relative path to the full path in the install folder. If the path is full,...
static const char * supportedMeshesFormats()
returns the list of supported images formats
static void strToFile(const char *text, const char *filename)
write the string to file
static void progressBar(float stage, float max_stage, const char *message)
Show the progress bar.
Definition CoreAPI.h:5800
void showMessage()
show the accumulated log in the message box
logger & floatPrecission(int signs=2)
set the precission of floating-point output
logger & flush()
save all acumulated text to the file
void open()
open the accumulated log in the default text editor
logger & directTo(const char *filename)
Direct the log output to the file
logger & timestamp()
add the timestamp to the log as the
logger & endTimer()
stop the timer and output the time into the log as amount of microseconds
logger & newline()
start newline in the text file
logger & startTimer()
start the timer to profile some operation
logger()
create the logger object. You may call directTo later and flush the output there. Otherwise,...
str getFullPath()
Returns the absolute path to the log file.
logger(const char *filename)
create the logger object and direct the output there
logger & format(const char *format,...)
send the formatted message
this class represents different resources accessible in UI - alphas, strips, materials,...
Definition CoreAPI.h:3917
std::string getCurrentItem()
returns the current item name (if possible)
void removeItem(const char *itemName)
remove the item from the current folder
std::vector< std::string > listFolders()
list folders of the resource type referred by this object
std::string currentFolderFullPath()
full path (relative to the 3DCoat's documents) to the current folder files
static std::vector< std::string > listAllResourcesTypes()
list all available resources types
void setCurrentFolder(const char *folder)
set the current folder (short name without the full path)
void moveItemToFolder(const char *itemName, const char *destFolderName)
move the item to another folder
void createFolder(const char *folderName)
create the folder and switch there
void selectItem(const char *itemName)
select/activate the item in the current folder
std::vector< std::string > supportedExtensions()
get the list of supported extensions for the resource type referred by this object
void addItem(const char *itemPath)
add the item to the current folder
std::vector< std::string > listCurrentFolderItems()
get the list of all items in the current folder
std::string currentFolder()
get the current folder short name
std::string rootPath()
the root path (relative to the 3DCoat's documents) to the resource type referred by this object
resource(const char *id)
create the reference to some resource type to access it and operate with it
void removeFolder(const char *folderName)
remove the folder and switch to the root folder if this is the current folder
Definition CoreAPI.h:2406
static std::vector< std::string > listAllSettings()
get the list of all available settings
static float getFloat(const char *ID)
get the float value from the settings
static bool setString(const char *ID, const char *value)
set the string value to the settings
static void pressButton(const char *button_name)
triger some action in settings
static void resetSettings(bool ResetGeneralSettings=true, bool ResetHiddenSet=true, bool ResetHotkeys=true, bool RestNavigation=true, bool ResetPresets=true, bool ResetTheme=true, bool ResetWindows=true)
reset all settings to default values, application will restart
static bool getBool(const char *ID)
get the boolen value from the settings
static std::string getString(const char *ID)
get the string value from the settings
static void saveSettings()
save all changed settings
static int getInt(const char *ID)
get the integer value from the settings
static bool setFloat(const char *ID, float value)
set the float value to the settings
static bool setInt(const char *ID, int value)
set the integer value to the settings
static bool valueExists(const char *ID)
returns true if the value in settings exists
static bool setBool(const char *ID, bool value)
set the boolean value to the settings
Definition CoreAPI.h:1370
static std::vector< comms::cPlane > getCurrentPlanes()
Returns all symmetry planes using the current symmetry state.
static symm & translation(int numX, float stepX, int numY, float stepY, int numZ, float stepZ)
Enable the translation symmetry.
static symm & xyz(bool x, bool y, bool z)
Enable the XYZ-mirror symmetry.
static symm & enable(bool _enable=true)
Enable the symmetry.
static vec3 & start()
get the start point reference
static symm & axialMirror(int n, bool extraMirror=false, bool stepSymmetry=false)
Enable the axial mirror symmetry.
static bool & stepSymmetry()
returns the state of step symmetry
static bool & x()
check x symmetry state
static symm & getCurrentTransforms(list< mat4 > &symmetryTransforms)
Returns all transforms using the current symmetry state.
static bool & z()
check z symmetry state
static symm & setCustomSymetryTransforms(list< mat4 > &symmetryTransforms)
enable the custom symmetry, provide the symmetry transfoms
static bool & y()
check y symmetry state
static int & axialOrder()
returns the axial symmetry order if axial or axial mirror symmetry enabled
static std::vector< mat4 > getCurrentTransforms()
Returns all transforms using the current symmetry state.
static symm & getCurrentPlanes(list< comms::cPlane > &planes)
Returns all symmetry planes using the current symmetry state.
static symm & setCustomSymetryTransforms(pybind11::list &symmetryTransforms)
enable the custom symmetry, provide the symmetry transfoms
static symm & showSymmetryPlane(bool show=true)
Show or hide the symmetry planes.
static float & stepZ()
returns the reference to the z-step if the translational symmetry used
static symm & toGlobalSpace()
set the symmetry to be in global space
static bool & extraMirror()
returns the state of extra mirror, this is valid only tor the axial symmetry
static symm & toLocalSpace()
set the symmetry to be in local space
static int & numY()
returns the reference to the number of the y repeats if the translational symmetry used
static symm & disable()
disable the symmetry
static bool is_axial()
Check if the axial symmetry enabled
static symm & axial(int n, bool extraMirror=false, bool stepSymmetry=false)
Enable the axial symmetry.
static symm & set_start(const vec3 &pos)
set the central point for the symmetry
static int & numX()
returns the reference to the number of the x repeats if the translational symmetry used
static void enableGlobally()
Enable symmetry (preliminary disabled by disableGlobally)
static bool is_xyz()
check if the XYZ symmetry enabled
static symm & toGeneral()
set the symmetry to general case
static symm & set_end(const vec3 &pos)
set the end point for the symmetry axis, calling this function enables the general case of the symmet...
static void disableGlobally()
Totally disable symmetry, don't forget to enable after all operations!
static vec3 & end()
the end point reference
static bool isCustomSymmetry()
Check if the custom symmetry used.
static int & numZ()
returns the reference to the number of the z repeats if the translational symmetry used
static float & stepX()
returns the reference to the x-step if the translational symmetry used
static bool is_translation()
Check if the translation symmetry enabled.
static bool isAxialMirror()
Check if the axial mirror symmetry enabled.
static float & stepY()
returns the reference to the y-step if the translational symmetry used
text primitive
Definition CorePrimAPI.h:1735
operate over the Coat's ui
Definition CoreAPI.h:3312
static const char * roomName(int index)
get the room name by index
static void toolParam(BaseClass *B)
show the class B as the part of the tools params panel
static bool checkIfMenuItemInserted(const char *ID_in_menu)
Check if the command inserted somewhere into the menu.
static std::string inputString(const char *text, int min_length=0)
input text under the mouse position
static void toRoom(const char *name, bool Force=false)
switch to the room
static void insertInMenu(const char *Menu, const char *ID_in_menu, const char *script_path)
Insert the scripted command into the main menu.
static void apply()
pess ENTER, acts as Apply usually
static bool setBoolValue(const char *id, bool value)
Set the value for the checkbox in UI.
static void removeToolParam(BaseClass *B=nullptr)
remove the class from the tools params
static int roomsCount()
returns the rooms count
static void setFileForFileDialog(const char *filename)
Set the file for the next file dialog that will be triggered by user. If you will use coat::ui:cmd(....
static void enablePenChannel(int i, bool enabled)
enable or disable the pen channel
static const char * getOption(const char *id)
get the option from preferences
static bool getBoolField(const char *id)
Get the bool field from the checkbox in UI.
static int inputInt(int initial_value)
input the integer value under the mouse position
static const char * roomID(int index)
get the text identifier of the room
static float inputFloat(float initial_value)
inputh the float value under the mouse position
static bool isInRoom(const char *name)
check if we are in the specified room
static void addExtension(const char *roomID, const char *section, pybind11::object &obj)
Add the extension (new tool) into the room. Look the GeneratorExample.py.
static bool setEditBoxValue(const char *id, float value)
set the edit box value
static const std::string getIdTranslation(const char *id)
Get the translation for the text identifier.
static bool setEditBoxValue(const char *id, int value)
set the edit box value
static bool isEnabledPenChannel(int i)
check if the pen channel is enabled
static bool cmd(const char *id, std::function< void()> process_in_modal_dialog=0)
execute some action in UI as if you pressed on some control
static bool setSliderValue(const char *id, float value)
Set the value for the the slider (if exists in UI)
static void hideDontShowAgainMessage(const char *id)
Hides the "Don't show again dialog" for the current session (not forever)
static void addTranslation(const char *id, const char *text)
Add the translation for the text identifier.
static void showInfoMessage(const char *infoID, int milliseconds)
Show the floating information message for the some time period.
static const char * currentRoom()
get the current room name
static float getSliderValue(const char *id)
get the value of the slider
static bool wait(const char *id, float max_seconds)
wait till the element id will appear in the UI. The element will not be clicked. The max wait time is...
static bool getEditBoxValue(const char *id, str &result)
get the edit box value
static void removeCommandFromMenu(const char *ID_in_menu)
remove the command from the menu
static void insertInToolset(const char *roomID, const char *section, const char *toolID, const char *script_path="")
Insert the script-based tool into the toolset.
static bool setOption(const char *id, const char *value)
set the value to preferences
static bool checkIfExtensionPresent(const char *extension_ID)
Check if extension named as extension_ID is present in the 3DCoat.
static void switchToLanguage(const char *language)
Switch the layout to the language.
static bool cmd(const char *id, pybind11::object fn=pybind11::none())
execute some action in UI as if you pressed on some control
static bool presentInUI(const char *id)
Check if the elemnt present in the UI.
static bool setEditBoxValue(const char *id, const char *value)
set the edit box value
static const std::string getCurrentLanguage()
Get the current language file name (without the XML extension)
static void highlight(const char *id, float milliseconds)
highlight the UI element for a while
static float scale()
returns the scale in comparison to the smallest UI theme
Definition CoreAPI.h:4435
static float getFPS()
get the current FPS
static void set(const char *key, const char *value)
Globally set the value for the key, it is even stored between sessions of the 3DCoat.
static float getFrameTimeMs()
get the frame time in milliseconds
static void testSuccessful()
report that the test was successful. In this case the file "InstallFolder/.installer/test_success....
static void testFailed(const char *message)
report that the test was successful. In this case the file "InstallFolder/.installer/test_failed....
static void clearEnum(const char *enumID)
clear the global strings list.
static int getEnumValueIndex(const char *enumID, const char *key)
get the index of the value in the global strings list. That lists used in dropdown boxes in UI
static bool inRenderProcess()
check if the viewport is in render process in render room
static const char * getEnumValueByIndex(const char *enumID, int index)
get the value from the global strings list by index. That lists used in dropdown boxes in UI
static void quit()
exit the 3DCoat
static vec4 dwordToVec4(unsigned int d)
convert DWORD (unsigned int) to vec4
static unsigned vec4ToDword(const vec4 &v)
convert vec4 to DWORD (unsigned int)
static vec3 randomNormal()
get the normalized random vector
static void addEnumValue(const char *enumID, const char *key, int value=- 1)
add the value to the global strings list.
static float random01()
get the random value 0..1
static const char * get(const char *key)
Get previously stored value by the key.
static float perlin(vec3 p, float seed=0)
generate the perlin noise value
static float random(float min, float max)
get the random value in range
static int getEnumValuesCount(const char *enumID)
get the count of the values in the global strings list. That lists used in dropdown boxes in UI
static void randomize(int seed)
set the random seed for all further random value generation
static void signal(const char *message)
send some message to 3DCoat (usually used for internal purposes)
static int getEnumValue(const char *enumID, const char *key)
get the integer value that corresponds to the string value from the global strings list.
static std::vector< std::string > & last_signals()
get the list of last signals sent to 3DCoat
static vec3 perlin3d(vec3 p, float seed=0)
returns the perlin noise 3d vector
The UV API. The mesh is taken from the current room. If paint or UV rooms is active,...
Definition CoreAPI.h:4602
static void toUvSet(int uv_set, int island_index, int destination_uv_set)
move the island from one uv-set to another one
static std::vector< int > getSeams()
get all seams across the mesh
static Mesh getWholeMesh()
get the whole mesh from the paint/UV/Retopo room - in dependence on current room
static int islandsCount(int uv_set)
get the islands count over the current uv-set
static void toPlanar(int uv_set, int island_index)
unwrap the island using the Planar approach
static void addSeam(DWORDS2 start_vertex_index, int end_vertex_index)
add the seam to the mesh
static void toLscm(int uv_set, int island_index)
unwrap the island using the LSCM approach
static std::vector< int > getIslandVertexMapping(int uv_set, int island_index)
get the mapping from the vertex index in the mesh that was got by islandToMesh to the vertex index in...
static std::vector< int > getIslandBorder(int uv_set, int island_index)
get unsorted list of edges on the border of the island
static Mesh flattenSingleIsland(const Mesh &mesh, int method, bool optimize_rotation=true, bool scale_to_geometry=true)
Flatten the mesh that consists of the single island.
static Mesh selectedToMesh()
get the selected faces as the Mesh object
static void unwrapUnassigned()
re-wrap/extend islands in correspondence to the changed seams and inserted faces. Pay attention,...
static void removeSharpEdge(int start_vertex_index, int end_vertex_index)
remove the sharp edge from the mesh
static Mesh islandToMeshInSpace(int uv_set, int island_index)
get the mesh that contains the island, each point is the coordinate in space (not the uv coordinate!...
static Mesh islandToMesh(int uv_set, int island_index)
get the mesh that contains the island, xy of each point is the UV coordinate. The mesh contains only ...
static void setUnwrapIslandsDistance(float distance)
set the border around the islands when we pack it
static vec2 getIslandVertexUv(int uv_set, int island_index, int vertex_index)
get the uv coordinate of the positional vertex in the island
static void toAbf(int uv_set, int island_index)
unwrap the island using the ABF approach
static void applyUVSet()
apply uv changes to the paint room mesh (if we use uv/paint context)
static int currentUvSet()
get the current uv-set index
static float getUnwrapIslandsDistance()
get the border around the islands when we pack it
static void meshToIsland(const Mesh &mesh, int uv_set, int island_index)
use the mesh (that was previously got by islandToMesh) to replace the island in the current uv-set
static void unwrap(int uv_set)
unwrap the current uv-set
static std::vector< int > getSharpEdges()
get the sharp edges across the mesh
static void addSharpEdge(int start_vertex_index, int end_vertex_index)
add the sharp edge to the mesh
static void removeSeam(int start_vertex_index, int end_vertex_index)
remove the seam from the mesh
static int uvSetsCount()
get the UV-sets count.
static void toGu(int uv_set, int island_index)
unwrap the island using the GU (Globally Uniform) approach
static void toStripe(int uv_set, int island_index)
try to uwrap the island as the regular stripe
static std::vector< int > getBorderBetweenIslands(int uv_set1, int island_index1, int uv_set2, int island_index2)
get the border between two islands
static void pack(int uv_set, bool rotate, bool shuffle)
pack the islands in the current uv-set
The coat namespace used for most 3DCoat API calls except low-level internal structures.
Definition CoreAPI.h:43
bool gltf_support()
gltf export supported
comms::cVec3 vec3
3D - float vector, see the cVec3
Definition CoreAPI.h:50
void menu_separator()
add the separator to the current menu, this command may be called only from the menu making script
BoolOpType
Boolean operations type.
Definition CoreAPI.h:87
@ BOOL_SUBTRACT
boolean subtract
Definition CoreAPI.h:93
@ BOOL_ADD
boolean add
Definition CoreAPI.h:91
@ BOOL_MERGE
just merge, no booleans, it may be used only in surface mode
Definition CoreAPI.h:89
@ BOOL_INTERSECT
boolean intersect
Definition CoreAPI.h:95
bool IsInTool(const char *ToolID)
check if we are in some tool
bool is_new_scene()
is the scene new/empty?
void insert_extensions()
insert extensions into the toolset (may be used only from the toolset.py)
bool UseRecordScript()
check is scripts recording available
bool voxtree_object_picked()
check if the sculpt object is picked in the viewport
int GetCurrentToolSubmode(const char *id)
get the current tool submode (usually for the uv/retopo tools)
void set_space_panel_columns_count(int num)
set the space panel columns count (only for the toolset.py)
void menu_sort()
sort items in the current menu
void menu_item(const char *id)
add the item to the menu, this command may be called only from the menu making script
void menu_info(const char *id)
add the information item to the menu (without any action, just message), this command may be called o...
bool is_surface()
check if the current sculpt object is in surface mode
comms::cVec4 vec4
4D - float vector, see the cVec4
Definition CoreAPI.h:47
void start_main_menu(const char *id)
strat the main menu root items, this command may be called only from the menu making script
bool is_ptex()
check if ptex is used in the current scene
bool ue5_support()
returns if ue5 support enabled
void tools_item(const char *id)
add the item to the tools section (toolset.py)
bool RoomExists(const char *name)
check if the room exists
bool iconic_submenu(const char *id, int size)
start the menu that will be shown on the icon click, like the navigation menu
bool is_mv()
check if mv objects available in scene
void show_space_panel(const char *Subset, int NumColumns)
show the space panel (with limitations if need)
comms::cVec2 vec2
2D - vector, see the cVec2
Definition CoreAPI.h:56
bool voxtree_item_picked()
check if the VoxTree item is picked
comms::cMat4 mat4
4x4 float matrix, see the cMat4
Definition CoreAPI.h:59
void default_tool(const char *tool)
set the default tool for the toolset.py
ClusterScale
the parameters to be used for cluster scaling in Model, scaleSelectedFacesClusters
Definition CoreAPI.h:4829
void tools_section(const char *id)
start the tools section in the toolset.py
bool IsDebug()
is Debug mode (for developers only)
int tex_approach()
returns the texturing approach index (from the Textures menu)
bool doc_mode()
check if script is in auto-documenting mode (legacy)
bool is_medical()
check if the app is medical
void menu_exit()
finish the current submenu, this command may be called only from the menu making script
bool is_multires()
check if the current sculpt object is on some multiresolution level
void SetAutoSnapDefaults(bool value)
set the default value for auto-snapping, usually for the retopo/modeling rooms (in toolset....
void show_rmb_panel()
show the rmb panel
void menu_hotkey(const char *id, int Shift, int Ctrl, int Alt)
set the hotkey for the menu item, this command may be called only from the menu making script
void page_suffix(const char *suffix)
set the additional suffix for the page in the toolset.py
bool IsRecordScript()
is the script recording enabled?
bool empty_space_picked()
check if no object is picked
comms::cRect rect
rect float, see the cRect
Definition CoreAPI.h:73
void start_rmb_panel()
start the RNB panel. This command may be called only from the RMB response making script (curves....
comms::cVec3i vec3i
3D - int vector, see the cVec3i
Definition CoreAPI.h:53
bool is_steam_app()
is it steam app?
comms::cList< X > list
the array template, see cList
Definition CoreAPI.h:70
void extensions_main_menu()
insert extension menu into the main menu
bool lock_ui_changes()
check if UI changes locked (for specialized applications, like printing)
comms::cMat3 mat3
3x3 float matrix, see the cMat3
Definition CoreAPI.h:62
bool retopo_object_picked()
the retopo object is picked
bool menu_submenu(const char *id)
add the submenu to the current menu, this command may be called only from the menu making script
bool is_proxy()
check if current sculpt object is in proxy mode
bool IsInRoom(const char *name)
check if you are in some room
bool is_ppp()
chack if there are any ppp objects in scene
comms::cStr str
the string that is compatible with the 3DCoat engine, see the cStr
Definition CoreAPI.h:67
void menu_insert_extensions(const char *id)
insert extension into the main menu (may be called only from the menu making script)
void tools_comment(const char *id)
comment in toolset.py for auto-documentation (legacy)
bool menu_property(const char *id)
returns boolean property value
void PureIconic()
enable the radial menu mode for the space panel
bool CheckIfExists(const char *path)
check if the file exists