SDL2_gfx 1.0.1 GraphicsprimitivesandsurfacefunctionsforSDL2

- Main Page
- Data Structures
- Files

- File List
- Globals

Defines | Functions
I:/Sources/sdl2gfx/SDL2_imageFilter.c File Reference
`#include <stdio.h>`
`#include <stdlib.h>`
`#include <string.h>`
`#include "SDL.h"`
`#include "SDL2_imageFilter.h"`

Go to the source code of this file.

## Defines
#define | SWAP_32(x) (((x) >> 24) | (((x) & 0x00ff0000) >> 8) | (((x) & 0x0000ff00) << 8) | ((x) << 24))
| Swaps the byte order in a 32bit integer (LSB becomes MSB, etc.).
## Functions
int | SDL_imageFilterMMXdetect (void)
| MMX detection routine (with override flag).
void | SDL_imageFilterMMXoff ()
| Disable MMX check for filter functions and and force to use non-MMX C based code.
void | SDL_imageFilterMMXon ()
| Enable MMX check for filter functions and use MMX code if available.
int | SDL_imageFilterAdd (unsigned char *Src1, unsigned char *Src2, unsigned char *Dest, unsigned int length)
| Filter using Add: D = saturation255(S1 + S2)
int | SDL_imageFilterMean (unsigned char *Src1, unsigned char *Src2, unsigned char *Dest, unsigned int length)
| Filter using Mean: D = S1/2 + S2/2.
int | SDL_imageFilterSub (unsigned char *Src1, unsigned char *Src2, unsigned char *Dest, unsigned int length)
| Filter using Sub: D = saturation0(S1 - S2)
int | SDL_imageFilterAbsDiff (unsigned char *Src1, unsigned char *Src2, unsigned char *Dest, unsigned int length)
| Filter using AbsDiff: D = | S1 - S2 |.
int | SDL_imageFilterMult (unsigned char *Src1, unsigned char *Src2, unsigned char *Dest, unsigned int length)
| Filter using Mult: D = saturation255(S1 * S2)
int | SDL_imageFilterMultNorASM (unsigned char *Src1, unsigned char *Src2, unsigned char *Dest, unsigned int SrcLength)
| Internal ASM Filter using MultNor: D = S1 * S2.
int | SDL_imageFilterMultNor (unsigned char *Src1, unsigned char *Src2, unsigned char *Dest, unsigned int length)
| Filter using MultNor: D = S1 * S2.
int | SDL_imageFilterMultDivby2 (unsigned char *Src1, unsigned char *Src2, unsigned char *Dest, unsigned int length)
| Filter using MultDivby2: D = saturation255(S1/2 * S2)
int | SDL_imageFilterMultDivby4 (unsigned char *Src1, unsigned char *Src2, unsigned char *Dest, unsigned int length)
| Filter using MultDivby4: D = saturation255(S1/2 * S2/2)
int | SDL_imageFilterBitAnd (unsigned char *Src1, unsigned char *Src2, unsigned char *Dest, unsigned int length)
| Filter using BitAnd: D = S1 & S2.
int | SDL_imageFilterBitOr (unsigned char *Src1, unsigned char *Src2, unsigned char *Dest, unsigned int length)
| Filter using BitOr: D = S1 | S2.
int | SDL_imageFilterDiv (unsigned char *Src1, unsigned char *Src2, unsigned char *Dest, unsigned int length)
| Filter using Div: D = S1 / S2.
int | SDL_imageFilterBitNegation (unsigned char *Src1, unsigned char *Dest, unsigned int length)
| Filter using BitNegation: D = !S.
int | SDL_imageFilterAddByte (unsigned char *Src1, unsigned char *Dest, unsigned int length, unsigned char C)
| Filter using AddByte: D = saturation255(S + C)
int | SDL_imageFilterAddUint (unsigned char *Src1, unsigned char *Dest, unsigned int length, unsigned int C)
| Filter using AddUint: D = saturation255((S[i] + Cs[i % 4]), Cs=Swap32((uint)C)
int | SDL_imageFilterAddByteToHalf (unsigned char *Src1, unsigned char *Dest, unsigned int length, unsigned char C)
| Filter using AddByteToHalf: D = saturation255(S/2 + C)
int | SDL_imageFilterSubByteMMX (unsigned char *Src1, unsigned char *Dest, unsigned int SrcLength, unsigned char C)
| Internal MMX Filter using SubByte: D = saturation0(S - C)
int | SDL_imageFilterSubByte (unsigned char *Src1, unsigned char *Dest, unsigned int length, unsigned char C)
| Filter using SubByte: D = saturation0(S - C)
int | SDL_imageFilterSubUint (unsigned char *Src1, unsigned char *Dest, unsigned int length, unsigned int C)
| Filter using SubUint: D = saturation0(S[i] - Cs[i % 4]), Cs=Swap32((uint)C)
int | SDL_imageFilterShiftRight (unsigned char *Src1, unsigned char *Dest, unsigned int length, unsigned char N)
| Filter using ShiftRight: D = saturation0(S >> N)
int | SDL_imageFilterShiftRightUint (unsigned char *Src1, unsigned char *Dest, unsigned int length, unsigned char N)
| Filter using ShiftRightUint: D = saturation0((uint)S[i] >> N)
int | SDL_imageFilterMultByByte (unsigned char *Src1, unsigned char *Dest, unsigned int length, unsigned char C)
| Filter using MultByByte: D = saturation255(S * C)
int | SDL_imageFilterShiftRightAndMultByByte (unsigned char *Src1, unsigned char *Dest, unsigned int length, unsigned char N, unsigned char C)
| Filter using ShiftRightAndMultByByte: D = saturation255((S >> N) * C)
int | SDL_imageFilterShiftLeftByte (unsigned char *Src1, unsigned char *Dest, unsigned int length, unsigned char N)
| Filter using ShiftLeftByte: D = (S << N)
int | SDL_imageFilterShiftLeftUint (unsigned char *Src1, unsigned char *Dest, unsigned int length, unsigned char N)
| Filter using ShiftLeftUint: D = ((uint)S << N)
int | SDL_imageFilterShiftLeft (unsigned char *Src1, unsigned char *Dest, unsigned int length, unsigned char N)
| Filter ShiftLeft: D = saturation255(S << N)
int | SDL_imageFilterBinarizeUsingThreshold (unsigned char *Src1, unsigned char *Dest, unsigned int length, unsigned char T)
| Filter using BinarizeUsingThreshold: D = (S >= T) ? 255:0.
int | SDL_imageFilterClipToRange (unsigned char *Src1, unsigned char *Dest, unsigned int length, unsigned char Tmin, unsigned char Tmax)
| Filter using ClipToRange: D = (S >= Tmin) & (S <= Tmax) S:Tmin | Tmax.
int | SDL_imageFilterNormalizeLinear (unsigned char *Src, unsigned char *Dest, unsigned int length, int Cmin, int Cmax, int Nmin, int Nmax)
| Filter using NormalizeLinear: D = saturation255((Nmax - Nmin)/(Cmax - Cmin)*(S - Cmin) + Nmin)
int | SDL_imageFilterConvolveKernel3x3Divide (unsigned char *Src, unsigned char *Dest, int rows, int columns, signed short *Kernel, unsigned char Divisor)
| Filter using ConvolveKernel3x3Divide: Dij = saturation0and255( ... )
int | SDL_imageFilterConvolveKernel5x5Divide (unsigned char *Src, unsigned char *Dest, int rows, int columns, signed short *Kernel, unsigned char Divisor)
| Filter using ConvolveKernel5x5Divide: Dij = saturation0and255( ... )
int | SDL_imageFilterConvolveKernel7x7Divide (unsigned char *Src, unsigned char *Dest, int rows, int columns, signed short *Kernel, unsigned char Divisor)
| Filter using ConvolveKernel7x7Divide: Dij = saturation0and255( ... )
int | SDL_imageFilterConvolveKernel9x9Divide (unsigned char *Src, unsigned char *Dest, int rows, int columns, signed short *Kernel, unsigned char Divisor)
| Filter using ConvolveKernel9x9Divide: Dij = saturation0and255( ... )
int | SDL_imageFilterConvolveKernel3x3ShiftRight (unsigned char *Src, unsigned char *Dest, int rows, int columns, signed short *Kernel, unsigned char NRightShift)
| Filter using ConvolveKernel3x3ShiftRight: Dij = saturation0and255( ... )
int | SDL_imageFilterConvolveKernel5x5ShiftRight (unsigned char *Src, unsigned char *Dest, int rows, int columns, signed short *Kernel, unsigned char NRightShift)
| Filter using ConvolveKernel5x5ShiftRight: Dij = saturation0and255( ... )
int | SDL_imageFilterConvolveKernel7x7ShiftRight (unsigned char *Src, unsigned char *Dest, int rows, int columns, signed short *Kernel, unsigned char NRightShift)
| Filter using ConvolveKernel7x7ShiftRight: Dij = saturation0and255( ... )
int | SDL_imageFilterConvolveKernel9x9ShiftRight (unsigned char *Src, unsigned char *Dest, int rows, int columns, signed short *Kernel, unsigned char NRightShift)
| Filter using ConvolveKernel9x9ShiftRight: Dij = saturation255( ... )
int | SDL_imageFilterSobelX (unsigned char *Src, unsigned char *Dest, int rows, int columns)
| Filter using SobelX: Dij = saturation255( ... )
int | SDL_imageFilterSobelXShiftRight (unsigned char *Src, unsigned char *Dest, int rows, int columns, unsigned char NRightShift)
| Filter using SobelXShiftRight: Dij = saturation255( ... )
void | SDL_imageFilterAlignStack (void)
| Align stack to 32 byte boundary,.
void | SDL_imageFilterRestoreStack (void)
| Restore previously aligned stack.

## Define Documentation

#define SWAP_32 | ( |  | x | ) | (((x) >> 24) | (((x) & 0x00ff0000) >> 8) | (((x) & 0x0000ff00) << 8) | ((x) << 24))

Swaps the byte order in a 32bit integer (LSB becomes MSB, etc.).

Definition at line 61 of file SDL2_imageFilter.c.

## Function Documentation

int SDL_imageFilterAbsDiff | ( | unsigned char * | Src1,
|  | unsigned char * | Src2,
|  | unsigned char * | Dest,
|  | unsigned int | length
| ) |  |

Filter using AbsDiff: D = | S1 - S2 |.

Parameters:

  Src1 | Pointer to the start of the first source byte array (S1).
  Src2 | Pointer to the start of the second source byte array (S2).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source arrays.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 542 of file SDL2_imageFilter.c.

int SDL_imageFilterAdd | ( | unsigned char * | Src1,
|  | unsigned char * | Src2,
|  | unsigned char * | Dest,
|  | unsigned int | length
| ) |  |

Filter using Add: D = saturation255(S1 + S2)

Parameters:

  Src1 | Pointer to the start of the first source byte array (S1).
  Src2 | Pointer to the start of the second source byte array (S2).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source arrays.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 173 of file SDL2_imageFilter.c.

int SDL_imageFilterAddByte | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | unsigned char | C
| ) |  |

