summaryrefslogtreecommitdiff
path: root/graphics
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2021-12-24 03:01:03 +0000
committerNorbert Preining <norbert@preining.info>2021-12-24 03:01:03 +0000
commit71bfbdc975332e32bf47112ec2d32f8491b1df40 (patch)
tree9fd890769d91f55bee8be839f70c2e41450adbac /graphics
parentefa3a013f699c533896b44e4fcb74c730e94ad34 (diff)
CTAN sync 202112240301
Diffstat (limited to 'graphics')
-rw-r--r--graphics/pgf/contrib/kinematikz/README28
-rw-r--r--graphics/pgf/contrib/kinematikz/kinematikz.sty2633
-rw-r--r--graphics/pgf/contrib/kinematikz/kinematikzmanual.pdfbin0 -> 502184 bytes
3 files changed, 2661 insertions, 0 deletions
diff --git a/graphics/pgf/contrib/kinematikz/README b/graphics/pgf/contrib/kinematikz/README
new file mode 100644
index 0000000000..485ea515cb
--- /dev/null
+++ b/graphics/pgf/contrib/kinematikz/README
@@ -0,0 +1,28 @@
+kinematikz package by Vitor Santos (vitor@ua.pt)
+Version 1.0 dated 21/Dec/2021
+
+This package provides functionalities to draw kinematic diagrams
+for mechanisms using dedicate symbols (some inspired on the ISO standard and others).
+The intention is not to represent CAD mechanical drawings of mechanisms and
+robots, but only to represent 2D and 3D kinematic chains. The package provides
+links, joints and other symbols, mostly in the form of TikZ pic objects.
+These pics can be placed in the canvas either by a central point for joints,
+and start and end points for some links.
+
+The documentation consists of a PDF manual that describes the principles with the
+syntax, examples and a reference listing of all the objects and their parameters.
+
+The package is author-maintained.
+Permission is granted to copy, distribute and/or modify this
+software under the terms of the LATEX Project Public License,
+version 1.3.1, or the GNU Public License. This software is
+provided ‘as is’, without warranty of any kind, either expressed
+or implied, including, but not limited to, the implied warranties
+of merchantability and fitness for a particular purpose.
+
+FILES:
+
+README
+kinematikz.sty
+kinematikzmanual.pdf
+
diff --git a/graphics/pgf/contrib/kinematikz/kinematikz.sty b/graphics/pgf/contrib/kinematikz/kinematikz.sty
new file mode 100644
index 0000000000..76b4b8f7de
--- /dev/null
+++ b/graphics/pgf/contrib/kinematikz/kinematikz.sty
@@ -0,0 +1,2633 @@
+\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
diff --git a/graphics/pgf/contrib/kinematikz/kinematikzmanual.pdf b/graphics/pgf/contrib/kinematikz/kinematikzmanual.pdf
new file mode 100644
index 0000000000..910e8e3895
--- /dev/null
+++ b/graphics/pgf/contrib/kinematikz/kinematikzmanual.pdf
Binary files differ