Index of /CTAN/macros/latex/contrib/hycolor

(1)

The hycolor package

Heiko Oberdiek

^∗

2020-01-27 v1.10

Abstract

Packagehycolorimplements the color option stuff that is used by packages hyperrefandbookmark. It is not intended as package for the user.

1 Documentation

The packagehycolorimplements color options for packageshyperrefandbookmark.

Packagexcolorprovides macros for extracting color values and converting color data to other color models. If this package is loaded, the full range of color specifications of packages color and xcolor are supported including the optional argument for the color model.

\hypersetup{linkbordercolor=red}%needsxcolor

\hypersetup{linkbordercolor=[named]{red}}%needsxcolor

\hypersetup{linkbordercolor=[rgb]{1,0,0}}

Without packagexcolorsome of the options only support some models, if they are given directly, e.g.:

\bookmarksetup{color=[rgb]{1,0,0}}

Because of compatibility some options of hyperrefalso support space separated RGB values:

\hypersetup{linkbordercolor=1 0 0}%is the same as

\hypersetup{linkbordercolor=[rgb]{1,0,0}}

Coloring is optional, it can be turned off by using an empty value:

\hypersetup{linkbordercolor={}}

The PDF specification knows some kind of an emtpy color setting without values. This applies to form field colors. The new A virtual color modelemptyis introduced for this purpose, e.g.

\TextField[backgroundcolor={[empty]{}}, ...]{...}%or

\TextField[{backgroundcolor=[empty]{}, ...}]{...}

PDF specification 1.7 also allows this for border link colors. But this isn’t currently supported by this package, because the tested viewers (AR7/Linux, xpdf 3.00, ghostscript 8.54) don’t support this yet. In contrary ghostscript generates an error message.

1.1 Summary

Color option Models withoutxcolor RGB color Model empty

BKM.color gray, rgb no no

Hyp.*color all no no

Hyp.*bordercolor gray, rgb yes no

Field.*color gray, rgb,cmyk yes yes

AtFi.color gray, rgb yes no

“RGB color” means that the color value can be given as space separated RGB numbers (real numbers in the range from 0 to 1). Explanation of the color option prefixes:

(3)

Prefix Explanation BKM Packagebookmark

Hyp Packagehyperref: package options or\hypersetup Field Packagehyperref: Form field options

AtFi Packageattachfile2: option color

2 Implementation

1h*packagei

2\NeedsTeXFormat{LaTeX2e}

3\ProvidesPackage{hycolor}%

4 [2020-01-27 v1.10 Color options for hyperref/bookmark (HO)]%

Should not be needed afterxcolorupdates, Avoid loading xcolor-patchbut fix Gray color model.

5% \RequirePackage{xcolor-patch}[2019/12/15]

6\AtBeginDocument{%

7\def\@tempa#1,{%

8 \XC@ifxcase\tm{%

9 \XC@mod@rgb{%

10 \XC@calcN{#1}\@@tmp

11 \edef\@@tmp{\@@tmp,\@@tmp,\@@tmp}%

12 }%

13 \XC@mod@cmy{%

14 \XC@calcC{#1}\@@tmp

16 }%

17 \XC@mod@cmyk{%

19 \edef\@@tmp{0,0,0,\@@tmp}%

20 }%

21 \XC@mod@RGB{%

22 \edef\@@scl{\rangeRGB}%

23 \XC@calcM{#1}\@@tmp

25 }%

26 \XC@mod@HTML{%

27 \edef\@@scl{\@cclv}%

29 \XC@calcH\@@tmp\@@tmp

30 \edef\@@tmp{\@@tmp\@@tmp\@@tmp}%

31 }%

32 \XC@mod@HSB{%

33 \edef\@@scl{\rangeHSB}%

35 \edef\@@tmp{0,0,\@@tmp}%

36 }%

37 \XC@mod@Gray{%

38 \edef\@@scl{\rangeGray}%

40 }%

41 }%

42 {%

44 \edef\@@tmp{0,0,\@@tmp}%

45 }%

46 }%

47\ifx\XC@cnv@gray\@tempa

(4)

48 \def\XC@cnv@gray#1,{%

49 \XC@ifxcase\tm{%

50 \XC@mod@rgb{%

53 }%

54 \XC@mod@gray{}%

55 \XC@mod@cmy{%

58 }%

59 \XC@mod@cmyk{%

61 \edef\@@tmp{0,0,0,\@@tmp}%

62 }%

63 \XC@mod@RGB{%

67 }%

68 \XC@mod@HTML{%

73 }%

74 \XC@mod@HSB{%

77 \edef\@@tmp{0,0,\@@tmp}%

78 }%

79 \XC@mod@Gray{%

82 }%

83 }%

84 {%

86 \edef\@@tmp{0,0,\@@tmp}%

87 }%

88 }%

89\fi

90\let\@tempa\relax

91}

2.1 Normalization

2.1.1 Sanitize value of color option ProcedureDefSanitized(cmd, value)

Param: cmd (macro)

Param: value (value of color option)

Result: value is expanded, sanitized, and stored in macrocmd.

Initialize active characters;

cmd := Expandvalue; Sanitizecmd;

Sanitization means that the string does not contain any macros or special

(5)

tokens. It consists of characters with catcode 12 (other). The only exception is the space with catcode 10 (space).

\HyColor@DefSanitized

92\begingroup

93 \catcode‘\!=13 %

94 \catcode‘\:=13 %

95 \catcode‘\-=13 %

96 \catcode‘\+=13 %

97 \catcode‘\;=13 %

98 \catcode‘\"=13 %

99 \catcode‘\>=13 %

100 \edef\x{%

101 \def\noexpand!{\string!}%

102 \def\noexpand:{\string:}%

103 \def\noexpand-{\string-}%

104 \def\noexpand+{\string+}%

105 \def\noexpand;{\string;}%

106 \def\noexpand"{\string"}%

107 \def\noexpand>{\string>}%

108 }%