Filter using AddByte: D = saturation255(S + C)

Parameters:

  Src1 | Pointer to the start of the source byte array (S).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source array.
  C | Constant value to add (C).

Returns:
  Returns 0 for success or -1 for error.

Definition at line 1791 of file SDL2_imageFilter.c.

int SDL_imageFilterAddByteToHalf | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | unsigned char | C
| ) |  |

Filter using AddByteToHalf: D = saturation255(S/2 + C)

Parameters:

  Src1 | Pointer to the start of the source byte array (S).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source array.
  C | Constant to add (C).

Returns:
  Returns 0 for success or -1 for error.

Definition at line 2068 of file SDL2_imageFilter.c.

int SDL_imageFilterAddUint | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | unsigned int | C
| ) |  |

Filter using AddUint: D = saturation255((S[i] + Cs[i % 4]), Cs=Swap32((uint)C)

Parameters:

  Src1 | Pointer to the start of the source byte array (S).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source array.
  C | Constant to add (C).

Returns:
  Returns 0 for success or -1 for error.

Definition at line 1919 of file SDL2_imageFilter.c.

void SDL_imageFilterAlignStack | ( | void |  | ) |

Align stack to 32 byte boundary,.

Definition at line 7326 of file SDL2_imageFilter.c.

int SDL_imageFilterBinarizeUsingThreshold | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | unsigned char | T
| ) |  |

