\NeedsTeXFormat{LaTeX2e}[1994/06/01]
\ProvidesPackage{kinematikz}[2021/12/21 kinematikz definitions Package]
%--------------------------
% Vitor Santos
%--------------------------
\RequirePackage{tikz}
\RequirePackage{graphicx}
\RequirePackage{tikz-3dplot}
\RequirePackage{xstring}
\RequirePackage{ifthen}
\RequirePackage{listofitems}
\RequirePackage{xpatch}
\usetikzlibrary{backgrounds,matrix,shapes,arrows} %and some special libraries for tikz
\usetikzlibrary{shapes.multipart,shadows}
\usetikzlibrary{calc}
\usetikzlibrary{decorations.pathreplacing}
\usetikzlibrary{decorations.pathmorphing}
\usetikzlibrary{positioning} %for pic
\usetikzlibrary{patterns}
\usetikzlibrary{scopes} %to use shorthands for scopes ;-)
\usetikzlibrary{angles}
\usetikzlibrary{hobby} %to use shorthands for smooth curves ;-) Use many Latex3 stuff... is that recommended...?
\usetikzlibrary{math} %for some more elaborate calculations ;-)
\usetikzlibrary{intersections} %for intersections
\usetikzlibrary{fit} %for fitting nodes after a list of points
\usetikzlibrary{arrows.meta} %for special line endings :-)
%\pgfdeclarelayer{background}
%\pgfdeclarelayer{foreground}
%\pgfsetlayers{background,main,foreground}
%
https://tex.stackexchange.com/questions/86023/tikz-declare-function-and-babel-french-option
%\usetikzlibrary{babel} % For incompatibilities with tikz declarations and babel with french :-((( But it creates other problems :-(((
%Put it locally to test things....
%-----------------------------------
%\newif\iftikziii %create a test of which tikz version we have. NOT YET USED
%\begingroup
%\def\getmainversion#1.#2\getmainversion{#1}
%\ifnum\expandafter\getmainversion\pgfversion\getmainversion=3
%\global\tikziiitrue
%\fi
%\endgroup
%-----------------------------------
%Check the date of tikz (date is approximate - v3.1.5 or later required)
\makeatletter
\@ifpackagelater{tikz}{2020/01/01}{%
% Package is new enough
}{%
\PackageError{kinematikz}{Package tikz is too old for some kinematikz facilities}{Use another version of tikz package (v.3.1.5 or later)}%
}
\makeatother
% file with kinematics chains symbology
% v. santos, v1, apr 2017
% v2, aug 2017
% minor adjustmente in Feb 2018
% v3 - started in Oct 2018 - towards the first fotmal LaTeX package
% v4 - started in Sep 2020 - Changed name into kinematikz using previous stuff
% use prefix (kind of name space) km instead of vs for local defs and commands
% new creations follow that, later on change all existing
% v5 - started on Feb 2021 - pic arguments being managed with package listofitems. (but no all migrate yet)
% v6 - started on Sep 2021 - create pipc synonyms. Inside a tikzset do:
% new synonym/.pic={\pic {existing name={#1}};},
% The previous construction works and the passed argument #1 is actually
% all the arguments regardless of their format. Some may even be
%decomposed in #1/#2/ etc.. or something else in the existing elements defined locally. This was a nice trick to create synonim seemlessly!
%
% v7 - Nov 2021 - prepare version for deployment
% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
% The main ideia is:
% create symbols for:
% 2D and 3D representation
% ISO and non-ISO common
% Geometry must develop around a central point along rectangular bbox
% Expected connection/anchor points:
% east, west, north, south
%
% Symbols must have a central point (or more) that will define them
% Tikz coordinates should be defined (created) to ease the process of placement
% and establishing links. Arbitrary or possibily in a matrix (useful for more complex structures)
%
% TODOs
%
% migrate all vs prefixes to kn prefixes (DONE)
% erase all obsolete pics and styles (DONE)
% erase compulsory arguments in pics that still have it
% global definitions for kinematics chains.
%%==========================================================
% from
https://tex.stackexchange.com/questions/54358/custom-and-built-in-tikz-fill-patterns
% defining the new dimensions and parameters
\newlength{\hatchspread}
\newlength{\hatchthickness}
\newlength{\hatchshift}
\newcommand{\hatchcolor}{}
% declaring the keys in tikz
\tikzset{hatchspread/.code={\setlength{\hatchspread}{#1}},
hatchthickness/.code={\setlength{\hatchthickness}{#1}},
hatchshift/.code={\setlength{\hatchshift}{#1}},% must be >= 0
hatchcolor/.code={\renewcommand{\hatchcolor}{#1}}}
% setting the default values
\tikzset{hatchspread=3pt,
hatchthickness=0.4pt,
hatchshift=0pt,% must be >= 0
hatchcolor=black}
% declaring the pattern
\pgfdeclarepatternformonly[\hatchspread,\hatchthickness,\hatchshift,\hatchcolor]% variables
{custom north west lines}% name
{\pgfqpoint{\dimexpr-2\hatchthickness}{\dimexpr-2\hatchthickness}}% lower left corner
{\pgfqpoint{\dimexpr\hatchspread+2\hatchthickness}{\dimexpr\hatchspread+2\hatchthickness}}% upper right corner
{\pgfqpoint{\dimexpr\hatchspread}{\dimexpr\hatchspread}}% tile size
{% shape description
\pgfsetlinewidth{\hatchthickness}
\pgfpathmoveto{\pgfqpoint{0pt}{\dimexpr\hatchspread+\hatchshift}}
\pgfpathlineto{\pgfqpoint{\dimexpr\hatchspread+0.15pt+\hatchshift}{-0.15pt}}
\ifdim \hatchshift > 0pt
\pgfpathmoveto{\pgfqpoint{0pt}{\hatchshift}}
\pgfpathlineto{\pgfqpoint{\dimexpr0.15pt+\hatchshift}{-0.15pt}}
\fi
\pgfsetstrokecolor{\hatchcolor}
% \pgfsetdash{{1pt}{1pt}}{0pt}% dashing cannot work correctly in all situation this way
\pgfusepath{stroke}
}
\pgfdeclarepatternformonly[\hatchspread,\hatchthickness,\hatchshift,\hatchcolor]% variables
{custom north east lines}% name
{\pgfqpoint{\dimexpr-2\hatchthickness}{\dimexpr-2\hatchthickness}}% lower left corner
{\pgfqpoint{\dimexpr\hatchspread+2\hatchthickness}{\dimexpr\hatchspread+2\hatchthickness}}% upper right corner
{\pgfqpoint{\dimexpr\hatchspread}{\dimexpr\hatchspread}}% tile size
{% shape description
\pgfsetlinewidth{\hatchthickness}
\pgfpathmoveto{\pgfqpoint{\dimexpr\hatchshift-0.15pt}{-0.15pt}}
\pgfpathlineto{\pgfqpoint{\dimexpr\hatchspread+0.15pt}{\dimexpr\hatchspread-\hatchshift+0.15pt}}
\ifdim \hatchshift > 0pt
\pgfpathmoveto{\pgfqpoint{-0.15pt}{\dimexpr\hatchspread-\hatchshift-0.15pt}}
\pgfpathlineto{\pgfqpoint{\dimexpr\hatchshift+0.15pt}{\dimexpr\hatchspread+0.15pt}}
\fi
\pgfsetstrokecolor{\hatchcolor}
% \pgfsetdash{{1pt}{1pt}}{0pt}% dashing cannot work correctly in all situation this way
\pgfusepath{stroke}
}
%%==========================================================
\def\TikZ{Ti\emph{k}Z}
\def\Kinematikz{Kinema\TikZ}
\def\kinematikz{\Kinematikz}
\newcommand{\knKinematikz}{ %A logo for the package still in development
\pic [scale=0.3,transform shape] (F) {frame=7cm};
\pic [scale=0.3,transform shape,xshift=-3.2cm] (L1) at (F-end) {link bar generic={90:2/0/0/0//1}};
\coordinate (tt) at ($(L1-start)!0.9!(L1-center)$);
\pic [scale=0.3,transform shape](L2) at (tt) {link bar generic={50:1.2/0//1//1}};
\pic [scale=0.3,transform shape](L3) at (tt) {link bar generic={-38:1.1/0//1//1}};
\node [at=(L3-end),xshift=-1pt, yshift=2.5pt,anchor=west,TSF] {inema\TikZ};
\pic[scale=0.3,transform shape] (F) {frame=7cm}; %Just to cover if exposed...
}
\makeatletter
\newcommand\currentcoordinate{\the\tikz@lastxsaved,\the\tikz@lastysaved}
\makeatother
\def\pivotRadius{3pt} %radius of pivot elements
\def\linkWidth{6.42pt} %width of links for vsCustomLinks
\def\linkWidth{1pt} %width of links for vsCustomLinks
\def\gapGround{0.04} %separation of moving ground contact (unit is default -- cm)
\def\lAng{90} %default angle for link arms (can override locally)
\def\lLenA{0.5} %default length for link arm A (can override locally)
\def\lLenB{0.5} %default length for link arm B (can override locally)
\def\COMradius{0.4em} %radius of center of mass (because of "em" can scale with font size modifyers :-)
\def\LinkFillColor{gray!50} %default color of planar 2D links
\def\SubLinkFillColor{gray!30} %default color of planar 2D sublinks (like pistons in 2D)
\def\lockRadius{1.25*\pivotRadius} % to define the size of locks in ISO symbols
\tikzset{TSF/.style={transform shape=false}}
% The "transform shape" is necessarry to also scale pic in case of scaling tikzpictures
%becase the global option scale=..., does not affect nodes or pics. But the problem
%is that it scales fonts as well.. so you can use a smaller font like \footnotesize which is OK for scales of 1.25 except minor issue in kerning. But, it's better to use
%an independnet solution which is to use "transform shape=false" locally on the node to avoid font scaling. So this is useful to keep nodes without drawn shapes with normal
%font sizes...
%So it is recomended to use the TSF style created above in nodes with only text and
%no shape to be drawn to keep text the default size
\newcommand{\lineTip}[1]{\fill #1 circle (0.6pt)} %was 0.4 pt, but 0.6 is adequate for "thick" lines. command to append small termination to some tips of lines to cover for poorer line joining :-( Accepts one argument which is the point where to put the terminations
%NOTE - in many cases the previous was replaced by [line cap=round] which is more automatic, but applies to both ends of line and that can be undesired in certain cases; actually a style knLineCap was created for that :-)
%\draw [options] (center) +(start ang:radius) arc (start ang:end ang:radius); %technique to draw an arc with a center, radius, start and end angle
%---Code to allow callout overlay-----------
%code from:
https://tex.stackexchange.com/questions/187165/callout-with-multiple-pointers-how-to-design-it
% The goal is to translate
% \overlaynode<red,blue>{hallo};
% into
% \node[red]{hallo};
% \node[blue]{hallo};
\makeatletter
\def\overlaynode<#1>#2;{
\gdef\stacknodecommonpart{#2}
\pgfkeys{/typeset node/.list={#1}}
}
\pgfkeys{
/typeset node/.code={
\edef\pgf@marshal{\noexpand\node[#1]\stacknodecommonpart;}
\pgf@marshal
}
}
\def\overlaynodedrawfill{\pgfutil@ifnextchar[{\overlaynodedrawfill@opt}{\overlaynodedrawfill@opt[]}}
\def\overlaynodedrawfill@opt[#1]<#2>#3;{
\begin{scope}[transparency group,draw=black,fill=white,line cap=round,line join=round,#1]
\pgfmathsetmacro\pgflinewidthdouble{2\pgflinewidth}
\overlaynode<#2>[draw=pgfstrokecolor,line width=\pgflinewidthdouble]#3;
\overlaynode<#2>[fill=pgffillcolor]#3;
\end{scope}
}
\makeatother
%----------------------------------
%----------------------------------
%% Command to draw a coordinate system in 2D with 3rd axis (z) in perspective
% Accepts an optional argument which if the orientation of the system
% The second argument is the index of the coordinate system,
% and the thrid is the point where to draw that is:
% \knAddCoordFrame[ang]{num}{point}
% \knAddCoordFrame{num}{point}
% A special index should also be allowed (R,H, etc...)
\def\knCoordScale{1} %Global scale for Coordinate frame sizes. Can be adjusted
\newcommand{\knAddCoordFrameZout}[3][0]{ %#1 - optional: angle; #2 - mandatory: suffix; #3 startingpoint
\ifthenelse{ \equal{#3}{} }
{
\def\cAng{0}
\def\cSuff{#1}
\def\cOrigin{#2}
}
{
\def\cAng{#1}
\def\cSuff{#2}
\def\cOrigin{#3}
}
\tikzmath{
int \drawTheta;
\drawTheta=0;
if ( \cSuff >= 0 ) then
{
\drawTheta=1;
} else
{
\cSuff = int(-\cSuff);
};
}
\pgfmathparse{int(\cSuff+1)} %had to use int to avoid decimal places
\edef\idxAng{\pgfmathresult}
\draw[robot coord system,rotate=\cAng] \cOrigin -- ++({\knCoordScale*0.5},0) node[above,TSF] {$\hat x_{\cSuff}$};
\draw[robot coord system,rotate=\cAng] \cOrigin -- ++(0,{\knCoordScale*0.75}) node[left,TSF] {$\hat y_{\cSuff}$};
\draw[robot coord system] \cOrigin -- ++({-\knCoordScale*0.5},{-\knCoordScale*0.5}) node[right,TSF] {$\hat z_{\cSuff}$};
%\draw [options] (center) +(start ang:radius) arc (start ang:end ang:radius);
\ifthenelse{ \equal{\drawTheta}{1} }
{
\draw [angular lines no limits] \cOrigin ++(-135:{\knCoordScale*0.4}) +(-30:0.2) arc (-30:+150:0.2) node [left,xshift=3pt,TSF] {$ \theta_{\idxAng} $};
}
{}
\draw [fill] \cOrigin circle (1pt);
}
%-------
\newcommand{\knAddCoordFrameZoutB}[4][0]{ %#1 - optional: tikz options; #2 rotation angle except for one axis; #3 - mandatory: suffix; #4 startingpoint
\ifthenelse{ \equal{#4}{} } %Only has 3 parameters
{
\def\cOptions{}
\def\cAng{#1}
\def\cSuff{#2}
\def\cOrigin{#3}
}
{ %Has the 4 parameters
\def\cOptions{#1}
\def\cAng{#2} %This angle overrides angle potentially included in the general options
\def\cSuff{#3}
\def\cOrigin{#4}
}
\tikzmath{
int \drawTheta;
\drawTheta=0;
%Comment next since this is now for special cases
% if ( \cSuff >= 0 ) then
% {
% \drawTheta=1;
% } else
% {
% \cSuff = int(-\cSuff);
% };
}
%\pgfmathparse{int(\cSuff+1)} %had to use int to avoid decimal places
\edef\idxAng{\pgfmathresult} \edef\idxAng{-}
\draw[robot coord system,\cOptions,rotate=\cAng] \cOrigin -- ++({\knCoordScale*0.5},0) node[above,TSF] {$\hat x_{\cSuff}$};
\draw[robot coord system,\cOptions,rotate=\cAng] \cOrigin -- ++(0,{\knCoordScale*0.75}) node[left,TSF] {$\hat y_{\cSuff}$};
\draw[robot coord system,\cOptions] \cOrigin -- ++({-\knCoordScale*0.5},{-\knCoordScale*0.5}) node[right,TSF] {$\hat z_{\cSuff}$};
%\draw [options] (center) +(start ang:radius) arc (start ang:end ang:radius);
\ifthenelse{ \equal{\drawTheta}{1} }
{
\draw [angular lines no limits] \cOrigin ++(-135:{\knCoordScale*0.4}) +(-30:0.2) arc (-30:+150:0.2) node [left,xshift=3pt,TSF] {$ \theta_{\idxAng} $};
}
{}
\draw [fill] \cOrigin circle (1pt);
}
%-------
\newcommand{\knAddCoordFrameZup}[3][0]{ %#1 - optional: angle; #2 - mandatory: suffix; #3 startingpoint
\ifthenelse{ \equal{#3}{} }
{
\def\cAng{0}
\def\cSuff{#1}
\def\cOrigin{#2}
}
{
\def\cAng{#1}
\def\cSuff{#2}
\def\cOrigin{#3}
}
\tikzmath{
int \drawTheta;
\drawTheta=0; %by default does not draw
if ( \cSuff >= 0 ) then
{
\drawTheta=1;
}
else
{
\cSuff = int(-\cSuff);
};
}
\pgfmathparse{int(\cSuff+1)} %had to use int to avoid decimal places
\edef\idxAng{\pgfmathresult}
\draw[robot coord system,rotate=\cAng] \cOrigin -- ++({\knCoordScale*0.5},0) node[anchor=south west,inner sep=1pt,TSF] {$\hat x_{\cSuff}$};
\draw[robot coord system,rotate=\cAng] \cOrigin -- ++(0,{\knCoordScale*0.75}) node[anchor=south east,inner sep=1pt,TSF] {$\hat z_{\cSuff}$};
\draw[robot coord system] \cOrigin -- ++({\knCoordScale*0.5},{\knCoordScale*0.5}) node[anchor=south east,inner sep=1pt,TSF] {$\hat y_{\cSuff}$};
\ifthenelse{ \equal{\drawTheta}{1} }
{
\draw[angular lines no limits,rotate=\cAng] \cOrigin ++(90:{\knCoordScale*0.4}) node [left,xshift=-3pt,TSF] {$ \theta_{\idxAng} $} [partial ellipse=-250:60:0.25cm and 0.1cm];
}{}
\draw[fill] \cOrigin circle (1pt);
}
%------
\newcommand{\knAddCoordFrameZdown}[3][0]{ %#1 - optional: angle; #2 - mandatory: suffix; #3 startingpoint
\ifthenelse{ \equal{#3}{} }
{
\def\cAng{0}
\def\cSuff{#1}
\def\cOrigin{#2}
}
{
\def\cAng{#1}
\def\cSuff{#2}
\def\cOrigin{#3}
}
\tikzmath{
int \drawTheta;
\drawTheta=0; %by default does not draw
if ( \cSuff >= 0 ) then
{
\drawTheta=1;
}
else
{
\cSuff = int(-\cSuff);
};
}
\pgfmathparse{int(\cSuff+1)} %had to use int to avoid decimal places
\edef\idxAng{\pgfmathresult}
\draw[robot coord system,rotate=\cAng] \cOrigin -- ++({\knCoordScale*0.5},0) node[anchor=south east,inner sep=1pt,TSF] {$\hat x_{\cSuff}$};
\draw[robot coord system,rotate=\cAng] \cOrigin -- ++(0,-{\knCoordScale*0.75}) node[anchor=south east,inner sep=1pt,TSF] {$\hat z_{\cSuff}$};
\draw[robot coord system] \cOrigin -- ++(-{\knCoordScale*0.5},{-\knCoordScale*0.5}) node[anchor=south east,inner sep=1pt,TSF] {$\hat y_{\cSuff}$};
\ifthenelse{ \equal{\drawTheta}{1} }
{
\draw[angular lines no limits,rotate=\cAng] \cOrigin ++(-90:{\knCoordScale*0.4}) [partial ellipse=60:-250:0.25cm and 0.1cm] node [right,xshift=2pt,yshift=4pt,TSF] {$ \theta_{\idxAng} $};
}{}
\draw[fill] \cOrigin circle (1pt);
}
%-----
\newcommand{\knAddCoordFrameZupRotX}[3][0]{ %#1 - optional: angle; #2 - mandatory: suffix; #3 startingpoint
\ifthenelse{ \equal{#3}{} }
{
\def\cAng{0}
\def\cSuff{#1}
\def\cOrigin{#2}
}
{
\def\cAng{#1}
\def\cSuff{#2}
\def\cOrigin{#3}
}
\tikzmath{
int \drawTheta;
\drawTheta=0; %by default does not draw
if ( \cSuff >= 0 ) then
{
\drawTheta=1;
}
else
{
\cSuff = int(-\cSuff);
};
}
\pgfmathparse{int(\cSuff+1)} %had to use int to avoid decimal places
\edef\idxAng{\pgfmathresult}
\draw[robot coord system,rotate=\cAng] \cOrigin -- ++({\knCoordScale*0.5},0) node[anchor=south east,inner sep=1pt,TSF] {$\hat y_{\cSuff}$};
\draw[robot coord system,rotate=\cAng] \cOrigin -- ++(0,{\knCoordScale*0.75}) node[anchor=south east,inner sep=1pt,TSF] {$\hat z_{\cSuff}$};
\draw[robot coord system] \cOrigin -- ++({-\knCoordScale*0.5},{-\knCoordScale*0.5}) node[anchor=south east,inner sep=1pt,TSF] {$\hat x_{\cSuff}$};
\ifthenelse{ \equal{\drawTheta}{1} }
{
\draw[angular lines no limits,rotate=\cAng] \cOrigin ++(90:{\knCoordScale*0.4}) node [left,xshift=-3pt,TSF] {$ \theta_{\idxAng} $} [partial ellipse=-250:60:0.25cm and 0.1cm];
}{}
\draw[fill] \cOrigin circle (1pt);
}
%-----
\newcommand{\knAddCoordFrameZright}[3][0]{ %#1 - optional: angle; #2 - mandatory: suffix; #3 startingpoint (if suffix is < 0 does not draw angle :-)
\ifthenelse{ \equal{#3}{} }
{
\def\cAng{0}
\def\cSuff{#1}
\def\cOrigin{#2}
}
{
\def\cAng{#1}
\def\cSuff{#2}
\def\cOrigin{#3}
}
\tikzmath{
int \drawTheta;
\drawTheta=0; %by default does not draw
if ( \cSuff >= 0 ) then
{
\drawTheta=1;
}
else
{
\cSuff = int(-\cSuff);
};
}
\pgfmathparse{int(\cSuff+1)} %had to use int to avoid decimal places
\edef\idxAng{\pgfmathresult}
\draw[robot coord system,rotate=\cAng] \cOrigin -- ++({\knCoordScale*0.5},0) node[above,TSF] {$\hat z_{\cSuff}$};
\draw[robot coord system,rotate=\cAng] \cOrigin -- ++(0,{\knCoordScale*0.75}) node[left,TSF] {$\hat x_{\cSuff}$};
\draw[robot coord system] \cOrigin -- ++({-\knCoordScale*0.5},{-\knCoordScale*0.5}) node[right,TSF] {$\hat y_{\cSuff}$};
\ifthenelse{ \equal{\drawTheta}{1} }
{
\draw[angular lines no limits,rotate=\cAng] \cOrigin ++(0:{\knCoordScale*0.2}) [partial ellipse=60:330:0.1cm and 0.25cm] node [below,anchor=north west,TSF] {$ \theta_{\idxAng} $};
}
{}
\draw[fill] \cOrigin circle (1pt);
}
%===========================================
% Command intended to cover for all the above with flexibility
% The facilities in tikz 3D lib or tikz-3dplot do not help...
% Command must cover generates one of the following options
% System direction (order left to right, d means down)
%
% Y
% |__X (ZdYX) (default)
% /
% Z
%
% X
% |__Z (YdXZ) rotz90 * rotx90 * default
% /
% Y
%
% Z
% |__Y (XdZY)
% /
% X
%
% _X (YdZdX)
% /|
% Y Z
%
% Z Y
% |/__X (ZYX)
%
%
%Implement a switch case in latex
%from
https://tex.stackexchange.com/questions/5116/making-switch-case-with-etoolboxs-ifdefequal/5210
\newcommand{\CheckCase}[1]{%
\par\noindent%What is this for??
\IfEqCase*{#1}{%
{ZdYX}{\def\zDir{-135:{\knCoordScale*0.4}} \def\yDir{90:{\knCoordScale*1}} \def\xDir{0:{\knCoordScale*1}} }%
{YdXZ}{}%
{XdZY}{}%
{YdZdX}{}%
{ZYX}{}%
}[Did not match any given case!]%Put the default here
}%
\newcommand{\knAddCoordFrame}[5][0]{
% #1 - optional rotation angle in plane (default 0)
% #2 - suffix for system naming (0,1,2,..., H, R, ... other)
% #3 - starting point Where to draw origin in current picture
% #4 - type of system (ZdYX,YdXZ,XdZY,YdZdX,ZYX)
% #5 - draw joint around z , or along z; (0 - no drawing, 1 - circular, 2 - linear )
%\def\zDir{-135:{\knCoordScale*0.4}} \def\yDir{90:{\knCoordScale*1}} \def\xDir{0:{\knCoordScale*1}}
\ifthenelse{\equal{#5}{} } %if not 5 params passed...
{
\def\cAng{0}
\def\cSuff{#1}
\def\cOrigin{#2}
\def\cType{#3}
\def\cJoint{#4}
}
{
\def\cAng{#1}
\def\cSuff{#2}
\def\cOrigin{#3}
\def\cType{#4}
\def\cJoint{#5}
}
\tikzmath{
int \drawTheta;
\drawTheta=0;
if ( \cSuff >= 1 ) then
{
\drawTheta=1;
} else
{
\cSuff = int(-\cSuff);
};
}
\pgfmathparse{int(\cSuff+1)} %had to use int to avoid decimal places
\edef\idxAng{\pgfmathresult}
% \CheckCase{\cType}%Extract type of coord system and adjust some macros accordingly
\draw[robot coord system,rotate=\cAng] \cOrigin -- ++(\xDir) node[TSF] {$\hat x_{\cSuff}$};
\draw[robot coord system,rotate=\cAng] \cOrigin -- ++(\yDir) node[TSF] {$\hat y_{\cSuff}$};
\draw[robot coord system,rotate=\cAng] \cOrigin -- ++(\zdir) node[TSF] {$\hat z_{\cSuff}$};
%\draw [options] (center) +(start ang:radius) arc (start ang:end ang:radius);
\ifthenelse{ \equal{\drawTheta}{1} }
{
% \draw [angular lines no limits] \cOrigin ++(-135:{\knCoordScale*0.4}) +(-30:0.2) arc (-30:+150:0.2) node [left,xshift=3pt,TSF] {$ \theta_{\idxAng} $};
}
{}
\draw [fill] \cOrigin circle (1pt);
}
%===========================================
%-----------------------------------
\tikzset{
%
https://tex.stackexchange.com/questions/23453/symbol-center-of-mass-dowelpin
pics/center of mass/.style={ %
code={
\begin{scope}[radius=\COMradius] %use the same radius for all operations in scope
\fill (0,0) -- ++(\COMradius,0) arc [start angle=0,end angle=90] -- ++(0,-2*\COMradius) arc [start angle=270, end angle=180];%
\draw (0,0) circle;%
\end{scope}
}%
}
}
\newcommand{\addCOM}[1][black] %alternative to "center of mass" pic. Accepts one argument which are the parameters to fill and draw operations.
%Valid only when there is a (-center) node defined, so most useful inside other figures (pic or other)...
{
\begin{scope}[radius=\COMradius] %use the same radius for all operations in scope
\fill [#1] (-center) -- ++(\COMradius,0) arc [start angle=0,end angle=90] -- ++(0,-2*\COMradius) arc [start angle=270, end angle=180];%
\draw [#1] (-center) circle;%
\end{scope}
}
%after
https://tex.stackexchange.com/questions/39293/coordinates-a-b-compute-b-a-and-angle-between-x-and-b-a
\newcommand{\kmpgfextractangle}[2]
{
\pgfmathanglebetweenpoints{\pgfpointorigin}{\pgfpointanchor{#2}{center}}
\global\let#1\pgfmathresult
}
%after
https://tex.stackexchange.com/questions/98924/transform-defined-coordinates-in-tikz
\makeatletter
\newcommand{\gettikzxy}[3]{%
\tikz@scan@one@point\pgfutil@firstofone#1\relax
\edef#2{\the\pgf@x}%
\edef#3{\the\pgf@y}%
}
\makeatother
%Next definitions inspired from
%
https://tex.stackexchange.com/questions/411726/how-to-connect-nodes-with-45-degree-and-0-degree-lines-possibly-via-style/411734
\tikzset{
45-/.style={
to path={
let \p{start}=(\tikztostart),
\p{target}=(\tikztotarget),
\p{diff}=({\x{target}-\x{start}}, {\y{target}-\y{start}}),
\p{absdiff}=({abs(\x{diff})}, {abs(\y{diff})}),
\n{mindiff}={min(\x{absdiff}, \y{absdiff})},
\p{inter}=(
{sign(\x{diff}) * \n{mindiff}},
{sign(\y{diff}) * \n{mindiff}}
)
in
\ifnum \ifdim\x{target}=\x{start} 1
\else \ifdim\y{target}=\y{start} 1
\else \ifdim\x{absdiff}=\y{absdiff} 1
\else 0\fi\fi\fi=1 %primitive tex or condition
-- (\tikztotarget)
\else
--++ (\p{inter}) -- (\tikztotarget)
\fi
},
},
}
%THIS STARTS WITH THE DIAGONAL PART AND ADDS THE VERTICAL/HORIZONTAL PART AFTER
%SWAP POINTS IF YOU WANT THE REVERSE.
\tikzset{
-45/.style={
to path={
let \p{start}=(\tikztostart),
\p{target}=(\tikztotarget),
\p{diff}=({\x{target}-\x{start}}, {\y{target}-\y{start}}),
\p{absdiff}=({abs(\x{diff})}, {abs(\y{diff})}),
\n{mindiff}={min(\x{absdiff}, \y{absdiff})},
\p{inter}=(
{sign(\x{diff}) * \n{mindiff}},
{sign(\y{diff}) * \n{mindiff}}
),
\p{inter}=(
\x{target},
{sign(\y{diff}) * \n{mindiff}}
)
in
\ifnum
\ifdim\x{target}=\x{start} 1 % points in horizontal?
\else \ifdim\y{target}=\y{start} 1 % points in vertical?
\else \ifdim\x{absdiff}=\y{absdiff} 1 % points in45º diagonal?
\else 0 % not any of those
\fi
\fi
\fi=1 %primitive tex or condition
-- (\tikztotarget) %single horizontal/vertical/diagonal line
\else
-- (\p{inter}) -- (\tikztotarget) %two steps: to intermediate and to target
\fi
},
},
}
%%===============================================================
\tikzset{ %definitions for some filling and line styles
ground/.style={ %style for a decoration (of a line)
% The border decoration is a path replacing decorator.
% For the ground style we want to draw the original path.
% The postaction option is therefore used to ensure that the
% border decoration is drawn *after* the original path.
% postaction={ %uncomment to also draw the path, but attention to the xshift
draw,
very thin,
decorate,
decoration={
border,
angle=120,
mirror=true,
amplitude=0.2cm,
transform={xshift=2.5pt},
% pre=lineto, pre length=3pt, post=border, %post length=2pt,
segment length=2pt,
},
% } %uncomment to also draw the path
},
%------------------------------------------
ground2 texture/.style={
pattern=custom north east lines,
hatchspread=2.5pt,
% hatchcolor=green!65!black,
% hatchcolor=black,
hatchshift=0pt,
hatchthickness=0.3pt,
% pattern=north east lines, pattern color=black,
},
ground2/.style={ %style for a node (rectangle) - good only for multiple of 90º orientations
rectangle,
line width=0,
ground2 texture,
minimum height=5pt,
anchor=north west,
inner sep=0,
transform shape, %to rotate rectangle (but not pattern)
},
%------------------------------------------
knLinkStyle/.style={% main style for links - namely type of line
thick, %was very thick
% line join=round, %curved connections? May be yes to match line caps...
miter limit=5, %avoid long sharp corners in special edges
},
knLineCap/.style={ %additional option for line cap in some drawings
line cap=round,
},
knJointStyle/.style={ %Style for drawing joint parts - not the link parts, like ends or arms!
knLinkStyle, %similar to knLinkStyle. But can be adjusted if needed
line join=miter, %Reinforce the default, unless you want soft corners in rectangles.
},
%-------------------------------------------
cube face 1/.style={
knJointStyle,
line join=bevel,
fill=white, %to allow hidding lines in drawing
},
gripper 1/.style={
line join=bevel,
knJointStyle, %was very thick
},
%% SEVERAL LINE STYLES
auxiliary lines/.style={
very thin,
blue,
},
symmetry lines/.style={ %to indicate symmetric longitudinal rotational axle
auxiliary lines,
line width=0.5pt,
densely dash dot,
},
dimension lines no limits/.style={
auxiliary lines,
red,
>=stealth,
<->,
},
dimension lines/.style={
dimension lines no limits,
|<->|,
},
angular lines no limits/.style={
dimension lines no limits,
red,
>=stealth,
->,
},
angular lines/.style={
angular lines no limits,
->|, %possibly |->| ?
},
joint axis/.style={
symmetry lines,
black,
},
%%OTHER USEFUL STYLES
robot coord system/.style={
thick,
->,
>=stealth,
blue,
},
partial ellipse/.style args={#1:#2:#3}{
insert path={+ (#1:#3) arc (#1:#2:#3)}
},
%------------------------------------------
}
% Check also
https://tex.stackexchange.com/questions/463370/pass-an-argument-for-a-pic
% for how to pass arguments to pics
% And this
https://tex.stackexchange.com/questions/250728/tikz-pics-with-optional-default-parameters
% to specify default arguments
%%===============================================================
\tikzset{
%===================================================
pics/frame/.default=1cm, %default argument - base width
pics/frame/.style args={#1}{ %ISO frame 3952-1-3.1 % OK in man (passed to the manual)
% Arg 1 - dimension - base width [1cm]
code={
% \pgfmathsetmacro\myW{#1/2}; %in case you need maths
\coordinate (-left) at (-#1/2,0);
\coordinate (-right) at (#1/2,0);
\coordinate (-center) at (0,0);
\coordinate (-centerTan) at (0,0.175); %This point of for tangency of a link polygon there
\coordinate (-north) at (0,0);
\coordinate (-in) at (0,0);
\coordinate (-out) at (-in);
\coordinate (-end) at (-out);
\coordinate (-south) at (-north);
\coordinate (-start) at (-in);
\node [ground2,minimum width=#1] at (-left) {}; % \draw [ground] (0,0) -- (2,0);
\draw [knJointStyle] (-left) -- ++(#1,0);
} %end of code for this particular pic
},
%------------------------------------------
pics/frame 3D/.default=1cm, %default argument - base width
pics/frame 3D/.style args={#1}{ %Frame 3D
% Arg 1 - dimension - base width [1cm]
code={
% \pgfmathsetmacro\myW{#1/2}; %in case you need maths
\coordinate (-west) at (-#1/2,0);
\coordinate (-east) at (#1/2,0);
\coordinate (-center) at (0,0);
\coordinate (-south) at (-135:#1/4);
\coordinate (-north) at (45:#1/4);
\coordinate (-south west) at ($(-south)-(#1/2,0)$);
\coordinate (-south east) at ($(-south)+(#1/2,0)$);
\coordinate (-north west) at ($(-north)-(#1/2,0)$);
\coordinate (-north east) at ($(-north)+(#1/2,0)$);
\coordinate (-in) at (0,0);
\coordinate (-out) at (-in);
\coordinate (-end) at (-out);
\coordinate (-start) at (-in);
\coordinate (-left) at (-west);
\coordinate (-right) at (-east);
\node [ground2,minimum width=#1] at (-south west) {};
\draw [ground2 texture,draw=none, pattern=custom north west lines,] (-south east) -- (-north east) -- ++(0,-5pt) -- ($(-south east)-(0,5pt)$ ) --cycle ;
\draw [knJointStyle] (-south west) -- (-south east) -- (-north east) -- (-north west) -- cycle;
} %end of code for this particular pic
},
%===================================================
pics/base flat pivot/.style={ %simple flat ground with a pivot
code={
\coordinate (-left) at (-1,0);
\coordinate (-right) at (1,0);
\coordinate (-center) at (0,0.175); %why this and not (0,0)?
\coordinate (-north) at (0,0);
\node [ground2,minimum width=2cm] at (-left) {}; % \draw [ground] (0,0) -- (2,0);
\draw [knJointStyle] (-left) -- ($(-north)+(-\pivotRadius-1.5pt,0)$) arc (180:0:\pivotRadius+1.5pt) -- (-right);
\draw [fill=white] (-north) circle (\pivotRadius);
} %end of code for this particular pic
},
%------------------------------------------
pics/frame pivot flat/.default=1cm, %simple flat frame with a pivot
pics/frame pivot flat/.style={ %simple flat ground with a pivot % OKinman
code={
\coordinate (-left) at (-#1/2,0);
\coordinate (-right) at (#1/2,0);
% \coordinate (-center) at (0,0.175); %why this and not (0,0)?
\coordinate (-center) at (0,0);
\coordinate (-north) at (0,0);
\coordinate (-out) at (0,0);
\coordinate (-end) at (-out);
\coordinate (-in) at (0,0);
\coordinate (-start) at (-in);
\coordinate (-south) at (0,-\pivotRadius/2);
\node [ground2,minimum width=#1] at (-left) {}; % \draw [ground] (0,0) -- (2,0);
\draw [knJointStyle] (-left) -- ($(-north)+(-\pivotRadius-1.5pt,0)$) arc (180:0:\pivotRadius+1.5pt) -- (-right);
\draw [fill=white] (-north) circle (\pivotRadius);
} %end of code for this particular pic
},
%===================================================
pics/frame pivot trapezium/.default=0.8cm, %trapezium frame with a pivot
pics/frame pivot trapezium/.style={ %OKinman
code={
\coordinate (-left) at (-#1/2,-#1/4);
\coordinate (-right) at (#1/2,-#1/4);
\coordinate (-center) at (0,0);
\coordinate (-north) at ($(-center)+(90:#1*0.355)$);
\coordinate (-in) at (-center);
\coordinate (-start) at (-center);
\coordinate (-out) at (-center);
\coordinate (-end) at (-center);
\coordinate (-south) at ($(-left)!0.5!(-right)$);
\draw [knJointStyle, line join=round] (-left) -- ++(0:#1) -- ++(120:#1*0.7) -- ++(180:#1*0.3) -- cycle;
\node at (-left) [ground2,minimum width=#1] {}; % \draw [ground] (0,0) -- (1,0);
\draw [] (-center) circle (\pivotRadius);
} %end of code for this particular pic
},
%===================================================
pics/frame pivot rounded/.default=0.5cm, %rounded frame with a pivot
pics/frame pivot rounded/.style={ %OKinman
code={
\coordinate (-left) at (-#1/2,-#1/2);
\coordinate (-right) at ( #1/2,-#1/2);
\coordinate (-center) at (0,0);
\coordinate (-in) at (-center);
\coordinate (-out) at (-center);
\coordinate (-end) at (-out);
\coordinate (-start) at (-center);
\coordinate (-south) at ($(-left)!0.5!(-right)$);
\draw [knJointStyle, line join=round] (-left) -- ++(0:#1) -- ++(90:#1/2) arc (0:180:#1/2) node [midway,inner sep=0] (-north){} -- cycle;
\node at (-left) [ground2,minimum width=#1] {}; %\draw [ground] (0,0) -- (0.5,0);
\draw [] (-center) circle (\pivotRadius);
} %end of code for this particular pic
},
%===================================================
pics/frame pivot triangle/.default=0.7cm, %triangle frame with a pivot
pics/frame pivot triangle/.style={ %OKinman
code={
% \pgfmathsetmacro\myH{2*sin(60)}
\pgfmathsetmacro\myH{1.3}
\coordinate (-left) at (-#1/2,-#1/\myH);
\coordinate (-right) at ( #1/2,-#1/\myH);
\coordinate (-center) at (0,0);
\coordinate (-north) at (-center);
\coordinate (-in) at (-center);
\coordinate (-end) at (-in);
\coordinate (-start) at (-in);
\coordinate (-out) at (-center);
% \coordinate (-south) at ($(-left)!0.5!(-right)$); %This is failing in the book!!! Problem was babel package with french option!
\coordinate (-south) at ($0.5*(-left)+0.5*(-right)$); %so use this... :-(
\draw [knJointStyle, line join=round] (-center) -- (-left) -- (-right) -- cycle;
\node at (-left) [ground2,minimum width=#1] {};% \draw [ground] (0,0) -- (0.5,0);
\draw [fill=white] (-center) circle (\pivotRadius);
} %end of code for this particular pic
},
%===================================================
pics/frame dual pivot slide/.style={ %OKinman
%Arg 1 -> width [2cm]
%Arg 2 -> fraction of placement from -0.25 to +0.25 [0] %default is in the center
%Arg 3 -> fraction size of cursor of frame [0.5] %But there sre max and min absolute sizes
code={
% ----START ANALYSE ARGUMENTS AND SET DEFAULTS --------------------------
\ifthenelse{ \equal{#1}{}} {\def\allArgs{/}} {\def\allArgs{#1}}
\setsepchar[.]{/} % "/" is the separator "." is the second level separator
\readlist\myArgs{\allArgs}
\ifthenelse{ \myArgslen > 0} {\itemtomacro\myArgs[1]\fLength} {\def\fLength{}}
\ifthenelse{ \myArgslen > 1} {\itemtomacro\myArgs[2]\fFraction}{\def\fFraction{}}
\ifthenelse{ \myArgslen > 2} {\itemtomacro\myArgs[3]\fCursor}{\def\fCursor{}}
%Test if any parameter is blank and put the default in that case
\ifthenelse{ \equal{\fLength}{} }{\def\fLength{2cm}} {}
\ifthenelse{ \equal{\fFraction}{}}{\def\fFraction{0}} {}
\ifthenelse{ \equal{\fCursor}{}}{\def\fCursor{0.5}} {}
%-----------------------END ANALYSE ARGUMENTS AND SET DEFAULTS -------------------
\dimendef\myL=0 %first create a dimension register...
% \pgfmathsetlength\myL{max(2*\pivotRadius,\fCursor*\fLength)} %min size
% \pgfmathsetlength\myL{min(1cm,\fCursor*\fLength)} %max size
\pgfmathsetlength\myL{max(2*\pivotRadius,min(1cm,\fCursor*\fLength)} %min/max size
%limit excursion of cursor
\pgfmathsetmacro\fFraction{min(0.25,\fFraction)}
\pgfmathsetmacro\fFraction{max(-0.25,\fFraction)}
\coordinate (-left) at (-\fLength/2,0);
\coordinate (-right) at (\fLength/2,0);
\coordinate (-center) at ($(-left)!0.5!(-right)$);
\coordinate (-in) at (\fFraction*\fLength,0); %proportion of displacement
\coordinate (-north) at ($(-left)!0.5!(-right)+(0,0.25)$);
\coordinate (-start) at (-in);
\coordinate (-out) at (-in);
\coordinate (-end) at (-out);
\coordinate (-south) at ($(-left)!0.5!(-right)-(0,0.25)$);
\draw [line width=1pt,fill=\LinkFillColor] ($(-in)+(-\myL/2,\gapGround-0.25)$) rectangle ++(\myL,0.5-2*\gapGround);
\node [ground2,minimum width=\fLength] at (-\fLength/2,-0.25) {}; % \draw [ground] (0,0) -- (2,0);
\node [ground2,minimum width=\fLength,anchor=south west] at (-\fLength/2,0.25) {}; %\draw [ground] (2,0.5) -- (0,0.5);
\draw [knJointStyle] (-\fLength/2,0.25) -- (\fLength/2,0.25);
\draw [knJointStyle] (-\fLength/2,-0.25) -- (\fLength/2,-0.25);
% \coordinate (-center) at (1,0.25);
\draw [fill=white] (-in) circle (\pivotRadius);
} %end of code for this particular pic
},
%----------------------------------------------------------
} % end of base/frame styles
\tikzset{ %definitions/pics for SYMBOLS INSPIRED FROM ISO 3952-1
%===============================================================
pics/revolute pair planar/.style={ % ISO
%Arg 1 -> destination point
%Arg 2 -> boolean: add or not COM (discarded -1 in legacy for a special case... :-( )
%Arg 3 -> boolean: add or not pivot in destination (default is 1 yes)
code={
% ----START ANALYSE ARGUMENTS AND SET DEFAULTS --------------------------
\ifthenelse{ \equal{#1}{}} {\def\allArgs{/} \def\noArgs{1} \def\addStartPivot{0} } {\def\allArgs{#1} \def\noArgs{0} \def\addStartPivot{1}}
\setsepchar[.]{/} % "/" is the separator "." is the second level separator
\readlist\myArgs{\allArgs}
\ifthenelse{ \myArgslen > 0} {\itemtomacro\myArgs[1]\endPoint} {\def\endPoint{}}
\ifthenelse{ \myArgslen > 1} {\itemtomacro\myArgs[2]\dCOM} {\def\dCOM{} }
\ifthenelse{ \myArgslen > 2} {\itemtomacro\myArgs[3]\addEndPivot}{\def\addEndPivot{} }
%Test if any parameter is blank and put the default in that case
\ifthenelse{ \equal{\endPoint}{} }{\def\endPoint{15:1}}{}
\ifthenelse{ \equal{\dCOM}{} }{\def\dCOM{0}} {}
\ifthenelse{ \equal{\addEndPivot}{}}{\def\addEndPivot{1}} {}
%-----------------------END ANALYSE ARGUMENTS AND SET DEFAULTS -------------------
\coordinate (-in) at (0,0);
\coordinate (-start) at (-in);
\coordinate (-end) at (\endPoint);
\coordinate (-out) at (-end);
% \coordinate (-center) at ($(-start)!0.5!(-end)$); %This is failing... :-(
\coordinate (-center) at ($0.5*(-start)+0.5*(-end)$); %... so use this
\draw [knLinkStyle] (-in) -- (-end);
%Test for a special case when no params are passed and append a second arm
\ifnum \noArgs=1
\draw [knLinkStyle] (-end) -- ++(-10:0.7) coordinate (-end2);
\fi
\ifthenelse{\addStartPivot=1}{
\draw [knLinkStyle,fill=white] (-start) circle (\pivotRadius);
}{}
\ifthenelse{\addEndPivot=1}{
\draw [knLinkStyle,fill=white] (-end) circle (\pivotRadius);
}{}
\ifthenelse{\dCOM=1}{ \addCOM }{}
} %end of code for this particular pic
},
%===============================================================
%
pics/revolute pair spatial/.default={45:1cm/0/0}, %ISO revolute pair - 3D %FOR CONSISTENCY PASSED POINT SHOULD NOT BE IN () CORRECT THAT IN CALLER
%param: point for link end (default: (45:1cm));
%param: direction of end arm: 0 top, 1 bottom (default: 0);
%param: axle fixed to some frame: 0 not fixed, 1 fixed (default: 0)
pics/revolute pair spatial/.style args={#1/#2/#3}{ % ISO
% TODO: should accept partial parameters
code={
\def\invGap{3pt} %inner separation of body 2 from limits of body 1
\def\outvGap{6pt} %outer gap of axle (can be zero in fexed variant)
\def\argA{#1}
\def\argB{#2} \def\armTop {0}
\def\argC{#3} \def\fFixed {1}
\coordinate (-center) at (\currentcoordinate);
\def\rectW{0.6cm}
\def\rectH{0.4cm}
\if\argC\fFixed
\def\outvGap{0pt}
\fi
%NB. If param 1 is passed as literal its effect is local, if by a node name, global!
%That is why default parameter always has local referencing
%SO FOR EASIER LOCAL REPRESENTATIONS CENTER THE pic AROUND (0,0)
%But that may complicate anchoring....
\coordinate (-in) at ($(-center) - (0:\rectW/2+\outvGap+\invGap)$);
\coordinate (-in2) at ($(-center) + (0:\rectW/2+\outvGap+\invGap)$);
\coordinate (-start) at (-in);
\coordinate (-start2) at (-in2);
\coordinate (-end) at (#1); %Note that this is an absolute point, not relative to -center
\coordinate (-out) at (-end);
\coordinate (-north) at ($(-center) + (0,\rectH/2)$);
\coordinate (-south) at ($(-center) - (0,\rectH/2)$);
\coordinate (-east) at ($(-center) + (0:\rectW/2+\invGap)$);
\coordinate (-west) at ($(-center) - (0:\rectW/2+\invGap)$);
\if\argC\fFixed %expected to have a frame in one end - so shift all coordinate names
\coordinate (-in) at ($(-in) + (0:\rectW/2+\outvGap+\invGap)$);
\coordinate (-in2) at ($(-in2) + (0:\rectW/2+\outvGap+\invGap)$);
\coordinate (-start) at (-in);
\coordinate (-start2) at (-in2);
\coordinate (-end) at ($(-end) + (0:\rectW/2+\outvGap+\invGap)$);
\coordinate (-out) at (-end);
\coordinate (-north) at ($(-north) + (0:\rectW/2+\outvGap+\invGap)$);
\coordinate (-south) at ($(-south) + (0:\rectW/2+\outvGap+\invGap)$);
\coordinate (-east) at ($(-east) + (0:\rectW/2+\outvGap+\invGap)$);
\coordinate (-west) at ($(-west) + (0:\rectW/2+\outvGap+\invGap)$);
\fi
%\node[inner sep=0, minimum width=\rectW+2*\outvGap+2*\invGap,circle,opacity=0.5] (-bbox) at (0,0) {};
% previous node created to attempt anchoring pic by any of it internal nodes
% but it only works if not defined after other internal coordinates. Only explicit
% measumrents, otherwise the anchor is always at (0,0) and
% you need shift to anchor the pic :-( Moreover, only the node is relocated by anchoring
% and not the other drawings :-(((( Check more at
%
https://tex.stackexchange.com/questions/185279/anchoring-tikz-pics
% \kmpgfextractangle{\nAng}{-end} %not #1, needs to be a node name :-(
% There is problem when pic is named because then -end is not found :-((
% So I need to do the calculation myself
\newdimen\XCoord
\newdimen\YCoord
\newdimen\XCoordN
\newdimen\YCoordN
\newdimen\XCoordS
\newdimen\YCoordS
\newdimen\XCoordiN
\newdimen\YCoordiN
% \path ($#1-(-north) - (-in)$); \pgfgetlastxy{\XCoord}{\YCoord};
% \pgfmathparse{atan2(\YCoord,\XCoord)}
% \edef\nAng{\pgfmathresult}%
%
% \path ($#1-(-south) - (-in)$); \pgfgetlastxy{\XCoord}{\YCoord};
% \pgfmathparse{atan2(\YCoord,\XCoord)}
% \edef\sAng{\pgfmathresult}%
%But that is a problem because \pgfgetlastxy works with absolute coordinates in the figure, which is a problem when there are transformations on parts of the image :-(
%So we need another trick to calculate the angles:
% \path (-in); \pgfgetlastxy{\XCoord} {\YCoord};
% \path (-north); \pgfgetlastxy{\XCoordN} {\YCoordN};
% \path (-south); \pgfgetlastxy{\XCoordS} {\YCoordS};
% \path #1; \pgfgetlastxy{\XCoordiN}{\YCoordiN};
%But this previous solution works for only translations (but not all rotations)
%So there is this one using the custom \gettikzxy:
% \gettikzxy{(-in)} {\XCoord} {\YCoord}
\path (-in); \pgfgetlastxy{\XCoord} {\YCoord};
\gettikzxy{(-north)} {\XCoordN} {\YCoordN}
\gettikzxy{(-south)} {\XCoordS} {\YCoordS}
\gettikzxy{(-end)} {\XCoordiN}{\YCoordiN}
\pgfmathparse{atan2(\YCoordiN-\YCoordN,\XCoordiN-\XCoordN)}
\edef\nAng{\pgfmathresult}%
\pgfmathparse{atan2(\YCoordiN-\YCoordS,\XCoordiN-\XCoordS)}
\edef\sAng{\pgfmathresult}%
% In case I wanted the vector length
% \pgfmathparse{veclen(\XCoord...,\YCoord...)}
% \edef\lRadius{\pgfmathresult}%
\draw [knLineCap,knLinkStyle] (-in) -- (-in2); % horiz axis. Round line extremities for better connection
\draw [knJointStyle] ($(-in)+(\outvGap,-\rectH/2-1pt)$) -- ++(90:\rectH+2pt); %vert bar left
\draw [knJointStyle] ($(-in2)+(-\outvGap,-\rectH/2-1pt)$) -- ++(90:\rectH+2pt); %vert bar right
\if\argC\fFixed % two lines
\draw [knJointStyle] ($(-in)+(\outvGap, \rectH/2)+(\invGap,0)$) -- ++(\rectW,0);
\draw [knJointStyle] ($(-in)+(\outvGap,-\rectH/2)+(\invGap,0)$) -- ++(\rectW,0);
\else % a full rectangle
\draw [knJointStyle] ($(-in)+(\outvGap,-\rectH/2)+(\invGap,0)$) rectangle ++(\rectW,\rectH); %rectangle
\fi
\if\argB\armTop
\draw [knLineCap,knLinkStyle] (-north) -- (-end); %arm
\fill [] (-north) -- ++(\lockRadius,0) arc (0:\nAng:\lockRadius) -- cycle; %lock, as arc
\else
\draw [knLineCap,knLinkStyle] (-south) -- (-end); %arm
\fill [] (-south) -- ++(\lockRadius,0) arc (0:\sAng:\lockRadius) -- cycle; %lock, as arc
\fi
} %end of code for this particular pic
},
%-----------------------------------
linear pair/.pic={\pic {prismatic pair={#1}};}, %a synonym for prismatic pair. %always use #1 independetly of the number or arguments!
pics/prismatic pair/.default={45:1cm/0}, %ISO linear pair %FOR CONSISTENCY PASSED POINT SHOULD NOT BE IN () CHECK THAT IN CALLER
%param: point for link end (default: (45:1cm));
%param: direction of end arm: 0 top, 1 bottom (default: 0);
pics/prismatic pair/.style args={#1/#2}{ % ISO
code={
\def\argA{(#1)}
\def\argB{#2} \def\armTop {0}
\def\endGap{8pt}
\def\rectW{0.6cm}
\def\rectH{0.4cm}
%NB. If param 1 is passed as literal its effect is local, if by a node name, global!
%That is why default parameter always has local referencing
%SO FOR EASIER LOCAL REPRESENTATIONS CENTER THE pic AROUND (0,0)
%But that may complicate anchoring....
% \coordinate (-center) at (\currentcoordinate);
\coordinate (-center) at (0,0);
\coordinate (-east) at ($(-center) + (0:\rectW/2)$);
\coordinate (-west) at ($(-center) - (0:\rectW/2)$);
\coordinate (-in) at ($(-west) - (0:\endGap)$);
\coordinate (-in2) at ($(-east) + (0:\endGap)$);
\coordinate (-start) at (-in);
\coordinate (-start2) at (-in2);
\coordinate (-end) at (#1);
\coordinate (-out) at (-end);
\coordinate (-north) at ($(-center) + (0,\rectH/2)$);
\coordinate (-south) at ($(-center) - (0,\rectH/2)$);
%\node[inner sep=0, minimum width=\rectW,circle,opacity=0.5] (-bbox) at (0,0) {};
% previous node created to attempt anchoring pic by any of it internal nodes
% but it only works if not defined after other internal coordinates. Only explicit
% measumrents, otherwise the anchor is always at (0,0) and
% you need shift to anchor the pic :-( Moreover, only the node is relocated by anchoring
% and not the other drawings :-(((( Check more at
%
https://tex.stackexchange.com/questions/185279/anchoring-tikz-pics
% \kmpgfextractangle{\nAng}{-end} %not #1, needs to be a node name :-(
% There is problem when pic is named because then -end is not found :-((
% So I need to do the calculation myself
\newdimen\XCoord
\newdimen\YCoord
\newdimen\XCoordN
\newdimen\YCoordN
\newdimen\XCoordS
\newdimen\YCoordS
\newdimen\XCoordiN
\newdimen\YCoordiN
% \gettikzxy{(-in)} {\XCoord} {\YCoord}
\path (-in); \pgfgetlastxy{\XCoord} {\YCoord};
\gettikzxy{(-north)} {\XCoordN} {\YCoordN}
\gettikzxy{(-south)} {\XCoordS} {\YCoordS}
\gettikzxy{(#1)} {\XCoordiN}{\YCoordiN}
\pgfmathparse{atan2(\YCoordiN-\YCoordN,\XCoordiN-\XCoordN)}
\edef\nAng{\pgfmathresult}%
\pgfmathparse{atan2(\YCoordiN-\YCoordS,\XCoordiN-\XCoordS)}
\edef\sAng{\pgfmathresult}%
% In case I wanted the vector length
% \pgfmathparse{veclen(\XCoord...,\YCoord...)}
% \edef\lRadius{\pgfmathresult}%
\coordinate (llCorner) at ($(-center) - (\rectW/2,\rectH/2)$);
\draw [knJointStyle] (llCorner) rectangle ++(\rectW, \rectH);
\draw [knLinkStyle] (-in) -- (-west) (-in2) -- (-east);
\if\argB\armTop
\draw [knLineCap,knLinkStyle] (-north) -- (-end);%arm
\fill [] (-north) -- ++(\lockRadius,0) arc (0:\nAng:\lockRadius) -- cycle; %lock, as arc
\else
\draw [knLineCap,knLinkStyle] (-south) -- (-end);%arm
\fill [] (-south) -- ++(\lockRadius,0) arc (0:\sAng:\lockRadius) -- cycle; %lock, as arc
\fi
} %end of code for this particular pic
},
%===============================================================
pics/spherical pair/.style={ % 2d socket and ball pair ISO
code={
% ----START ANALYSE ARGUMENTS AND SET DEFAULTS --------------------------
\ifthenelse{ \equal{#1}{}} {\def\allArgs{/}} {\def\allArgs{#1}}
\setsepchar[.]{/} % "/" is the separator "." is the second level separator
\readlist\myArgs{\allArgs}
\ifthenelse{ \myArgslen > 0} {\itemtomacro\myArgs[1]\angR} {\def\angR{}}
\ifthenelse{ \myArgslen > 1} {\itemtomacro\myArgs[2]\rFactor} {\def\rFactor{}}
\ifthenelse{ \myArgslen > 2} {\itemtomacro\myArgs[3]\lLenA} {\def\lLenA{}}
\ifthenelse{ \myArgslen > 3} {\itemtomacro\myArgs[4]\lLenB} {\def\lLenB{}}
\ifthenelse{ \myArgslen > 4} {\itemtomacro\myArgs[5]\atIn} {\def\atIn{}}
%Test if any parameter is blank and put the default in that case
\ifthenelse{ \equal{\angR}{}} {\def\angR{15}} {} %default angle of end arm
\ifthenelse{ \equal{\rFactor}{}} {\def\rFactor{1}} {} %default scale factor for ball
\ifthenelse{ \equal{\lLenA}{}} {\def\lLenA{0.8}} {} %default left arm length
\ifthenelse{ \equal{\lLenB}{}} {\def\lLenB{0.8}} {} %default right arm length
\ifthenelse{ \equal{\atIn}{}} {\def\atIn{0}} {} %1 to attach to -in instead of -center
%-----------------------END ANALYSE ARGUMENTS AND SET DEFAULTS -------------------
\def\gapBS{1.5pt} %gap between ball and socket
\def\ballRadius{\rFactor*\pivotRadius}
\def\tmpIn{(\lLenA,0)} %The temporary in for a shift if required
\def\inShift{(0,0)} %Default internal shift (null)
\ifthenelse{ \equal{\atIn}{1}} {\def\inShift{\tmpIn}} {} %new internal shift if attaching to -in
% TODO this next option should also be available in other pics
\begin{scope}[shift={\inShift}] % to adjust the anchoring point as needed
\coordinate (-center) at (0,0);
\draw [knLinkStyle] (-center) -- ++(-\lLenA,0) coordinate (-in);
\fill [] ($(-center)-(\ballRadius+\gapBS,0)$) -- ++(-\ballRadius,0) arc (180:30:\ballRadius) -- cycle; %lock left
% \draw [vsISOLinkStyle,fill=white] (-center) arc (90:270:0.2); %socket
\draw [knLinkStyle,fill=white] ([shift=(60:\ballRadius+\gapBS)]-center) arc (60:300:\ballRadius+\gapBS); %This is way too smart: check
https://tex.stackexchange.com/questions/66216/draw-arc-in-tikz-when-center-of-circle-is-specified
\draw [knLinkStyle] (-center) -- ++(\angR:\lLenB) coordinate (-end); %right arm
\fill [] ($ (-center) + (\angR:\ballRadius) $) -- ++(\angR:\ballRadius) arc (\angR:-120:\ballRadius) -- cycle; %lock right
\draw [knLinkStyle,fill=white] (-center) circle (\ballRadius); %ball
\coordinate (-start) at (-in);
\coordinate (-out) at (-end);
\end{scope}
} %end of code for this particular pic
},
%------------------------------------------
%%%% I AM HERE ... DURING THE MIGRATION TO ISO
%===============================================================
%
pics/helical pair/.default={45:1cm/0}, %
%param: point for link end (default: (45:1cm));
%param: direction of end arm: 0 top, 1 bottom (default: 0);
pics/helical pair/.style args={#1/#2}{ %
code={
\def\argA{(#1)}
\def\argB{#2} \def\armTop {0}
\def\endGap{8pt}
\def\rectW{0.6cm}
\def\rectH{0.4cm}
%NB. If param 1 is passed as literal its effect is local, if by a node name, global!
%That is why default parameter always has local referencing
%SO FOR EASIER LOCAL REPRESENTATIONS CENTER THE pic AROUND (0,0)
%But that may complicate anchoring....
% \coordinate (-center) at (\currentcoordinate);
\coordinate (-center) at (0,0);
\coordinate (-east) at ($(-center) + (0:\rectW/2)$);
\coordinate (-west) at ($(-center) - (0:\rectW/2)$);
\coordinate (-in) at ($(-west) - (0:\endGap)$);
\coordinate (-in2) at ($(-east) + (0:\endGap)$);
\coordinate (-start) at (-in);
\coordinate (-start2) at (-in2);
\coordinate (-end) at (#1);
\coordinate (-out) at (-end);
\coordinate (-north) at ($(-center) + (0,\rectH/2)$);
\coordinate (-south) at ($(-center) - (0,\rectH/2)$);
\node[inner sep=0, minimum width=\rectW,circle,opacity=0.5] (-bbox) at (0,0) {};
% previous node created to attempt anchoring pic by any of it internal nodes
% but it only works if not defined after other internal coordinates. Only explicit
% measumrents, otherwise the anchor is always at (0,0) and
% you need shift to anchor the pic :-( Moreover, only the node is relocated by anchoring
% and not the other drawings :-(((( Check more at
%
https://tex.stackexchange.com/questions/185279/anchoring-tikz-pics
% \kmpgfextractangle{\nAng}{-end} %not #1, needs to be a node name :-(
% There is problem when pic is named because then -end is not found :-((
% So I need to do the calculation myself
\newdimen\XCoord
\newdimen\YCoord
\newdimen\XCoordN
\newdimen\YCoordN
\newdimen\XCoordS
\newdimen\YCoordS
\newdimen\XCoordiN
\newdimen\YCoordiN
% \gettikzxy{(-in)} {\XCoord} {\YCoord}
\path (-in); \pgfgetlastxy{\XCoord} {\YCoord};
\gettikzxy{(-north)} {\XCoordN} {\YCoordN}
\gettikzxy{(-south)} {\XCoordS} {\YCoordS}
\gettikzxy{(#1)} {\XCoordiN}{\YCoordiN}
\pgfmathparse{atan2(\YCoordiN-\YCoordN,\XCoordiN-\XCoordN)}
\edef\nAng{\pgfmathresult}%
\pgfmathparse{atan2(\YCoordiN-\YCoordS,\XCoordiN-\XCoordS)}
\edef\sAng{\pgfmathresult}%
% In case I wanted the vector length
% \pgfmathparse{veclen(\XCoord...,\YCoord...)}
% \edef\lRadius{\pgfmathresult}%
\coordinate (llCorner) at ($(-center) - (\rectW/2,\rectH/2)$);
\draw [knJointStyle] (llCorner) rectangle ++(\rectW, \rectH);
\draw [knLinkStyle] (-in) -- (-west) (-in2) -- (-east);
% \draw [knLinkStyle, decoration={snake,segment length=\rectW/2.75,amplitude=\rectH/3.5}] (-west) decorate {--(-east)};
%The previous decoration is not adjusting to scale so using a compopund of sin/cos :-(
\draw [knLinkStyle] (-west) sin
($(-west)+(\rectW/12,\rectH/4)$) cos
($(-west)+(2*\rectW/12,0)$) sin
($(-west)+(3*\rectW/12,-\rectH/4)$) cos
($(-west)+(4*\rectW/12,0)$) sin
($(-west)+(5*\rectW/12,\rectH/4)$) cos
($(-west)+(6*\rectW/12,0)$) sin
($(-west)+(7*\rectW/12,-\rectH/4)$) cos
($(-west)+(8*\rectW/12,0)$) sin
($(-west)+(9*\rectW/12,\rectH/4)$) cos
($(-west)+(10*\rectW/12,0)$) sin
($(-west)+(11*\rectW/12,-\rectH/4)$) cos
(-east);
\if\argB\armTop
\draw [knLineCap,knLinkStyle] (-north) -- (-end); %arm
\fill [] (-north) -- ++(\lockRadius,0) arc (0:\nAng:\lockRadius) -- cycle; %lock, as arc
\else\
\draw [knLineCap,knLinkStyle] (-south) -- (-end); %arm
\fill [] (-south) -- ++(\lockRadius,0) arc (0:\sAng:\lockRadius) -- cycle; %lock, as arc
\fi
} %end of code for this particular pic
},
%------------------------------------------
pics/cylindrical pair/.default={45:1cm/0},%
%param: point for link end (default: (45:1cm));
%param: direction of end arm: 0 top, 1 bottom (default: 0);
pics/cylindrical pair/.style args={#1/#2}{ % cylindrical link ISO
code={
\def\argA{(#1)}
\def\argB{#2} \def\armTop {0}
\def\endGap{0.7cm} %Extension of axis for each side
\def\rectW{0.6cm} %width
\def\rectH{0.4cm} %height
\coordinate (-center) at (0,0);
\coordinate (-in) at ($(-center) - (0:\endGap)$);
\coordinate (-in2) at ($(-center) + (0:\endGap)$);
\coordinate (-start) at (-in);
\coordinate (-start2) at (-in2);
\coordinate (-end) at (#1);
\coordinate (-out) at (-end);
\coordinate (-east) at (-in2);
\coordinate (-west) at (-in);
\coordinate (-north) at ($(-center) + (0,\rectH/2)$);
\coordinate (-south) at ($(-center) - (0,\rectH/2)$);
% \kmpgfextractangle{\nAng}{-end} %not #1, needs to be a node name :-(
% There is problem when pic is named because then -end is not found :-((
% So I need to do the calculation myself
\newdimen\XCoord
\newdimen\YCoord
\newdimen\XCoordN
\newdimen\YCoordN
\newdimen\XCoordS
\newdimen\YCoordS
\newdimen\XCoordiN
\newdimen\YCoordiN
% \gettikzxy{(-in)} {\XCoord} {\YCoord}
\path (-in); \pgfgetlastxy{\XCoord} {\YCoord};
\gettikzxy{(-north)} {\XCoordN} {\YCoordN}
\gettikzxy{(-south)} {\XCoordS} {\YCoordS}
\gettikzxy{(#1)} {\XCoordiN}{\YCoordiN}
\pgfmathparse{atan2(\YCoordiN-\YCoordN,\XCoordiN-\XCoordN)}
\edef\nAng{\pgfmathresult}% angle in north arm
\pgfmathparse{atan2(\YCoordiN-\YCoordS,\XCoordiN-\XCoordS)}
\edef\sAng{\pgfmathresult}% angle in south arm
% In case I wanted the vector length
% \pgfmathparse{veclen(\XCoord...,\YCoord...)}
% \edef\lRadius{\pgfmathresult}%
\coordinate (llCorner) at ($(-center) - (\rectW/2,\rectH/2)$);
%Draw the joint parts
\draw [knJointStyle] (llCorner) -- ++(\rectW, 0);
\draw [knJointStyle] (llCorner) ++(0, \rectH) -- ++(\rectW, 0);
%Draw the link (axis) part
\draw [knLinkStyle] (-in) -- (-in2);
\if\argB\armTop
\draw [knLineCap,knLinkStyle] (-north) -- (-end); %arm
\fill [] (-north) -- ++(\lockRadius,0) arc (0:\nAng:\lockRadius) -- cycle; %lock, as arc
\else\
\draw [knLineCap,knLinkStyle] (-south) -- (-end); %arm
\fill [] (-south) -- ++(\lockRadius,0) arc (0:\sAng:\lockRadius) -- cycle; %lock, as arc
\fi
} %end of code for this particular pic
},
%------------------------------------------
pics/cylindrical pair F/.default={90:0.75cm},%
%param: point for link end (default: (90:0.75cm));
pics/cylindrical pair F/.style args={#1}{ % cylindrical pair in Frontal view ISO
code={
\def\diam{0.2cm} %radius
\coordinate (-center) at (0,0);
\coordinate (-in) at (-center);
\coordinate (-start) at (-in);
\coordinate (-out) at (#1);
\coordinate (-end) at (-out);
\draw [knLinkStyle] (-center) -- (#1);
\draw [knLinkStyle, fill=white] (-center) circle (\diam);
\draw [knLinkStyle, fill=black] (-center) circle (0.01);
} %end of code for this particular pic
},
%------------------------------------------
pics/planar contact pair/.default={60:0.5cm/-120:0.5cm},%
%param: point for upper link end (default: (45:0.5cm));
%param: point for lower link end (default: (-135:0.5cm));
pics/planar contact pair/.style args={#1/#2}{ % plannar link in 2D ISO. Replaces the previous plannarlink2D
code={
\def\rectW{0.9cm} %width
\def\rectH{0.2cm} %height
\draw [knJointStyle] (-0.5*\rectW,-0.5*\rectH) -- ++(0:\rectW); %horiz bottom
\draw [knJointStyle] (-0.5*\rectW, 0.5*\rectH) -- ++(0:\rectW); %horiz top
\coordinate (-north) at (0, 0.5*\rectH);
\coordinate (-south) at (0,-0.5*\rectH);
\coordinate (-center) at (0,0);
\coordinate (-end) at (#1); %top
\coordinate (-end1) at (-end);
\coordinate (-end2) at (#2); %bottom
\coordinate (-in) at (-end2); %bottom
\coordinate (-out) at (-end); %top
\coordinate (-start) at (-in);
\newdimen\XCoord \newdimen\YCoord
\newdimen\XCoordN \newdimen\YCoordN
\newdimen\XCoordS \newdimen\YCoordS
\newdimen\XCoordiN \newdimen\YCoordiN
\newdimen\XCoordiS \newdimen\YCoordiS
% \gettikzxy{(-in)} {\XCoord} {\YCoord}
\path (-in); \pgfgetlastxy{\XCoord} {\YCoord};
\gettikzxy{(-north)} {\XCoordN} {\YCoordN}
\gettikzxy{(-south)} {\XCoordS} {\YCoordS}
\gettikzxy{(#1)} {\XCoordiN}{\YCoordiN}
\gettikzxy{(#2)} {\XCoordiS}{\YCoordiS}
\pgfmathparse{atan2(\YCoordiN-\YCoordN,\XCoordiN-\XCoordN)}
\edef\nAng{\pgfmathresult}% angle in north arm
\pgfmathparse{atan2(\YCoordiS-\YCoordS,\XCoordiS-\XCoordS)}
\edef\sAng{\pgfmathresult}% angle in south arm
\draw [knLineCap,knLinkStyle] (-north) -- (-end); %arm
\fill [] (-north) -- ++(\lockRadius,0) arc (0:\nAng:\lockRadius) -- cycle;
%lock up
\draw [knLineCap,knLinkStyle] (-south) -- (-end2); %arm
\fill [] (-south) -- ++(-\lockRadius,0) arc (0:180+\sAng:-\lockRadius) -- cycle;
} %end of code for this particular pic
},
%------------------------------------------
rotating cam plate/.pic={\pic {camlink=#1};}, %ISO synonym of camlink which is the legacy name
pics/camlink/.default=-30, % default arguments for this pic
pics/camlink/.style args={#1}{ % cam link with triangular pivot ISO
code={
\coordinate (-center) at (0.2,0.33);
{ [shift=(-center),rotate=#1, local bounding box=bb] %translate into center (abbrev. for scope)
\draw [
name path global=vsCurvedLine, %needed the global because of the scope :-(
use Hobby shortcut, closed=true,
scale=-1.75,
fill=\LinkFillColor
]
(0,-0.7) .. (0.2,-0.6) .. (0,0.4) .. (-0.2,-0.6) .. (0,-0.7);
\coordinate (-out) at (0,1); %anchor point in case you need it
\coordinate (-end) at (-out);
%This can be an amuseming alternative
% \node[name path global=vsCurvedLine,
% star,
% draw,
% minimum width=2cm,
% rounded corners=5pt,
% star points=6,
% rotate=#1,
% xshift=10pt,
% yscale=1.2,
%% shading = axis, left color=blue, right color=red!30!white, shading angle=135,
% ] at (-center) {};
}
%State a vertical passing some contact point (for example the (-center))
%and extend it to the limit of the bounding box
\path let \p1=(bb.north), \p2=(-center) in coordinate (-toplimit) at (\x2,\y1);
\path let \p1=(bb.south), \p2=(-center) in coordinate (-bottomlimit) at (\x2,\y1);
\path [name path=vsVerticalLine] (-toplimit) -- (-bottomlimit);
\path [name intersections={of={vsVerticalLine} and {vsCurvedLine}}] ;
% \coordinate (-touchtop) at (intersection-1);
% \coordinate (-touchbottom) at (intersection-2);
% as intesections may change order must do a further text of which point is up...
\path let \p1=(intersection-1),
\p2=(intersection-2) in coordinate (-touchtop) at (\x1,{max(\y1,\y2)});
\path let \p1=(intersection-1),
\p2=(intersection-2) in coordinate (-touchbottom) at (\x1,{min(\y1,\y2)});
%Can do the same in horizontal
\path let \p1=(bb.west), \p2=(-center) in coordinate (-leftlimit) at (\x1,\y2);
\path let \p1=(bb.east), \p2=(-center) in coordinate (-rightlimit) at (\x1,\y2);
\path [name path=vsHorizontalLine] (-leftlimit) -- (-rightlimit);
\path [name intersections={of={vsHorizontalLine} and {vsCurvedLine}}] ;
\path let \p1=(intersection-1),
\p2=(intersection-2) in coordinate (-touchright) at ({max(\x1,\x2)},\y2);
\path let \p1=(intersection-1),
\p2=(intersection-2) in coordinate (-touchleft) at ({min(\x1,\x2)},\y2);
\draw [line join=round,fill=white] (0,0) -- (0.4,0) -- (0.2,0.33) -- cycle;
\node [ground2,minimum width=0.8cm,xshift=-0.2cm] {};% \draw [ground] (0,0) -- (0.5,0);
\draw [thick,xshift=-0.2cm] (0,0) -- (0.8,0);
\draw [fill=white] (-center) circle (\pivotRadius);
} %end of code for this particular pic
}, %end of pic
%------------------------------------------
campin/.pic={\pic {cam follower=4};}, %a way to keep compatibility with the early campin element that can now be emulated as a particular case of cam follower
%------------------------------------------
pics/cam follower/.style={ % The ISO version of campin
code={
%------------------------
\ifthenelse{ \equal{#1}{}} {\def\allArgs{/}} {\def\allArgs{#1}}
\setsepchar[.]{/} % "/" is the separator "." is the second level separator
\readlist\myArgs{\allArgs}
\ifthenelse{ \myArgslen > 0} {\itemtomacro\myArgs[1]\pinType} {\def\pinType{}}
\ifthenelse{ \myArgslen > 1} {\itemtomacro\myArgs[2]\pinDir} {\def\pinDir{}}
%Test if any parameter is blank and put the default in that case
\ifthenelse{ \equal{\pinType}{}} {\def\pinType{0}} {} %default 0 for knifeedhe
\ifthenelse{ \equal{\pinDir}{}} {\def\pinDir{0}} {} %default 0 for vertical
%----------------------
\def\KNIFEEDGE{0}
\def\ARCUATE{1}
\def\ROLLER{2}
\def\FLATFACED{3}
\def\CAMPIN{4} %A special definition for an eralier version non ISO
\def\PINVERT{0}
\def\PINHORIZ{1}
\def\armLen{1cm} %length or arm
\def\tipGap{20pt} % gap from contact to arm
\coordinate (-in) at (0,0);
\if\pinType\KNIFEEDGE %
\def\tipGap{8pt} % gap from contact to arm
\draw [knLinkStyle,line join=round] (-in) -- ++(-4pt,\tipGap) -- ++(8pt,0) -- cycle;
\else
\if\pinType\ARCUATE
\def\tipGap{6pt} % gap from contact to arm
\draw [knLinkStyle] (-6pt,\tipGap) arc (-180:0:\tipGap) -- cycle;
\else
\if\pinType\ROLLER
\def\tipGap{10pt} % gap from contact to arm
\draw [knLinkStyle,fill=white] (0,0.5*\tipGap) circle (0.5*\tipGap);
\draw [knLinkStyle,fill=white] (0,0.5*\tipGap) circle (0.25*\tipGap);
\else
\if\pinType\FLATFACED
\def\tipGap{3pt} % gap from contact to arm
\draw [knLinkStyle] (-5pt,0) rectangle ++(10pt,\tipGap);
\fi
\fi
\fi
\fi
\coordinate (-topin) at (0,\tipGap);
\if\pinDir\PINVERT %
\coordinate (-end) at (0,\armLen);
\else
\coordinate (-end) at (\armLen,\tipGap);
\fi
\draw [knLinkStyle] (-topin) -- (-end);
\coordinate (-out) at (-end);
\coordinate (-center) at (-in);
\coordinate (-start) at (-in);
\if\pinType\CAMPIN %legacy for early campin
\coordinate (-center) at (0,17pt);
\draw [fill=\LinkFillColor] (0,0)--++(2pt,4pt)--++(0,30pt)--++(-2pt,0) coordinate (-end) --++(-2pt,0)--++(0,-30pt) --cycle;
\coordinate (-out) at (-end);
\fi
} %end of code for this particular pic
}, %end of pic
%------------------------------------------
} %end of tikzset
%
%====== OTHER DEFINITIONS vsCustomLinks =================
\tikzset{ % definitions for my definitions of link pics ()
%
% Technique adapted from
https://tex.stackexchange.com/questions/218813/latex-access-every-character-of-an-string-variable using listofitems package
pics/link bar generic/.style=%
%Arg 1 -> point of end [0:30pt] %Point cannot come in ( ) because it gives problems below... :-(
%Arg 2 -> bool include the COM symbol in the geometric center [1]
%Arg 3 -> bool has pivot in -start [1]
%Arg 4 -> bool has pivot in -end [1]
%Arg 5 -> bool draw option crosshairs in extremes [0]
%Arg 6 -> line width undocumented :-) to manipulate line with
{
code={
% ----START ANALYSE ARGUMENTS AND SET DEFAULTS --------------------------
%Split joint argument in several args. If passed, use it, else put blanks.
%But first impose an empty list in case no args are passed to avoid error of readlist
\ifthenelse{ \equal{#1}{}} {\def\allArgs{/}} {\def\allArgs{#1}}
\setsepchar[.]{/} % "/" is the separator "." is the second level separator
\readlist\myArgs{\allArgs}
\ifthenelse{ \myArgslen > 0} {\def\destPoint {\myArgs[1]}} {\def\destPoint{}}
\ifthenelse{ \myArgslen > 1} {\def\hasCOM {\myArgs[2]}} {\def\hasCOM{}}
\ifthenelse{ \myArgslen > 2} {\def\hasStartPivot{\myArgs[3]}} {\def\hasStartPivot{}}
\ifthenelse{ \myArgslen > 3} {\def\hasEndPivot {\myArgs[4]}} {\def\hasEndPivot{}}
\ifthenelse{ \myArgslen > 4} {\def\hasCrossHairs{\myArgs[5]}} {\def\hasCrossHairs{}}
\ifthenelse{ \myArgslen > 5} {\def\hasThinLines {\myArgs[6]}} {\def\hasThinLines{}}
%Test if any parameter is blank and put the default in that case
\ifthenelse{ \equal{\destPoint}{}} {\def\destPoint {0:30pt}}{}
\ifthenelse{ \equal{\hasCOM}{}} {\def\hasCOM {1}} {}
\ifthenelse{ \equal{\hasStartPivot}{}}{\def\hasStartPivot{1}} {}
\ifthenelse{ \equal{\hasEndPivot}{}} {\def\hasEndPivot {1}} {}
\ifthenelse{ \equal{\hasCrossHairs}{}}{\def\hasCrossHairs{0}} {}
\ifthenelse{ \equal{\hasThinLines}{}} {\def\hasThinLines {0}} {}
%-----------------------END ANALYSE ARGUMENTS AND SET DEFAULTS -------------------
\coordinate (-start) at (\currentcoordinate);
\coordinate (-end) at (\destPoint);
\coordinate (-end1) at (-end); %a synonym for compatitility with others
%AUX CALCS
\coordinate (A) at (-start);
\coordinate (B) at ($(A)+(-end)$);
%Calculate angle of point alignment
\gettikzxy{(A)} {\XCoordA} {\YCoordA}
\gettikzxy{(B)} {\XCoordB} {\YCoordB}
\pgfmathparse{atan2(\YCoordB-\YCoordA,\XCoordB-\XCoordA)}
\edef\nAng{\pgfmathresult}%
\def\lWidth{0.75pt} %line width of drawings.
\ifthenelse{\hasThinLines=1}{\def\lWidth{0.2pt}}{}%Very very thin (0 in the limit)
%Calculate base length
\pgfmathparse{veclen(\XCoordB-\XCoordA,\YCoordB-\YCoordA)}
\edef\lRadiusS{\pgfmathresult}%
%Calculate extension factor beyond B and obtain posB
\pgfmathparse{1+5/\lRadiusS} %Extension of 5pt more to draw a pivot
\edef\lFact{\pgfmathresult}%
\coordinate (posB) at ($(A)!\lFact!(B)$); %Full extremity with the pivot point
% \coordinate (posB) at ($\lFact*(A)+(B)$); %Full extremity with the pivot point
%Calculate extension factor beyond A and obtain preA
\pgfmathparse{1+5/\lRadiusS} %Extension of 5pt more to draw a pivot
\edef\lFact{\pgfmathresult}%
\coordinate (preA) at ($(B)!\lFact!(A)$); %Full extremity with the pivot point
% \coordinate (preA) at ($\lFact*(B)+(A)$); %Full extremity with the pivot point
\def\rrWest{none} %ending type for the case in no pivot in West (left or start)
\def\rrEast{none} %ending type for the case in no pivot in East (right or end)
\ifthenelse{\hasStartPivot=1}{\def\rrWest{convex}}{\coordinate (preA) at (A);} % if using pre extension keep the calculations
\ifthenelse{\hasEndPivot=1}{\def\rrEast{convex}}{\coordinate (posB) at (B);} % if using pre extension keep the calculations
%After this point the final extremities are in preA and posB even if no pivots (coincide with A/B)
% \coordinate (-center) at ($(preA)!0.5!(posB)$);
\coordinate (-center) at ($0.5*(preA)+0.5*(posB)$);
\gettikzxy{(preA)} {\XCoordA} {\YCoordA}
\gettikzxy{(posB)} {\XCoordB} {\YCoordB}
\pgfmathparse{veclen(\XCoordB-\XCoordA,\YCoordB-\YCoordA)}
\edef\lRadius{\pgfmathresult}%
\coordinate (ppreA) at ($(preA)-(\nAng:\lWidth/2)$); %recalculate for correct drawing below
\node [rotate=\nAng,
inner sep=0,
rounded rectangle,
draw,
fill=\LinkFillColor,
line width=\lWidth, %controls line width
minimum width=\lRadius, %dimension (actually the longest dim or link length)
minimum height=10pt, %dimension (actually the shortests dim or link thickness)
% at=(-center);
at=(ppreA), %actully preA with a line width correction
anchor=west, %force this anchor to avoid external changes...
rounded rectangle west arc=\rrWest, %none, convex, concave %controls the ending type
rounded rectangle east arc=\rrEast, %none, convex, concave %controls the ending type
] () {};
\coordinate (-in) at (-start);
\coordinate (-out) at (-end);
\coordinate (-south) at ($ (-center) - (90+\nAng:5pt)$);
\coordinate (-north) at ($ (-center) + (90+\nAng:5pt)$);
\ifthenelse{\hasStartPivot=1}{\draw [fill=white] (-start) circle (\pivotRadius);}{} % draw pivot in start
\ifthenelse{\hasEndPivot=1}{\draw [fill=white] (-end) circle (\pivotRadius);}{} % draw pivot in end
\ifthenelse{\hasCOM=1}{
\tiny \addCOM %[blue] or [fill=none,draw=none], etc. %addmits that (-center) is defined
} {}
\ifthenelse{\hasCrossHairs=1}{
\draw (A) -- ++(90+\nAng:4pt) (A) -- ++(-90+\nAng:4pt) (A) -- ++(\nAng:4pt) (A) -- ++(180+\nAng:4pt);
\draw (B) -- ++(90+\nAng:4pt) (B) -- ++(-90+\nAng:4pt)(B) -- ++(\nAng:4pt) (B) -- ++(180+\nAng:4pt);} {}
} %end of code for this particular pic
},
%------------------------------------------
pics/linear joint bar/.style={% 2D linear joint bar
% arg 1 - fraction of insertion (default 0.5) - 0 is no insertion at all, 1 is fully inserted
% arg 2 - lenght of fixed part (default 1cm)
% arg 3 - boolean - has curved base (0 no - default, 1 - yes)
% arg 4 - boolean - has curved tip (0 no, 1 yes (default))
code={
% ----START ANALYSE ARGUMENTS AND SET DEFAULTS --------------------------
\ifthenelse{ \equal{#1}{}} {\def\allArgs{/}} {\def\allArgs{#1}}
\setsepchar[.]{/} % "/" is the separator "." is the second level separator
\readlist\myArgs{\allArgs}
\ifthenelse{ \myArgslen > 0} {\itemtomacro\myArgs[1]\fracDepth} {\def\fracDepth{}}
\ifthenelse{ \myArgslen > 1} {\itemtomacro\myArgs[2]\fixLen} {\def\fixLen{}}
\ifthenelse{ \myArgslen > 2} {\itemtomacro\myArgs[3]\curvBase} {\def\curvBase{}}
\ifthenelse{ \myArgslen > 3} {\itemtomacro\myArgs[4]\curvTip} {\def\curvTip{}}
%Test if any parameter is blank and put the default in that case
\ifthenelse{ \equal{\fracDepth}{}} {\def\fracDepth{0.5}} {} %default 0.5 fraction of insertion
\ifthenelse{ \equal{\fixLen}{}} {\def\fixLen{1cm}} {} %default 1cm length of fixed part
\ifthenelse{ \equal{\curvBase}{}} {\def\curvBase{0}} {} %default is no curved base
\ifthenelse{ \equal{\curvTip}{}} {\def\curvTip{1}} {} %default is to have a curved tip
%-----------------------END ANALYSE ARGUMENTS AND SET DEFAULTS -------------------
\def\iGap{2pt} %inner separation of piston from body
\def\rectH{10pt} %height of outer cyl
\begin{scope}[rotate=0] %No rotation draw it horizontally
\coordinate (-start) at (0,0);
\coordinate (-jpoint) at ($(0,0) + (\fixLen,0) $);
\coordinate (-center) at (-jpoint);
\coordinate (-end) at ($(0,0) + (2*\fixLen-\fracDepth*\fixLen,0) $); %size varies
\coordinate (-in) at (-start);
\coordinate (-out) at (-end);
\coordinate (-topright) at ([yshift=0.5*\rectH]-jpoint);
\coordinate (-topleft) at ([yshift=0.5*\rectH]-start);
\coordinate (-bottomleft) at ([yshift=-0.5*\rectH]-start);
\coordinate (-bottomright) at ([yshift=-0.5*\rectH]-jpoint);
\coordinate (-toprightS) at ([yshift={0.5*\rectH-\iGap}]-end);
\coordinate (-topleftS) at ([yshift={0.5*\rectH-\iGap}]-jpoint);
\coordinate (-bottomleftS) at ([yshift={-0.5*\rectH+\iGap}]-jpoint);
\coordinate (-bottomrightS) at ([yshift={-0.5*\rectH+\iGap}]-end);
\ifthenelse{ \equal{\curvTip}{0} }
{
\fill [\SubLinkFillColor] (-topleftS) -- (-toprightS) -- (-bottomrightS) -- (-bottomleftS) -- cycle;
}
{
\fill [\SubLinkFillColor] (-topleftS) -- (-toprightS) arc (90:-90:0.5*\rectH-\iGap) -- (-bottomleftS) -- cycle;
}
\ifthenelse{ \equal{\curvBase}{0} }
{
\draw [knLinkStyle,fill=\LinkFillColor] (-topright) -- (-topleft) -- (-bottomleft) -- (-bottomright);
}
{
\draw [knLinkStyle,fill=\LinkFillColor] (-topright) -- (-topleft) arc (90:270:0.5*\rectH) -- (-bottomright);
\draw [fill=white] (-start) circle (\pivotRadius);
}
\end{scope}
} %end of code for this particular pic
},
%------------------------------------------
pics/link polygon/.style=%
%Arg 1 -> point of -end1
%Arg 2 -> point of -end2
%...
%Arg n -> point of -endn
{
code={
%Split joint argument in several args. Empty arguments are discarded.
%But first impose a default list with onde point in case no args at all are passed to avoid error of readlist
\ifthenelse{ \equal{#1}{}} {\def\allArgs{0:30pt}} {\def\allArgs{#1}}
\ignoreemptyitems %to discard empty entries in list of arguments
\setsepchar[.]{/} % "/" is the separator; "." is separator of sperators in the separator list
\readlist\myArgs{\allArgs} %separate the argments in their own variable (myArgs[1], myArgs[2], etc...
% studying second level separators to decide which pivot to draw, but it complicates too much the decoding code. So use a defined list (macro) of booleans to decide which pivot points to draw.
%Lame solutions -- limited to a fixed number because could not implement the solution shown
\ifdefined\ListOfPivotPointsToDraw
%do nothing
\else
% \count=\myArgslen \def\ListOfPivotPointsToDraw{\loop \ifnum\count0>0 \advance\count0 by -1 {1,}\repeat}
\def\ListOfPivotPointsToDraw{1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1} %:-((
\fi
\setsepchar{,} % restore the "," separator;
\readlist\dPivots{\ListOfPivotPointsToDraw} %
\coordinate (-start) at (\currentcoordinate);
\coordinate (-in) at (-start);
%Create all -end coordinates
\foreachitem\pPoint\in\myArgs{\coordinate [at=(\pPoint),name=-end\pPointcnt] ; \coordinate [at=(\pPoint),name=-out\pPointcnt] ;}
\coordinate (-centerS) at (-start); %init this accumulator
\foreachitem\pPoint\in\myArgs{\coordinate [at=($(\pPoint)+(-centerS)$),name=-centerS] ;} %add allpoints
\coordinate (-out) at (-out1);
\coordinate (-end) at (-out);
\xdef\AllPoints{(-in)} %start with -in
\foreach \n in {1,...,\myArgslen} {\xdef\AllPoints{\AllPoints(-end\n)} } %add all -ends
\node[fit=\AllPoints] (-box){}; %create a fit box
\pgfmathsetmacro\vsWeight{1/(\myArgslen+1)} %because you cannot apply division in nodes :-(( and do not forget starting points
\coordinate (-center) at ($\vsWeight*(-centerS)$);
%Trick draw a wide line first
%%OPTION A - The best except if you want a fill pattern
\draw [line join=round, line width=10pt,rounded corners=0pt, fill=\LinkFillColor]
(-start) \foreach \n in {1,...,\myArgslen} {-- (-end\n)} -- cycle;
%... and then the same with a thinner line with the same color as fill color
\draw [\LinkFillColor, line join=round, line width=8.25pt,rounded corners=0pt, fill=\LinkFillColor]
(-start) \foreach \n in {1,...,\myArgslen} {-- (-end\n)} -- cycle;
%%OPTION B - The simplest and best for patterns but not the best for the geometry contour :-(
% \draw [line join=round, line width=0.75pt,rounded corners=0pt, pattern=north east lines]
% (-start) \foreach \n in {1,...,\myArgslen} {-- (-end\n)} -- cycle;
%%OPTION C
% %This Alternative is more elegant but not faithfull geometrically and poorer for 2 points only :-(
% \def\exFact{1.15}
% \draw [line join=round,
% line width=0.75pt,
% rounded corners=5pt,
%% fill=\LinkFillColor,
% pattern=north east lines
% ]
% ($(-center)!\exFact!(-start)$) \foreach \n in {1,...,\myArgslen} {-- ($(-center)!\exFact!(-end\n)$)} -- cycle;
%%OPTION D - Inspired in A and uses pattersn but leaves a white border. May confuse. Perhaps avoid
% \draw [line join=round, line width=10pt,rounded corners=0pt] %, fill=\LinkFillColor]
% (-start) \foreach \n in {1,...,\myArgslen} {-- (-end\n)} -- cycle;
%% %... and then the same with a thinner line with the same color as fill color
% \draw [white, line join=round, line width=8.25pt,rounded corners=0pt,fill=white]
% (-start) \foreach \n in {1,...,\myArgslen} {-- (-end\n)} -- cycle;
% \draw [draw=none,line join=round, line width=0pt,rounded corners=0pt, pattern=north east lines]
% (-start) \foreach \n in {1,...,\myArgslen} {-- (-end\n)} -- cycle;
%
%%OPTION E
%% This would be a trick with clip but not very useful since line options cannot be passed to clip :-(
% \begin{scope}
% %Sets the clipping areas and also the limits to use as bounding box of polygon
% \clip [ use as bounding box ]
% (-start) \foreach \n in {1,...,\myArgslen} {-- (-end\n)} -- cycle;
% %Draw a rectangle filled with the correct pattern
% \draw [draw=none,pattern=north east lines] (current bounding box.south west) rectangle (current bounding box.north east);
% \end{scope}
\draw [fill=white] (-start) circle (\pivotRadius); %pivot at -start
%Draw remainder pivots
\foreach \n in {1,...,\myArgslen}
{
\ifthenelse{ \dPivots[\n] = 1}
{
\draw [fill=white] (-end\n) circle (\pivotRadius); %pivot at -end\n
}{}
}
\pic at (-center) {center of mass};
} %end of code for this particular pic
},
%------------------------------------------
pics/linear piston/.style={% 2D linear piston-like pair. Replaces the previous 2
% arg 1 - fraction of insertion (default 0.5)
% arg 2 - width of inner piston plate (default 5pt)
code={
% ----START ANALYSE ARGUMENTS AND SET DEFAULTS --------------------------
% TODO Should be extended to all pics with params. Only some have it------ :-)
\ifthenelse{ \equal{#1}{}} {\def\allArgs{/}} {\def\allArgs{#1}}
\setsepchar[.]{/} % "/" is the separator "." is the second level separator
\readlist\myArgs{\allArgs}
\ifthenelse{ \myArgslen > 0} {\itemtomacro\myArgs[1]\fracDepth} {\def\fracDepth{}}
\ifthenelse{ \myArgslen > 1} {\itemtomacro\myArgs[2]\pWidth} {\def\pWidth{}}
%Test if any parameter is blank and put the default in that case
\ifthenelse{ \equal{\fracDepth}{}} {\def\fracDepth{0.5}} {} %default 0.5 fraction of insertion
\ifthenelse{ \equal{\pWidth}{}} {\def\pWidth{10pt}} {} %default 5pt width
%-----------------------END ANALYSE ARGUMENTS AND SET DEFAULTS -------------------
\def\iGap{2pt} %inner separation of piston plate from body
\def\rectH{0.5cm} %height of outer cyl
\edef\rectW{2*\iGap+\pWidth} %width of outer cyl
\def\armLen{0.4cm} %arm length
\begin{scope}[rotate=90]
\coordinate (-center) at (0,0);
\coordinate (-innerend) at ($(-center) - (0, \fracDepth*\rectH) $);
\coordinate (-start) at (0,\armLen);
% \coordinate (-start) at ($(-innerend) - (0,\rectH-\fracDepth*\rectH+\armLen) $); %Keep size
\coordinate (-end) at ($(-innerend) - (0,0.5*\rectH+\armLen) $); %size varies
\coordinate (-in) at (-start);
\coordinate (-out) at (-end);
\coordinate (-iend) at (-innerend);
\draw [knJointStyle] (-\iGap-0.5*\pWidth,-\rectH) -- ++(0,\rectH) -- ++(\rectW,0) -- ++(0, -\rectH);
\draw [knJointStyle, ultra thick] (-innerend) -- ++(-0.5*\pWidth,0)(-innerend)--++(0.5*\pWidth,0);
\draw [knLinkStyle] (-center) -- (-start) (-innerend) -- (-end);
\end{scope}
} %end of code for this particular pic
},
%------------------------------------------
}
%=========== ALTERNATIVES TO ISO =================================
\tikzset{ %definitions/pics for link symbols alternatives to ISO
%------------------------------------------
pics/rotational colinear/.style={ %~ alternative rotational joint with axis colinear with link
code={
\def\vsLen{0.6}
\def\vsAng{30}
\coordinate (-center) at (0,0);
\coordinate (BP) at ($(-center)-(0,{\vsLen*sin(\vsAng)})$); %low point
\draw [knJointStyle] (BP) -- ++(\vsAng:\vsLen) coordinate[name=RP] -- ++(180-\vsAng:\vsLen) coordinate[name=TP] -- ++(180+\vsAng:\vsLen) coordinate[name=LP] -- cycle (LP) -- (RP);
\draw [knLinkStyle] (TP) --++(0, 0.25) coordinate[name=-end];
\draw [knLinkStyle] (BP) --++(0,-0.25) coordinate[name=-start];
\coordinate (-in) at (-start);
\coordinate (-out) at (-end);
}
},
%------------------------------------------
}
%%=============== the default XYZ convention in tikz
%
% YY
% ^
% |
% |
% +-----> XX
% /
% /
% ZZ
%
%%======== ELEMENTS TO DRAW FULL CHAINS WITH 3D EQUIVALENTS =====
\tikzset{
%-----------------------------------------------------------------------
pics/linear 3D/.style={ % linear link in 3D generic that accepts one argument and no terminal lines
% Arg 1 -> direction of motion
% Meanings:
%Absent: defaults to the right (5) with simple ends drawn (for illustration)
%The remainder options do not draw end segments and add a plane for thr direction of motion:
%1 top
%2 bottom
%3 near (front/closer)
%4 far (back of page)
%5 right
%6 left
code={
\def\cubedge{0.75}% cube edge
\def\plangap{0.15}% gap of extra plane for motion indication
%0.353553=cos(45)/2
%some points below seem not perfect at larger vlues of cube size :-(
\def\halfEdge{\cubedge*0.512} %should be 0.5 but tikz is not using perfect ortogonal perspective and this is relevant for occluding cases.. :-(
\coordinate (-center) at (0,0,0); %The usual default
\coordinate (-refstart) at ($(-center)+(-\cubedge/2,-\cubedge/2,-\cubedge/2)$); %easier to start in the back left lower vertex :-)
\coordinate (-label) at ($(-refstart)+(\cubedge/4,\cubedge/4,\cubedge/4)$); %central place for a label
%Command to draw the main cube. Invoke below in the right order
\newcommand{\knDrawMainCube}{
\draw [cube face 1] (-refstart) -- ++(0,\cubedge,0) -- ++(\cubedge,0,0) -- ++(0,-\cubedge,0) -- cycle; %back
\draw [cube face 1] (-refstart) -- ++(0,0,\cubedge) -- ++(0,\cubedge,0) -- ++(0,0,-\cubedge) -- cycle; %left
\draw [cube face 1] (-refstart) -- ++(0,0,\cubedge) -- ++(\cubedge,0,0) -- ++(0,0,-\cubedge) -- cycle; %bottom
\draw [cube face 1] (-refstart) ++(0,\cubedge,0) -- ++(0,0,\cubedge) -- ++(\cubedge,0,0) -- ++(0,0,-\cubedge) -- cycle; %top
\draw [cube face 1] (-refstart) ++(\cubedge,0,0) -- ++(0,0,\cubedge) -- ++(0,\cubedge,0) -- ++(0,0,-\cubedge) -- cycle; %right
\draw [cube face 1] (-refstart) ++(0,0,\cubedge) -- ++(0,\cubedge,0) -- ++(\cubedge,0,0) -- ++(0,-\cubedge,0) -- cycle; %frontal
}
\def\arg{#1} %if absent, a default to the right with simple ends drawn (for illustration)
\def\TTT {1} %no ends extra plane to top
\def\BBB {2} %no ends extra plane to bottom
\def\NNN {3} %no ends extra plane to near (front/closer)
\def\FFF {4} %no ends extra plane to far (back of page)
\def\RRR {5} %no ends extra plane to right
\def\LLL {6} %no ends extra plane to left
%Adapt behavior depending on argument
\if\arg\TTT %1 is to draw plane on the top
\knDrawMainCube
\draw [cube face 1] (-refstart) ++(0,{\cubedge+\plangap},0) -- ++(0,0,\cubedge) -- ++(\cubedge,0,0) -- ++(0,0,-\cubedge) -- cycle; %after top
\coordinate (-east) at ($(-center)+(\cubedge/2,0,0)$);
\coordinate (-west) at ($(-center)+(-\halfEdge*1.353553,0,0)$); %adjust X for hidden line effect
\coordinate (-south) at ($(-center)+(0,-\halfEdge*1.353553,0)$); %adjust Y for hidden line effect
\coordinate (-north) at ($(-center)+(0,{\cubedge/2+\plangap},0)$);
\coordinate (-front) at ($(-center)+(-\halfEdge*0.353553,-\halfEdge*0.353553,0)$);
\coordinate (-back) at ($(-center)+(\halfEdge*1.353553,\halfEdge*1.353553,0)$);
\coordinate (-out) at (-north);
\coordinate (-in) at (-south);
\else
\if\arg\BBB %2 is to draw plane below
% \begin{pgfonlayer}{background}
\draw [cube face 1] (-refstart) ++(0,-\plangap,0) -- ++(0,0,\cubedge) -- ++(\cubedge,0,0) -- ++(0,0,-\cubedge) -- cycle; %after down
% \end{pgfonlayer}{background}
\knDrawMainCube
\coordinate (-east) at ($(-center)+(\cubedge/2,0,0)$);
\coordinate (-west) at ($(-center)+(-\halfEdge*1.353553,0,0)$); %adjust X for hidden line effect
\coordinate (-south) at ($(-center)+(0,-\halfEdge*1.353553-\plangap,0)$); %adjust Y for hidden line effect
\coordinate (-north) at ($(-center)+(0,\cubedge/2,0)$);
\coordinate (-front) at ($(-center)+(-\halfEdge*0.353553,-\halfEdge*0.353553,0)$);
\coordinate (-back) at ($(-center)+(\halfEdge*1.353553,\halfEdge*1.353553,0)$);
\coordinate (-out) at (-south);
\coordinate (-in) at (-north);
\else
\if\arg\NNN %3 is to draw plane on the front (near) far)
\knDrawMainCube
\draw [cube face 1] (-refstart) ++(0,0,\cubedge+\plangap) -- ++(\cubedge,0,0) -- ++(0,\cubedge,0) -- ++(-\cubedge,0,0) -- cycle; %afterfront
\coordinate (-east) at ($(-center)+(\cubedge/2,0,0)$);
\coordinate (-west) at ($(-center)+(-\halfEdge*1.353553-1.353553*\plangap*0.28,0,0)$); %adjust X for hidden line effect. Formula is approx but irregularities found in defining it
\coordinate (-south) at ($(-center)+(0,-\halfEdge*1.3536-1.353553*\plangap*0.28,0)$); %adjust Y for hidden line effect. Formula is approx but irregularities found in defining it
\coordinate (-north) at ($(-center)+(0,\cubedge/2,0)$);
\coordinate (-front) at ($(-center)+(-\halfEdge*0.353553-\plangap/2*0.353553,-\halfEdge*0.353553-\plangap/2*0.353553,0)$);
\coordinate (-back) at ($(-center)+(\halfEdge*1.353553,\halfEdge*1.353553,0)$);
\coordinate (-in) at (-back);
\coordinate (-out) at (-front);
\else
\if\arg\FFF %4 is to draw plane on the back far)
% \begin{pgfonlayer}{background}
\draw [cube face 1] (-refstart) ++(0,0,-\plangap) -- ++(\cubedge,0,0) -- ++(0,\cubedge,0) -- ++(-\cubedge,0,0) -- cycle;
%afterback
% \end{pgfonlayer}{background}
\knDrawMainCube
\coordinate (-east) at ($(-center)+(\cubedge/2,0,0)$);
\coordinate (-west) at ($(-center)+(-\halfEdge*1.353553,0,0)$); %adjust X for hidden line effect
\coordinate (-south) at ($(-center)+(0,-\halfEdge*1.353553,0)$); %adjust Y for hidden line effect
\coordinate (-north) at ($(-center)+(0,\cubedge/2,0)$);
\coordinate (-front) at ($(-center)+(-\halfEdge*0.353553-\plangap/2*0.353553,-\halfEdge*0.353553-\plangap/2*0.353553,0)$);
\coordinate (-back) at ($(-center)+(\halfEdge*1.353553+\plangap*0.353553,\halfEdge*1.353553+\plangap*0.353553,0)$);
\coordinate (-out) at (-back);
\coordinate (-in) at (-front);
\else
\if\arg\RRR %5 is to draw plane on the right
\knDrawMainCube
\draw [cube face 1] (-refstart) ++({\cubedge+\plangap},0,0) -- ++(0,0,\cubedge) -- ++(0,\cubedge,0) -- ++(0,0,-\cubedge) -- cycle; %afterright
\coordinate (-east) at ($(-center)+({\cubedge/2+\plangap},0,0)$);
\coordinate (-west) at ($(-center)+(-\halfEdge*1.353553,0,0)$); %adjust X for hidden line effect
\coordinate (-south) at ($(-center)+(0,-\halfEdge2*1.353553,0)$); %adjust Y for hidden line effect
\coordinate (-north) at ($(-center)+(0,\cubedge/2,0)$);
\coordinate (-front) at ($(-center)+(-\halfEdge*0.353553-\plangap/2*0.353553,-\halfEdge*0.353553-\plangap/2*0.353553,0)$);
\coordinate (-back) at ($(-center)+(\halfEdge*1.353553,\halfEdge*1.353553,0)$);
\coordinate (-out) at (-east);
\coordinate (-in) at (-west);
\else
\if\arg\LLL %6 is to draw plane on the left
% \begin{pgfonlayer}{background}
\draw [cube face 1] (-refstart) ++(-\plangap,0,0) -- ++(0,0,\cubedge) -- ++(0,\cubedge,0) -- ++(0,0,-\cubedge) -- cycle; %afterleft
% \end{pgfonlayer}
\knDrawMainCube
\coordinate (-east) at ($(-center)+(\cubedge/2,0,0)$);
\coordinate (-west) at ($(-center)+(-\halfEdge*1.353553-\plangap,0,0)$); %adjust X for hidden line effect
\coordinate (-south) at ($(-center)+(0,-\halfEdge*1.353553,0)$); %adjust Y for hidden line effect
\coordinate (-north) at ($(-center)+(0,\cubedge/2,0)$);
\coordinate (-front) at ($(-center)+(-\halfEdge*0.353553,-\halfEdge*0.353553,0)$);
\coordinate (-back) at ($(-center)+(\halfEdge*1.353553,\halfEdge*1.353553,0)$);
\coordinate (-out) at (-west);
\coordinate (-in) at (-east);
\else %other values (or none) is to draw a right and plane and simple pins right/left
\knDrawMainCube
\draw [cube face 1] (-refstart) ++({\cubedge+\plangap},0,0) -- ++(0,0,\cubedge) -- ++(0,\cubedge,0) -- ++(0,0,-\cubedge) -- cycle; %afterright
\coordinate (-east) at ($(-center)+({\cubedge/2+\plangap},0,0)$);
\coordinate (-west) at ($(-center)+(-\halfEdge*1.353553,0,0)$); %adjust X for hidden line effect
\coordinate (-south) at ($(-center)+(0,-\halfEdge2*1.353553,0)$); %adjust Y for hidden line effect
\coordinate (-north) at ($(-center)+(0,\cubedge/2,0)$);
\coordinate (-front) at ($(-center)+(-\halfEdge*0.353553-\plangap/2*0.353553,-\halfEdge*0.353553-\plangap/2*0.353553,0)$);
\coordinate (-back) at ($(-center)+(\halfEdge*1.353553,\halfEdge*1.353553,0)$);
\coordinate (-out) at (-east);
\coordinate (-in) at (-west);
\draw [knLinkStyle] (-out) -- ++(0.5cm,0) node [inner sep=0] (-neweast) {};
\draw [knLinkStyle] (-in) -- ++(-0.5cm,0) node [inner sep=0] (-newwest) {};
\coordinate (-east) at (-neweast);
\coordinate (-west) at (-newwest);
\coordinate (-out) at (-east);
\coordinate (-in) at (-west);
\fi %of LLL
\fi %RRR
\fi %of FFF
\fi %of NNN
\fi %of BBB
\fi %of TTT
\coordinate (-top) at (-north);
\coordinate (-bottom) at (-south);
\coordinate (-end) at (-out);
\coordinate (-start) at (-in);
% For illustration purposed only...
%\draw [red](-center) -- ++(3,0,0)
% (-center) -- ++(0,3,0)
% (-center) -- ++(0,0,6)
% ;
%\draw [dashed] (-center) -- ++(-3,0,0)
% (-center) -- ++(0,-3,0)
% (-center) -- ++(0,0,-6)
% ;
% \foreach \n in {A,B,C,D,E,F,G,H,J,K,O}
% \foreach \n in {in,out} %
% \foreach \n in {start,end} %
% \foreach \n in {center,east,west,north,south,front,back,in,out}%
% \fill (-\n) circle (0.5pt) node [inner sep=0,anchor=south,yshift=1pt,font={\tiny\sffamily}] {\n};
} %end of code for this particular pic
},
%-----------------------------------------------------------------------
%Generic gripper with two fingers with variable orientation
pics/gripper/.style={ %
%Arg 1 -> direction (times 90º) to orient starting with 0 to the right [0]
%Arg 2 -> bool draw in pespective[0]
code={
% ----START ANALYSE ARGUMENTS AND SET DEFAULTS --------------------------
\ifthenelse{ \equal{#1}{}} {\def\allArgs{/}} {\def\allArgs{#1}}
\setsepchar[.]{/} % "/" is the separator "." is the second level separator
\readlist\myArgs{\allArgs}
\ifthenelse{ \myArgslen > 0} {\itemtomacro\myArgs[1]\fDir} {\def\fDir{}}
\ifthenelse{ \myArgslen > 1} {\itemtomacro\myArgs[2]\fPerspective}{\def\fPerspective{}}
%Test if any parameter is blank and put the default in that case
\ifthenelse{ \equal{\fDir}{} } {\def\fDir{0}} {} %default 0 - to the right
\ifthenelse{ \equal{\fPerspective}{}}{\def\fPerspective{0}} {} %default 0 - no perspective
%-----------------------END ANALYSE ARGUMENTS AND SET DEFAULTS -------------------
\coordinate (-center) at (0,0);
\def\knxSLANT{0} %default: no slant
\def\knySCALE{1} %default: no change in y scale
\def\knYES{1}
\if\fPerspective\knYES
\def\knySCALE{0.5}
\ifodd\fDir %1,3
\def\knxSLANT{-1}
\else %even: 0,2
\def\knxSLANT{1}
\fi
\fi
%Details: if perspective is 0
% simple rotation
% if perspective is 1:
% yscale=0.5 (diagonal lengths are half in perspective)
% xslant= 1 if dir is even
% xslant=-1 if dir is odd
\begin{scope}[rotate={90*\fDir},xslant=\knxSLANT]
\coordinate (-fingertip1) at (0.5,\knySCALE*0.5);
\draw [gripper 1] (-fingertip1) -- ++(-0.5,0) -- ++(0,-1*\knySCALE) -- ++(0.5,0) coordinate (-fingertip2);
\coordinate (-in) at (0,0);
\coordinate (-start) at (-in); \coordinate (-out) at (-in); \coordinate (-end) at (-out);
\end{scope}
} %end of code for this particular pic
},
%
}
%Configurations for rotational 3D joints. Edit at will :-)
\def\Lcyl{1} %Cylinder length (1.75) %was 1.5 %was 1.25
\def\Hcyl{0.75} %Cylinder height (diameter) (1) %was 0.75
\def\Wcyl{0.15} %Ellipse minor semi-axis (valid for H and V versions) (0.2)
\def\armRight{0.3} %Arm on the right (0.4)
\def\armLeft{\armRight} %Arm on the left (similar to right)
\def\armGap{0.45} %Gap between cylinder and arm bar (0.7)
%==================== NEW VARIANTS OF NON ISO ===================
\tikzset{
%This pic can be rotated (and What about a V version to have node names consistent with actual position? Being built below)
pics/rotational 3D H/.style={ %rotational joint in 3D in Horizontal position
% Arg 1 %if absent a default with simple ends
% 0: no ends. A simple cylinder
% 1: arm at top
% 2: arm at bottom
% 3: arm at near (front/closer)
% 4: arm at far (back of page)
code={
%Draw the horizontal cylinder with visible face on the right
\draw [knJointStyle] (\Lcyl/2,0) ellipse ({\Wcyl} and \Hcyl/2); %right ellipse
\draw [knJointStyle,fill=white] (\Lcyl/2,\Hcyl/2) -- ++(-\Lcyl,0) arc (90:270:{\Wcyl} and \Hcyl/2) -- ++(\Lcyl,0) arc (270:90:{\Wcyl} and \Hcyl/2) ; %Remainder
%Create auxiliary points
\coordinate (-center) at (0,0); %center point
\coordinate (-O) at (-center); %center point
\coordinate (-A) at (\Lcyl/2,0); %right center point
\coordinate (-C) at ($(-A) + (\armRight,0)$); %east extremity
\coordinate (-B) at (-\Lcyl/2-\Wcyl,0); %right center point
\coordinate (-D) at ($(-A) - (\Lcyl,0) - (\armLeft,0)$); %west extremity
\coordinate (-E) at (0,\Hcyl/2); %top point on surface
\coordinate (-F) at (0,-\Hcyl/2); %bottom point on surface
\coordinate (-G) at ($(-E) + (0,\armGap)$); %top arm center
\coordinate (-H) at ($(-F) - (0,\armGap)$); %bottom arm center
\coordinate (-J) at ($(0,0) + (45:{\armGap+\Hcyl/4})$); %back arm center
\coordinate (-K) at ($(0,0) + (-135:{\armGap+\Hcyl/4})$); %front arm center
\coordinate (-east) at (-C);
\coordinate (-west) at (-D);
\coordinate (-label) at ($(-center)-(\Hcyl/6,0pt)$); %adjusted a bit to the left
%Define some macros to test argument
\def\arg{#1} %if absent a default with simple ends
\edef\NOENDS{0}% no ends. A simple cylinder
\def\TTT {1} %top
\def\BBB {2} %bottom
\def\NNN {3} %near (front/closer)
\def\FFF {4} %far (back of page)
%Adapt behavior depending on argument
\if\arg\TTT %1 is to draw arm on the top (use \if not \ifx !!!)
\coordinate (-south) at (-F); \coordinate (-start) at (-south); \coordinate (-in) at (-south);
\coordinate (-north) at (-G); \coordinate (-end) at (-north); \coordinate (-out) at (-north);
\draw [knLinkStyle] (-A) -- (-C) |- (-G); %upper arm
\begin{pgfonlayer}{background}
\draw [knLinkStyle] (-G) -| (-D) -- (-B); %upper arm
\end{pgfonlayer}{background}
\else
\if\arg\BBB %2 is to draw arm on the bottom
\coordinate (-south) at (-H); \coordinate (-end) at (-south); \coordinate (-out) at (-south);
\coordinate (-north) at (-E); \coordinate (-in) at (-north); \coordinate (-start) at (-north);
\draw [knLinkStyle] (-A) -- (-C) |- (-H);
\begin{pgfonlayer}{background}
\draw [knLinkStyle] (-H) -| (-D) -- (-B); %lower arm
\end{pgfonlayer}{background}
\else
\if\arg\NNN %3 is to draw arm on the front ()near)
\coordinate (-south) at (-F); \coordinate (-in2) at (-south); \coordinate (-start2) at (-south);
\coordinate (-north) at (-E);
\coordinate (-in) at ($(0,0) + (45:{0.707*\Hcyl})$);
\coordinate (-start) at (-in);
\coordinate (-out) at (-K); \coordinate (-end) at (-out);
% \draw [knJointStyle] (-A) -- (-C) to [45-] (-K) -- ++(-\Lcyl/2-\armRight,0) -- (-D) -- (-B); %front arm
\draw [knLinkStyle] (-A) -- (-C) to [45-] (-K);
\begin{pgfonlayer}{background}
\draw [knLinkStyle] (-K) -- ++(-\Lcyl/2-\armRight,0) -- (-D) -- (-B); %front arm
\end{pgfonlayer}{background}
\else
\if\arg\FFF %4 is to draw arm on the back far)
\coordinate (-south) at (-F);
\coordinate (-in) at ($(0,0) + (-135:{\Hcyl/4})$); \coordinate (-start) at (-in);
\coordinate (-north) at (-J); \coordinate (-out) at (-north); \coordinate (-end) at (-north);
% \draw [knJointStyle] (-B) -- (-D) to [45-] (-J) -- ++(\Lcyl/2+\armRight,0) -- (-C) -- (-A); % back arm
\draw [knLinkStyle] (-A) -- (-C) -- ++(45:{\Hcyl/4+\armGap}) -- (-J);
\begin{pgfonlayer}{background}
\draw [knLinkStyle] (-J) -- ++({-\Lcyl/2-\armLeft},0) -- (-D) -- (-B);
\end{pgfonlayer}
\else
\if\arg\NOENDS %0 is not to draw any ends or arms so adjust
\coordinate (-east) at (-A);
\coordinate (-west) at (-B);
\coordinate (-south) at (-F);
\coordinate (-north) at (-E);
\coordinate (-in) at (-west); \coordinate (-start) at (-in);
\coordinate (-out) at (-east); \coordinate (-end) at (-out);
\else %other values (or none) is not to draw arm only pins
\coordinate (-south) at (-F);
\coordinate (-north) at (-E);
\coordinate (-in) at (-west); \coordinate (-start) at (-in);
\coordinate (-out) at (-east); \coordinate (-end) at (-out);
\draw [knLinkStyle] (-A) -- (-C);
\begin{pgfonlayer}{background}
\draw [knLinkStyle] (-B) -- (-D);
\end{pgfonlayer}
\fi %of NOENDS
\fi %of FFF
\fi %of NNN
\fi %of BBB
\fi %of TTT
% For illustration purposed only...
% \foreach \n in {A,B,C,D,E,F,G,H,J,K,O}
% \foreach \n in {in,out} %
% \foreach \n in {start,end} %
% \foreach \n in {center,east,west,north,south} % north,south coincide with in/out
% \fill (-\n) circle (0.5pt) node [inner sep=0,anchor=south,yshift=1pt,font={\tiny\sffamily}] {\n};
}
},
%-------------------------------------------------
pics/rotational 3D P/.style={ %rotational 3D joint in perspective
% Arg 1 -> direction of the arm coming out of the cylinder
% 1 %arm on right
% 2 %arm on left
% 3 %arm up
% 4 %arm down
% 0 or no argment % raw cylinder with no ends at all
code={
%Create auxiliary points
\coordinate (-center) at (0,0); %center point
\coordinate (-O) at (-center); %center point
\coordinate (-A) at ($(-center) + (-135:{\Lcyl/4})$); %right cyl center, start point of circle
% \coordinate (-B) at ($ (-A) + (45:{\Lcyl/2+\Hcyl/2}) $); %Left cyl center
\coordinate (-B) at ($ (-A) + (45:{\Lcyl/2}) $); %Left cyl center
\coordinate (-C) at ($ (-A) + (-135:{\armRight/2)})$); %right arm extremity
\coordinate (-D) at ($ (-A) + (45:{\Lcyl/2+\armLeft/2)})$); %left arm extremity
\coordinate (-D) at ($ (-B) + (45:{\armLeft/2)})$); %left arm extremity
\coordinate (-E) at (0, \Hcyl/2); %top point of cylinder surface
\coordinate (-G) at (0, {\Hcyl/2+\armGap}); % arm center top
\coordinate (-H) at (0, {-\Hcyl/2-\armGap}); %Arm center bottom
\coordinate (-J) at ({\Hcyl/2+\armGap},0); %Arm center right
\coordinate (-K) at ({-\Hcyl/2-\armGap},0); %Arm center left
\coordinate (-L) at (\Hcyl/2,0,0); % right side of cylinder surface
\path [name path=vsLocalCirc] (-A) ellipse ({\Hcyl/2} and {\Hcyl/2});
\path [name path=vsHorizLine] (-center) -- ++(-\Hcyl,0);
\path [name path=vsVertiLine] (-center) -- ++(0,-\Hcyl);
\path [name intersections={of={vsHorizLine} and {vsLocalCirc}}] ;
\coordinate (-M) at (intersection-1); % left point of cylinder surface
\path [name intersections={of={vsVertiLine} and {vsLocalCirc}}] ;
\coordinate (-F) at (intersection-1); % Bottom point of cylinder surface
\path [name path=vsDiagLine] (-B) -- ++(45:\Hcyl);
\path [name path=vsRestOfCyl] ($(-A)+(135:{\Hcyl/2})$) --
++(45:\Lcyl/2) arc (135:-45:{\Hcyl/2} and {\Hcyl/2}) --
++(-135:\Lcyl/2) arc (-45:135:{\Hcyl/2} and {\Hcyl/2});
\path [name intersections={of={vsDiagLine} and {vsRestOfCyl}}] ;
\coordinate (-N) at (intersection-1); % far point of cylinder in diag
\coordinate (-southwest) at (-C);
\coordinate (-northeast) at (-D);
\coordinate (-label) at ($(-center)!0.7!(-D)$); %some point to place label with enough clearance
\coordinate (-near) at (-C);
\coordinate (-far) at (-D);
\coordinate (-west) at (-M); %default for simple cylinder
\coordinate (-east) at (-L); %default for simple cylinder
%Draw the perspective cylinder with visible face on the right (facing out)
%Actually it is a circle in ortogonal projection... anyway...
\draw [knJointStyle] (-A) ellipse ({\Hcyl/2} and {\Hcyl/2}); %front ellipse
\newcommand{\knDrawCylinderLateral}{
\draw [knJointStyle,fill=white] ($(-A)+(135:{\Hcyl/2})$) --
++(45:\Lcyl/2) arc (135:-45:{\Hcyl/2} and {\Hcyl/2}) --
++(-135:\Lcyl/2) arc (-45:135:{\Hcyl/2} and {\Hcyl/2}); %rest of cylinder filled with white
}
\def\arg{#1}
\def\RRR {1} %arm on right
\def\LLL {2} %arm on left
\def\UUU {3} %arm up
\def\DDD {4} %arm down
\def\NOENDS{0} %no ends at all
% \begin{pgfonlayer}{background} %Needed to take advantage of hidden lines in some arms...)
\if\arg\RRR %1 is to draw arm on the right
\coordinate (-south) at (-F); \coordinate (-start bottom) at (-south); \coordinate (-in bottom) at (-south);
\coordinate (-east) at (-J); \coordinate (-end) at (-east); \coordinate (-out) at (-east);
\coordinate (-north) at (-E); \coordinate (-in top) at (-north); \coordinate (-start top) at (-north);
\coordinate (-west) at (-M); \coordinate (-in left) at (-west); \coordinate (-start left) at (-west);
\coordinate (-in) at (-in left); \coordinate (-start) at (-start left);
%Right
%Some tricks because to [45-] forces some specific path :-(
% \draw [knLinkStyle](-A) -- (-C)(-J) to[45-] (-C)(-J) -- ++(45:{\Lcyl/4+\armLeft/2}) -- (-D) -- (-B);
% \begin{pgfonlayer}{background}
\draw [knLinkStyle] (-J) -- ++(45:{\Lcyl/4+\armLeft/2}) -- (-D) -- (-B); %back part of arm
\knDrawCylinderLateral
\draw [knLinkStyle] (-A) -- (-C) -- ++({\Hcyl/2+\armGap},0) -- (-J); %front part of arm
% \end{pgfonlayer}
\else
\if\arg\LLL %2 is to draw arm on the left
\coordinate (-south) at (-F); \coordinate (-start bottom) at (-south); \coordinate (-in bottom) at (-south);
\coordinate (-east) at (-L); \coordinate (-in right) at (-east); \coordinate (-start right) at (-east);
\coordinate (-north) at (-E); \coordinate (-in top) at (-north); \coordinate (-start top) at (-north);
\coordinate (-west) at (-K); \coordinate (-out) at (-west); \coordinate (-end) at (-west);
\coordinate (-in) at (-in right); \coordinate (-start) at (-start right);
%Left
%\draw [knJointStyle](-A) -- (-C) -- ++(180:{\Hcyl/2+\armGap}) -- (-K) to[45-] (-D) -- (-B);
% \begin{pgfonlayer}{background}
\draw [knLinkStyle](-K) to[45-] (-D) -- (-B);
% \end{pgfonlayer}
\knDrawCylinderLateral
\draw [knLinkStyle](-A) -- (-C) -- ++(180:{\Hcyl/2+\armGap}) -- (-K);
\else
\if\arg\UUU %3 is to draw arm on the upper part
\coordinate (-south) at (-F); \coordinate (-start bottom) at (-south); \coordinate (-in bottom) at (-south);
\coordinate (-east) at (-L); \coordinate (-in right) at (-east); \coordinate (-start right) at (-east);
\coordinate (-north) at (-G); \coordinate (-out) at (-north); \coordinate (-end) at (-north);
\coordinate (-west) at (-M); \coordinate (-in left) at (-west); \coordinate (-start left) at (-west);
\coordinate (-in) at (-in bottom); \coordinate (-start) at (-start bottom);
%Up
% \draw [knJointStyle](-A) -- (-C)(-G) to[45-] (-C)(-G) -- ++(45:{\Lcyl/4+\armLeft/2}) -- (-D) -- (-B);
% \begin{pgfonlayer}{background}
\draw [knLinkStyle] (-G) -- ++(45:{\Lcyl/4+\armLeft/2}) -- (-D) -- (-B); ;
% \end{pgfonlayer}
\knDrawCylinderLateral
\draw [knLinkStyle](-A) -- (-C) -- ++(0,\Hcyl/2+\armGap) -- (-G);
\else
\if\arg\DDD %4 is to draw arm on the lower part)
\coordinate (-south) at (-H); \coordinate (-end) at (-south); \coordinate (-out) at (-south);
\coordinate (-east) at (-L); \coordinate (-in right) at (-east); \coordinate (-start right) at (-east);
\coordinate (-north) at (-E); \coordinate (-in top) at (-north); \coordinate (-start top) at (-north);
\coordinate (-west) at (-M); \coordinate (-in left) at (-west); \coordinate (-start left) at (-west);
\coordinate (-in) at (-in top); \coordinate (-start) at (-start top);
%Down
%\draw [knJointStyle](-A) -- (-C) -- ++(-90:{\Hcyl/2+\armGap}) -- (-H) to[45-] (-D) -- (-B);
% \begin{pgfonlayer}{background}
\draw [knLinkStyle] (-H)to[45-] (-D) -- (-B);
% \end{pgfonlayer}
\knDrawCylinderLateral
\draw [knLinkStyle](-A) -- (-C) -- ++(-90:{\Hcyl/2+\armGap}) -- (-H);
\else
\if\arg\NOENDS %0 is to draw no extremities or arm
\coordinate (-south) at (-F);
\coordinate (-north) at (-E);
\coordinate (-southwest) at (-A);
\coordinate (-northeast) at (-B);
\coordinate (-in near) at (-A);
\coordinate (-in left) at (-M); \coordinate (-start left) at (-in left);
\coordinate (-in bottom) at (-south); \coordinate (-start bottom) at (-in bottom);
\coordinate (-in top) at (-north); \coordinate (-start top) at (-in top);
\coordinate (-out far) at (-N); \coordinate (-out right) at (-east);
\coordinate (-in) at (-in left); \coordinate (-start) at (-in);
\coordinate (-out) at (-out right); \coordinate (-end) at (-out);
\knDrawCylinderLateral
\else %other values (or none) is not to draw arm; only pins
\coordinate (-south) at (-F);
\coordinate (-north) at (-E);
\coordinate (-in) at (-near); \coordinate (-start) at (-in);
\coordinate (-out) at (-N); \coordinate (-end) at (-out);
% \begin{pgfonlayer}{background}
\draw [knLinkStyle] (-B) -- (-D);
% \end{pgfonlayer}
\knDrawCylinderLateral
\draw [knLinkStyle] (-A) -- (-C);
\fi %of NOENDS
\fi %of DDD
\fi %of UUU
\fi %of LLL
\fi %of RRR
% \end{pgfonlayer}
% For illustration purposed only...
% \foreach \n in {A,B,C,D,E,F,G,H,J,K,L,M}
% \foreach \n in {in,out} %
% \foreach \n in {start,end} %
% \foreach \n in {center,east,west,north,south} % north,south coincide with in/out
% \fill (-\n) circle (0.5pt) node [inner sep=0,anchor=south,yshift=1pt,font={\tiny\sffamily}] {\n};
}
},
%-------------------------------------------------
pics/rotational 3D V/.style={ %rotational joint in 3D in Vertical position
% Arg 1 %if absent a default with simple ends
% 0: no ends. A simple cylinder
% 1: arm at left
% 2: arm at right
% 3: arm at near (front/closer)
% 4: arm at far (back of page)
code={ %copied code orinally from the horizontal and rotated it :-)
\begin{scope}[rotate=90,yscale=-1] %use yscale -1 to have arm=1 on the right and the perspective variants in the right direction
%Draw the horizontal cylinder with visible face on the right
\draw [knJointStyle] (\Lcyl/2,0) ellipse ({\Wcyl} and \Hcyl/2); %right (top) ellipse
\draw [knJointStyle,fill=white] (\Lcyl/2,\Hcyl/2) -- ++(-\Lcyl,0) arc (90:270:{\Wcyl} and \Hcyl/2) --
++(\Lcyl,0) arc (270:90:{\Wcyl} and \Hcyl/2) ; %Remainder
%%%
\path [name path=vsDiagLine] (0,0) -- ++(45:\Hcyl);
\path [name path=vsRestOfCyl] (\Lcyl/2,\Hcyl/2) -- ++(-\Lcyl,0) arc (90:270:{\Wcyl} and \Hcyl/2) --
++(\Lcyl,0) arc (270:90:{\Wcyl} and \Hcyl/2) ;
\path [name intersections={of={vsDiagLine} and {vsRestOfCyl}}] ;
\coordinate (-N) at (intersection-1); % lateral far point of cylinder in diag
%Create auxiliary points
\coordinate (-center) at (0,0); %center point
\coordinate (-O) at (-center); %center point
\coordinate (-A) at (\Lcyl/2,0); %right center point
\coordinate (-C) at ($(-A) + (\armRight,0)$); %east extremity
\coordinate (-B) at (-\Lcyl/2-\Wcyl,0); %right center point
\coordinate (-D) at ($(-A) - (\Lcyl,0) - (\armLeft,0)$); %west extremity
\coordinate (-E) at (0,\Hcyl/2); %top point on surface
\coordinate (-F) at (0,-\Hcyl/2); %bottom point on surface
\coordinate (-G) at ($(-E) + (0,\armGap)$); %top arm center
\coordinate (-H) at ($(-F) - (0,\armGap)$); %bottom arm center
\coordinate (-J) at ($(0,0) + (45:{\armGap+\Hcyl/4})$); %back arm center
\coordinate (-K) at ($(0,0) + (-135:{\armGap+\Hcyl/4})$); %front arm center
\coordinate (-east) at (-E);
\coordinate (-west) at (-F);
\coordinate (-label) at ($(-center)-(\Hcyl/6,0pt)$); %adjusted a bit to the bottom
%Define some macros to test argument
\def\arg{#1} %if absent a default with simple ends
\edef\NOENDS{0}% no ends. A simple cylinder
\def\TTT {1} %top (when rotated - left)
\def\BBB {2} %bottom (when rotated - right)
\def\NNN {3} %near (front/closer)
\def\FFF {4} %far (back of page)
%Adapt behavior depending on argument
\if\arg\TTT %1 is to draw arm on the top (right) (use \if not \ifx !!!)
\coordinate (-south) at (-D); \coordinate (-start) at (-F); \coordinate (-in) at (-start);
\coordinate (-north) at (-C); \coordinate (-end) at (-G); \coordinate (-out) at (-end);
% \draw [knLinkStyle] (-A) -- (-C) |- (-G) -| (-D) -- (-B); %upper arm
\draw [knLinkStyle] (-A) -- (-C) |- (-G); %upper half arm
% \begin{pgfonlayer}{background} %not needed (and does not inherit all passed options :-(! )
\draw [knLinkStyle] (-G) -| (-D) -- (-B); %lower half arm
% \end{pgfonlayer}{background}
\else
\if\arg\BBB %2 is to draw arm on the bottom (left)
\coordinate (-south) at (-D); \coordinate (-end) at (-H); \coordinate (-out) at (-end);
\coordinate (-west) at (-end);
\coordinate (-north) at (-C); \coordinate (-in) at (-E); \coordinate (-start) at (-in);
% \draw [knLinkStyle] (-A) -- (-C) |- (-H) -| (-D) -- (-B); %lower arm
\draw [knLinkStyle] (-A) -- (-C) |- (-H);
% \begin{pgfonlayer}{background}
\draw [knLinkStyle] (-H) -| (-D) -- (-B); %lower arm
% \end{pgfonlayer}{background}
\else
\if\arg\NNN %3 is to draw arm on the front (near)
\coordinate (-south) at (-D); \coordinate (-in2) at (-south); \coordinate (-start2) at (-south);
\coordinate (-north) at (-C); \coordinate (-in) at (-N); \coordinate (-start) at (-in);
\coordinate (-out) at (-K); \coordinate (-end) at (-out);
% \draw [knLinkStyle] (-A) -- (-C) to [45-] (-K) -- ++(-\Lcyl/2-\armRight,0) -- (-D) -- (-B); %front arm
\draw [knLinkStyle] (-A) -- (-C) to [45-] (-K);
% \begin{pgfonlayer}{background}
\draw [knLinkStyle] (-K) -- ++(-\Lcyl/2-\armRight,0) -- (-D) -- (-B); %front arm
% \end{pgfonlayer}{background}
\else
\if\arg\FFF %4 is to draw arm on the back far)
\coordinate (-south) at (-D); \coordinate (-in) at ($(-center)+(-135:\Hcyl/4)$); \coordinate (-start) at (-in);
\coordinate (-north) at (-C); \coordinate (-out) at (-J); \coordinate (-end) at (-out);
% \draw [knLinkStyle] (-B) -- (-D) to [45-] (-J) -- ++(\Lcyl/2+\armRight,0) -- (-C) -- (-A); % back arm
\draw [knLinkStyle] (-A) -- (-C) -- ++(45:{\Hcyl/4+\armGap}) -- (-J);
\begin{pgfonlayer}{background}
\draw [knLinkStyle] (-J) -- ++({-\Lcyl/2-\armLeft},0) -- (-D) -- (-B);
\end{pgfonlayer}
\else
\if\arg\NOENDS %0 is not to draw any ends or arms so adjust
\coordinate (-east) at (-F);
\coordinate (-west) at (-E);
\coordinate (-south) at (-B);
\coordinate (-north) at (-A);
\coordinate (-in) at (-south); \coordinate (-start) at (-in);
\coordinate (-out) at (-north); \coordinate (-end) at (-out);
\else %other values (or none) is not to draw arm only pins
\coordinate (-south) at (-D);
\coordinate (-north) at (-C);
\coordinate (-in) at (-south); \coordinate (-start) at (-in);
\coordinate (-out) at (-north); \coordinate (-end) at (-out);
\draw [knLinkStyle] (-A) -- (-C);
\begin{pgfonlayer}{background}
\draw [knLinkStyle] (-B) -- (-D);
\end{pgfonlayer}
\fi %of NOENDS
\fi %of FFF
\fi %of NNN
\fi %of BBB
\fi %of TTT
% For illustration purposed only...
% \foreach \n in {A,B,C,D,E,F,G,H,J,K,O}
% \foreach \n in {in,out} %
% \foreach \n in {start,end} %
% \foreach \n in {center,east,west,north,south} % north,south coincide with in/out
% \fill (-\n) circle (0.5pt) node [inner sep=0,anchor=south,yshift=1pt,font={\tiny\sffamily}] {\n};
\end{scope}
}
},
%-------------------------------------------------
%
} %end of tikzset
%------------------------------------------------
\endinput