109 \def\y#1{\endgroup

110 \def\HyColor@DefSanitized##1##2{%

111 \begingroup

112 \csname @safe@activestrue\endcsname

113 #1%

114 \edef\x{\endgroup

115 \def\noexpand##1{##2}%

116 }%

117 \x

118 \@onelevel@sanitize##1%

119 }%

120 }%

121\expandafter\y\expandafter{\x}

2.1.2 Normalize result

ProcedureNormalizeNum(value, cmd) Param: value (Sanitized explicit number) Param: cmd (Macro that stores result) Result: cmd contains normalized number if valuept <0ptthen

cmd ←0;

else if number before dot of value <1then cmd ←number after dot of value;

cmd ←strip trailing zeros fromcmd; if dot remains only then

cmd ←0;

end else

cmd ←1;

end

The number is limited to the range between 0.0 and 1.0 and formatted as short PDF number without leading or trailing zeros. The precision of the number isn’t changed.

(6)

\HyColor@NormalizeNum

122\def\HyColor@NormalizeNum#1#2{%

123 \ifdim#1pt<\z@

124 \def#2{0}%

125 \else

126 \edef#2{\zap@space#1 \@empty}%

127 \expandafter\HyColor@CheckDot#2..\@nil#2%

128 \fi

129}

130\def\HyColor@CheckDot#1.#2.#3\@nil#4{%

131 \ifnum0#1<\@ne

132 \ifx\\#2\\%

133 \def#4{0}%

134 \else

135 \edef#4{\HyColor@ReverseString#2\@nil{}}%

136 \edef#4{\expandafter\HyColor@StripLeadingZeros#4\@empty}%

137 \ifx#4\@empty

138 \def#4{0}%

139 \else

140 \edef#4{.\expandafter\HyColor@ReverseString#4\@nil{}}%

141 \fi

142 \fi

143 \else

144 \def#4{1}%

145 \fi

146}

147\def\HyColor@ReverseString#1#2\@nil#3{%

148 \ifx\\#2\\%

149 #1#3%

150 \else

151 \@ReturnAfterFi{%

152 \HyColor@ReverseString#2\@nil{#1#3}%

153 }%

154 \fi

155}

156\long\def\@ReturnAfterFi#1\fi{\fi#1}

157\def\HyColor@StripLeadingZeros#1{%

158 \ifx#10%

159 \expandafter\HyColor@StripLeadingZeros

160 \else

161 #1%

162 \fi

163}

\HyColor@NormalizeCommaRGB

164\def\HyColor@NormalizeCommaRGB#1,#2,#3\@nil#4{%

165 \HyColor@NormalizeNum{#1}\HyColor@temp

166 \let#4\HyColor@temp

168 \edef#4{#4 \HyColor@temp}%

171}

\HyColor@NormalizeCommaCMYK

172\def\HyColor@NormalizeCommaCMYK#1,#2,#3,#4\@nil#5{%

174 \let#5\HyColor@temp

(7)

181}

2.2 Main algorithm for color options

ProcedureMainColorOptionAlgorithm(key, value, cmd) Param: key (name of color option)

Param: value (value of color option) Param: cmd (macro that stores result)

Result: Macrocmd contains the calculated color specification string or has the meaning of \relaxif the color must not set

DefSanitized(temp,value);

Call option specific algorithm(key,temp,cmd);

2.3 Package bookmark

Since v0.8 2007/03/27 package bookmark only provides one color option color.

Because optionrgbcolorcan easily given as color specification in model rgb:

rgbcolor=hri hgi hbi ≡ color=[rgb]{hri,hgi,hbi}

Package bookmark stores the result in macro \BKM@color. The empty string is

(8)

interpreted asno color.

ProcedureBookmarkColor(value, cmd, package, option) Param: value (value of optioncolor)

Param: cmd (macro for result)

Param: package(package name for error message) Param: option (option name for error message) switchvalue do

caseempty do cmd ←no color;

end

casewith model do if with xcolor then

cmd ←ConvertToRGB(model,values);

else

if model=rgb then

cmd ←values as normalized values;

else if model=gray then

cmd ←values as normalized tripled values;

else error;

end end end

otherwise do

if with xcolor then

