From c5d5a564c85c13ab700c04e82067194f336c206c Mon Sep 17 00:00:00 2001 From: Mats Honkamaa Date: Mon, 11 Sep 2023 10:05:08 +0300 Subject: [PATCH] Doc: Document snapping Document the new snapping function. Also small typo fix. Task-number: QDS-10526 Change-Id: I1f11e6485c6445e1357e9cd042205428c7bd1270 Reviewed-by: Inkamari Harjula Reviewed-by: Miikka Heikkinen --- .../images/icons/snapping-3d-conf.png | Bin 0 -> 1912 bytes .../images/icons/snapping-3d.png | Bin 0 -> 1854 bytes .../qtdesignstudio-3d-editor.qdoc | 41 +++++++++++++++++- 3 files changed, 40 insertions(+), 1 deletion(-) create mode 100644 doc/qtdesignstudio/images/icons/snapping-3d-conf.png create mode 100644 doc/qtdesignstudio/images/icons/snapping-3d.png diff --git a/doc/qtdesignstudio/images/icons/snapping-3d-conf.png b/doc/qtdesignstudio/images/icons/snapping-3d-conf.png new file mode 100644 index 0000000000000000000000000000000000000000..bf57f857be199e9b5787d9f09fa354f71a7b6902 GIT binary patch literal 1912 zcmeAS@N?(olHy`uVBq!ia0y~yU=RRd4kiW$h6xih%orFLI14-?iy0XBj({-ZRBb+K z1_n06%#etZ2wxwokg&dz0$52&wylyQ$U=n(-v9;Y{GwC^OFcu~WCH_31#?TiM2i#?b5mm-1tS9^ zV|@c-eIsLC0}CrtGb>|r1t?ImQ?MyYNwW%aaf4b`l#*tvlu=SrV5P5LUS6(OZmgGI zl&)`RX=$l%V5Dzkq+67drdwQ@SCUwvn^&w1Gr=XbIJqdZpd>RtPXT0NVp4u-iLH_n z)YyvL0=Thx#n5m{&d=4aNG#Ad)H4A23GCUFWVpJ5(xM!&kGF7t6Oq&;Z_uvxR#aRS6v)ZS&*t9lvXKNJYO4f_ zHC+QsT?2~{14}DILn}iAZ3AN~0|SUs-~5!!v`TDBjSZ{}O;D7kmL#SmmLw8XoRVyn zmS2>cSYoS`nVXoNs$YpKqU6%`B5sj13c0jFJ$h`4?rT zXXYj5Ae#zuRZ3=xRf<_!lDWBgs%~1Mk%4ZCnTe@xQeskyu34gqxmj9TQlepsF(@^I z6Nr^ZW^qY=Q6)5g1g924Svi>s;51>Cm<&qmwo1vMNKQ>rf(mD12@j%dhUzcRNX^3= z`4HQS^V3So6N^$E(^K9Z=B!*o<;oY3s~{(vKmdKI;Vst0FxShhX4Qo literal 0 HcmV?d00001 diff --git a/doc/qtdesignstudio/images/icons/snapping-3d.png b/doc/qtdesignstudio/images/icons/snapping-3d.png new file mode 100644 index 0000000000000000000000000000000000000000..a434305e257346110d09e2164ec55eced830993b GIT binary patch literal 1854 zcmeAS@N?(olHy`uVBq!ia0y~yU=RRd4kiW$h6xih%orFLI14-?iy0XBj({-ZRBb+K z1_svMnIRD+5xzcF$@#f@i7EL>sd^Q;1q>iyV_#8_n4FzjqL7rDo|$K>^nUk#C56ls zTcvPQUjyF)=hTc$kE){7;3~h6MhI|Z8xtBTx$+|-gpg^Jvqyke^gTP3i$ zR(Zu%AYpwa1+bEmY+EHqkcA2nz5xo(`9-M;mU@P|$p!|73g(u2i54j)=BCCv3PuJ- z#`*@v`bNgO1{PMPW>&`L3Q(YAr(jc*l4cd;;s&*>C?(BSDWjyMz)D}gyu4hm+*mKa zC|%#s($Z4jz)0W7NVg~@O}Dr*uOzWTH?LS3W`avc7m0xRdD)WnkfqLBRj99T>Rz?`gLWTI!Tpb?&#my%yztcj!{)g`ec)m8}< zYq|!Ox&{^@29{QahE|3K+6Kl}1_ltNzWFJcX_eTN8W~!dnxiO9ElEsCEJ-A&I3?LC zEx#x?vBXv>GdD3kRlguFT}c5Rj8@M1Ir&At`6;QkO2%MU`1)FT<`tJD<|U_ky4WgJ zRKk7Sm;_N8l>nNr=+BsB`2CDnL~Zy>ucqbpIi!x zS(yHm%oHn2V@pFrb7M2zL=y`m-83T;LtP8wL{nWe^F*^0Ln9+Y12apQ{r*Ln>6v+n zIb@py%5b10VdaroT#{c@3C$6~sfAEhPNo7l6<8%EgHpGxQZgu7Q&W_n!kJh?fH)sO zj4jVd&BGhr5M{;rX(i=}MX8SIsd*&?laoF!#}_A-;deT5kq2=THm9Q`KZr8YoDL1v zUta`}*4CijR+u zo}8@Sx$()}+uPse<@r2%^e8PYZN6QtRlx^^I`11dZ`S|+%iY_)zy9Bs?_bwOY-H+h z`z~+)si4@|l!J@&>>R`7pPN!EzU18BC;LKdN*VkKKUcSCIT3tco q#KCiXCRa~gGSb)gkBpSm;AXh+bj})%J;GL?8qU+z&t;ucLK6UQ3xZ7m literal 0 HcmV?d00001 diff --git a/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-editor.qdoc b/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-editor.qdoc index d86d1f55249..454a7a0845d 100644 --- a/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-editor.qdoc +++ b/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-editor.qdoc @@ -183,7 +183,7 @@ and drag the component along the axis. \li To move components on a plane, click the plane handle and drag the component on the plane. - \li To move an component freely in the 3D view, click and drag the gray + \li To move components freely in the 3D view, click and drag the gray handle at the center of the move gizmo. \endlist @@ -221,6 +221,35 @@ gray handle at the center of the component. \endlist + \section1 Snapping + + With snapping turned on, the objects in the \uicontrol 3D view snap to certain + intervals during transformation (move, rotate, scale). + + You can toggle snapping in the following ways: + + \list + \li Select \inlineimage icons/snapping-3d.png + in the \uicontrol 3D view toolbar. + \li Hold down the \key Ctrl key. + \endlist + + With snapping turned on, you can press and hold \key Shift to snap objects to one tenth of + the specified snap interval. + + \section2 Configuring Snapping + + To edit snapping settings, select \inlineimage icons/snapping-3d-conf.png + in the \uicontrol 3D view toolbar. + + In the configure dialog, you can do the following: + \list + \li Turn on and off snapping separately for the different transformations + (move, rotate, scale). + \li Set snap intervals. + \li Toggle if the position snaps to absolute or relative values. + \endlist + \section1 Aligning Views and Cameras To align a camera to the \uicontrol{3D} view: @@ -375,6 +404,16 @@ \li Toggle Edit Light On/Off \li \key U \li \l{Using Edit Light} + \row + \li \inlineimage icons/snapping-3d.png + \li Toggle Snapping During Node Drag + \li \key Shift + \key Tab + \li \l{Snapping} + \row + \li \inlineimage icons/snapping-3d-conf.png + \li Open Snap Configuration Dialog + \li + \li \l{Configuring Snapping} \row \li \inlineimage icons/align-camera-on.png \li Align Selected Cameras to View