 |
Leptonica 1.85.0
Image processing and image analysis suite
|
|
Leptonica 1.85.0
Image processing and image analysis suite
|
#include <string.h>#include <math.h>#include "allheaders.h"Go to the source code of this file.
Macros | |
| #define | DEBUG 0 |
Functions | |
| static l_float32 | normalizeAngleForShear (l_float32 radang, l_float32 mindif) |
| PIX * | pixHShear (PIX *pixd, PIX *pixs, l_int32 yloc, l_float32 radang, l_int32 incolor) |
| PIX * | pixVShear (PIX *pixd, PIX *pixs, l_int32 xloc, l_float32 radang, l_int32 incolor) |
| PIX * | pixHShearCorner (PIX *pixd, PIX *pixs, l_float32 radang, l_int32 incolor) |
| PIX * | pixVShearCorner (PIX *pixd, PIX *pixs, l_float32 radang, l_int32 incolor) |
| PIX * | pixHShearCenter (PIX *pixd, PIX *pixs, l_float32 radang, l_int32 incolor) |
| PIX * | pixVShearCenter (PIX *pixd, PIX *pixs, l_float32 radang, l_int32 incolor) |
| l_ok | pixHShearIP (PIX *pixs, l_int32 yloc, l_float32 radang, l_int32 incolor) |
| l_ok | pixVShearIP (PIX *pixs, l_int32 xloc, l_float32 radang, l_int32 incolor) |
| PIX * | pixHShearLI (PIX *pixs, l_int32 yloc, l_float32 radang, l_int32 incolor) |
| PIX * | pixVShearLI (PIX *pixs, l_int32 xloc, l_float32 radang, l_int32 incolor) |
Variables | |
| static const l_float32 | MinDiffFromHalfPi = 0.04f |
About arbitrary lines
PIX *pixHShear()
PIX *pixVShear()
About special 'points': UL corner and center
PIX *pixHShearCorner()
PIX *pixVShearCorner()
PIX *pixHShearCenter()
PIX *pixVShearCenter()
In place about arbitrary lines
l_int32 pixHShearIP()
l_int32 pixVShearIP()
Linear interpolated shear about arbitrary lines
PIX *pixHShearLI()
PIX *pixVShearLI()
Static helper
static l_float32 normalizeAngleForShear()
Definition in file shear.c.
|
static |
| [in] | pixd | [optional] this can be null, equal to pixs, or different from pixs |
| [in] | pixs | any depth; cmap ok |
| [in] | yloc | location of horizontal line, measured from origin |
| [in] | radang | angle in radians |
| [in] | incolor | L_BRING_IN_WHITE, L_BRING_IN_BLACK; |
Notes:
(1) There are 3 cases:
(a) pixd == null (make a new pixd)
(b) pixd == pixs (in-place)
(c) pixd != pixs
(2) For these three cases, use these patterns, respectively:
pixd = pixHShear(NULL, pixs, ...);
pixHShear(pixs, pixs, ...);
pixHShear(pixd, pixs, ...);
(3) This shear leaves the horizontal line of pixels at y = yloc
invariant. For a positive shear angle, pixels above this
line are shoved to the right, and pixels below this line
move to the left.
(4) With positive shear angle, this can be used, along with
pixVShear(), to perform a cw rotation, either with 2 shears
(for small angles) or in the general case with 3 shears.
(5) Changing the value of yloc is equivalent to translating
the result horizontally.
(6) This brings in incolor pixels from outside the image.
(7) In-place shears do not work on cmapped pix, because the
in-place operation cannot initialize to the requested incolor,
so we shear from a copy.
(8) The angle is brought into the range [-pi, -pi]. It is
not permitted to be within MinDiffFromHalfPi radians
from either -pi/2 or pi/2.
Definition at line 117 of file shear.c.
References L_BRING_IN_BLACK, L_BRING_IN_WHITE, PIX_SRC, pixHShear(), and pixHShearIP().
Referenced by pixHShear(), pixHShearCenter(), and pixHShearCorner().
| [in] | pixd | [optional] if not null, must be equal to pixs |
| [in] | pixs | any depth |
| [in] | radang | angle in radians |
| [in] | incolor | L_BRING_IN_WHITE, L_BRING_IN_BLACK; |
Notes:
(1) See pixHShear() for usage.
(2) This does a horizontal shear about the center, with (+) shear
pushing increasingly leftward (-x) with increasing y.
Definition at line 394 of file shear.c.
References pixHShear().
| [in] | pixd | [optional], if not null, must be equal to pixs |
| [in] | pixs | any depth |
| [in] | radang | angle in radians |
| [in] | incolor | L_BRING_IN_WHITE, L_BRING_IN_BLACK; |
Notes:
(1) See pixHShear() for usage.
(2) This does a horizontal shear about the UL corner, with (+) shear
pushing increasingly leftward (-x) with increasing y.
Definition at line 336 of file shear.c.
References pixHShear().
| l_ok pixHShearIP | ( | PIX * | pixs, |
| l_int32 | yloc, | ||
| l_float32 | radang, | ||
| l_int32 | incolor ) |
| [in] | pixs | any depth; no cmap |
| [in] | yloc | location of horizontal line, measured from origin |
| [in] | radang | angle in radians |
| [in] | incolor | L_BRING_IN_WHITE, L_BRING_IN_BLACK; |
Notes:
(1) This is an in-place version of pixHShear(); see comments there.
(2) This brings in 'incolor' pixels from outside the image.
(3) pixs cannot be colormapped, because the in-place operation
only blits in 0 or 1 bits, not an arbitrary colormap index.
(4) Does a horizontal full-band shear about the line with (+) shear
pushing increasingly leftward (-x) with increasing y.
Definition at line 459 of file shear.c.
References L_BRING_IN_BLACK, and L_BRING_IN_WHITE.
Referenced by pixHShear().
| [in] | pixs | 8 bpp or 32 bpp, or colormapped |
| [in] | yloc | location of horizontal line, measured from origin |
| [in] | radang | angle in radians, in range (-pi/2 ... pi/2) |
| [in] | incolor | L_BRING_IN_WHITE, L_BRING_IN_BLACK; |
Notes:
(1) This does horizontal shear with linear interpolation for
accurate results on 8 bpp gray, 32 bpp rgb, or cmapped images.
It is relatively slow compared to the sampled version
implemented by rasterop, but the result is much smoother.
(2) This shear leaves the horizontal line of pixels at y = yloc
invariant. For a positive shear angle, pixels above this
line are shoved to the right, and pixels below this line
move to the left.
(3) Any colormap is removed.
(4) The angle is brought into the range [-pi/2 + del, pi/2 - del],
where del == MinDiffFromHalfPi.
Definition at line 613 of file shear.c.
References GET_DATA_BYTE, L_BRING_IN_BLACK, L_BRING_IN_WHITE, REMOVE_CMAP_BASED_ON_SRC, and SET_DATA_BYTE.
| [in] | pixd | [optional], this can be null, equal to pixs, or different from pixs |
| [in] | pixs | any depth; cmap ok |
| [in] | xloc | location of vertical line, measured from origin |
| [in] | radang | angle in radians; not too close to +-(pi / 2) |
| [in] | incolor | L_BRING_IN_WHITE, L_BRING_IN_BLACK; |
Notes:
(1) There are 3 cases:
(a) pixd == null (make a new pixd)
(b) pixd == pixs (in-place)
(c) pixd != pixs
(2) For these three cases, use these patterns, respectively:
pixd = pixVShear(NULL, pixs, ...);
pixVShear(pixs, pixs, ...);
pixVShear(pixd, pixs, ...);
(3) This shear leaves the vertical line of pixels at x = xloc
invariant. For a positive shear angle, pixels to the right
of this line are shoved downward, and pixels to the left
of the line move upward.
(4) With positive shear angle, this can be used, along with
pixHShear(), to perform a cw rotation, either with 2 shears
(for small angles) or in the general case with 3 shears.
(5) Changing the value of xloc is equivalent to translating
the result vertically.
(6) This brings in incolor pixels from outside the image.
(7) In-place shears do not work on cmapped pix, because the
in-place operation cannot initialize to the requested incolor,
so we shear from a copy.
(8) The angle is brought into the range [-pi, -pi]. It is
not permitted to be within MinDiffFromHalfPi radians
from either -pi/2 or pi/2.
Definition at line 236 of file shear.c.
References L_BRING_IN_BLACK, L_BRING_IN_WHITE, PIX_SRC, pixVShear(), and pixVShearIP().
Referenced by pixVShear(), pixVShearCenter(), and pixVShearCorner().
| [in] | pixd | [optional] if not null, must be equal to pixs |
| [in] | pixs | any depth |
| [in] | radang | angle in radians |
| [in] | incolor | L_BRING_IN_WHITE, L_BRING_IN_BLACK; |
Notes:
(1) See pixVShear() for usage.
(2) This does a vertical shear about the center, with (+) shear
pushing increasingly downward (+y) with increasing x.
Definition at line 423 of file shear.c.
References pixVShear().
| [in] | pixd | [optional], if not null, must be equal to pixs |
| [in] | pixs | any depth |
| [in] | radang | angle in radians |
| [in] | incolor | L_BRING_IN_WHITE, L_BRING_IN_BLACK; |
Notes:
(1) See pixVShear() for usage.
(2) This does a vertical shear about the UL corner, with (+) shear
pushing increasingly downward (+y) with increasing x.
Definition at line 365 of file shear.c.
References pixVShear().
| l_ok pixVShearIP | ( | PIX * | pixs, |
| l_int32 | xloc, | ||
| l_float32 | radang, | ||
| l_int32 | incolor ) |
| [in] | pixs | any depth; no cmap |
| [in] | xloc | location of vertical line, measured from origin |
| [in] | radang | angle in radians |
| [in] | incolor | L_BRING_IN_WHITE, L_BRING_IN_BLACK; |
Notes:
(1) This is an in-place version of pixVShear(); see comments there.
(2) This brings in 'incolor' pixels from outside the image.
(3) pixs cannot be colormapped, because the in-place operation
only blits in 0 or 1 bits, not an arbitrary colormap index.
(4) Does a vertical full-band shear about the line with (+) shear
pushing increasingly downward (+y) with increasing x.
Definition at line 532 of file shear.c.
References L_BRING_IN_BLACK, and L_BRING_IN_WHITE.
Referenced by pixVShear().
| [in] | pixs | 8 bpp or 32 bpp, or colormapped |
| [in] | xloc | location of vertical line, measured from origin |
| [in] | radang | angle in radians, in range (-pi/2 ... pi/2) |
| [in] | incolor | L_BRING_IN_WHITE, L_BRING_IN_BLACK; |
Notes:
(1) This does vertical shear with linear interpolation for
accurate results on 8 bpp gray, 32 bpp rgb, or cmapped images.
It is relatively slow compared to the sampled version
implemented by rasterop, but the result is much smoother.
(2) This shear leaves the vertical line of pixels at x = xloc
invariant. For a positive shear angle, pixels to the right
of this line are shoved downward, and pixels to the left
of the line move upward.
(3) Any colormap is removed.
(4) The angle is brought into the range [-pi/2 + del, pi/2 - del],
where del == MinDiffFromHalfPi.
Definition at line 723 of file shear.c.
References GET_DATA_BYTE, L_BRING_IN_BLACK, L_BRING_IN_WHITE, REMOVE_CMAP_BASED_ON_SRC, and SET_DATA_BYTE.
1.12.0