texlive[55966] Master/texmf-dist: pinoutikz (27jul20)

commits+karl at tug.org commits+karl at tug.org
Mon Jul 27 23:40:59 CEST 2020


Revision: 55966
          http://tug.org/svn/texlive?view=revision&revision=55966
Author:   karl
Date:     2020-07-27 23:40:58 +0200 (Mon, 27 Jul 2020)
Log Message:
-----------
pinoutikz (27jul20)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/latex/pinoutikz/README.md
    trunk/Master/texmf-dist/doc/latex/pinoutikz/pinoutikz_doc_en.pdf
    trunk/Master/texmf-dist/doc/latex/pinoutikz/pinoutikz_doc_en.tex
    trunk/Master/texmf-dist/tex/latex/pinoutikz/pinoutikz.sty

Modified: trunk/Master/texmf-dist/doc/latex/pinoutikz/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/pinoutikz/README.md	2020-07-27 21:39:14 UTC (rev 55965)
+++ trunk/Master/texmf-dist/doc/latex/pinoutikz/README.md	2020-07-27 21:40:58 UTC (rev 55966)
@@ -1,8 +1,8 @@
 							_________________
 
 							pinoutikz package
-								  1.1.1
-							   2019/12/02
+								  1.1.2
+							   2020/07/27
 							_________________
 
 This package provides macros for chip pinout diagrams typesetting.
@@ -31,6 +31,9 @@
 
 Revision history:
 ------------------------------------------------------------------------------
+Version 1.1.2, 2020/07/27 (against 1.1.1)
+* Solved: https://tex.stackexchange.com/questions/555013/how-can-i-overlay-annotation-on-a-pinoutikz-figure
+* Pinout diagrams can be used as glyphs (PDIP, PLCC, ...) or as picture elements (pctPDIP, pctPLCC, ...)
 Version 1.1.1, 2019/12/02 (against 1.1.0)
 * PLCC package: 1st-pin index added
 * Documentation updated

Modified: trunk/Master/texmf-dist/doc/latex/pinoutikz/pinoutikz_doc_en.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/pinoutikz/pinoutikz_doc_en.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/pinoutikz/pinoutikz_doc_en.tex	2020-07-27 21:39:14 UTC (rev 55965)
+++ trunk/Master/texmf-dist/doc/latex/pinoutikz/pinoutikz_doc_en.tex	2020-07-27 21:40:58 UTC (rev 55966)
@@ -42,7 +42,11 @@
 	classoffset=1,%
 	morekeywords={% macros and commands of pinouTikz
 		PDIP,%
+		pctPDIP,%
 		PLCC,%
+		pctPLCC,%
+		TQFP,%
+		pctTQFP,%
 		SOP},%
 	keywordstyle=\color{@xs at keywordspinouTikz},%
 	classoffset=0}
@@ -111,7 +115,7 @@
 This package defines macros for generating symbolic pinout diagrams for different package classes, such as DIP, PLCC, etc.
 
 \subsection{Motivation}
-Whoever has ever had to do with FPGA or MCUs (whether for living and leisure), it's just natural he or she might have been in a need to document some pins. So was my case and since I failed in finding any package in \LaTeX{} to suit my needs, I opted for creating one myself.
+Whoever has ever had to do with FPGA or MCUs (whether for living or leisure), it's just natural he or she might have been in a need to document some pins. So was my case and since I failed in finding any package in \LaTeX{} to suit my needs, I opted for creating one myself.
 
 I hope others will find it as useful as it was to me and my colleagues.
 
@@ -129,7 +133,7 @@
 
 \textbf{Important}: in the following, a \argu{number} can be an integer written with numeric chars, a counter, or the result of an arithmetic operation made with the command \verbinline|\numexpr|.\smallskip
 
-All the macros of \pinouTikz are displayed in {\makeatletter\color{@xs at keywordspinouTikz}red}.
+All the macros of \pinouTikz are displayed in {\makeatletter\color{@xs at keywordspinouTikz}blue}.
 
 \subsection{The pinout diagrams}
 \subsubsection{\ttfamily\textbackslash PDIP}
@@ -136,21 +140,25 @@
 \verbinline|\PDIP|\arguD{pincount}\ARGU{pinarray}
 \smallskip
 
-Draws a PDIP package with generic number of pins.
+Draws a PDIP package with generic number of pins, as a standalone glyph.
 