Filter using BinarizeUsingThreshold: D = (S >= T) ? 255:0.

Parameters:

  Src1 | Pointer to the start of the source byte array (S).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source array.
  T | The threshold boundary (inclusive).

Returns:
  Returns 0 for success or -1 for error.

Definition at line 3534 of file SDL2_imageFilter.c.

int SDL_imageFilterBitAnd | ( | unsigned char * | Src1,
|  | unsigned char * | Src2,
|  | unsigned char * | Dest,
|  | unsigned int | length
| ) |  |

Filter using BitAnd: D = S1 & S2.

Parameters:

  Src1 | Pointer to the start of the first source byte array (S1).
  Src2 | Pointer to the start of the second source byte array (S2).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source arrays.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 1278 of file SDL2_imageFilter.c.

int SDL_imageFilterBitNegation | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length
| ) |  |

Filter using BitNegation: D = !S.

Parameters:

  Src1 | Pointer to the start of the source byte array (S).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source array.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 1671 of file SDL2_imageFilter.c.

int SDL_imageFilterBitOr | ( | unsigned char * | Src1,
|  | unsigned char * | Src2,
|  | unsigned char * | Dest,
|  | unsigned int | length
| ) |  |

Filter using BitOr: D = S1 | S2.

Parameters:

  Src1 | Pointer to the start of the first source byte array (S1).
  Src2 | Pointer to the start of the second source byte array (S2).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source arrays.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 1392 of file SDL2_imageFilter.c.

