RandomImageGenerator: does what it says on the tin. More...

Public Member Functions
	__construct ( $options=[])

	getImageSpec ()
	Generate data representing an image of random size (within limits), consisting of randomly colored and sized upward pointing triangles against a random background color.

	getImageWriteMethod ( $format)
	Figure out how we write images.

	getRandomColor ()
	Generate a string of random colors for ImageMagick or SVG, like "rgb(12, 37, 98)".

	writeImages ( $number, $format='jpg', $dir=null)
	Writes random images with random filenames to disk in the directory you specify, or current working directory.

	writeImageWithApi ( $spec, $format, $filename)
	Based on an image specification, write such an image to disk, using Imagick PHP extension.

	writeImageWithCommandLine ( $spec, $format, $filename)
	Based on an image specification, write such an image to disk, using the command line ImageMagick program ('convert').

	writeSvg ( $spec, $format, $filename)
	Based on image specification, write a very simple SVG file to disk.

Static Public Member Functions
static	shapePointsToString ( $shape)
	Given [ [ 'x' => 10, 'y' => 20 ], [ 'x' => 30, y=> 5 ] ] returns "10,20 30,5" Useful for SVG and imagemagick command line arguments.

Private Member Functions
	getRandomFilenames ( $number, $extension='jpg', $dir=null)
	Return a number of randomly-generated filenames Each filename uses two words randomly drawn from the dictionary, like elephantine_spatula.jpg.

	getRandomLines ( $number_desired)
	Return N random lines from a file.

	getRandomWordPairs ( $number)
	Get an array of random pairs of random words, like [ [ 'foo', 'bar' ], [ 'quux', 'baz' ] ];.

Static Private Member Functions
static	matrixMultiply2x2 ( $matrix, $x, $y)
	Given a matrix and a pair of images, return new position.

static	rotateImageSpec (&$spec, $matrix)
	Given an image specification, produce rotated version This is used when simulating a rotated image capture with Exif orientation.

Private Attributes
	$dictionaryFile

	$maxHeight = 800

	$maxWidth = 800

	$minHeight = 400

	$minWidth = 400

	$shapesToDraw = 5

Static Private Attributes
static	$orientations
	Orientations: 0th row, 0th column, Exif orientation code, rotation 2x2 matrix that is opposite of orientation.

Detailed Description

RandomImageGenerator: does what it says on the tin.

Can fetch a random image, or also write a number of them to disk with random filenames.

Definition at line 30 of file RandomImageGenerator.php.

Constructor & Destructor Documentation

◆ __construct()

RandomImageGenerator::__construct ( $options = [] )

Definition at line 72 of file RandomImageGenerator.php.

References $dictionaryFile, $options, and $property.

Member Function Documentation

◆ getImageSpec()

RandomImageGenerator::getImageSpec ( )

Generate data representing an image of random size (within limits), consisting of randomly colored and sized upward pointing triangles against a random background color.

(This data is used in the writeImage* methods).

Returns: mixed

Definition at line 183 of file RandomImageGenerator.php.

References $shapesToDraw, and getRandomColor().

Referenced by writeImages().

◆ getImageWriteMethod()

RandomImageGenerator::getImageWriteMethod ( $format )

Figure out how we write images.

This is a factor of both format and the local system

Parameters

string $format (a typical extension like 'svg', 'jpg', etc.)

Exceptions

Exception

Returns: string

Definition at line 129 of file RandomImageGenerator.php.

References $wgExiv2Command, $wgImageMagickConvertCommand, and $wgUseImageMagick.

Referenced by writeImages().

◆ getRandomColor()

RandomImageGenerator::getRandomColor ( )

Generate a string of random colors for ImageMagick or SVG, like "rgb(12, 37, 98)".

Returns: string

Definition at line 422 of file RandomImageGenerator.php.

Referenced by getImageSpec().

◆ getRandomFilenames()

RandomImageGenerator::getRandomFilenames	(	$number,
		$extension = 'jpg',
		$dir = null )

private

Return a number of randomly-generated filenames Each filename uses two words randomly drawn from the dictionary, like elephantine_spatula.jpg.

