Files
OpenFOAM-12/applications/utilities/surface/surfaceTransformPoints/surfaceTransformPoints.C

131 lines
4.6 KiB
C++

/*---------------------------------------------------------------------------*\
========= |
\\ / F ield | OpenFOAM: The Open Source CFD Toolbox
\\ / O peration | Website: https://openfoam.org
\\ / A nd | Copyright (C) 2011-2021 OpenFOAM Foundation
\\/ M anipulation |
-------------------------------------------------------------------------------
License
This file is part of OpenFOAM.
OpenFOAM is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License
along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
Application
surfaceTransformPoints
Description
Transform (translate, rotate, scale) a surface.
Usage
\b surfaceTransformPoints "\<transformations\>" \<input\> \<output\>
Supported transformations:
- \par translate=<translation vector>
Translational transformation by given vector
- \par rotate=(\<n1 vector\> \<n2 vector\>)
Rotational transformation from unit vector n1 to n2
- \par Rx=\<angle [deg] about x-axis\>
Rotational transformation by given angle about x-axis
- \par Ry=\<angle [deg] about y-axis\>
Rotational transformation by given angle about y-axis
- \par Rz=\<angle [deg] about z-axis\>
Rotational transformation by given angle about z-axis
- \par Ra=\<axis vector\> \<angle [deg] about axis\>
Rotational transformation by given angle about given axis
- \par scale=\<x-y-z scaling vector\>
Anisotropic scaling by the given vector in the x, y, z
coordinate directions
Example usage:
surfaceTransformPoints \
"translate=(-0.586 0 -0.156), \
Ry=3.485, \
translate=(0.586 0 0.156)" \
constant/geometry/w3_orig.stl constant/geometry/w3.stl
See also
Foam::transformer
transformPoints
\*---------------------------------------------------------------------------*/
#include "argList.H"
#include "unitConversion.H"
#include "MeshedSurfaces.H"
using namespace Foam;
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
int main(int argc, char *argv[])
{
#include "removeCaseOptions.H"
argList::addNote
(
"Transforms a surface geometry "
"by translation, rotation and/or scaling.\n"
"The <transformations> are listed comma-separated in a string "
"and executed in sequence.\n\n"
"transformations:\n"
" translate=<vector> "
"translation by vector, e.g. (1 2 3)\n"
" rotate=(<n1> <n2>) "
"rotation from unit vector n1 to n2\n"
" Rx=<angle> "
"rotation by given angle [deg], e.g. 90, about x-axis\n"
" Ry=<angle> "
"rotation by given angle [deg] about y-axis\n"
" Rz=<angle> "
"rotation by given angle [deg] about z-axis\n"
" Ra=<axis vector> <angle> "
"rotation by given angle [deg] about specified axis\n"
" scale=<vector> "
"scale by factors from vector in x, y, z directions,\n"
" "
"e.g. (0.001 0.001 0.001) to scale from mm to m\n\n"
"example:\n"
" surfaceTransformPoints \"translate=(1.2 0 0), Rx=90\" "
"in.stl out.obj"
);
argList::noParallel();
argList::validArgs.append("transformations");
argList::validArgs.append("surface file");
argList::validArgs.append("output surface file");
argList args(argc, argv);
const string transformationString(args[1]);
const fileName surfFileName(args[2]);
const fileName outFileName(args[3]);
#include "createTransforms.H"
Info<< "Reading surf from " << surfFileName << " ..." << nl
<< "Writing surf to " << outFileName << " ..." << endl;
meshedSurface surf1(surfFileName);
pointField points(surf1.points());
transforms.transformPosition(points, points);
surf1.movePoints(points);
surf1.write(outFileName);
Info<< "End\n" << endl;
return 0;
}
// ************************************************************************* //