+\verbinline|\pctPDIP|\arguD{pincount}\ARGU{pinarray}
+\smallskip
+
+Draws a PDIP package with generic number of pins, as a picture sub-element.
+
 \begin{itemize}
 	\item \argu{pincount} the  number of pins of a DIP package and should be an even number.
 	\item \ARGU{pinarray} is a comma-separated list of pins  - each pin definition is as follows: \argu{pinnumber}/\ARGU{pinlabel}.
 \end{itemize}
 
-%% 4-pin example
-%\begin{minipage}[t]{0.65\linewidth}
+%% 4-pin example, as a glyph
 \begin{lstlisting}
 \begin{figure}
   \centering
   \PDIP(4){%
   	1/{E},2/B,3/NC,4/C}
-  \caption{NPN-Transistor, 4-pin PDIP package} \label{fig:X_DIP4}
+  \caption{NPN-Transistor, 4-pin PDIP package, as a glyph} \label{fig:X_DIP4}
 \end{figure}
 \end{lstlisting}%
 
@@ -163,10 +171,63 @@
   	3/NC,
   	4/C
   	}%
-  \caption{NPN-Transistor, 4-pin PDIP package} \label{fig:X_DIP4}
+  \caption{NPN-Transistor, 4-pin PDIP package, as a glyph} \label{fig:X_DIP4}
 \end{figure}
 
-%\end{minipage}\hfill
+%% 4-pin example, within a picture
+\begin{lstlisting}
+\begin{figure}[ht!]
+  \centering
+  \begin{tikzpicture}
+  % an arbitrary picture laid over the PDIP diagram
+  \draw[thick,rounded corners=8pt](0,0)-- (0,2)-- (1,3.25)-- (2,2)-- (2,0)-- (0,2)-- (2,2)-- (0,0);
+  % a PDIP diagram itself
+  \pctPDIP(4){%
+  	1/{E},
+  	2/B,
+  	3/NC,
+  	4/C
+  	}%
+  % a PDIP diagram itself
+  \begin{scope}[shift={(3.5,0.5)}]
+  \pctPDIP(4){%
+  	1/{E},
+  	2/B,
+  	3/NC,
+  	4/C
+  	}%
+  \end{scope}
+  \end{tikzpicture}
+  \caption{NPN-Transistor, 4-pin PDIP package, placed within another picture, twice} \label{fig:X_DIP8}
+\end{figure}
+\end{lstlisting}%
+
+%% 4-pin example, within a picture
+\begin{figure}[ht!]
+  \centering
+  \begin{tikzpicture}
+  % an arbitrary picture laid over the PDIP diagram
+  \draw[thick,rounded corners=8pt](0,0)-- (0,2)-- (1,3.25)-- (2,2)-- (2,0)-- (0,2)-- (2,2)-- (0,0);
+  % a PDIP diagram itself
+  \pctPDIP(4){%
+  	1/{E},
+  	2/B,
+  	3/NC,
+  	4/C
+  	}%
+  % a PDIP diagram itself
+  \begin{scope}[shift={(3.5,0.5)}]
+  \pctPDIP(4){%
+  	1/{E},
+  	2/B,
+  	3/NC,
+  	4/C
+  	}%
+  \end{scope}
+  \end{tikzpicture}
+  \caption{NPN-Transistor, 4-pin PDIP package, placed within another picture, twice} \label{fig:X_DIP8}
+\end{figure}
+
 %% 8-pin example
 %\begin{minipage}[t]{0.65\linewidth}
 \begin{lstlisting}
@@ -182,7 +243,7 @@
   	7/NC,
   	8/$V_{cc}$%
   	}
-  \caption{TTL logic chip, 8-pin PDIP package} \label{fig:X_DIP8}
+  \caption{TTL logic chip, 8-pin PDIP package, as a glyph} \label{fig:X_DIP8}
 \end{figure}
 \end{lstlisting}%
 
@@ -199,7 +260,7 @@
   	7/NC,
   	8/$V_{cc}$%
   	}
-  \caption{TTL logic chip, 8-pin PDIP package} \label{fig:X_DIP8}
+  \caption{TTL logic chip, 8-pin PDIP package, as a glyph} \label{fig:X_DIP8}
 \end{figure}
 %\end{minipage}\hfill
 
@@ -253,8 +314,13 @@
 \verbinline|\TQFP|\arguD{pinnumber}\ARGU{pinarray}
 \smallskip
 
-Draws a TQFP package with generic number of pins.
+Draws a TQFP package with generic number of pins, as a standalone glyph.
 
+\verbinline|\pctTQFP|\arguD{pinnumber}\ARGU{pinarray}
+\smallskip
+
+Draws a TQFP package with generic number of pins, as a picture sub-element.
+
 \begin{itemize}
 	\item \argu{pincount} the  number of pins of a DIP package and should be an even number.
 	\item \ARGU{pinarray} is a comma-separated list of pins  - each pin definition is as follows: \argu{pinnumber}/\ARGU{pinlabel}.
