*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> OpenGL/glconvolutionparameterext (3)              
Title
Content
Arch
Section
 

Contents


glConvolutionParameterEXT(3G)  OpenGL Reference	 glConvolutionParameterEXT(3G)


NAME    [Toc]    [Back]

     glConvolutionParameterfEXT, glConvolutionParameteriEXT,
     glConvolutionParameterfvEXT, glConvolutionParameterivEXT -	set
     convolution parameters

C SPECIFICATION    [Toc]    [Back]

     void glConvolutionParameterfEXT( GLenum target,
				      GLenum pname,
				      GLfloat params )
     void glConvolutionParameteriEXT( GLenum target,
				      GLenum pname,
				      GLint params )



PARAMETERS    [Toc]    [Back]

     target  The target	for the	convolution parameter.	Must be	one of
	     GL_CONVOLUTION_1D_EXT, GL_CONVOLUTION_2D_EXT, or
	     GL_SEPARABLE_2D_EXT.

     pname   The parameter to be set.  Must be GL_CONVOLUTION_BORDER_MODE_EXT.

     params  The parameter value.  Must	be GL_REDUCE_EXT.


C SPECIFICATION    [Toc]    [Back]

     void glConvolutionParameterfvEXT( GLenum target,
				       GLenum pname,
				       const GLfloat *params )
     void glConvolutionParameterivEXT( GLenum target,
				       GLenum pname,
				       const GLint *params )



PARAMETERS    [Toc]    [Back]

     target
	  The target for the convolution parameter.  Must be one of
	  GL_CONVOLUTION_1D_EXT, GL_CONVOLUTION_2D_EXT,	or
	  GL_SEPARABLE_2D_EXT.

     pname
	  The parameter	to be set.  Must be one	of
	  GL_CONVOLUTION_BORDER_MODE_EXT, GL_CONVOLUTION_FILTER_SCALE_EXT, or
	  GL_CONVOLUTION_FILTER_BIAS_EXT.

     params
	  The parameter	value.	Must be	GL_REDUCE_EXT if pname is
	  GL_CONVOLUTION_BORDER_MODE_EXT.  Otherwise, must be a	vector of four
	  values (for red, green, blue,	and alpha, respectively) to be used
	  for scaling (when pname is GL_CONVOLUTION_FILTER_SCALE_EXT) or for
	  biasing (when	pname is GL_CONVOLUTION_FILTER_BIAS_EXT) a convolution
	  filter kernel.




									Page 1






glConvolutionParameterEXT(3G)  OpenGL Reference	 glConvolutionParameterEXT(3G)


DESCRIPTION    [Toc]    [Back]

     glConvolutionParameterEXT sets the	value of a convolution parameter.

     target selects the	convolution filter to be affected:
     GL_CONVOLUTION_1D_EXT, GL_CONVOLUTION_2D_EXT, or GL_SEPARABLE_2D_EXT for
     the 1D, 2D, or separable 2D filter, respectively.

     pname selects the parameter to be changed.
     GL_CONVOLUTION_FILTER_SCALE_EXT and GL_CONVOLUTION_FILTER_BIAS_EXT	affect
     the definition of the convolution filter kernel; see
     glConvolutionFilter1DEXT, glConvolutionFilter2DEXT, and
     glSeparableFilter2DEXT for	details.  In these cases, params is an array
     of	four values to be applied to red, green, blue, and alpha values
     respectively.

     A pname value of GL_CONVOLUTION_BORDER_MODE_EXT controls the convolution
     border mode.  Currently the only acceptable parameter value is
     GL_REDUCE_EXT.  When this mode is in effect, the image resulting from
     convolution is smaller than the source image.  If the filter width	is Wf
     and height	is Hf, and the source image width is Ws	and height is Hs, then
     the convolved image width will be Ws-Wf+1 and height will be Hs-Hf+1.
     (If this reduction	would generate an image	with zero or negative width
     and/or height, the	output is simply null, with no error generated.)  The
     coordinates of the	image resulting	from convolution are zero through Ws-
     Wf	in width and zero through Hs-Hf	in height.

NOTES    [Toc]    [Back]

     In	cases where errors can result from the specification of	invalid	image
     dimensions, it is the dimensions after convolution	that are tested, not
     the dimensions of the source image.  For example, glTexImage1D requires
     power-of-two image	size.  When REDUCE_EXT border mode is in effect
     (currently	this is	always true), the source image must be larger than the
     final power-of-two	size by	one less than the size of the 1D filter
     kernel.

ERRORS    [Toc]    [Back]

     GL_INVALID_ENUM is	generated if target is not one of the allowable
     values.

     GL_INVALID_ENUM is	generated if pname is not one of the allowable values.

     GL_INVALID_ENUM is	generated if pname is GL_CONVOLUTION_BORDER_MODE_EXT
     and params	is not GL_REDUCE_EXT.

     GL_INVALID_OPERATION is generated if glConvolutionParameterEXT is
     executed between the execution of glBegin and the corresponding execution
     of	glEnd.

ASSOCIATED GETS    [Toc]    [Back]

     glGetConvolutionParameterEXT





									Page 2






glConvolutionParameterEXT(3G)  OpenGL Reference	 glConvolutionParameterEXT(3G)


SEE ALSO    [Toc]    [Back]

      
      
     glConvolutionFilter1DEXT, glConvolutionFilter2DEXT,
     glSeparableFilter2DEXT, glGetConvolutionParameterEXT.


									PPPPaaaaggggeeee 3333
[ Back ]
 Similar pages
Name OS Title
glgetconvolutionparameterext IRIX get convolution parameters
glgetconvolutionparameter IRIX get convolution parameters
conv IRIX Convolution and Correlation Library
glconvolutionfilter2d IRIX define a two-dimensional convolution filter
glgetconvolutionfilterext IRIX get current 1D or 2D convolution filter kernel
glconvolutionfilter1d IRIX define a one-dimensional convolution filter
glgetconvolutionfilter IRIX get current 1D or 2D convolution filter kernel
glconvolutionfilter1dext IRIX define a one-dimensional convolution filter
glconvolutionfilter2dext IRIX define a two-dimensional convolution filter
glcopyconvolutionfilter2d IRIX copy pixels into a two-dimensional convolution filter
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service