Parameters

int	$number	Number of filenames to generate
string	$extension	Optional, defaults to 'jpg'
string	$dir	Optional, defaults to current working directory

Returns: array Array of filenames

Definition at line 158 of file RandomImageGenerator.php.

References getRandomWordPairs().

Referenced by writeImages().

◆ getRandomLines()

RandomImageGenerator::getRandomLines ( $number_desired )

private

Return N random lines from a file.

Will throw exception if the file could not be read or if it had fewer lines than requested.

Parameters

int $number_desired Number of lines desired

Exceptions

Exception

Returns: array Array of exactly n elements, drawn randomly from lines the file

Definition at line 460 of file RandomImageGenerator.php.

References $dictionaryFile, $line, and $lines.

Referenced by getRandomWordPairs().

◆ getRandomWordPairs()

RandomImageGenerator::getRandomWordPairs ( $number )

private

Get an array of random pairs of random words, like [ [ 'foo', 'bar' ], [ 'quux', 'baz' ] ];.

Parameters

int $number Number of pairs

Returns: array Two-element arrays

Definition at line 438 of file RandomImageGenerator.php.

References $lines, and getRandomLines().

Referenced by getRandomFilenames().

◆ matrixMultiply2x2()

static RandomImageGenerator::matrixMultiply2x2	(	$matrix,
		$x,
		$y )

staticprivate

Given a matrix and a pair of images, return new position.

Parameters

array	$matrix	2x2 rotation matrix
int	$x	The x-coordinate number
int	$y	The y-coordinate number

Returns: array Transformed with properties x, y

Definition at line 373 of file RandomImageGenerator.php.

Referenced by rotateImageSpec().

◆ rotateImageSpec()

static RandomImageGenerator::rotateImageSpec	(	&	$spec,
			$matrix )

staticprivate

Given an image specification, produce rotated version This is used when simulating a rotated image capture with Exif orientation.

Parameters

array	$spec	Returned by getImageSpec
array	$matrix	2x2 transformation matrix

Returns: array Transformed Spec

Definition at line 334 of file RandomImageGenerator.php.

References matrixMultiply2x2().

Referenced by writeImageWithApi().

◆ shapePointsToString()

static RandomImageGenerator::shapePointsToString ( $shape )

static

Given [ [ 'x' => 10, 'y' => 20 ], [ 'x' => 30, y=> 5 ] ] returns "10,20 30,5" Useful for SVG and imagemagick command line arguments.

Parameters

array $shape Array of arrays, each array containing x & y keys mapped to numeric values

Returns: string

Definition at line 227 of file RandomImageGenerator.php.

References $points.

Referenced by writeImageWithCommandLine().

◆ writeImages()

RandomImageGenerator::writeImages	(	$number,
		$format = 'jpg',
		$dir = null )

Writes random images with random filenames to disk in the directory you specify, or current working directory.

Parameters

int	$number	Number of filenames to write
string	$format	Optional, must be understood by ImageMagick, such as 'jpg' or 'gif'
string	$dir	Directory, optional (will default to current working directory)

Returns: array Filenames we just wrote

Definition at line 111 of file RandomImageGenerator.php.

References getImageSpec(), getImageWriteMethod(), and getRandomFilenames().

◆ writeImageWithApi()

RandomImageGenerator::writeImageWithApi	(	$spec,
		$format,
		$filename )

Based on an image specification, write such an image to disk, using Imagick PHP extension.

Parameters

array	$spec	Spec describing background and circles to draw
string	$format	File format to write
string	$filename	Filename to write to

Definition at line 275 of file RandomImageGenerator.php.

References $image, $retval, $wgExiv2Command, print, rotateImageSpec(), wfEscapeShellArg(), and wfShellExec().

◆ writeImageWithCommandLine()

RandomImageGenerator::writeImageWithCommandLine	(	$spec,
		$format,
		$filename )

Based on an image specification, write such an image to disk, using the command line ImageMagick program ('convert').

