Skip to content

Commit 55c82bd

Browse files
committed
More v3 info in readme
1 parent faae548 commit 55c82bd

2 files changed

Lines changed: 37 additions & 6 deletions

File tree

Readme.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -178,6 +178,30 @@ file_put_contents('barcode.svg', (new Picqer\Barcode\Renderers\SvgRenderer())->r
178178
## Upgrading to v3
179179
There is no need to change anything when upgrading from v2 to v3. Above you find the new preferred way of using this library since v3. But the old style still works.
180180

181+
If you want to convert to the new style, here is an example:
182+
```php
183+
// Old style
184+
$generator = new Picqer\Barcode\BarcodeGeneratorSVG();
185+
echo $generator->getBarcode('081231723897', $generator::TYPE_CODE_128);
186+
187+
// New style
188+
$barcode = (new Picqer\Barcode\Types\TypeCode128())->getBarcode('081231723897');
189+
$renderer = new Picqer\Barcode\Renderers\SvgRenderer();
190+
echo $renderer->render($barcode);
191+
```
192+
193+
The width in the SVG and HTML renderer is now the width of the end result, instead of the widthFactor. If you want to keep dynamic widths, you can get the width of the encoded Barcode and multiply it by the widthFactor to get the same result as before. See here an example for a widthFactor of 2:
194+
```php
195+
// Old style
196+
$generator = new Picqer\Barcode\BarcodeGeneratorSVG();
197+
echo $generator->getBarcode('081231723897', $generator::TYPE_CODE_128, 2. 30);
198+
199+
// New style
200+
$barcode = (new Picqer\Barcode\Types\TypeCode128())->getBarcode('081231723897');
201+
$renderer = new Picqer\Barcode\Renderers\SvgRenderer();
202+
echo $renderer->render($barcode, $barcode->getWidth() * 2, 30);
203+
```
204+
181205
---
182206

183207
## Previous style generators

tests/TypesTest.php

Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,36 @@
11
<?php
22

33
use PHPUnit\Framework\TestCase;
4+
use Picqer\Barcode\Renderers\SvgRenderer;
5+
use Picqer\Barcode\Types\TypeCode39;
6+
use Picqer\Barcode\Types\TypeCode39Checksum;
7+
use Picqer\Barcode\Types\TypeCode39Extended;
48

59
class TypesTest extends TestCase
610
{
711
public function test_generator_can_generate_code_39_barcode()
812
{
9-
$generator = new Picqer\Barcode\BarcodeGeneratorSVG();
10-
$result = $generator->getBarcode('1234567890ABC', $generator::TYPE_CODE_39);
13+
$barcode = (new TypeCode39())->getBarcode('1234567890ABC');
14+
$renderer = new SvgRenderer();
15+
$result = $renderer->render($barcode, $barcode->getWidth() * 2);
1116

1217
$this->assertStringEqualsFile('tests/verified-files/TypeCode39-1234567890ABC.svg', $result);
1318
}
1419

1520
public function test_generator_can_generate_code_39_checksum_barcode()
1621
{
17-
$generator = new Picqer\Barcode\BarcodeGeneratorSVG();
18-
$result = $generator->getBarcode('1234567890ABC', $generator::TYPE_CODE_39_CHECKSUM);
22+
$barcode = (new TypeCode39Checksum())->getBarcode('1234567890ABC');
23+
$renderer = new SvgRenderer();
24+
$result = $renderer->render($barcode, $barcode->getWidth() * 2);
1925

2026
$this->assertGreaterThan(100, strlen($result));
2127
}
2228

2329
public function test_generator_can_generate_code_39_extended_barcode()
2430
{
25-
$generator = new Picqer\Barcode\BarcodeGeneratorSVG();
26-
$result = $generator->getBarcode('1234567890abcABC', $generator::TYPE_CODE_39E);
31+
$barcode = (new TypeCode39Extended())->getBarcode('1234567890abcABC');
32+
$renderer = new SvgRenderer();
33+
$result = $renderer->render($barcode, $barcode->getWidth() * 2);
2734

2835
$this->assertStringEqualsFile('tests/verified-files/TypeCode39Extended-1234567890abcABC.svg', $result);
2936
}

0 commit comments

Comments
 (0)