parameters - Latex Tikz/Pgf 声明带有参数的形状和带有数字的 anchor

Question

我正在用 pgf 编写一些形状，我并不真正了解它是如何工作的，但我设法阅读了文档。

\pgfdeclareshape{reg}{
  % The 'minimum width' and 'minimum height' keys, not the content, determine
  % the size
  \savedanchor\northeast{%
    \pgfmathsetlength\pgf@x{\pgfshapeminwidth}%
    \pgfmathsetlength\pgf@y{\pgfshapeminheight}%
    \pgf@x=0.11\pgf@x
    \pgf@y=0.15\pgf@y
  }
  % This is redundant, but makes some things easier:
  \savedanchor\southwest{%
    \pgfmathsetlength\pgf@x{\pgfshapeminwidth}%
    \pgfmathsetlength\pgf@y{\pgfshapeminheight}%
    \pgf@x=-0.11\pgf@x
    \pgf@y=-0.15\pgf@y
  }
  % Inherit from rectangle
  \inheritanchorborder[from=rectangle]

  % Define same anchor a normal rectangle has
  \anchor{center}{\pgfpointorigin}
  \anchor{north}{\northeast \pgf@x=0pt}
  \anchor{east}{\northeast \pgf@y=0pt}
  \anchor{south}{\southwest \pgf@x=0pt}
  \anchor{west}{\southwest \pgf@y=0pt}
  \anchor{north east}{\northeast}
  \anchor{north west}{\northeast \pgf@x=-\pgf@x}
  \anchor{south west}{\southwest}
  \anchor{south east}{\southwest \pgf@x=-\pgf@x}
  \anchor{text}{
    \pgfpointorigin
    \advance\pgf@x by -.5\wd\pgfnodeparttextbox%
    \advance\pgf@y by -.5\ht\pgfnodeparttextbox%
    \advance\pgf@y by +.5\dp\pgfnodeparttextbox%
  }

  % Define anchors for signal ports

  \anchor{CLK}{
    \pgf@process{\northeast}%
    \pgf@x=0\pgf@x%
    \pgf@y=1\pgf@y%
  }
  \anchor{PC}{
    \pgf@process{\northeast}%
    \pgf@x=-2.5\pgf@x%
    \pgf@y=0\pgf@y%
  }

  \anchor{PCS}{
    \pgf@process{\northeast}%
    \pgf@x=2.5\pgf@x%
    \pgf@y=0\pgf@y%
  }

  % Draw the rectangle box and the port labels
  \backgroundpath{
    % Rectangle box
    \pgfpathrectanglecorners{\southwest}{\northeast}

    % Drawing Triangle for clock input
    % upper left x
    \southwest \pgf@xa=\pgf@x 
    \northeast \pgf@ya=\pgf@y \pgf@yb=\pgf@y \pgf@xb=\pgf@x
    \pgf@anchor@reg@CLK
    \pgf@xc=\pgf@x \pgf@yc=\pgf@y
    \pgfmathsetlength\pgf@x{1.3ex}
    \advance\pgf@xa by .15mm
    \advance\pgf@xb by -.15mm
    \advance\pgf@yc by -\pgf@x
    \pgfpathmoveto{\pgfpoint{\pgf@xa}{\pgf@ya}}
    \pgfpathlineto{\pgfpoint{\pgf@xb}{\pgf@yb}}
    \pgfpathlineto{\pgfpoint{\pgf@xc}{\pgf@yc}}
    \pgfclosepath


    \tikzset{flip flop/port labels} % Use font from this style
    \tikz@textfont



    %Drawing CLK circuit
    \pgf@anchor@reg@CLK
    \pgf@xa=\pgf@x \pgf@ya=\pgf@y
    \pgf@xb=\pgf@x \pgf@yb=\pgf@y
    \pgfmathsetlength\pgf@x{1.8ex}
    \advance\pgf@yb by \pgf@x
    \pgfpathmoveto{\pgfpoint{\pgf@xa}{\pgf@ya}}
    \pgfpathlineto{\pgfpoint{\pgf@xb}{\pgf@yb}}
    %Draw clock label
    \pgf@anchor@reg@CLK\pgftext[base,at={\pgfpoint{\pgf@x}{\pgf@y}}]{\raisebox{2.5ex}{CLK}}

    %Drawing PC circuit
    \pgf@anchor@reg@PC
    \pgf@ya=\pgf@y \pgf@yb=\pgf@y \pgf@xa=\pgf@x
    \pgf@anchor@reg@west
    \pgf@xb=\pgf@x 
    %\pgfmathsetlength\pgf@x{2.7ex}
    %\advance\pgf@xb by \pgf@x
    \pgfpathmoveto{\pgfpoint{\pgf@xa}{\pgf@ya}}
    \pgfpathlineto{\pgfpoint{\pgf@xb}{\pgf@yb}}
    \pgf@anchor@reg@PC\pgftext[base,at={\pgfpoint{\pgf@x+0.5ex}{\pgf@y}}]{\raisebox{.5ex}{PC}}

    %Drawing PC' circuit
    \pgf@anchor@reg@PCS
    \pgf@ya=\pgf@y \pgf@yb=\pgf@y\pgf@xa=\pgf@x 
    \pgf@anchor@reg@east
    \pgf@xb=\pgf@x 
    %\pgfmathsetlength\pgf@x{2.5ex}
    %\advance\pgf@xb by \pgf@x
    \pgfpathmoveto{\pgfpoint{\pgf@xa}{\pgf@ya}}
    \pgfpathlineto{\pgfpoint{\pgf@xb}{\pgf@yb}}
    \pgf@anchor@reg@PCS\pgftext[base,at={\pgfpoint{\pgf@x}{\pgf@y}}]{\raisebox{.5ex}{PC'}}
  }

}

我在这里创建了一个形状，在外面有一些连接点，它实际上效果很好。但是我真的很想在创建这个形状时有一个参数，这样我就可以指定端口的数量。

比如像这样

\begin{tikzpicture}
    \node [reg,black!50,ports=3] (PC) at (0,0) {};
\end{tikzpicture}

但我在文档中找不到允许自定义参数的内容。我还想将 anchor 命名为 A1、A2 和 A3，但我似乎无法在名称中添加数字，即使在文档中它明确表示像“1”和“::”这样的名称应该没问题，但仍然“A1”是。

如果有人对如何执行此操作有任何想法，我将感谢您的帮助。也许还有一些关于使用 pgf 创建形状的更好引用。

为了编辑 tex 文件，我使用 Overleaf 和 pdflatex。

编辑:我现在发现您可以使用 \pgfkeys 向形状添加参数，但它们似乎无法正常工作，我真的不知道该怎么做。

\def\microarchbasekey{/tikz/microarch}
\pgfkeys{\microarchbasekey/.is family}

\pgfdeclareshape{mux}{

    \pgfkeys{\microarchbasekey,inputs/.initial=2,spacing/.initial=5}

    \savedmacro{\numpins}{
        \def\numpins{\pgfkeysvalueof{\microarchbasekey/inputs}}
    }

    \saveddimen{\spacing}{
        \pgf@x = \pgfkeysvalueof{\microarchbasekey/spacing}
    }

%a lot of code down there
}

但它给了我以下错误

A number should have been here; I inserted `0'.
(If you can't figure out why I needed to see a number,
look up `weird error' in the index to The TeXbook.)

但我找不到代码的缺失部分。

Answer 1

可能这是一个更适合 TeX/LaTeX site 的问题, 但无论如何...

关键的事情如下:

1. 为参数添加键。注意层次结构，node 需要 /tikz 系列下的键:

   %
   % better to create a family, but as an example...
   \tikzset{flip flop/port labels/.initial={\tiny}}
   %
   % number of ports
   \tikzset{ports/.initial=4}
   %
   % we need a counter
   \newcount\tmp@a
   

2. 添加稳定(链接到特定节点，而不是通用形状)参数，所有这些都是计算 anchor 位置所需的:

   % you have to save the relevant parameters as \savedmacro
       \savedmacro\numports{
           \edef\numports{\pgfkeysvalueof{/tikz/ports}}%
       }
       % and \saveddimen
       \saveddimen\pinsdelta{
           % you can't use savedmacros nor savedanchors here (bummer!)
           \edef\numports{\pgfkeysvalueof{/tikz/ports}}%
           \pgfmathsetlength\pgf@x{0.22*\pgfshapeminheight/(\numports+1)}%
       }
   

3. 在形状定义中，您必须使用技巧添加 anchor --- anchor 必须添加到形状内部函数中。危险，因为开发人员可以在将来更改它(它已经发生了)，但我不知道其他办法。

   % create input anchors
       % this touch internal things, so beware...
       % anchors are named pgf@anchor@<name-of-the-shape>@<name of the anchors>
       \pgfutil@g@addto@macro\pgf@sh@s@reg{%
           \tmp@a=\numports\relax
           \pgfmathloop%
           \ifnum\pgfmathcounter>\tmp@a%
           \else%
           % assign the anchor "in \pgfmathcounter" to the macro \reg@port with the number as argument
           \expandafter\xdef\csname pgf@anchor@reg@in \pgfmathcounter\endcsname{%
               \noexpand\reg@port{\pgfmathcounter}% defined below
           }%
           % \typeout{YAY\space\pgfmathcounter}
           \repeatpgfmathloop%
       }
   

4. 定义计算变量 anchor 的具体函数。您必须在此处仅使用 \saved... 类型的参数，否则，您的 anchor 将使用参数的最后一个值，而不是节点指定的正确值。

   \def\reg@port#1{%
       % this macro has the function to return the position of the anchor
       % it must use only \savedanchors and \savedmacros
       % the parameter is the number of the anchor (see above)
       \northeast
       \pgf@x=-\pgf@x
       \pgf@ya=\pgf@y
       \pgfmathsetlength{\pgf@y}{\pgf@ya-(#1+0.5)*\pinsdelta}%
   }
   

现在，我不明白你是如何画出你的形状的，所以 anchor 不在它们应该去的地方，但是好吧:

我的完整代码在这里:

\documentclass[border=10pt]{standalone}
\usepackage{tikz}
\makeatletter
%
% better to create a family, but as an example...
\tikzset{flip flop/port labels/.initial={\tiny}}
%
% number of ports
\tikzset{ports/.initial=4}
%
% we need a counter
\newcount\tmp@a

\pgfdeclareshape{reg}{

    % you have to save the relevant parameters as \savedmacro
    \savedmacro\numports{
        \edef\numports{\pgfkeysvalueof{/tikz/ports}}%
    }
    % and \saveddimen
    \saveddimen\pinsdelta{
        % you can't use savedmacros nor savedanchors here (bummer!)
        \edef\numports{\pgfkeysvalueof{/tikz/ports}}%
        \pgfmathsetlength\pgf@x{0.22*\pgfshapeminheight/(\numports+1)}%
    }

    % The 'minimum width' and 'minimum height' keys, not the content, determine
    % the size
    \savedanchor\northeast{%
        \pgfmathsetlength\pgf@x{\pgfshapeminwidth}%
        \pgfmathsetlength\pgf@y{\pgfshapeminheight}%
        \pgf@x=0.11\pgf@x
        \pgf@y=0.15\pgf@y
    }
    % This is redundant, but makes some things easier:
    \savedanchor\southwest{%
        \pgfmathsetlength\pgf@x{\pgfshapeminwidth}%
        \pgfmathsetlength\pgf@y{\pgfshapeminheight}%
        \pgf@x=-0.11\pgf@x
        \pgf@y=-0.15\pgf@y
    }
    % Inherit from rectangle
    \inheritanchorborder[from=rectangle]

    % Define same anchor a normal rectangle has
    \anchor{center}{\pgfpointorigin}
    \anchor{north}{\northeast \pgf@x=0pt}
    \anchor{east}{\northeast \pgf@y=0pt}
    \anchor{south}{\southwest \pgf@x=0pt}
    \anchor{west}{\southwest \pgf@y=0pt}
    \anchor{north east}{\northeast}
    \anchor{north west}{\northeast \pgf@x=-\pgf@x}
    \anchor{south west}{\southwest}
    \anchor{south east}{\southwest \pgf@x=-\pgf@x}
    \anchor{text}{
        \pgfpointorigin
        \advance\pgf@x by -.5\wd\pgfnodeparttextbox%
        \advance\pgf@y by -.5\ht\pgfnodeparttextbox%
        \advance\pgf@y by +.5\dp\pgfnodeparttextbox%
    }

    % Define anchors for signal ports

    \anchor{CLK}{
        \pgf@process{\northeast}%
        \pgf@x=0\pgf@x%
        \pgf@y=1\pgf@y%
    }
    \anchor{PC}{
        \pgf@process{\northeast}%
        \pgf@x=-2.5\pgf@x%
        \pgf@y=0\pgf@y%
    }

    \anchor{PCS}{
        \pgf@process{\northeast}%
        \pgf@x=2.5\pgf@x%
        \pgf@y=0\pgf@y%
    }

    % Draw the rectangle box and the port labels
    \backgroundpath{
        % Rectangle box
        \pgfpathrectanglecorners{\southwest}{\northeast}

        % Drawing Triangle for clock input
        % upper left x
        \southwest \pgf@xa=\pgf@x
        \northeast \pgf@ya=\pgf@y \pgf@yb=\pgf@y \pgf@xb=\pgf@x
        \pgf@anchor@reg@CLK
        \pgf@xc=\pgf@x \pgf@yc=\pgf@y
        \pgfmathsetlength\pgf@x{1.3ex}
        \advance\pgf@xa by .15mm
        \advance\pgf@xb by -.15mm
        \advance\pgf@yc by -\pgf@x
        \pgfpathmoveto{\pgfpoint{\pgf@xa}{\pgf@ya}}
        \pgfpathlineto{\pgfpoint{\pgf@xb}{\pgf@yb}}
        \pgfpathlineto{\pgfpoint{\pgf@xc}{\pgf@yc}}
        \pgfclosepath


        \tikzset{flip flop/port labels} % Use font from this style
        \tikz@textfont



        %Drawing CLK circuit
        \pgf@anchor@reg@CLK
        \pgf@xa=\pgf@x \pgf@ya=\pgf@y
        \pgf@xb=\pgf@x \pgf@yb=\pgf@y
        \pgfmathsetlength\pgf@x{1.8ex}
        \advance\pgf@yb by \pgf@x
        \pgfpathmoveto{\pgfpoint{\pgf@xa}{\pgf@ya}}
        \pgfpathlineto{\pgfpoint{\pgf@xb}{\pgf@yb}}
        %Draw clock label
        \pgf@anchor@reg@CLK\pgftext[base,at={\pgfpoint{\pgf@x}{\pgf@y}}]{\raisebox{2.5ex}{CLK}}

        %Drawing PC circuit
        \pgf@anchor@reg@PC
        \pgf@ya=\pgf@y \pgf@yb=\pgf@y \pgf@xa=\pgf@x
        \pgf@anchor@reg@west
        \pgf@xb=\pgf@x
        %\pgfmathsetlength\pgf@x{2.7ex}
        %\advance\pgf@xb by \pgf@x
        \pgfpathmoveto{\pgfpoint{\pgf@xa}{\pgf@ya}}
        \pgfpathlineto{\pgfpoint{\pgf@xb}{\pgf@yb}}
        \pgf@anchor@reg@PC\pgftext[base,at={\pgfpoint{\pgf@x+0.5ex}{\pgf@y}}]{\raisebox{.5ex}{PC}}

        %Drawing PC' circuit
        \pgf@anchor@reg@PCS
        \pgf@ya=\pgf@y \pgf@yb=\pgf@y\pgf@xa=\pgf@x
        \pgf@anchor@reg@east
        \pgf@xb=\pgf@x
        %\pgfmathsetlength\pgf@x{2.5ex}
        %\advance\pgf@xb by \pgf@x
        \pgfpathmoveto{\pgfpoint{\pgf@xa}{\pgf@ya}}
        \pgfpathlineto{\pgfpoint{\pgf@xb}{\pgf@yb}}
        \pgf@anchor@reg@PCS\pgftext[base,at={\pgfpoint{\pgf@x}{\pgf@y}}]{\raisebox{.5ex}{PC'}}
    }

    % create input anchors
    % this touch internal things, so beware...
    % anchors are named pgf@anchor@<name-of-the-shape>@<name of the anchors>
    \pgfutil@g@addto@macro\pgf@sh@s@reg{%
        \tmp@a=\numports\relax
        \pgfmathloop%
        \ifnum\pgfmathcounter>\tmp@a%
        \else%
        % assign the anchor "in \pgfmathcounter" to the macro \reg@port with the number as argument
        \expandafter\xdef\csname pgf@anchor@reg@in \pgfmathcounter\endcsname{%
            \noexpand\reg@port{\pgfmathcounter}% defined below
        }%
        % \typeout{YAY\space\pgfmathcounter}
        \repeatpgfmathloop%
    }

}
%
\def\reg@port#1{%
    % this macro has the function to return the position of the anchor
    % it must use only \savedanchors and \savedmacros
    % the parameter is the number of the anchor (see above)
    \northeast
    \pgf@x=-\pgf@x
    \pgf@ya=\pgf@y
    \pgfmathsetlength{\pgf@y}{\pgf@ya-(#1+0.5)*\pinsdelta}%
}
\makeatother

%%% handy macro to show the anchors

\def\showcoord(#1)<#2:#3>{%
    node[circle, red, draw, inner sep=1pt,pin={%
        [red, inner sep=0.5pt, font=\small,
        pin distance=#3cm, pin edge={red, }%
    ]#2:#1}](#1){}}

\begin{document}
\begin{tikzpicture}
    \node [draw,reg,minimum width=3cm, minimum height=3cm, black!50] (PC1) at (0,0) {};
    \path (PC1.north west) \showcoord(NW)<45:0.2>;
    \node [draw, reg,black!50,minimum width=3cm, minimum height=5cm, ports=6, blue] (PC2) at (3,0) {};
    \foreach \p in {1,...,4} \path(PC1.in \p) \showcoord(in \p)<145:0.3>;
    \foreach \p in {1,...,6} \path(PC2.in \p) \showcoord(in \p)<145:0.3>;
\end{tikzpicture}
\end{document}