(model,values ←get model and values;

cmd ←ConvertToRGB(model,values);

else error;

end end end

182\def\HyColor@BookmarkColor#1#2#3#4{%

183 \HyColor@IfModel{#1}{%

184 \HyColor@IfXcolor{%

185 \convertcolorspec\HyColor@model\HyColor@values

186 \HyColor@model@rgb#2%

187 \expandafter\HyColor@NormalizeCommaRGB#2\@nil#2%

188 }{%

189 \ifx\HyColor@model\HyColor@model@rgb

190 \expandafter\HyColor@NormalizeCommaRGB\HyColor@values\@nil#2%

191 \else

192 \ifx\HyColor@model\HyColor@model@gray

193 \expandafter\HyColor@NormalizeNum

194 \expandafter{\HyColor@values}#2%

195 \edef#2{#2 #2 #2}%

196 \else

197 \let#2\@empty

198 \HyColor@ErrorModelNoXcolor{#3}{#4}%

199 \fi

200 \fi

201 }%

202 }{%

(9)

203 \let#2\HyColor@values

204 \ifx#2\@empty

205 \else

207 \extractcolorspec{#1}#2%

208 \expandafter\convertcolorspec#2\HyColor@model@rgb#2%

210 }{%

211 \let#2\@empty

212 \HyColor@ErrorSpecNoXcolor{#3}{#4}%

213 }%

214 \fi

215 }%

216}

217\def\HyColor@ErrorModelNoXcolor#1#2{%

218 \PackageError{#1}{%

219 Color model ‘\HyColor@model’ is not supported\MessageBreak

220 without package ‘xcolor’ in\MessageBreak

221 ‘#2=[\HyColor@model]{\HyColor@values}’%

222 }\@ehc

223}

224\def\HyColor@ErrorSpecNoXcolor#1#2{%

226 This color specification is not supported\MessageBreak

227 without package ‘xcolor’ in\MessageBreak

228 ‘#2=\HyColor@values’%

229 }\@ehc

230}

231\def\HyColor@IfModel#1{%

232 \@ifnextchar[{%

233 \HyColor@WithModel

234 }{%

235 \HyColor@WithoutModel

236 }%

237 #1\@nil

238}

239\def\HyColor@WithModel[#1]#2\@nil{%

240 \HyColor@DefSanitized\HyColor@model{#1}%

241 \HyColor@DefSanitized\HyColor@values{#2}%

242 \@firstoftwo

243}

244\def\HyColor@WithoutModel#1\@nil{%

245 \let\HyColor@model\relax

246 \HyColor@DefSanitized\HyColor@values{#1}%

247 \@secondoftwo

248}

2.4 Utils

\@ReturnAfterFi

249\long\def\@ReturnAfterFi#1\fi{\fi#1}

\HyColor@IfXcolor

250\def\HyColor@IfXcolor{%

251 \begingroup\expandafter\expandafter\expandafter\endgroup

252 \expandafter\ifx\csname convertcolorspec\endcsname\relax

(10)

253 \expandafter\@secondoftwo

254 \else

255 \expandafter\@firstoftwo

256 \fi

257}

258\def\HyColor@model@empty{empty}

259\@onelevel@sanitize\HyColor@model@empty

260\def\HyColor@model@gray{gray}

261\@onelevel@sanitize\HyColor@model@gray

262\def\HyColor@model@rgb{rgb}

263\@onelevel@sanitize\HyColor@model@rgb

264\def\HyColor@model@cmyk{cmyk}

265\@onelevel@sanitize\HyColor@model@cmyk

266\def\HyColor@model@Gray{Gray}

267\@onelevel@sanitize\HyColor@model@Gray

2.5 Package hyperref

2.5.1 Options Hyp.*color

268\def\HyColor@UseColor#1{%

269 \ifx\relax#1\@empty

270 \else

271 \ifx\@empty#1\@empty

272 \else

273 \expandafter\expandafter\expandafter\HyColor@@UseColor#1\@nil

274 \fi

275 \fi

276}

277\def\HyColor@@UseColor{%

278 \@ifnextchar[\HyColor@@@UseColor\HyColor@@@@UseColor

279}

280\def\HyColor@@@UseColor[#1]#2\@nil{%

281 \color[{#1}]{#2}%

282}

283\def\HyColor@@@@UseColor#1\@nil{%

284 \color{#1}%

285}

ProcedureHyperrefColor(value, cmd) Param: value (value of the option) Param: cmd (macro for result) switchvalue do

end

casewith model do

Call\colorwith model;

end

casewithout model do

Call\colorwithout model;

end end

286\def\HyColor@HyperrefColor#1#2{%

288 \edef#2{[{\HyColor@model}]{\HyColor@values}}%

(11)

289 }{%

291 \ifx#2\@empty

292 \let#2\relax

293 \fi

294 }%

295}

(12)

2.5.2 Generic algorithm

ProcedureAlgorithm X0134(value, cmd, package, option)

Param: value(value of the option) Param: cmd(macro for result)

Param: package(package name for error message) Param: option(option name for error message) switchvaluedo

caseempty do cmd←no color;

end

casewith model do switchmodeldo

caseempty do cmd←””;

end

casegray, rgb, cmykdo cmd←output();

end

caseGray do

ifwith xcolor then

(model,values)←convert to gray;

else

error(package,option, ”Missing xcolor”),cmd ←no color;

end end else

ifwith xcolor then

(model,values)←convert to rgb;

cmd←output();

else

end end end end

casergb valuesdo

(model,values)←(”rgb”, (r,g,b));

cmd←output();

end

casewithout modeldo ifwith xcolor then

(model,values)←get model and values(value);

switchmodeldo

casegray, rgb, cmykdo cmd←output();

end

caseGray do

(model,values)←convert to gray;

cmd←output();

end else

cmd←output();

end end else

end end end

\HyColor@XZeroOneThreeFour

296\def\HyColor@XZeroOneThreeFour#1#2#3#4{%

(13)

298 \ifx\HyColor@model\HyColor@model@empty

299 \let#2\@empty

300 \else\ifx\HyColor@model\HyColor@model@gray

303 \else\ifx\HyColor@model\HyColor@model@rgb

305 \else\ifx\HyColor@model\HyColor@model@cmyk

306 \expandafter\HyColor@NormalizeCommaCMYK\HyColor@values\@nil#2%

307 \else\ifx\HyColor@model\HyColor@model@Gray

310 \HyColor@model@gray#2%

311 \expandafter\HyColor@NormalizeNum\expandafter{#2}#2%

312 \let\HyColor@model\HyColor@model@gray

313 }{%

314 \let#2\relax

316 }%

317 \else

322 \let\HyColor@model\HyColor@model@rgb

323 }{%

324 \let#2\relax

326 }%

327 \fi\fi\fi\fi\fi

328 }{%

330 \ifx#2\@empty

331 \let#2\relax

332 \else

333 \expandafter\HyColor@IfRGB\expandafter{\HyColor@values}{%

335 }{%

337 \expandafter\extractcolorspec\expandafter{\HyColor@values}#2%

338 \edef\HyColor@model{\expandafter\@firstoftwo#2}%

339 \edef\HyColor@values{\expandafter\@secondoftwo#2}%

341 \expandafter\HyColor@NormalizeNum\expandafter

342 {\HyColor@values}#2%

344 \expandafter\HyColor@NormalizeCommaRGB

345 \HyColor@values\@nil#2%

347 \expandafter\HyColor@NormalizeCommaCMYK

348 \HyColor@values\@nil#2%

349 \else\ifx\HyColor@model\HyColor@model@Gray

351 \HyColor@model@gray#2%

352 \expandafter\HyColor@NormalizeNum\expandafter

353 {\HyColor@values}#2%

354 \let\HyColor@model\HyColor@model@gray

(14)

355 \else

360 \fi\fi\fi\fi

361 }{%

362 \let#2\relax

364 }%

365 }%

366 \fi

367 }%

368}