@@ -348,6 +414,11 @@
 
 Draws a PLCC package with generic number of pins.
 
+\verbinline|\pctPLCC|\arguD{pinnumber}\ARGU{pinarray}
+\smallskip
+
+Draws a PLCC package with generic number of pins, as a picture sub-element.
+
 \begin{itemize}
 	\item \argu{pincount} the  number of pins of a DIP package and should be an even number.
 	\item \ARGU{pinarray} is a comma-separated list of pins  - each pin definition is as follows: \argu{pinnumber}/\ARGU{pinlabel}.

Modified: trunk/Master/texmf-dist/tex/latex/pinoutikz/pinoutikz.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/pinoutikz/pinoutikz.sty	2020-07-27 21:39:14 UTC (rev 55965)
+++ trunk/Master/texmf-dist/tex/latex/pinoutikz/pinoutikz.sty	2020-07-27 21:40:58 UTC (rev 55966)
@@ -38,8 +38,8 @@
 \usetikzlibrary{shapes.misc, shapes.geometric}
 
 \def\pinoutikzname               {pinouTikz}
-\def\pinoutikzversion            {1.1.1}
-\def\pinoutikzdate               {2019/11/25}
+\def\pinoutikzversion            {1.1.2}
+\def\pinoutikzdate               {2020/07/27}
 
 %% Formatt a pin name
 \def\FormatPinLabel#1{
@@ -116,12 +116,7 @@
   \end{scope}
 }
 
-%% PDIP package diagram
-%% @param#1: offset
-%% @param#2: number of pins (divisible by 2)
-%% @param#3: comma separated definitions list for every pin - every pin definition must be enclosed in quotation marks ("")
-\def\PDIP(#1)#2{%
-  \begin{tikzpicture}
+\def\pctPDIP(#1)#2{%
   \begin{scope}[shift={(0,0)}]
     \sffamily
     \textsf{%
@@ -149,6 +144,15 @@
     }
   }
   \end{scope}
+}
+
+%% PDIP package diagram
+%% @param#1: offset
+%% @param#2: number of pins (divisible by 2)
+%% @param#3: comma separated definitions list for every pin - every pin definition should be enclosed in quotation marks ("")
+\def\PDIP(#1)#2{%
+  \begin{tikzpicture}
+   \pctPDIP(#1){#2}
   \end{tikzpicture}
 }
 
@@ -199,6 +203,17 @@
   }
 }
 
+%% PLCC package picture
+%% @param#1: offset
+%% @param#2: number of pins (divisible by 2)
+%% @param#3: comma separated definitions list for every pin - every pin definition must be enclosed in quotation marks ("")
+\def\pctPLCC(#1)#2{%
+  \begin{scope}[shift={(0,0)}]
+  \GENFOUREDGE(#1){#2}{PLCC}{round(#1*.125)}
+  \end{scope}
+}
+
+
 %% PLCC package diagram
 %% @param#1: offset
 %% @param#2: number of pins (divisible by 2)
@@ -205,12 +220,19 @@
 %% @param#3: comma separated definitions list for every pin - every pin definition must be enclosed in quotation marks ("")
 \def\PLCC(#1)#2{%
   \begin{tikzpicture}
+  \pctPLCC(#1){#2}
+  \end{tikzpicture}
+}
+
+%% TQFP package picture
+%% @param#1: offset
+%% @param#2: number of pins (divisible by 2)
+%% @param#3: comma separated definitions list for every pin - every pin definition must be enclosed in quotation marks ("")
+\def\pctTQFP(#1)#2{%
   \begin{scope}[shift={(0,0)}]
-  \GENFOUREDGE(#1){#2}{PLCC}{round(#1*.125)}
+  \GENFOUREDGE(#1){#2}{TQFP}{0}
   \end{scope}
-  \end{tikzpicture}
 }
-
 %% TQFP package diagram
 %% @param#1: offset
 %% @param#2: number of pins (divisible by 2)
@@ -217,9 +239,7 @@
 %% @param#3: comma separated definitions list for every pin - every pin definition must be enclosed in quotation marks ("")
 \def\TQFP(#1)#2{%
   \begin{tikzpicture}
-  \begin{scope}[shift={(0,0)}]
-  \GENFOUREDGE(#1){#2}{TQFP}{0}
-  \end{scope}
+  \pctTQFP(#1){#2}
   \end{tikzpicture}
 }
 



More information about the tex-live-commits mailing list.