int SDL_imageFilterClipToRange | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | unsigned char | Tmin,
|  | unsigned char | Tmax
| ) |  |

Filter using ClipToRange: D = (S >= Tmin) & (S <= Tmax) S:Tmin | Tmax.

Parameters:

  Src1 | Pointer to the start of the source byte array (S).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source array.
  Tmin | Lower (inclusive) boundary of the clipping range.
  Tmax | Upper (inclusive) boundary of the clipping range.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 3691 of file SDL2_imageFilter.c.

int SDL_imageFilterConvolveKernel3x3Divide | ( | unsigned char * | Src,
|  | unsigned char * | Dest,
|  | int | rows,
|  | int | columns,
|  | signed short * | Kernel,
|  | unsigned char | Divisor
| ) |  |

Filter using ConvolveKernel3x3Divide: Dij = saturation0and255( ... )

Parameters:

  Src | The source 2D byte array to convolve. Should be different from destination.
  Dest | The destination 2D byte array to store the result in. Should be different from source.
  rows | Number of rows in source/destination array. Must be >2.
  columns | Number of columns in source/destination array. Must be >2.
  Kernel | The 2D convolution kernel of size 3x3.
  Divisor | The divisor of the convolution sum. Must be >0.

Note: Non-MMX implementation not available for this function.

Returns:
  Returns 1 if filter was applied, 0 otherwise.

Definition at line 3980 of file SDL2_imageFilter.c.

int SDL_imageFilterConvolveKernel3x3ShiftRight | ( | unsigned char * | Src,
|  | unsigned char * | Dest,
|  | int | rows,
|  | int | columns,
|  | signed short * | Kernel,
|  | unsigned char | NRightShift
| ) |  |

Filter using ConvolveKernel3x3ShiftRight: Dij = saturation0and255( ... )

Parameters:

  Src | The source 2D byte array to convolve. Should be different from destination.
  Dest | The destination 2D byte array to store the result in. Should be different from source.
  rows | Number of rows in source/destination array. Must be >2.
  columns | Number of columns in source/destination array. Must be >2.
  Kernel | The 2D convolution kernel of size 3x3.
  NRightShift | The number of right bit shifts to apply to the convolution sum. Must be <7.

Note: Non-MMX implementation not available for this function.

Returns:
  Returns 1 if filter was applied, 0 otherwise.

Definition at line 5378 of file SDL2_imageFilter.c.