2.5.3 Field options

\HyColor@FieldBColor

369\let\HyColor@FieldBColor\HyColor@XZeroOneThreeFour

\HyColor@FieldColor

370\def\HyColor@FieldColor#1#2#3#4{%

371 \let\HyColor@model\@empty

372 \HyColor@XZeroOneThreeFour{#1}{#2}{#3}{#4}%

373 \ifx#2\relax

374 \let#2\@empty

375 \else

376 \ifx#2\@empty

377 \else

379 \edef#2{#2 g}%

381 \edef#2{#2 rg}%

383 \edef#2{#2 k}%

384 \else

385 \PackageError{#3}{Internal error: unsupported color model}\@ehc

386 \fi\fi\fi

387 \fi

388 \fi

389}

2.5.4 Detection for naked RGB values

\HyColor@IfRGB

390\newif\ifHyColor@result

391\begingroup\expandafter\expandafter\expandafter\endgroup

392\expandafter\ifx\csname pdfmatch\endcsname\relax

394\else

396\fi

397{%

398 \begingroup

399 \def\x#1{\endgroup

400 \def\HyColor@IfRGB##1{%

401 \HyColor@@IfRGB##1#1#1#1\@nil

402 }%

(15)

403 }%

404 \x{ }%

405 \edef\HyColor@TwoSpaces{\space\space}%

406 \def\HyColor@@IfRGB#1 #2 #3 #4\@nil{%

407 \HyColor@resulttrue

408 \def\HyColor@temp{#4}%

409 \ifx\HyColor@temp\HyColor@TwoSpaces

410 \HyColor@CheckNum{#1}%

411 \ifHyColor@result

415 \fi

416 \fi

417 \else

418 \HyColor@resultfalse

419 \fi

422 \edef\HyColor@values{#1,#2,#3}%

424 \else

426 \fi

427 }%

428 \def\HyColor@zero{0}%

429 \def\HyColor@one{1}%

430 \def\HyColor@dot{.}%

431 \def\HyColor@CheckNum#1{%

432 \def\HyColor@temp{#1}%

433 \ifx\HyColor@temp\@empty

435 \else

436 \edef\HyColor@temp{\@car#1\@nil}%

437 \ifx\HyColor@temp\HyColor@zero

438 \else

439 \ifx\HyColor@temp\HyColor@one

440 \else

441 \ifx\HyColor@temp\HyColor@dot

442 \else

444 \fi

445 \fi

446 \fi

447 \fi

448 }%

449}{%

450 \def\HyColor@MatchNum{%

451 (0*1\string\.0*|0*1|0+\string\.?[0-9]*|\string\.[0-9]+)%

452 }%

453 \def\HyColor@IfRGB#1{%

454 \ifnum\pdfmatch{^\HyColor@MatchNum\space\HyColor@MatchNum

455 \space\HyColor@MatchNum$}{#1}>\z@

457 \edef\HyColor@values{%

458 \expandafter\strip@prefix\pdflastmatch1,%

459 \expandafter\strip@prefix\pdflastmatch2,%

460 \expandafter\strip@prefix\pdflastmatch3%

(16)

461 }%

462 \HyColor@resulttrue

464 \else

467 \fi

468 }%

469}

2.5.5 Options *bordercolor

ProcedureHyperrefBorderColor(value, cmd, package, option) Param: value (value of the option)

Param: cmd (macro for result)

Param: package, option (package and option for error message) switchvalue do

end

casewith model do if with xcolor then

cmd ←output values;

else

switchmodel do casergb, graydo

end else

error(package,option, ”Missing xcolor”);

cmd ←no color;

end end end end

casergb values do cmd ←output values;

end

casewithout model do if with xcolor then

else

error(package,option, ”Missing xcolor”);cmd ←no color;

end end end

\HyColor@HyperrefBorderColor

470\def\HyColor@HyperrefBorderColor#1#2#3#4{%

(17)

476 }{%

479 \else

483 \edef#2{#2 #2 #2}%

484 \else

485 \let#2\relax

487 \fi

488 \fi

489 }%

490 }{%

492 \ifx#2\@empty

493 \let#2\relax

494 \else

495 \expandafter\HyColor@IfRGB\expandafter{\HyColor@values}{%

497 }{%

500 \expandafter\convertcolorspec#2\HyColor@model@rgb#2%

502 }{%

503 \let#2\relax

505 }%

506 }%

