Documentation

QRGdImagePNG extends QRGdImage
in package

GdImage png output

Tags
see
imagepng()

Table of Contents

Constants

MIME_TYPE  = 'image/png'

Properties

$background  : int
The allocated background color
$circleDiameter  : float
$circleRadius  : float
$connectPaths  : bool
$drawCircularModules  : bool
$drawLightModules  : bool
$eol  : string
$excludeFromConnect  : array<string|int, int>
$image  : GdImage
The GD image resource
$keepAsSquare  : array<string|int, int>
$length  : int
the side length of the QR image (modules * scale)
$matrix  : QRMatrix
the (filled) data matrix object
$moduleCount  : int
the current size of the QR matrix
$moduleValues  : array<string|int, mixed>
an (optional) array of color values for the several QR matrix parts
$options  : SettingsContainerInterface|QROptions
the options instance
$scale  : int
$upscaled  : bool
Whether we're running in upscale mode (scale < 20)

Methods

__construct()  : mixed
QROutputAbstract constructor.
dump()  : string|GdImage
Generates the output, optionally dumps it to a file, and returns it
moduleValueIsValid()  : bool
implements \chillerlan\QRCode\Output\QROutputInterface::moduleValueIsValid()
checkGD()  : void
Checks whether GD is installed and if the given mode is supported
collectModules()  : array<int, mixed>
collects the modules per QRMatrix::M_* type and runs a $transform function on each module and returns an array with the transformed modules
copyVars()  : void
Creates copies of several QROptions values to avoid calling the magic getters in long loops for a significant performance increase.
createImage()  : GdImage
Creates a new GdImage resource and scales it if necessary
drawImage()  : void
Draws the QR image
dumpImage()  : string
Creates the final image by calling the desired GD output function
getDefaultModuleValue()  : int
Returns a default value for either dark or light modules (return value depends on the output class)
getModuleValue()  : mixed
Returns the prepared value for the given $M_TYPE
getModuleValueAt()  : mixed
Returns the prepared module value at the given coordinate [$x, $y] (convenience)
getOutputDimensions()  : array<string|int, int>
Returns a 2 element array with the current output width and height
getQuality()  : int
Returns the image quality value for the current GdImage output child class (defaults to -1 ... 100)
guessMimeType()  : string
Guesses the mime type from the given $imageData
module()  : void
Creates a single QR pixel with the given settings
prepareModuleValue()  : int
Prepares the value for the given input (return value depends on the output class)
renderImage()  : void
Renders the image with the gdimage function for the desired output
saveToFile()  : void
Saves the qr $data to a $file. If $file is null, nothing happens.
setBgColor()  : void
Sets the background color
setMatrixDimensions()  : void
Sets/updates the matrix dimensions
setModuleValues()  : void
Sets the initial module values
setTransparencyColor()  : int
Sets the transparency color, returns the identifier of the new transparent color
toBase64DataURI()  : string
Returns a base64 data URI for the given string and mime type

Constants

Properties

$background

The allocated background color

protected int $background
Tags
see
imagecolorallocate()

$circleRadius

protected float $circleRadius
Tags
see
QROptions::$circleRadius

$connectPaths

protected bool $connectPaths
Tags
see
QROptions::$connectPaths

$drawCircularModules

protected bool $drawCircularModules
Tags
see
QROptions::$drawCircularModules

$drawLightModules

protected bool $drawLightModules
Tags
see
QROptions::$drawLightModules

$excludeFromConnect

protected array<string|int, int> $excludeFromConnect
Tags
see
QROptions::$excludeFromConnect

$image

The GD image resource

protected GdImage $image
Tags
see
imagecreatetruecolor()

$keepAsSquare

protected array<string|int, int> $keepAsSquare
Tags
see
QROptions::$keepAsSquare

$length

the side length of the QR image (modules * scale)

protected int $length

$moduleValues

an (optional) array of color values for the several QR matrix parts

protected array<string|int, mixed> $moduleValues
Tags
phpstan-var

array<int, mixed>

$upscaled

Whether we're running in upscale mode (scale < 20)

protected bool $upscaled = false
Tags
see
QROptions::$drawCircularModules

Methods

dump()

Generates the output, optionally dumps it to a file, and returns it

