summaryrefslogtreecommitdiff
path: root/graphics/pgf
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2021-02-27 03:01:43 +0000
committerNorbert Preining <norbert@preining.info>2021-02-27 03:01:43 +0000
commit4e6fb7c03bc033485887a99d2ffeca70ef8c0644 (patch)
tree5a337396041659a71d6da3f68367402d5c4e7dfe /graphics/pgf
parent8b1159ba65d4003e969141fb034abbdc19e27c4b (diff)
CTAN sync 202102270301
Diffstat (limited to 'graphics/pgf')
-rw-r--r--graphics/pgf/contrib/blox/README3
-rw-r--r--graphics/pgf/contrib/blox/blox.dtx51
-rw-r--r--graphics/pgf/contrib/blox/blox.pdfbin424593 -> 419381 bytes
3 files changed, 38 insertions, 16 deletions
diff --git a/graphics/pgf/contrib/blox/README b/graphics/pgf/contrib/blox/README
index e8c3cff73f..7be1bae2f8 100644
--- a/graphics/pgf/contrib/blox/README
+++ b/graphics/pgf/contrib/blox/README
@@ -5,6 +5,7 @@ File Contents
..README
..blox.dtx
..blox.pdf
+..blox.sty
Purpose
This package, along with tikz, will typeset block diagrams for
@@ -18,7 +19,7 @@ package so that blox works for the MikTeX installation I have.
License.
blox: Just an English translation of the schemabloc package.
-Copyright (C) 2014 Ben Reish
+Copyright (C) 2014-2021 Ben Reish
This file may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either version 1.3
diff --git a/graphics/pgf/contrib/blox/blox.dtx b/graphics/pgf/contrib/blox/blox.dtx
index 0accefac21..568498d911 100644
--- a/graphics/pgf/contrib/blox/blox.dtx
+++ b/graphics/pgf/contrib/blox/blox.dtx
@@ -1,7 +1,7 @@
% \iffalse meta-comment
% \preamble
%
-% Copyright (C) 2014 by Ben Reish
+% Copyright (C) 2014-2021 by Ben Reish
% -----------------------------------
%
% This file may be distributed and/or modified under the
@@ -17,15 +17,18 @@
% \endpreamble
% \fi
%
+% \iffalse %% makeindex -s gind.ist -o blox.ind blox.idx \fi
+% \iffalse %% makeindex -s gglo.ist -o blox.gls blox.glo
+% \fi
% \iffalse
%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
%<package>\ProvidesPackage{blox}%
-%<package>[2014/08/20 v2.5 Just an English translation of schemabloc]
+%<package>[2021/2/22 v2.51 Just an English translation of schemabloc]
%
%<*batchfile>
\begingroup
%%
-%% Copyright (C) 2014 by Ben Reish
+%% Copyright (C) 2014-2021 by Ben Reish
%%
%% This file may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either
@@ -42,7 +45,7 @@
\usedir{tex/latex/blox}
\preamble
This is a generated file.
-Copyright (C) 2014 by Ben Reish
+Copyright (C) 2014-2021 by Ben Reish
This file may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either
version 1.3 of this license or (at your option) any later
@@ -84,7 +87,7 @@ LaTeX version 1999/12/01 or later.
%</driver>
% \fi
%
-% \CheckSum{261}
+% \CheckSum{267}
%
% \CharacterTable
% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -260,7 +263,7 @@ LaTeX version 1999/12/01 or later.
% There are several commands for making blocks in the \blox\ package. They are context sensitive, so where you use them matters. Some do multiple things.
%
% \DescribeMacro{\bXBloc}
-% Usually, something happens inside a block of a block diagram. You'll want to describe what is happening inside the block. The first command for making blocks in \textsf{bloX} is |\bXBloc|\oarg{distance}\marg{Name}\marg{Contents}\marg{Previous Node}. This command makes a single block outline around whatever is in \meta{contents} and places it to the right of \meta{Previous Node} by \meta{distance} units (the default is 2).
+% Usually, something happens inside a block of a block diagram. You'll want to describe what is happening inside the block. The first command for making blocks in \textsf{blox} is |\bXBloc|\oarg{distance}\marg{Name}\marg{Contents}\marg{Previous Node}. This command makes a single block outline around whatever is in \meta{contents} and places it to the right of \meta{Previous Node} by \meta{distance} units (the default is 2).
%
% \DescribeMacro{\bXBlocL}
% The second command for making blocks to the right of the last item is |\bXBlocL|\oarg{distance}\marg{Name}\marg{Contents}\marg{Previous Node}. This command makes a block outline around whatever is in \meta{contents} and places it to the right of \meta{Previous Node} by \meta{distance} units (the default is 2) and then draws the connecting link between \meta{Previous Node} and the new block. (This is a slight labor savings if you don't want to label the link between the two.)
@@ -379,6 +382,10 @@ LaTeX version 1999/12/01 or later.
% |\bXLinkyx|\marg{Previous Node}\marg{Next Node} is the syntax. It creates a link which goes vertically, makes a right angle, and then goes horizontally. It has no label.
%
% To create a feedback loop where there is measurement noise, use |\bXLinkyx|, then create the noise block with |\bXBlocr|, and then use |\bXLinkxy| to finish the feedback loop. If no noise is in the measurement, then use a return.
+%
+% \DescribeMacro{\bXLinktyx}\DescribeMacro{\bXLinktb}
+% |\bXLinktyx|\marg{Previous Node}\marg{Next Node} draws a link from the top, center of \meta{Previous Node} to the closest horizontal connecting node on \meta{Next Node} via a right-angle turn. |\bXLinktb|\marg{Previous Node}\marg{Next Node} draws a link from the top, center of \meta{Previous Node} to the bottom, center connecting node on \meta{Next Node} in a straight line. Neither macro accounts for creating a label. If a label is required, use |\bXBranchy|, or |\bXBranchx| and |\bXLinkName|.
+% \changes{v2.51}{2014/12/04}{Added description of \texttt{bXLinktyx} and \texttt{bXLinktb} macros.}
%
% \subsection{Returns}
% Returns are what I generalized the simple feedback loop as: a line connecting the end of a linear block diagram to the beginning.
@@ -417,17 +424,17 @@ LaTeX version 1999/12/01 or later.
%
% \begin{figure}
% \centering
-% \begin{minipage}{.45\textwidth}
+% \begin{minipage}{.6\textwidth}
% \begin{tikzpicture}
% \bXInput[r]{A}
-% \bXLoop[1.25]{A}{c/Md,d/kid,e/$4<$}
+% \bXLoop[2]{A}{c/Md,d/kid,e/$4<$}
% \end{tikzpicture}
% \end{minipage}\hfil
-% \begin{minipage}{.45\textwidth}
+% \begin{minipage}{.4\textwidth}\vrbfnt
% \begin{verbatim}
% \begin{tikzpicture}
% \bXInput[r]{A}
-% \bXLoop[1.5]{A}{c/Md,d/kid,e/$4<$}
+% \bXLoop[2]{A}{c/Md,d/kid,e/$4<$}
% \end{tikzpicture}
% \end{verbatim}
% \end{minipage}
@@ -485,7 +492,7 @@ LaTeX version 1999/12/01 or later.
% \bXStyleBlocDefault
% \bXBloc[4]{H}{$P_3(s)$}{G}\bXLink[$y_2=u_3$]{G}{H}
% \bXReturn{G-H}{D}{}
-% \end{tiny
+% \end{tiny}
% \bXOutput{I}{H}\bXLink[$y_3$]{H}{I}
% \bXLabelStyle{green!80!black}
% \bXLineStyle{dashed, brown, text=purple}
@@ -642,8 +649,8 @@ LaTeX version 1999/12/01 or later.
% Normal beginning package commands to provide for making sure the package works correctly.
% \begin{macrocode}
\typeout{* }
-\typeout{bloX: Just an English translation of schemabloc package.}
-\typeout{bloX Copyright (C) 2014 Ben Reish}
+\typeout{blox: Just an English translation of schemabloc package.}
+\typeout{blox Copyright (C) 2014-2021 Ben Reish}
\typeout{* }
\typeout{This program comes with ABSOLUTELY NO WARRANTY.}
\typeout{This is free software, and you are welcome to redistribute it}
@@ -814,8 +821,9 @@ node distance=#1em,bXStyleBlocPotato,right] (#2) {#3};
% \end{macrocode}
% \end{macro}
%
-% \begin{macro}{\bXLink}\begin{macro}{\bXLinkxy}\begin{macro}{\bXLinkyx}
-% These macros tell \stikz\ where to place links, between which blocks. The normal macro is |\bXLink| which takes 3 arguments. It draws straight lines between the right edge of the previous node and the left edge of the next node. It names the link \meta{Previous Node}-\meta{Next Node}. This allows the selection of the middle of the link between to blocks for the having a return link drawn from. This macro will draw diagonal lines between nodes on different branches of a diagram. To maintain square corners, use the |\bXLinkxy| to go first horizontally, then vertically; or use |\bXLinkyx| to go first vertically and then horizontally.
+% \begin{macro}{\bXLink}\begin{macro}{\bXLinkxy}\begin{macro}{\bXLinkyx}\begin{macro}{\bXLinktyx}\begin{macro}{\bXLinktb}
+% These macros tell \stikz\ where to place links, between which blocks. The normal macro is |\bXLink| which takes 3 arguments. It draws straight lines between the right edge of the previous node and the left edge of the next node. It names the link \meta{Previous Node}-\meta{Next Node}. This allows the selection of the middle of the link between to blocks for the having a return link drawn from. This macro will draw diagonal lines between nodes on different branches of a diagram. To maintain square corners, use the |\bXLinkxy| to go first horizontally, then vertically; or use |\bXLinkyx| to go first vertically and then horizontally. To link from the top of the first block to the next block horizontally, use |\bXLinktyx| and to link from the top of the first block to the bottom of the second block, use |\bXLinktb|.
+% \changes{v2.51}{2014/12/04}{Added \texttt{bXLinktyx} and \texttt{bXLinktb} to be able to link blocks from the top of the starting block}
% \begin{macrocode}
\newcommand{\bXLink}[3][]{
\draw [bXLineStyle,auto] (#2) -- node[name=#2-#3] {#1} (#3);
@@ -828,6 +836,19 @@ node distance=#1em,bXStyleBlocPotato,right] (#2) {#3};
node[name=#2-#3,near end,right] {#1} (#3) ;
}
% \end{macrocode}
+% This macro draws a right-angled line between two nodes, the top of the first argument and the east or west side of the second argument. \stikz\ will try to connect to the closest node. There is no label making option.
+% \begin{macrocode}
+\newcommand{\bXLinktyx}[2]{
+ \draw [bXLineStyle] (#1.north) |- (#2) ;
+}
+% \end{macrocode}
+% This macro draws a straight line between two nodes, the top of the first argument and the bottom of the second argument. It can be a diagonal line. There is no label making option.
+% \begin{macrocode}
+\newcommand{\bXLinktb}[2]{
+ \draw [bXLineStyle] (#1.north) -- (#2.south) ;
+}
+% \end{macrocode}
+% \end{macro}\end{macro}
% \begin{macro}{\bXReturn}
% This macro creates two nodes, one directly below the second argument and one directly below the third argument. Then it draws straight lines to connect them.
% \begin{macrocode}
diff --git a/graphics/pgf/contrib/blox/blox.pdf b/graphics/pgf/contrib/blox/blox.pdf
index f6d2abd72c..28faf1c893 100644
--- a/graphics/pgf/contrib/blox/blox.pdf
+++ b/graphics/pgf/contrib/blox/blox.pdf
Binary files differ