int SDL_imageFilterConvolveKernel5x5Divide | ( | unsigned char * | Src,
|  | unsigned char * | Dest,
|  | int | rows,
|  | int | columns,
|  | signed short * | Kernel,
|  | unsigned char | Divisor
| ) |  |

Filter using ConvolveKernel5x5Divide: Dij = saturation0and255( ... )

Parameters:

  Src | The source 2D byte array to convolve. Should be different from destination.
  Dest | The destination 2D byte array to store the result in. Should be different from source.
  rows | Number of rows in source/destination array. Must be >4.
  columns | Number of columns in source/destination array. Must be >4.
  Kernel | The 2D convolution kernel of size 5x5.
  Divisor | The divisor of the convolution sum. Must be >0.

Note: Non-MMX implementation not available for this function.

Returns:
  Returns 1 if filter was applied, 0 otherwise.

Definition at line 4170 of file SDL2_imageFilter.c.

int SDL_imageFilterConvolveKernel5x5ShiftRight | ( | unsigned char * | Src,
|  | unsigned char * | Dest,
|  | int | rows,
|  | int | columns,
|  | signed short * | Kernel,
|  | unsigned char | NRightShift
| ) |  |

Filter using ConvolveKernel5x5ShiftRight: Dij = saturation0and255( ... )

Parameters:

  Src | The source 2D byte array to convolve. Should be different from destination.
  Dest | The destination 2D byte array to store the result in. Should be different from source.
  rows | Number of rows in source/destination array. Must be >4.
  columns | Number of columns in source/destination array. Must be >4.
  Kernel | The 2D convolution kernel of size 5x5.
  NRightShift | The number of right bit shifts to apply to the convolution sum. Must be <7.

Note: Non-MMX implementation not available for this function.

Returns:
  Returns 1 if filter was applied, 0 otherwise.

Definition at line 5555 of file SDL2_imageFilter.c.

int SDL_imageFilterConvolveKernel7x7Divide | ( | unsigned char * | Src,
|  | unsigned char * | Dest,
|  | int | rows,
|  | int | columns,
|  | signed short * | Kernel,
|  | unsigned char | Divisor
| ) |  |

Filter using ConvolveKernel7x7Divide: Dij = saturation0and255( ... )

Parameters:

  Src | The source 2D byte array to convolve. Should be different from destination.
  Dest | The destination 2D byte array to store the result in. Should be different from source.
  rows | Number of rows in source/destination array. Must be >6.
  columns | Number of columns in source/destination array. Must be >6.
  Kernel | The 2D convolution kernel of size 7x7.
  Divisor | The divisor of the convolution sum. Must be >0.

Note: Non-MMX implementation not available for this function.

Returns:
  Returns 1 if filter was applied, 0 otherwise.

Definition at line 4473 of file SDL2_imageFilter.c.

int SDL_imageFilterConvolveKernel7x7ShiftRight | ( | unsigned char * | Src,
|  | unsigned char * | Dest,
|  | int | rows,
|  | int | columns,
|  | signed short * | Kernel,
|  | unsigned char | NRightShift
| ) |  |

Filter using ConvolveKernel7x7ShiftRight: Dij = saturation0and255( ... )

Parameters:

  Src | The source 2D byte array to convolve. Should be different from destination.
  Dest | The destination 2D byte array to store the result in. Should be different from source.
  rows | Number of rows in source/destination array. Must be >6.
  columns | Number of columns in source/destination array. Must be >6.
  Kernel | The 2D convolution kernel of size 7x7.
  NRightShift | The number of right bit shifts to apply to the convolution sum. Must be <7.

Note: Non-MMX implementation not available for this function.

Returns:
  Returns 1 if filter was applied, 0 otherwise.

Definition at line 5856 of file SDL2_imageFilter.c.

int SDL_imageFilterConvolveKernel9x9Divide | ( | unsigned char * | Src,
|  | unsigned char * | Dest,
|  | int | rows,
|  | int | columns,
|  | signed short * | Kernel,
|  | unsigned char | Divisor
| ) |  |

Filter using ConvolveKernel9x9Divide: Dij = saturation0and255( ... )