Sample command line: $ convert -size 100x60 xc:rgb(90,87,45) \ -draw 'fill rgb(12,34,56) polygon 41,39 44,57 50,57 41,39' \ -draw 'fill rgb(99,123,231) circle 59,39 56,57' \ -draw 'fill rgb(240,12,32) circle 50,21 50,3' filename.png

Parameters

array	$spec	Spec describing background and shapes to draw
string	$format	File format to write (unused by this method but kept so it has the same signature as writeImageWithApi).
string	$filename	Filename to write to

Returns: bool

Definition at line 397 of file RandomImageGenerator.php.

References $args, $command, $retval, $wgImageMagickConvertCommand, shapePointsToString(), wfEscapeShellArg(), and wfShellExec().

◆ writeSvg()

RandomImageGenerator::writeSvg	(	$spec,
		$format,
		$filename )

Based on image specification, write a very simple SVG file to disk.

Ignores the background spec because transparency is cool. :)

Parameters

array	$spec	Spec describing background and shapes to draw
string	$format	File format to write (which is obviously always svg here)
string	$filename	Filename to write to

Exceptions

Exception

Definition at line 246 of file RandomImageGenerator.php.

Member Data Documentation

◆ $dictionaryFile

RandomImageGenerator::$dictionaryFile

private

Definition at line 31 of file RandomImageGenerator.php.

Referenced by __construct(), and getRandomLines().

◆ $maxHeight

RandomImageGenerator::$maxHeight = 800

private

Definition at line 35 of file RandomImageGenerator.php.

◆ $maxWidth

RandomImageGenerator::$maxWidth = 800

private

Definition at line 33 of file RandomImageGenerator.php.

◆ $minHeight

RandomImageGenerator::$minHeight = 400

private

Definition at line 34 of file RandomImageGenerator.php.

◆ $minWidth

RandomImageGenerator::$minWidth = 400

private

Definition at line 32 of file RandomImageGenerator.php.

◆ $orientations

RandomImageGenerator::$orientations

staticprivate

Initial value:

= [
        [
            '0thRow' => 'top',
            '0thCol' => 'left',
            'exifCode' => 1,
            'counterRotation' => [ [ 1, 0 ], [ 0, 1 ] ]
        ],
        [
            '0thRow' => 'bottom',
            '0thCol' => 'right',
            'exifCode' => 3,
            'counterRotation' => [ [ -1, 0 ], [ 0, -1 ] ]
        ],
        [
            '0thRow' => 'right',
            '0thCol' => 'top',
            'exifCode' => 6,
            'counterRotation' => [ [ 0, 1 ], [ 1, 0 ] ]
        ],
        [
            '0thRow' => 'left',
            '0thCol' => 'bottom',
            'exifCode' => 8,
            'counterRotation' => [ [ 0, -1 ], [ -1, 0 ] ]
        ]
    ]

Orientations: 0th row, 0th column, Exif orientation code, rotation 2x2 matrix that is opposite of orientation.

N.b. we do not handle the 'flipped' orientations, which is why there is no entry for 2, 4, 5, or 7. Those seem to be rare in real images anyway (we also would need a non-symmetric shape for the images to test those, like a letter F).

Definition at line 45 of file RandomImageGenerator.php.

◆ $shapesToDraw

RandomImageGenerator::$shapesToDraw = 5

private

Definition at line 36 of file RandomImageGenerator.php.

Referenced by getImageSpec().

The documentation for this class was generated from the following file:

tests/phpunit/includes/api/RandomImageGenerator.php

Public Member Functions

Static Public Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ getImageSpec()

◆ getImageWriteMethod()

◆ getRandomColor()

◆ getRandomFilenames()

◆ getRandomLines()

◆ getRandomWordPairs()

◆ matrixMultiply2x2()

◆ rotateImageSpec()

◆ shapePointsToString()

◆ writeImages()

◆ writeImageWithApi()

◆ writeImageWithCommandLine()

◆ writeSvg()

Member Data Documentation

◆ $dictionaryFile

◆ $maxHeight

◆ $maxWidth

◆ $minHeight

◆ $minWidth

◆ $orientations

◆ $shapesToDraw