GImage Class Reference

Classe per il trattamento di immagini. More...

Public Member Functions
	__construct ($abspath)
	Costruttore. More...
	getPath ()
	Ritorna il percorso relativo dell'immagine (da usare come attributo src del tag img) More...
	getWidth ()
	Ritorna la larghezza dell'immagine. More...
	getHeight ()
	Ritorna l'altezza dell'immagine. More...
	getResource ()
	Ritorna la resource dell'immagine. More...
	save ($abspath=null, $compression=75, $permissions=null)
	Salva l'immagine su filesystem. More...
	stream ($compression=75)
	Output dell'immagine. More...
	resize ($width, $height, $options)
	crop ($width, $height, $xo, $y0, $options=array())
	Crop dell'immagine con larghezza, altezza e punto iniziali dati. More...
	cropCenter ($width, $height, $options=array())
	Crop centrale dell'immagine con larghezza e altezza dati. More...
	cropEntropy ($width, $height, $options=array())
	Crop dell'immagine con larghezza e altezza dati nella zona a massima entropia. More...
	thumb ($width, $height, $options=array())
	Genera una thumb delle dimensioni Le thumb sono generate al volo e tenute in cache su db. More...
	resizeImage ($image, $width, $height, $options=array())
	Resize dell'immagine alle dimensioni fornite. More...

Data Fields
	$_dir = GIMAGE_DIR
	$_abspath
	$_image
	$_width
	$_height
	$_image_type
	$_tmp_image

Private Member Functions
	toKey ($abspath, $width, $height, $options)
	Genera una key univoca per un'operazione eseguita su un'immagine. More...
	getThumbFromKey ($key)
	Recupera il path dell'immagine se già stata sottoposta alla stessa operazione (cache) More...
	makeThumb ($key, $width, $height, $options)
	Genera una thumb delle dimensioni fornite Se viene fornita solo una dimensione oppure entrambe le dimensioni fornite rispecchiano il ratio dell'immagine originale viene effettuato un resize. More...
	saveTmpImage ($key, $compression=75)
	Salva l'immagine temporanea su filesystem e su db. More...
	cropImageEntropy ($image, $width, $height, $options)
	Crop dell'immagine nella parte con maggiore entropia. More...
	blackThresholdImage ($image, $rt, $gt, $bt)
	Converte ogni px con rgb maggiore di una soglia a nero. More...
	cloneImage ($image)
	Clona una risorsa immagine. More...
	slice ($image, $target_size, $axis)
	slice More...
	cropImage ($image, $width, $height, $x0, $y0, $options=array())
	Brief Ritorna il crop di un'immagine. More...
	grayscaleEntropy ($image)
	Calcola l'entropia di un'immagine. More...
	getImageHistogram ($image)
	Ricava una array di frequenze di tonalità di grigio dell'immagine. More...
	getEntropy ($histogram, $area)
	Calcola l'entropia dato l'istogramma di frequenze di colori. More...

Private Attributes
	$_table = 'sys_gimage'

Detailed Description

Classe per il trattamento di immagini.

Copyright

