rename photo to logo
This commit is contained in:
@@ -95,11 +95,11 @@ Layout options are set as options to the `\documentclass`, e.g.:
|
||||
- `qrfirst` or `textfirst`: switch position of QR-Code and text block, default: `qrfirst`
|
||||
- `https` or `www`: should links in the hints be prefixed with `https://` or `www.`, default: `https`
|
||||
- `countryformat=`: how to format the country in address. Values: `auto` (default: inline with mdash if <4 chars and city/zip exists), `inline` (always inline with mdash), `below` (always separate line)
|
||||
- `qreclevel=`: QR error correction level `L` (~7%), `M` (~15%), `Q` (~25%), or `H` (~30%), default: `Q`. Use `H` when `photoinqr=true`.
|
||||
- `photoinqr` or `nophotoinqr`: place photo in the center of the QR code (`photoinqr`) instead of next to the name, default: `nophotoinqr`. **Requires `qreclevel=H` for reliable scanning**.
|
||||
- `qrlogoscale=`: photo size in QR code as fraction of QR width (1.0 = 100%), default: `0.25` (25% width). Recommended values: Level H: 0.25-0.3, Level Q: 0.2, Level M: 0.15, Level L: 0.1. Higher values may reduce scannability.
|
||||
- `qrlogoborder=`: transparent padding around photo in QR code as fraction of QR width (1.0 = 100%), default: `0.02` (2%). Adds space between photo and QR modules.
|
||||
- `photoscale=`: scale factor for photo next to name (1.0 = 100% of name height), default: `1.0`. Use values like `2.0` or `2.5` for larger photos.
|
||||
- `qreclevel=`: QR error correction level `L` (~7%), `M` (~15%), `Q` (~25%), or `H` (~30%), default: `Q`. Use `H` when `logoinqr=true`.
|
||||
- `logoinqr` or `nologoinqr`: place logo in the center of the QR code (`logoinqr`) instead of next to the name, default: `nologoinqr`. **Requires `qreclevel=H` for reliable scanning**.
|
||||
- `qrlogoscale=`: logo size in QR code as fraction of QR width (1.0 = 100%), default: `0.25` (25% width). Recommended values: Level H: 0.25-0.3, Level Q: 0.2, Level M: 0.15, Level L: 0.1. Higher values may reduce scannability.
|
||||
- `qrlogoborder=`: transparent padding around logo in QR code as fraction of QR width (1.0 = 100%), default: `0.02` (2%). Adds space between logo and QR modules.
|
||||
- `logoscale=`: scale factor for logo next to name (1.0 = 100% of name height), default: `1.0`. Use values like `2.0` or `2.5` for larger logos.
|
||||
- `bgscale=`: background image scale factor (1.0 = 100% of card height), default: `1.0`. Use values like `1.5` or `2.0` for zoomed/cropped backgrounds. Only affects images, not colors.
|
||||
- `bgopacity=`: background image opacity/transparency (1.0 = 100% visible, 0.0 = invisible), default: `1.0`. Use lower values like `0.2` or `0.3` to fade the background so text remains readable. Only affects images, not colors.
|
||||
- `qrbgopacity=`: QR code background opacity (1.0 = solid white, 0.0 = transparent), default: `1.0`. White background behind QR code ensures scannability over background images. Use `0.0` for no background or lower values like `0.8` for semi-transparent.
|
||||
@@ -160,7 +160,7 @@ See this example_
|
||||
- `\google`: your account name on [google+] — only the name of the account, the url is prepended automatically
|
||||
- `\pgpurl`: the full url to your pgp public key (only added to the QR-Code, not shown in the text)
|
||||
- `\pgpfingerprint`: the fingerprint of your pgp public key
|
||||
- `\photo`: path to photo file (PNG, JPG, etc.) for display next to name or in QR code (if `photoinqr` option is set)
|
||||
- `\logo`: path to logo file (PNG, JPG, etc.) for display next to name or in QR code (if `logoinqr` option is set)
|
||||
- `\background`: path to background image file or color name (e.g., `yellow!20`, `blue!10`). If file exists, it's used as image; otherwise treated as color.
|
||||
|
||||
|
||||
@@ -208,40 +208,40 @@ Save it as file [texstudio_d30266.tex] and compile it to get [texstudio_d30266.p
|
||||
|
||||
See [examples] for more examples.
|
||||
|
||||
Photo (optional)
|
||||
================
|
||||
Logo (optional)
|
||||
===============
|
||||
|
||||
You can add an optional photo that appears next to the name or in the center of the QR code. The photo is dynamically scaled to match the name line height (when next to name) or to 25% of the QR code width (when in QR).
|
||||
You can add an optional logo that appears next to the name or in the center of the QR code. The logo is dynamically scaled to match the name line height (when next to name) or to 25% of the QR code width (when in QR).
|
||||
|
||||
```latex
|
||||
\photo{path/to/photo.png}
|
||||
\logo{path/to/logo.png}
|
||||
```
|
||||
|
||||
### Photo Placement Options:
|
||||
### Logo Placement Options:
|
||||
|
||||
**Default (photo next to name):**
|
||||
**Default (logo next to name):**
|
||||
```latex
|
||||
\documentclass{businesscard-qrcode}
|
||||
\photo{photo.png}
|
||||
\logo{logo.png}
|
||||
```
|
||||
|
||||
**Photo in QR code center:**
|
||||
**Logo in QR code center:**
|
||||
```latex
|
||||
\documentclass[photoinqr,qreclevel=H,qrlogoscale=0.25]{businesscard-qrcode}
|
||||
\photo{photo.png}
|
||||
\documentclass[logoinqr,qreclevel=H,qrlogoscale=0.25]{businesscard-qrcode}
|
||||
\logo{logo.png}
|
||||
```
|
||||
|
||||
**Important:** When using `photoinqr=true`:
|
||||
**Important:** When using `logoinqr=true`:
|
||||
- Always use `qreclevel=H` (highest error correction ~30%) for reliable scanning
|
||||
- Test QR code scannability with multiple apps before printing
|
||||
- Default `qrlogoscale=0.25` (25% width = 6.25% area) is recommended for Level H
|
||||
- If scanning fails, reduce to `qrlogoscale=0.2` or `qrlogoscale=0.15`
|
||||
- PNG transparency is preserved - use images with transparent backgrounds for best results
|
||||
|
||||
**Large photo next to name:**
|
||||
**Large logo next to name:**
|
||||
```latex
|
||||
\documentclass[photoscale=2.5]{businesscard-qrcode}
|
||||
\photo{photo.png}
|
||||
\documentclass[logoscale=2.5]{businesscard-qrcode}
|
||||
\logo{logo.png}
|
||||
```
|
||||
|
||||
**Background color:**
|
||||
|
||||
Reference in New Issue
Block a user