texlive[71190] Master/texmf-dist: fadingimage (6may24)
commits+karl at tug.org
commits+karl at tug.org
Mon May 6 22:17:16 CEST 2024
Revision: 71190
https://tug.org/svn/texlive?view=revision&revision=71190
Author: karl
Date: 2024-05-06 22:17:16 +0200 (Mon, 06 May 2024)
Log Message:
-----------
fadingimage (6may24)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/fadingimage/README.md
trunk/Master/texmf-dist/doc/latex/fadingimage/fadingimage.pdf
trunk/Master/texmf-dist/doc/latex/fadingimage/fadingimage.tex
trunk/Master/texmf-dist/tex/latex/fadingimage/fadingimage.sty
Modified: trunk/Master/texmf-dist/doc/latex/fadingimage/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/fadingimage/README.md 2024-05-06 20:17:08 UTC (rev 71189)
+++ trunk/Master/texmf-dist/doc/latex/fadingimage/README.md 2024-05-06 20:17:16 UTC (rev 71190)
@@ -1,17 +1,19 @@
# The `fadingimage` package
-This package provides three commands for adding fading full width picture at the top or bottom of a page.
+This package provides macros for inputting full width picture at the edges of pages quickly.
-**Welcome to pull requests
-[here](https://github.com/xiamyphys/fadingimage).**
+**Welcome to pull requests [here](https://github.com/xiamyphys/fadingimage/pulls).**
## License
-This work may be distributed and/or modified under the conditions of the
-[LaTeX Project Public License](http://www.latex-project.org/lppl.txt),
-either version 1.3c of this license or (at your option) any later version.
+This work may be distributed and/or modified under the conditions of the [LaTeX Project Public License](http://www.latex-project.org/lppl.txt), either version 1.3c of this license or (at your option) any later version.
This work has the LPPL maintenance status `maintained`.
-The Current Maintainer of this work is
-[Mingyu Hsia](https://www.ctan.org/author/xia-my).
\ No newline at end of file
+The Current Maintainer of this work is [Mingyu Hsia](https://www.ctan.org/author/xia-my).
+
+## Derivative Works
+
+- [notebeamer](https://ctan.org/pkg/notebeamer): Package provides macros for inputting slides on note papers quickly.
+
+- [litesolution](https://ctan.org/pkg/litesolution): Class designed for typesetting solutions of problems in exams, textbooks, etc.
Modified: trunk/Master/texmf-dist/doc/latex/fadingimage/fadingimage.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/fadingimage/fadingimage.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/fadingimage/fadingimage.tex 2024-05-06 20:17:08 UTC (rev 71189)
+++ trunk/Master/texmf-dist/doc/latex/fadingimage/fadingimage.tex 2024-05-06 20:17:16 UTC (rev 71190)
@@ -1,5 +1,5 @@
\documentclass[11pt,svgnames]{article}
-\usepackage{geometry,titlesec,authblk,hyperref,hologo}
+\usepackage{geometry,indentfirst,titlesec,authblk,hyperref,hologo}
\titleformat*{\section}{\bfseries\large}
\hologoFontSetup{general=\sffamily}
\usepackage{datetime}\yyyymmdddate
@@ -11,19 +11,19 @@
\def\cmd#1{\textcolor{MidnightBlue}{\texttt{\string#1}}}
\title{\bfseries The \pkg{fadingimage} Package}
-\author{Mingyu Hsia, \href{mailto:xiamyphys at gmail.com}{\ttfamily xiamyphys at gmail.com}}
+\author{Mingyu Hsia, \href{mailto:xiamyphys at hdu.edu.cn}{\ttfamily xiamyphys at hdu.edu.cn}}
\affil{Hangzhou Dianzi University}
-\date{\today\quad Version 0.2a\thanks{\url{https://github.com/xiamyphys/fadingimage}}}
+\date{\today\quad Version 0.3a\thanks{\url{https://github.com/xiamyphys/fadingimage}}}
\begin{document}
\maketitle
-\UPFadingImage[trim={0 {.96\paperheight} 0 0},clip]{Beautiful-realities}
-\LOWFadingImage[trim={0 0 0 {.96\paperheight}},clip]{Beautiful-realities}
+\UPFadingImage*[trim={0 {.96\paperheight} 0 0},clip]{Beautiful-realities}
+\LOWFadingImage*[trim={0 0 0 {.96\paperheight}},clip]{Beautiful-realities}
\vspace{-6ex}
\begin{abstract}
-This is \textsf{\textbf{not only the document but also the demo}} for the \pkg{fadingimage} package, which provides three commands for adding fading full width picture at the top, bottom or both of them on a page. This package is contained in the \pkg{LiteBook} and \pkg{LiteSolution} class.
+This is \textsf{\textbf{not only the document but also the demo}} for the \pkg{fadingimage} package, which provides macros for inputting full width picture at the edges of pages quickly. This package is contained in the \pkg{LiteBook} and \pkg{LiteSolution} class.
Welcome to feedback bugs or ideas via email \href{mailto:xiamyphys at gmail.com}{\ttfamily xiamyphys at gmail.com} or \href{https://github.com/xiamyphys/fadingimage}{GitHub}.
@@ -41,15 +41,18 @@
To learn more, please refer to \href{https://tex.stackexchange.com/questions/55437/how-do-i-update-my-tex-distribution}{How do I update my \hologo{TeX} distribution?}
-\section{Commands \cmd{UPFadingImage}, \cmd{LOWFadingImage} and \cmd{UPLOWFadingImage}}
+\section{Macros in this package}
-\begin{small}\begin{verbatim}
- \UPFadingImage [<keyval list>]{<file>} \LOWFadingImage[<keyval list>]{<file>}
- \UPLOWFadingImage[<keyval list>]{<file>}[<keyval list>]{<file>}
-\end{verbatim}\end{small}
+\begin{verbatim}
+ \UPFadingImage <*> [<keyval list>] {<file>} <!> % fading from top
+ \LOWFadingImage <*> [<keyval list>] {<file>} <!> % fading from bottom
+ \LTFadingImage <*> [<keyval list>] {<file>} <!> % fading from left
+ \RITFadingImage <*> [<keyval list>] {<file>} <!> % fading from right
+\end{verbatim}
-The first two commands all have 2 variables and the first one is optional. The second variable of the commands can assign the image that you want to insert, and the first one can assign the parameters of command \cmd{includegraphics}, such as clip to the inserted image.
+The four commands all have 2 variables and the first one is optional. The second variable can assign the image that you want to insert and the first one can assign the parameters of command \cmd{includegraphics}, such as clip to the inserted image.
-The third command is just a combination of the first two commands. If a star (*) is added after the commands above, the image you inserted won't be faded.
+If an exclamation \verb|<!>| is added at the end of the commands, the image inserted won't be faded. If a star \verb|<*>| is added after the commands it will automatically exit vertical mode \verb|\leavevmode| after inserting the image.
+
\end{document}
\ No newline at end of file
Modified: trunk/Master/texmf-dist/tex/latex/fadingimage/fadingimage.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/fadingimage/fadingimage.sty 2024-05-06 20:17:08 UTC (rev 71189)
+++ trunk/Master/texmf-dist/tex/latex/fadingimage/fadingimage.sty 2024-05-06 20:17:16 UTC (rev 71190)
@@ -1,5 +1,5 @@
%% ***********************************************************
-%% Copyright 2024 by Mingyu Hsia <xiamyphys at gmail.com> *
+%% Copyright 2024 by Mingyu Hsia <xiamyphys at hdu.edu.cn> *
%% *
%% This work may be distributed and/or modified under *
%% the conditions of the LaTeX Project Public License *
@@ -13,48 +13,48 @@
%% *
%% The Current Maintainer of this work is Mingyu Hsia. *
%% *
-%% This work consists of the files fadingimage.cls, *
+%% This work consists of the files fadingimage.sty, *
%% and README.md. *
%% available at https://github.com/xiamyphys/fadingimage *
%% ***********************************************************
% !Mode:: "TeX:UTF-8"
\NeedsTeXFormat{LaTeX2e}[2020/10/01]
-\ProvidesPackage{fadingimage}[2024/04/19/ v0.2a Package for adding fading full width picture at the top and bottom of a page.]
+\ProvidesPackage{fadingimage}[2024/05/06/ v0.3a Package provides macros for inputting full width picture at the edges of pages quickly.]
-\RequirePackage{tikz,xcolor}
-\usetikzlibrary{fadings}
-\NewDocumentCommand{\UPFadingImage}{ s O{} m }{
- \IfBooleanTF{#1}
- {
+\RequirePackage{tikz}\usetikzlibrary{fadings}
+\NewDocumentCommand{\UPFadingImage}{ s O{} m t! }{
+ \IfBooleanTF{#4}{
\tikz[remember picture,overlay]
\node[below,inner sep=0pt,outer sep=auto] at (current page.north) {\includegraphics[width=\paperwidth,#2]{#3}};
}{
\tikz[remember picture,overlay]
\node[scope fading=south,below,inner sep=0pt,outer sep=auto] at (current page.north) {\includegraphics[width=\paperwidth,#2]{#3}};
- }
+ }\IfBooleanT{#1}{\leavevmode}
}
-\NewDocumentCommand{\LOWFadingImage}{ s O{} m }{
- \IfBooleanTF{#1}
- {
+\NewDocumentCommand{\LOWFadingImage}{ s O{} m t! }{
+ \IfBooleanTF{#4}{
\tikz[remember picture,overlay]
\node[above,inner sep=0pt,outer sep=auto] at (current page.south) {\includegraphics[width=\paperwidth,#2]{#3}};
}{
\tikz[remember picture,overlay]
\node[scope fading=north,above,inner sep=0pt,outer sep=auto] at (current page.south) {\includegraphics[width=\paperwidth,#2]{#3}};
- }
+ }\IfBooleanT{#1}{\leavevmode}
}
-
-\NewDocumentCommand{\UPLOWFadingImage}{ s O{} m O{} m }{
- \IfBooleanTF{#1}
- {
- \tikz[remember picture,overlay]{
- \node[below,inner sep=0pt,outer sep=auto] at (current page.north) {\includegraphics[width=\paperwidth,#2]{#3}};
- \node[above,inner sep=0pt,outer sep=auto] at (current page.south) {\includegraphics[width=\paperwidth,#4]{#5}};
- }
+\NewDocumentCommand{\LTFadingImage}{ s O{} m t! }{
+ \IfBooleanTF{#4}{
+ \tikz[remember picture,overlay]
+ \node[right,inner sep=0pt,outer sep=auto] at (current page.west) {\includegraphics[height=\paperheight,#2]{#3}};
}{
- \tikz[remember picture,overlay]{
- \node[scope fading=south,below,inner sep=0pt,outer sep=auto] at (current page.north) {\includegraphics[width=\paperwidth,#2]{#3}};
- \node[scope fading=north,above,inner sep=0pt,outer sep=auto] at (current page.south) {\includegraphics[width=\paperwidth,#4]{#5}};
- }
- }
+ \tikz[remember picture,overlay]
+ \node[scope fading=east,right,inner sep=0pt,outer sep=auto] at (current page.west) {\includegraphics[height=\paperheight,#2]{#3}};
+ }\IfBooleanT{#1}{\leavevmode}
+}
+\NewDocumentCommand{\RITFadingImage}{ s O{} m t! }{
+ \IfBooleanTF{#4}{
+ \tikz[remember picture,overlay]
+ \node[left,inner sep=0pt,outer sep=auto] at (current page.east) {\includegraphics[height=\paperheight,#2]{#3}};
+ }{
+ \tikz[remember picture,overlay]
+ \node[scope fading=west,left,inner sep=0pt,outer sep=auto] at (current page.east) {\includegraphics[height=\paperheight,#2]{#3}};
+ }\IfBooleanT{#1}{\leavevmode}
}
\ No newline at end of file
More information about the tex-live-commits
mailing list.