public dump([string|null $file = null ]) : string|GdImage
Parameters
$file : string|null = null
Tags
inheritDoc
throws
ErrorException|QRCodeOutputException
Return values
string|GdImage

moduleValueIsValid()

implements \chillerlan\QRCode\Output\QROutputInterface::moduleValueIsValid()

public static moduleValueIsValid(array<string|int, int> $value) : bool
Parameters
$value : array<string|int, int>
Return values
bool

checkGD()

Checks whether GD is installed and if the given mode is supported

protected checkGD() : void
Tags
throws
QRCodeOutputException
codeCoverageIgnore

collectModules()

collects the modules per QRMatrix::M_* type and runs a $transform function on each module and returns an array with the transformed modules

protected collectModules(Closure $transform) : array<int, mixed>

The transform callback is called with the following parameters:

$x - current column $y - current row $M_TYPE - field value $M_TYPE_LAYER - (possibly modified) field value that acts as layer id

Parameters
$transform : Closure
Return values
array<int, mixed>

copyVars()

Creates copies of several QROptions values to avoid calling the magic getters in long loops for a significant performance increase.

protected copyVars() : void

These variables are usually used in the "module" methods and are called up to 31329 times (at version 40).

drawImage()

Draws the QR image

protected drawImage() : void

dumpImage()

Creates the final image by calling the desired GD output function

protected dumpImage() : string
Tags
throws
QRCodeOutputException
Return values
string

getDefaultModuleValue()

Returns a default value for either dark or light modules (return value depends on the output class)

protected getDefaultModuleValue(bool $isDark) : int
Parameters
$isDark : bool
Return values
int

getModuleValue()

Returns the prepared value for the given $M_TYPE

protected getModuleValue(int $M_TYPE) : mixed
Parameters
$M_TYPE : int
Tags
throws
QRCodeOutputException

if $moduleValues[$M_TYPE] doesn't exist

getModuleValueAt()

Returns the prepared module value at the given coordinate [$x, $y] (convenience)

protected getModuleValueAt(int $x, int $y) : mixed
Parameters
$x : int
$y : int

getOutputDimensions()

Returns a 2 element array with the current output width and height

protected getOutputDimensions() : array<string|int, int>

The type and units of the values depend on the output class. The default value is the current module count * scale.

Return values
array<string|int, int>

getQuality()

Returns the image quality value for the current GdImage output child class (defaults to -1 ... 100)

protected getQuality() : int
Return values
int

guessMimeType()

Guesses the mime type from the given $imageData

protected guessMimeType(string $imageData) : string
Parameters
$imageData : string
Tags
throws
QRCodeOutputException
Return values
string

module()

Creates a single QR pixel with the given settings

protected module(int $x, int $y, int $M_TYPE) : void
Parameters
$x : int
$y : int
$M_TYPE : int

prepareModuleValue()

Prepares the value for the given input (return value depends on the output class)

protected prepareModuleValue(mixed $value) : int
Parameters
$value : mixed
Tags
inheritDoc
throws
QRCodeOutputException
Return values
int

saveToFile()

Saves the qr $data to a $file. If $file is null, nothing happens.

protected saveToFile(string $data[, string|null $file = null ]) : void
Parameters
$data : string
$file : string|null = null
Tags
see
file_put_contents()
see
QROptions::$cachefile
throws
QRCodeOutputException

setBgColor()

Sets the background color

protected setBgColor() : void

setMatrixDimensions()

Sets/updates the matrix dimensions

protected setMatrixDimensions() : void

Call this method if you modify the matrix from within your custom module in case the dimensions have been changed

setModuleValues()

Sets the initial module values

protected setModuleValues() : void

setTransparencyColor()

Sets the transparency color, returns the identifier of the new transparent color

protected setTransparencyColor() : int
Return values
int

toBase64DataURI()

Returns a base64 data URI for the given string and mime type

protected toBase64DataURI(string $data[, string|null $mime = null ]) : string

The mime type can be set via class constant MIME_TYPE in child classes, or given via $mime, otherwise it is guessed from the image $data.

Parameters
$data : string
$mime : string|null = null
Return values
string 

        

        
    




    

    

                                

                

                                
    

        On this page

        
    


                

                            

            

    

        

            
Search results