2014 Otto srl (http://www.opensource.org/licenses/mit-license.php) The MIT License

Author

marco guidotti guido.nosp@m.ttim.nosp@m.@gmai.nosp@m.l.co.nosp@m.m

abidibo abidi.nosp@m.bo@g.nosp@m.mail..nosp@m.com

Constructor & Destructor Documentation

__construct

(

$abspath

)

Costruttore.

Parameters

string

$abspath

percorso assoluto del file

Returns

istanza di Gino.GImage

Member Function Documentation

blackThresholdImage (   $image,   $rt,   $gt,   $bt  )

private

Converte ogni px con rgb maggiore di una soglia a nero.

Parameters

resource	$image	image resource
int	$rt	red threshold
int	$gt	green threshold
int	$bt	blue threshold

Returns

void

cloneImage (   $image )

private

Clona una risorsa immagine.

Parameters

resopurce

$image

risorsa

Returns

resource clone

crop	(		$width,
			$height,
			$xo,
			$y0,
			$options = array()
	)

Crop dell'immagine con larghezza, altezza e punto iniziali dati.

Parameters

int	$width	Larghezza crop
int	$height	Altezza crop
int	$xo	Coordinata x punto top left di taglio
int	$yo	Coordinata y punto top left di taglio
array	$options	Opzioni.

Returns

void

cropCenter	(		$width,
			$height,
			$options = array()
	)

Crop centrale dell'immagine con larghezza e altezza dati.

Parameters

int	$width	Larghezza crop
int	$height	Altezza crop
array	$options	Opzioni.

Returns

void

cropEntropy	(		$width,
			$height,
			$options = array()
	)

Crop dell'immagine con larghezza e altezza dati nella zona a massima entropia.

Parameters

int	$width	Larghezza crop
int	$height	Altezza crop
array	$options	Opzioni.

Returns

void

cropImage (   $image,   $width,   $height,   $x0,   $y0,   $options = array()  )

private

Brief Ritorna il crop di un'immagine.

Parameters

resource	$image	Immagine da croppare
int	$width	larghezza immagine croppata
int	$height	altezza immagine croppata
int	$x0	coordinata x dalla quale partire a tagliare
int	$y0	coordinata y dalla quale partire a tagliare
array	$options	Opzioni.

Returns

resource immagine croppata

cropImageEntropy (   $image,   $width,   $height,   $options  )

private

Crop dell'immagine nella parte con maggiore entropia.

Parameters

resource	$image	resource immagine
int	$width	larghezza crop
int	$height	altezza crop
array	$options	Opzioni.

Returns

resource immagine

getEntropy (   $histogram,   $area  )

private

Calcola l'entropia dato l'istogramma di frequenze di colori.

Parameters

array	$histogram	istogramma di frequenze di colori
int	$area	area dell'immagine

Returns

float entropia

getHeight

(

)

Ritorna l'altezza dell'immagine.

Returns

altezza immagine in px

getImageHistogram (   $image )

private

Ricava una array di frequenze di tonalità di grigio dell'immagine.

Parameters

resource

$image

resource dell'immagine

Returns

array istogramma

getPath

(

)

Ritorna il percorso relativo dell'immagine (da usare come attributo src del tag img)

See also

Gino.relativePath

Returns

path relativo immagine

getResource

(

)

Ritorna la resource dell'immagine.

Returns

resource immagine

getThumbFromKey (   $key )

private

Recupera il path dell'immagine se già stata sottoposta alla stessa operazione (cache)

Parameters

string

$key

chiave univoca dell'operazione

Returns

Gino.GImage|FALSE oggetto GImage dell'immagine in cache o false

getWidth

(

)

Ritorna la larghezza dell'immagine.

Returns

larghezza immagine in px

grayscaleEntropy (   $image )

private

Calcola l'entropia di un'immagine.

Parameters

resource

$image

resource immagine

Returns

float entropia

makeThumb (   $key,   $width,   $height,   $options  )

private

Genera una thumb delle dimensioni fornite Se viene fornita solo una dimensione oppure entrambe le dimensioni fornite rispecchiano il ratio dell'immagine originale viene effettuato un resize.

Altrimenti viene effettuato un resize prima ed un crop dopo, cercando di tagliare la parte di immagine con maggiore entropia.

Parameters

string	$key	Chiave univoca che identifica la thumb da generare
int | null	$width	Larghezza della thumb
int | null	$height	Altezza della thumb
array	$options	Opzioni. Array associativo di opzioni: 'allow_enlarge': default false. Consente l'allargamento di immagini per soddisfare le dimensioni richieste.

Returns

Gino.GImage nuovo oggetto GImage della thumb generata

resize	(		$width,
			$height,
			$options
	)

resizeImage	(		$image,
			$width,
			$height,
			$options = array()
	)

Resize dell'immagine alle dimensioni fornite.

Parameters

resource	$image	resource dell'immagine
int	$width	Larghezza della thumb
int	$height	Altezza della thumb
array	$options	Opzioni.

Returns

resource immagine ridimensionata

save	(		$abspath = null,
			$compression = 75,
			$permissions = null
	)

Salva l'immagine su filesystem.

Parameters

string	$abspath	percorso (default il percorso originale dell'immagine)
int	$compression	compressione, default 75
string	$permission	permessi

Returns

void

saveTmpImage (   $key,   $compression = 75  )

private

Salva l'immagine temporanea su filesystem e su db.

Returns

Gino.GImage oggetto GImage della nuova immagine salvata

slice (   $image,   $target_size,   $axis  )

private

slice

Parameters

resource	$image
int	$target_size	dimensione finale
string	$axis	asse h=orizzontale, v=verticale

Returns

coordinata dalla quale tagliare

stream

(

$compression = 75

)

Output dell'immagine.

ob_start();
$image->stream();
$i = ob_get_clean();
echo "<img src='data:image/jpeg;base64," . base64_encode( $i )."'>";

Parameters

int

$compression

compressione, default 75

Returns

stream immagine

thumb	(		$width,
			$height,
			$options = array()
	)

Genera una thumb delle dimensioni Le thumb sono generate al volo e tenute in cache su db.

Se viene richiesta una thumb già creata viene direttamente restituita. Altrimenti viene creata.

Parameters

int | null	$width	Larghezza della thumb
int | null	$height	Altezza della thumb
array	$options	Opzioni. Array associativo di opzioni: 'allow_enlarge': default false. Consente l'allargamento di immagini per soddisfare le dimensioni richieste.

Returns

Gino.GImage nuovo oggetto immagine wrapper della thumb generata

toKey (   $abspath,   $width,   $height,   $options  )

private

Genera una key univoca per un'operazione eseguita su un'immagine.

Parameters

string	$abspath	percorso assoluto dell'immagine
int	$width	Larghezza dell'immagine dopo l'operazione
int	$height	Altezza dell'immagine dopo l'operazione array $options Opzioni

Returns

chiave univoca

Field Documentation

$_abspath

$_dir = GIMAGE_DIR

$_height

$_image

$_image_type

$_table = 'sys_gimage'

private

$_tmp_image

$_width

---

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

• lib/classes/class.GImage.php