Parameters:

  Src | The source 2D byte array to convolve. Should be different from destination.
  Dest | The destination 2D byte array to store the result in. Should be different from source.
  rows | Number of rows in source/destination array. Must be >8.
  columns | Number of columns in source/destination array. Must be >8.
  Kernel | The 2D convolution kernel of size 9x9.
  Divisor | The divisor of the convolution sum. Must be >0.

Note: Non-MMX implementation not available for this function.

Returns:
  Returns 1 if filter was applied, 0 otherwise.

Definition at line 4830 of file SDL2_imageFilter.c.

int SDL_imageFilterConvolveKernel9x9ShiftRight | ( | unsigned char * | Src,
|  | unsigned char * | Dest,
|  | int | rows,
|  | int | columns,
|  | signed short * | Kernel,
|  | unsigned char | NRightShift
| ) |  |

Filter using ConvolveKernel9x9ShiftRight: Dij = saturation255( ... )

Parameters:

  Src | The source 2D byte array to convolve. Should be different from destination.
  Dest | The destination 2D byte array to store the result in. Should be different from source.
  rows | Number of rows in source/destination array. Must be >8.
  columns | Number of columns in source/destination array. Must be >8.
  Kernel | The 2D convolution kernel of size 9x9.
  NRightShift | The number of right bit shifts to apply to the convolution sum. Must be <7.

Note: Non-MMX implementation not available for this function.

Returns:
  Returns 1 if filter was applied, 0 otherwise.

Definition at line 6219 of file SDL2_imageFilter.c.

int SDL_imageFilterDiv | ( | unsigned char * | Src1,
|  | unsigned char * | Src2,
|  | unsigned char * | Dest,
|  | unsigned int | length
| ) |  |

Filter using Div: D = S1 / S2.

Parameters:

  Src1 | Pointer to the start of the first source byte array (S1).
  Src2 | Pointer to the start of the second source byte array (S2).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source arrays.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 1549 of file SDL2_imageFilter.c.

int SDL_imageFilterMean | ( | unsigned char * | Src1,
|  | unsigned char * | Src2,
|  | unsigned char * | Dest,
|  | unsigned int | length
| ) |  |

Filter using Mean: D = S1/2 + S2/2.

Parameters:

  Src1 | Pointer to the start of the first source byte array (S1).
  Src2 | Pointer to the start of the second source byte array (S2).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source arrays.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 308 of file SDL2_imageFilter.c.

int SDL_imageFilterMMXdetect | ( | void |  | ) |

MMX detection routine (with override flag).

Returns:
  1 of MMX was detected, 0 otherwise.

Definition at line 80 of file SDL2_imageFilter.c.

void SDL_imageFilterMMXoff | ( | void |  | ) |

Disable MMX check for filter functions and and force to use non-MMX C based code.

Definition at line 93 of file SDL2_imageFilter.c.

void SDL_imageFilterMMXon | ( | void |  | ) |

Enable MMX check for filter functions and use MMX code if available.

Definition at line 101 of file SDL2_imageFilter.c.

int SDL_imageFilterMult | ( | unsigned char * | Src1,
|  | unsigned char * | Src2,
|  | unsigned char * | Dest,
|  | unsigned int | length
| ) |  |

Filter using Mult: D = saturation255(S1 * S2)

Parameters:

  Src1 | Pointer to the start of the first source byte array (S1).
  Src2 | Pointer to the start of the second source byte array (S2).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source arrays.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 729 of file SDL2_imageFilter.c.

int SDL_imageFilterMultByByte | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | unsigned char | C
| ) |  |

Filter using MultByByte: D = saturation255(S * C)

Parameters:

  Src1 | Pointer to the start of the source byte array (S).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source arrays.
  C | Constant to multiply with (C).

Returns:
  Returns 0 for success or -1 for error.

Definition at line 2790 of file SDL2_imageFilter.c.

int SDL_imageFilterMultDivby2 | ( | unsigned char * | Src1,
|  | unsigned char * | Src2,
|  | unsigned char * | Dest,
|  | unsigned int | length
| ) |  |

Filter using MultDivby2: D = saturation255(S1/2 * S2)