507 \fi

508 }%

509}

2.6 Package attachfile2

Before PDF-1.7 only RGB values are permitted in annotations. Since PDF-1.7 the color entry in annotations understands several color models, depending on the size of the color array:

• Zero entries: means transparent, not useful for file attachments. AR7/Linux and AR8/Linux show black instead.

• One entry: color model ‘gray’.

• Three entries: color model ‘rgb’.

• Four entries: color model ‘cmyk’.

An empty color specification is interpreted as “no color”.

\HyColor@DetectPdfVersion

510\def\HyColor@DetectPdfVersion{%

511 \begingroup\expandafter\expandafter\expandafter\endgroup

512 \expandafter\ifx\csname Hy@pdfversion\endcsname\relax

(18)

513 \global\chardef\HyColor@PdfVersion=0 %

514 \else

515 \global\chardef\HyColor@PdfVersion=\Hy@pdfversion\relax

516 \fi

517 \global\let\HyColor@DetectPdfVersion\relax

518}

\HyColor@SpaceToComma

519\def\HyColor@SpaceToComma#1 #2\@nil{%

520 #1%

521 \ifx\relax#2\relax

522 \expandafter\@gobble

523 \else

524 ,%

525 \expandafter\@firstofone

526 \fi

527 {%

528 \HyColor@SpaceToComma#2\@nil

529 }%

530}%

\HyColor@AttachfileColor

531\def\HyColor@AttachfileColor#1#2#3#4#5#6{%

532 \def#2{#1}%

533 \ifx#2\@empty

534 \let#3\@gobble

535 \let#4\@empty

536 \else

538 \HyColor@XZeroOneThreeFour{#1}#3{#5}{#6}%

540 \edef#2{%

541 [rgb]{\expandafter\HyColor@SpaceToComma#3 \@nil}%

542 }%

543 \fi

545 \edef#4{/C[#3]}% hash-ok

546 \edef#3##1{%

547 #3 %

548 \noexpand\csname atfi@SETRGBCOLOR##1\noexpand\endcsname

549 }%

550 \else

552 \HyColor@DetectPdfVersion

553 \ifnum\HyColor@PdfVersion<7 %

554 \edef#4{/C[#3 #3 #3]}% hash-ok

555 \else

556 \edef#4{/C[#3]}% hash-ok

557 \fi

558 \edef#3##1{%

559 #3 %

560 \noexpand\csname atfi@SETGRAYCOLOR##1\noexpand\endcsname

561 }%

562 \else

563 \ifx\HyColor@model\HyColor@model@cmyk

564 \HyColor@DetectPdfVersion

565 \ifnum\HyColor@PdfVersion<7 %

(19)

571 \edef#4{/C[#4]}% hash-ok

572 }{%

573 \let#4\@empty

575 }%

576 }{%

579 \expandafter\convertcolorspec#4%

582 \edef#4{/C[#4]}% hash-ok

583 }{%

584 \let#4\@empty

586 }%

587 }%

588 \else

589 \edef#4{/C[#3]}% hash-ok

590 \fi

591 \edef#3##1{%

592 #3 %

593 \noexpand\csname atfi@SETCMYKCOLOR##1\noexpand\endcsname

594 }%

595 \else

596 \ifx\HyColor@model\HyColor@model@empty

598 Color model ‘empty’ is not permitted for option ‘#6’%

599 }\@ehc

600 \let#2\@empty

601 \let#3\@gobble

602 \let#4\@empty

603 \else

604 \ifx\HyColor@model\relax % (missing xcolor)

605 \let#3\@gobble

606 \let#4\@empty

607 \else

609 Internal error: unsupported color model%

610 }\@ehc

611 \fi

612 \fi

613 \fi

614 \fi

615 \fi

616 \fi

617}

618h/packagei

2.7 Patch for package xcolor

Because the test files triggered a bug in package xcolor of version 2007/01/21 v2.11. I contacted the author of xcolor Uwe Kern. He responded with a test

(20)

version 2007/03/27 v2.12a00 that fixes the problem. However, apparently he did not found the time for an official release yet. Thus I have reluctantly written the following patch package using the fixes of v2.12a00.

The patch is immediately applied if packagexcoloris already loaded. Otherwise the patch is delayed using \AfterPackage if package scrlfile is loaded. As last resort\AtBeginDocumentis used.

619h*xcolori

620\NeedsTeXFormat{LaTeX2e}

621\ProvidesPackage{xcolor-patch}[2020/01/27 v1.10 xcolor patch]

622\RequirePackage{hopatch}

623\hopatch@AfterPackage{xcolor}{%

\XC@ifxcase

624 \long\def\reserved@a#1#2#3{%

625 \long\def\@@tmp##1##2{%

626 \ifx#1##1%

627 \toks@{##2}%

628 \expandafter\remove@to@nnil

629 \else

630 \expandafter\@@tmp

631 \fi

632 }%

633 \@@tmp#2#1{#3}\@nnil\the\toks@

634 }%

635 \ifx\XC@ifxcase\reserved@a

