Pix¶

Images resources.

• Table of contents
• Pix
  • _gtkPixNew
  • _gtkPixFree
  • _gtkPixScale
  • _gtkPixScaleEx
  • _gtkPixRotate
  • _gtkPixFlip
  • _gtkPixAddAlpha
  • _gtkPixCopyArea
  • _gtkPixSaturation

_gtkPixNew¶

create a new pix object

Prototype : fun [Chn P I [I I I]] ObjGtkPix

channel	Chn	a channel
filename	P	an image filename
mode	I	Mode. Should be at 0.
tuple	[I I I]	the width (or nil to not constraint it),
		the height (or nil to not constraint it),
		the ratio (1 to keep it)

Return : ObjGtkPix : a new pix object or nil if an error occurs

_gtkPixFree¶

Destroys a pix object

Prototype : fun [ObjGtkPix] I

Return : I : always 0 except if error, it returns nil

_gtkPixScale¶

Scale

Prototype : fun [ObjGtkPix I I I I] ObjGtkPix

pix	ObjGtkPix	a valid pix object
width	I	the new width
height	I	the new height
mode	I	an algorithm at your choice :	SCOL_GTK_PIX_INTERP_BILINEAR (default) :
			SCOL_GTK_PIX_INTERP_NEAREST :
			SCOL_GTK_PIX_INTERP_TILES :
			SCOL_GTK_PIX_INTERP_HYPER :
flag	I	if 1, the pix in the pix object pix will be destroyed.	If 0, the pix object pix will be kept and a new pix object will be created.

Return : ObjGtkPix : a new pix object or nil if an error occurs.

_gtkPixScaleEx¶

Not implemented yet.

Return : always nil.

_gtkPixRotate¶

Performs a rotation

Prototype : fun [ObjGtkPix I I] ObjGtkPix

pix	ObjGtkPix	a pix object
angle	I	0, 90, 180 or 270 degrees. Others values are ignored
flag	I	0 if the new pix Scol object is created with the rotated pix
		1 if the new pix replaces the pix in the curent pix object pix

Return : ObjGtkPix : a rotated pix in the (new or same) pix object or the same pix object if the value is bad or nil if an error occurs

_gtkPixFlip¶

Performs a flip to a pix object

Prototype : fun [ObjGtkPix I I] ObjGtkPix

pix	ObjGtkPix	a pix object
flip	I	SCOL_GTK_PIX_FLIP_HORIZONTAL or SCOL_GTK_PIX_FLIP_VERTICAL. Other value are ignored.
flag	I	0 if the new pix Scol object is created with the flipped pix
		1 if the new pix replaces the pix in the curent pix object pix

Return : ObjGtkPix : a flipped pix in the (new or same) pix object or the same pix object if the value is bad or nil if an error occurs

_gtkPixAddAlpha¶

Adds an alpha channel to an existing pix object.
If the tuple is not nil, then the color specified by it will be assigned zero opacity.
For example, if the tuple is equals at [255, 255, 255], all white pixels will become fully transparent.

Prototype : fun [ObjGtkPix [I I I] I] ObjGtkPix

pix	ObjGtkPix	a pix object
rgb	[I I I]	red, green and blue value (0->255). or nil (see above)
flag	I	0 if the new pix Scol object is created with the new pix
		1 if the new pix replaces the pix in the curent pix object pix

Return : ObjGtkPix : a new pix in the (new or same) pix object or the same pix object if the value is bad or nil if an error occurs

_gtkPixCopyArea¶

Copies a rectangular area from srcpix to destpix.

Prototype : fun [ObjGtkPix I I I I ObjGtkPix I I] ObjGtkPix

srcpix	ObjGtkPix	a source pix object
srcx	I	x coordinate in srcpix
srcy	I	y coordinate in srcpix
srcwidth	I	width to copy from srcpix
srcheight	I	height to copy from srcpix
destpix	ObjGtkPix	a destination pix object. If nil, a new pix object will be created in the current channel
destx	I	x coordinate in destpix
desty	I	y coordinate in destpix

Return : ObjGtkPix : the destination pix object or nil if error

_gtkPixSaturation¶

Modifies the saturation to a pix object

Prototype : fun [ObjPixGtk I] ObjGtkPix

Value (I) : Between - 100 and 0, saturation is reduced (-> greyscale), between 0 and 100, the saturation is increased (vivid colors). With 1.0, the saturation is unchanged.

Return : ObjGtkPix : the same pix object or nil if an error is occured.

Return Api