Parameters:

  Src1 | Pointer to the start of the first source byte array (S1).
  Src2 | Pointer to the start of the second source byte array (S2).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source arrays.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 1000 of file SDL2_imageFilter.c.

int SDL_imageFilterMultDivby4 | ( | unsigned char * | Src1,
|  | unsigned char * | Src2,
|  | unsigned char * | Dest,
|  | unsigned int | length
| ) |  |

Filter using MultDivby4: D = saturation255(S1/2 * S2/2)

Parameters:

  Src1 | Pointer to the start of the first source byte array (S1).
  Src2 | Pointer to the start of the second source byte array (S2).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source arrays.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 1141 of file SDL2_imageFilter.c.

int SDL_imageFilterMultNor | ( | unsigned char * | Src1,
|  | unsigned char * | Src2,
|  | unsigned char * | Dest,
|  | unsigned int | length
| ) |  |

Filter using MultNor: D = S1 * S2.

Parameters:

  Src1 | Pointer to the start of the first source byte array (S1).
  Src2 | Pointer to the start of the second source byte array (S2).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source arrays.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 862 of file SDL2_imageFilter.c.

int SDL_imageFilterMultNorASM | ( | unsigned char * | Src1,
|  | unsigned char * | Src2,
|  | unsigned char * | Dest,
|  | unsigned int | SrcLength
| ) |  |

Internal ASM Filter using MultNor: D = S1 * S2.

Parameters:

  Src1 | Pointer to the start of the first source byte array (S1).
  Src2 | Pointer to the start of the second source byte array (S2).
  Dest | Pointer to the start of the destination byte array (D).
  SrcLength | The number of bytes in the source arrays.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 792 of file SDL2_imageFilter.c.

int SDL_imageFilterNormalizeLinear | ( | unsigned char * | Src,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | int | Cmin,
|  | int | Cmax,
|  | int | Nmin,
|  | int | Nmax
| ) |  |

Filter using NormalizeLinear: D = saturation255((Nmax - Nmin)/(Cmax - Cmin)*(S - Cmin) + Nmin)

Parameters:

  Src | Pointer to the start of the source byte array (S).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source array.
  Cmin | Normalization constant.
  Cmax | Normalization constant.
  Nmin | Normalization constant.
  Nmax | Normalization constant.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 3909 of file SDL2_imageFilter.c.

void SDL_imageFilterRestoreStack | ( | void |  | ) |

Restore previously aligned stack.

Definition at line 7354 of file SDL2_imageFilter.c.

int SDL_imageFilterShiftLeft | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | unsigned char | N
| ) |  |

Filter ShiftLeft: D = saturation255(S << N)

Parameters:

  Src1 | Pointer to the start of the source byte array (S1).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source array.
  N | Number of bit-positions to shift (N). Valid range is 0 to 8.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 3393 of file SDL2_imageFilter.c.

int SDL_imageFilterShiftLeftByte | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | unsigned char | N
| ) |  |

Filter using ShiftLeftByte: D = (S << N)

Parameters:

  Src1 | Pointer to the start of the source byte array (S).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source arrays.
  N | Number of bit-positions to shift (N). Valid range is 0 to 8.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 3093 of file SDL2_imageFilter.c.

int SDL_imageFilterShiftLeftUint | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | unsigned char | N
| ) |  |

Filter using ShiftLeftUint: D = ((uint)S << N)

Parameters:

  Src1 | Pointer to the start of the source byte array (S).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source array.
  N | Number of bit-positions to shift (N). Valid range is 0 to 32.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 3210 of file SDL2_imageFilter.c.

int SDL_imageFilterShiftRight | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | unsigned char | N
| ) |  |

Filter using ShiftRight: D = saturation0(S >> N)

Parameters:

  Src1 | Pointer to the start of the source byte array (S).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source array.
  N | Number of bit-positions to shift (N). Valid range is 0 to 8.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 2476 of file SDL2_imageFilter.c.

int SDL_imageFilterShiftRightAndMultByByte | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | unsigned char | N,
|  | unsigned char | C
| ) |  |

Filter using ShiftRightAndMultByByte: D = saturation255((S >> N) * C)