636 \long\def\XC@ifxcase#1#2#3{%

637 \long\def\XC@if@##1##2{%

638 \ifx#1##1%

639 \toks@{##2}%

641 \else

642 \expandafter\XC@if@

643 \fi

644 }%

645 \XC@if@#2#1{#3}\@nnil

646 \the\toks@

647 }%

648 \fi

\XC@ifcase

649 \long\def\reserved@a#1#2#3{%

650 \long\def\@@tmp##1##2{%

651 \@expandtwoargs\in@{,#1,}{,##1,}%

652 \ifin@

653 \toks@{##2}%

655 \else

656 \expandafter\@@tmp

657 \fi

658 }%

659 \@@tmp#2{#1}{#3}\@nnil

660 \the\toks@

661 }%

662 \ifx\XC@ifcase\reserved@a

663 \long\def\XC@ifcase#1#2#3{%

664 \long\def\XC@if@##1##2{%

665 \@expandtwoargs\in@{,#1,}{,##1,}%

(21)

666 \ifin@

667 \toks@{##2}%

669 \else

670 \expandafter\XC@if@

671 \fi

672 }%

673 \XC@if@#2{#1}{#3}\@nnil

674 \the\toks@

675 }%

676 \fi

\XC@cnv@gray

677 \def\reserved@a#1,{%

678 \XC@ifxcase\tm{%

679 \XC@mod@rgb{%

682 }%

683 \XC@mod@cmy{%

686 }%

687 \XC@mod@cmyk{%

689 \edef\@@tmp{0,0,0,\@@tmp}%

690 }%

691 \XC@mod@RGB{%

695 }%

696 \XC@mod@HTML{%

701 }%

702 \XC@mod@HSB{%

705 \edef\@@tmp{0,0,\@@tmp}%

706 }%

707 \XC@mod@Gray{%

710 }%

711 }%

712 {%

714 \edef\@@tmp{0,0,\@@tmp}%

715 }%

716 }%

717 \ifx\XC@cnv@gray\reserved@a

718 \def\XC@cnv@gray#1,{%

719 \XC@ifxcase\tm{%

720 \XC@mod@rgb{%

(22)

723 }%

724 \XC@mod@gray{}%

725 \XC@mod@cmy{%

728 }%

729 \XC@mod@cmyk{%

731 \edef\@@tmp{0,0,0,\@@tmp}%

732 }%

733 \XC@mod@RGB{%

737 }%

738 \XC@mod@HTML{%

743 }%

744 \XC@mod@HSB{%

747 \edef\@@tmp{0,0,\@@tmp}%

748 }%

749 \XC@mod@Gray{%

752 }%

753 }%

754 {%

756 \edef\@@tmp{0,0,\@@tmp}%

757 }%

758 }%

759 \fi

2.7.1 Fix fragile \@frameb@x

\fboxbecomes fragile, because the internal \@frameb@x is redefined by package xcolor. The redefinition is no longer robust. Test file:

\documentclass{article}

\usepackage{xcolor}

\makeatletter

\protected@edef\x{\fbox{abc}}

\@@end

760 \@ifundefined{XC@frameb@x }{%

761 \expandafter\let\csname XC@frameb@x \endcsname\XC@frameb@x

762 \edef\XC@frameb@x{%

763 \noexpand\protect

764 \expandafter\noexpand\csname XC@frameb@x \endcsname

765 }%

766 \expandafter\ifx\csname XC@frameb@x \endcsname\@frameb@x

767 \let\@frameb@x\XC@frameb@x

768 \fi

(23)

769 }{}%

770}

771h/xcolori

3 Installation

3.1 Download

Package. This package is available on CTAN¹:

CTAN:macros/latex/contrib/hycolor/hycolor.dtx The source file.

CTAN:macros/latex/contrib/hycolor/hycolor.pdf Documentation.

3.2 Package installation

Unpacking. The .dtx file is a self-extracting docstrip archive. The files are extracted by running the.dtxthrough plain TEX:

tex hycolor.dtx

TDS. Now the different files must be moved into the different directories in your installation TDS tree (also known astexmftree):

hycolor.sty →tex/latex/hycolor/hycolor.sty xcolor-patch.sty→tex/latex/hycolor/xcolor-patch.sty hycolor.pdf →doc/latex/hycolor/hycolor.pdf hycolor.dtx →source/latex/hycolor/hycolor.dtx

If you have adocstrip.cfgthat configures and enablesdocstrip’s TDS installing feature, then some files can already be in the right place, see the documentation of docstrip.

3.3 Refresh file name databases

If your TEX distribution (TEX Live, MiKTEX, . . . ) relies on file name databases, you must refresh these. For example, TEX Live users runtexhashormktexlsr.

3.4 Some details for the interested

Unpacking with L^ATEX. The.dtxchooses its action depending on the format:

plain TEX: Rundocstripand extract the files.

L^ATEX: Generate the documentation.

If you insist on using L^ATEX for docstrip (really, docstrip does not need L^ATEX), then inform the autodetect routine about your intention:

latex \let\install=y\input{hycolor.dtx}

Do not forget to quote the argument according to the demands of your shell.

1CTAN:pkg/hycolor

(24)

Generating the documentation. You can use both the.dtx or the .drv to generate the documentation. The process can be configured by the configuration fileltxdoc.cfg. For instance, put this line into this file, if you want to have A4 as paper format:

\PassOptionsToClass{a4paper}{article}

An example follows how to generate the documentation with pdfL^ATEX:

pdflatex hycolor.dtx

makeindex -s gind.ist hycolor.idx pdflatex hycolor.dtx

4 History

[2007/04/09 v1.0]

• First version.

[2007/04/11 v1.1]

• Line ends sanitized.

[2008/07/29 v1.2]

• Support for packageattachfile2added.

[2008/08/01 v1.3]

• Patch packagexcolor-patchadded that fixes bugs in package xcolorto get the test files running.

[2008/09/08 v1.4]

• Fix added to packagexcolor-patch: Fragile\@frameb@x(used in \fbox) is made robust.

[2009/10/02 v1.5]

• Doku fixes (Herbert Voss).

[2009/12/12 v1.6]

• Short info shortened.

[2011/01/30 v1.7]

• Packagexcolor-patchuses package hopatch.

[2016/05/16 v1.8]

• Documentation updates.

(25)

[2019/12/15 v1.9]

• Documentation updates.

• Do not loadxcolor-patchby default.

[2020-01-27 v1.10]

• extra expansion step to avoid

! LaTeX Error: Undefined color ‘[{rgb}]errors in hyperref.

• add fix to Gray model fromxcolor-patch.

5 Index

Numbers written in italic refer to the page where the corresponding entry is de- scribed; numbers underlined refer to the code line of the definition; plain numbers refer to the code lines where the entry is used.

Symbols

\! . . . 93

\" . . . 98

\+ . . . 96

\- . . . 95

\. . . 451

\: . . . 94

\; . . . 97

\> . . . 99

\@@scl . . . 22,

27, 33, 38,64, 69, 75, 80, 692, 697, 703, 708, 734, 739, 745, 750 \@@tmp . . . 10,11,14,15,18,19,23, 24,28,29,30,34,35,39,43,44, 51,52,56,57,60,61,65,66,70, 71, 72, 76,77, 81, 85, 86, 625, 630, 633, 650, 656, 659, 680, 681, 684, 685, 688, 689, 693, 694, 698, 699, 700, 704, 705, 709, 713, 714, 721, 722, 726, 727, 730, 731, 735, 736, 740, 741, 742, 746, 747, 751, 755, 756 \@ReturnAfterFi . . . 151,156,249 \@car . . . 436

\@cclv . . . 27,69,697,739 \@ehc . . . 222,229,385,599,610 \@empty . . . 126,136,137,197, 204, 211, 269, 271, 291, 299, 330, 371, 374, 376, 433, 492, 533, 535, 573, 584, 600, 602, 606 \@expandtwoargs . . . 651,665 \@firstofone . . . 525

\@firstoftwo 242,255,338,393,423,463 \@frameb@x . . . 766,767 \@gobble . . . 522,534,601,605 \@ifnextchar . . . 232,278 \@ifundefined . . . 760

\@ne . . . 131

\@nil . . . 127,130,135,140,147, 152, 164, 172, 187, 190, 209, 237, 239, 244, 273, 280, 283, 304, 306, 321, 334, 345, 348, 358, 401, 406, 436, 475, 478, 496, 501, 519, 528, 541, 570, 581 \@nnil . . . 633,645,659,673 \@onelevel@sanitize . . . . . . . 118,259,261,263,265,267 \@secondoftwo . . . . . . . 247,253,339,395,425,466 \@tempa . . . 7,47,90 \\ . . . 132,148 A \AtBeginDocument . . . 6

C \catcode . . . . 93,94,95,96,97,98,99 \chardef . . . 513,515 \color . . . 281,284 \convertcolorspec . 185,208,309, 319, 350, 356, 473, 500, 568, 579 \csname . . . 112,252,392, 512, 548, 560, 593, 761, 764, 766 E \endcsname . . . 112,252,392, 512, 548, 560, 593, 761, 764, 766 \extractcolorspec . 207,337,499,578 H \hopatch@AfterPackage . . . 623

\Hy@pdfversion . . . 515

\HyColor@@@@UseColor . . . 278,283 \HyColor@@@UseColor . . . 278,280 \HyColor@@IfRGB . . . 401,406 \HyColor@@UseColor . . . 273,277 \HyColor@AttachfileColor . . . 531

(26)

\HyColor@BookmarkColor . . . 182

\HyColor@CheckDot . . . 127,130

\HyColor@CheckNum . 410,412,414,431

\HyColor@DefSanitized 92,240,241,246

\HyColor@DetectPdfVersion . . . . . . . 510,552,564

\HyColor@dot . . . 430,441

\HyColor@ErrorModelNoXcolor . . . . . . . 198,217,315,325,486,574

\HyColor@ErrorSpecNoXcolor . . . . . . . . 212,224,363,504,585

\HyColor@FieldBColor . . . 369

\HyColor@FieldColor . . . 370

\HyColor@HyperrefBorderColor . . . 470

\HyColor@HyperrefColor . . . 286

\HyColor@IfModel . . . . . . . 183,231,287,297,471,566

\HyColor@IfRGB . . . 333,390,495

\HyColor@IfXcolor . 184,206,250, 308, 318, 336, 472, 498, 567, 577

\HyColor@MatchNum . . . . 450,454,455

\HyColor@model . 185,189,192,219, 221, 240, 245, 288, 298, 300, 303, 305, 307, 309, 312, 319, 322, 338, 340, 343, 346, 349, 350, 354, 356, 359, 371, 378, 380, 382, 421, 456, 473, 477, 480, 544, 551, 563, 568, 596, 604

\HyColor@model@cmyk . . . . . . . 264,265,305,346,382,563

\HyColor@model@empty 258,259,298,596

\HyColor@model@Gray 266,267,307,349

\HyColor@model@gray . . . . . . . 192,260,261,300,310, 312, 340, 351, 354, 378, 480, 551

\HyColor@model@rgb . . . 186, 189, 208, 262, 263, 303, 320, 322, 343, 357, 359, 380, 421, 456, 474, 477, 500, 544, 569, 580

\HyColor@NormalizeCommaCMYK . . . . . . . 172,306,347

\HyColor@NormalizeCommaRGB . . . . . . . . 164,187, 190, 209, 304, 321, 334, 344, 358, 475, 478, 496, 501, 570, 581

\HyColor@NormalizeNum . . . 122, 165, 167, 169, 173, 175, 177, 179, 193, 301, 311, 341, 352, 481

\HyColor@one . . . 429,439

\HyColor@PdfVersion 513,515,553,565

\HyColor@resultfalse . . . . . . . 418,434,443,465,537

\HyColor@resulttrue . . . 407,462

\HyColor@ReverseString . . . . . . . 135,140,147,152

\HyColor@SpaceToComma . . . 519,541

\HyColor@StripLeadingZeros . . . . . . . . 136,157,159

\HyColor@temp . . . 165,166,167, 168, 169, 170, 173, 174, 175, 176, 177, 178, 179, 180, 408, 409, 432, 433, 436, 437, 439, 441

\HyColor@TwoSpaces . . . 405,409

\HyColor@UseColor . . . 268

\HyColor@values 185,190,194,203, 221, 228, 241, 246, 288, 290, 302, 304, 306, 309, 319, 329, 333, 334, 337, 339, 342, 345, 348, 350, 353, 356, 422, 457, 473, 478, 482, 491, 495, 496, 568

\HyColor@WithModel . . . 233,239

\HyColor@WithoutModel . . . 235,244

\HyColor@XZeroOneThreeFour . . . . . . . . 296,369,372,538

\HyColor@zero . . . 428,437 I

\ifdim . . . 123

\ifHyColor@result . . . . . . . 390,411,413,420,539

\ifin@ . . . 652,666

\ifnum . . . 131,454,553,565

\ifx 47,132,137,148,158,189,192, 204, 252, 269, 271, 291, 298, 300, 303, 305, 307, 330, 340, 343, 346, 349, 373, 376, 378, 380, 382, 392, 409, 433, 437, 439, 441, 477, 480, 492, 512, 521, 533, 544, 551, 563, 596, 604, 626, 635, 638, 662, 717, 766

\in@ . . . 651,665 M

\MessageBreak . . . 219,220,226,227 N

\NeedsTeXFormat . . . 2,620

\newif . . . 390 P

\PackageError . 218,225,385,597,608

\pdflastmatch . . . 458,459,460

\pdfmatch . . . 454

\protect . . . 763

\ProvidesPackage . . . 3,621 R

\rangeGray . . . 38,80,708,750

\rangeHSB . . . 33,75,703,745

\rangeRGB . . . 22,64,692,734

\remove@to@nnil . . . 628,640,654,668

\RequirePackage . . . 5,622

\reserved@a 624,635,649,662,677,717 S

\space . . . 405,454,455

\strip@prefix . . . 458,459,460

(27)

T

\the . . . 633,646,660,674

\tm . . . 8,49,678,719

\toks@ . . . 627, 633, 639, 646, 653, 660, 667, 674

X

\x . . . 100,114,117,121,399,404

\XC@calcC . . . . . 14,18,56,60,684,688,726,730

\XC@calcH . . . 29,71,699,741

\XC@calcM . . . 23, 28, 34, 39,65, 70, 76, 81, 693, 698, 704, 709, 735, 740, 746, 751

\XC@calcN . . . . . 10,43,51,85,680,713,721,755

\XC@cnv@gray . . . 47,48,677

\XC@frameb@x . . . 761,762,767

\XC@if@ . . . 637,642,645,664,670,673

\XC@ifcase . . . 649

\XC@ifxcase . . . 8,49,624,678,719

\XC@mod@cmy . . . 13,55,683,725

\XC@mod@cmyk . . . 17,59,687,729

\XC@mod@Gray . . . 37,79,707,749

\XC@mod@gray . . . 54,724

\XC@mod@HSB . . . 32,74,702,744

\XC@mod@HTML . . . 26,68,696,738

\XC@mod@RGB . . . 21,63,691,733

\XC@mod@rgb . . . 9,50,679,720 Y

\y . . . 109,121 Z

\z@ . . . 123,455

\zap@space . . . 126

Index of /CTAN/macros/latex/contrib/hycolor

The hycolor package

Heiko Oberdiek

2020-01-27 v1.10

Contents

1 Documentation

1.1 Summary

2 Implementation

2.1 Normalization

2.2 Main algorithm for color options

2.3 Package bookmark

2.4 Utils

2.5 Package hyperref

2.6 Package attachfile2

2.7 Patch for package xcolor

3 Installation

3.1 Download

3.2 Package installation

3.3 Refresh file name databases

3.4 Some details for the interested

4 History

[2007/04/09 v1.0]

[2007/04/11 v1.1]

[2008/07/29 v1.2]

[2008/08/01 v1.3]

[2008/09/08 v1.4]

[2009/10/02 v1.5]

[2009/12/12 v1.6]

[2011/01/30 v1.7]

[2016/05/16 v1.8]

[2019/12/15 v1.9]

[2020-01-27 v1.10]

5 Index