Parameters:

  Src1 | Pointer to the start of the source byte array (S).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source array.
  N | Number of bit-positions to shift (N). Valid range is 0 to 8.
  C | Constant to multiply with (C).

Returns:
  Returns 0 for success or -1 for error.

Definition at line 2943 of file SDL2_imageFilter.c.

int SDL_imageFilterShiftRightUint | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | unsigned char | N
| ) |  |

Filter using ShiftRightUint: D = saturation0((uint)S[i] >> N)

Parameters:

  Src1 | Pointer to the start of the source byte array (S1).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source array.
  N | Number of bit-positions to shift (N). Valid range is 0 to 32.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 2594 of file SDL2_imageFilter.c.

int SDL_imageFilterSobelX | ( | unsigned char * | Src,
|  | unsigned char * | Dest,
|  | int | rows,
|  | int | columns
| ) |  |

Filter using SobelX: Dij = saturation255( ... )

Parameters:

  Src | The source 2D byte array to sobel-filter. Should be different from destination.
  Dest | The destination 2D byte array to store the result in. Should be different from source.
  rows | Number of rows in source/destination array. Must be >2.
  columns | Number of columns in source/destination array. Must be >7.

Note: Non-MMX implementation not available for this function.

Returns:
  Returns 1 if filter was applied, 0 otherwise.

Definition at line 6799 of file SDL2_imageFilter.c.

int SDL_imageFilterSobelXShiftRight | ( | unsigned char * | Src,
|  | unsigned char * | Dest,
|  | int | rows,
|  | int | columns,
|  | unsigned char | NRightShift
| ) |  |

Filter using SobelXShiftRight: Dij = saturation255( ... )

Parameters:

  Src | The source 2D byte array to sobel-filter. Should be different from destination.
  Dest | The destination 2D byte array to store the result in. Should be different from source.
  rows | Number of rows in source/destination array. Must be >2.
  columns | Number of columns in source/destination array. Must be >8.
  NRightShift | The number of right bit shifts to apply to the filter sum. Must be <7.

Note: Non-MMX implementation not available for this function.

Returns:
  Returns 1 if filter was applied, 0 otherwise.

Definition at line 7052 of file SDL2_imageFilter.c.

int SDL_imageFilterSub | ( | unsigned char * | Src1,
|  | unsigned char * | Src2,
|  | unsigned char * | Dest,
|  | unsigned int | length
| ) |  |

Filter using Sub: D = saturation0(S1 - S2)

Parameters:

  Src1 | Pointer to the start of the first source byte array (S1).
  Src2 | Pointer to the start of the second source byte array (S2).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source arrays.

Returns:
  Returns 0 for success or -1 for error.

Definition at line 422 of file SDL2_imageFilter.c.

int SDL_imageFilterSubByte | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | unsigned char | C
| ) |  |

Filter using SubByte: D = saturation0(S - C)

Parameters:

  Src1 | Pointer to the start of the source byte array (S).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source arrays.
  C | Constant to subtract (C).

Returns:
  Returns 0 for success or -1 for error.

Definition at line 2196 of file SDL2_imageFilter.c.

int SDL_imageFilterSubByteMMX | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | SrcLength,
|  | unsigned char | C
| ) |  |

Internal MMX Filter using SubByte: D = saturation0(S - C)

Parameters:

  Src1 | Pointer to the start of the source byte array (S).
  Dest | Pointer to the start of the destination byte array (D).
  SrcLength | The number of bytes in the source array.
  C | Constant to subtract (C).

Returns:
  Returns 0 for success or -1 for error.

Definition at line 2130 of file SDL2_imageFilter.c.

int SDL_imageFilterSubUint | ( | unsigned char * | Src1,
|  | unsigned char * | Dest,
|  | unsigned int | length,
|  | unsigned int | C
| ) |  |

Filter using SubUint: D = saturation0(S[i] - Cs[i % 4]), Cs=Swap32((uint)C)

Parameters:

  Src1 | Pointer to the start of the source byte array (S1).
  Dest | Pointer to the start of the destination byte array (D).
  length | The number of bytes in the source array.
  C | Constant to subtract (C).

Returns:
  Returns 0 for success or -1 for error.

Definition at line 2325 of file SDL2_imageFilter.c.