com.googlecode.leptonica.android

Class Pixa

com.googlecode.leptonica.android.Pixa

public class Pixa

Java representation of a native PIXA object. This object contains multiple PIX objects and their associated bounding BOX objects.

Constructor Detail

Pixa

public Pixa(long nativePixa,
            int width,
            int height)

Creates a wrapper for the specified native Pixa pointer.

Parameters:

nativePixa - Native pointer to a PIXA object.

width - The width of the PIXA.

height - The height of the PIXA.

Method Detail

createPixa

public static Pixa createPixa(int size)

Creates a new Pixa with the specified minimum capacity. The Pixa will expand automatically as new Pix are added.

Parameters:

size - The minimum capacity of this Pixa.

Returns:

org.jetbrains.dokka.NodeRenderContent@51635af4: a new Pixa or null on error

createPixa

public static Pixa createPixa(int size,
                              int width,
                              int height)

Creates a new Pixa with the specified minimum capacity. The Pixa will expand automatically as new Pix are added.

If non-zero, the specified width and height will be used to specify the bounds of output images. *

Parameters:

size - The minimum capacity of this Pixa.

width - (Optional) The width of this Pixa, use 0 for default.

height - (Optional) The height of this Pixa, use 0 for default.

Returns:

org.jetbrains.dokka.NodeRenderContent@31929fa1: a new Pixa or null on error

getNativePixa

public long getNativePixa()

Returns a pointer to the native PIXA object. This is used by native code.

Returns:

org.jetbrains.dokka.NodeRenderContent@10bfea0a: a pointer to the native PIXA object

copy

public Pixa copy()

Creates a shallow copy of this Pixa. Contained Pix are cloned, and the resulting Pixa may be recycled separately from the original.

Returns:

org.jetbrains.dokka.NodeRenderContent@6e14201: a shallow copy of this Pixa

sort

public Pixa sort(int field,
                 int order)

Sorts this Pixa using the specified field and order. See Constants.L_SORT_BY_* and Constants.L_SORT_INCREASING or Constants.L_SORT_DECREASING.

Parameters:

field - The field to sort by. See Constants.L_SORT_BY_*.

order - The order in which to sort. Must be either Constants.L_SORT_INCREASING or Constants.L_SORT_DECREASING.

Returns:

org.jetbrains.dokka.NodeRenderContent@4d9e0cd3: a sorted copy of this Pixa

size

public int size()

Returns the number of elements in this Pixa.

Returns:

org.jetbrains.dokka.NodeRenderContent@6854ed56: the number of elements in this Pixa

recycle

public void recycle()

Recycles this Pixa and frees natively allocated memory. You may not access or modify the Pixa after calling this method.

Any Pix obtained from this Pixa or copies of this Pixa will still be accessible until they are explicitly recycled or finalized by the garbage collector.

finalize

protected void finalize()

join

public boolean join(Pixa otherPixa)

Merges the contents of another Pixa into this one.

Parameters:

otherPixa - The Pix to merge.

Returns:

org.jetbrains.dokka.NodeRenderContent@7d4b5ec: true on success

addPix

public void addPix(Pix pix,
                   int mode)

Adds a Pix to this Pixa.

Parameters:

pix - The Pix to add.

mode - The mode in which to add this Pix, typically Constants.L_CLONE.

addBox

public void addBox(Box box,
                   int mode)

Adds a Box to this Pixa.

Parameters:

box - The Box to add.

mode - The mode in which to add this Box, typically Constants.L_CLONE.

add

public void add(Pix pix,
                Box box,
                int mode)

Adds a Pix and associated Box to this Pixa.

Parameters:

pix - The Pix to add.

box - The Box to add.

mode - The mode in which to add this Pix and Box, typically Constants.L_CLONE.

getBox

public Box getBox(int index)

Returns the Box at the specified index, or null on error.

Parameters:

index - The index of the Box to return.

Returns:

org.jetbrains.dokka.NodeRenderContent@b290e5d: the Box at the specified index, or null on error

getPix

public Pix getPix(int index)

Returns the Pix at the specified index, or null on error.

Parameters:

index - The index of the Pix to return.

Returns:

org.jetbrains.dokka.NodeRenderContent@36ec637f: the Pix at the specified index, or null on error

getWidth

public int getWidth()

Returns the width of this Pixa, or 0 if one was not set when it was created.

Returns:

org.jetbrains.dokka.NodeRenderContent@791d06a9: the width of this Pixa, or 0 if one was not set when it was created

getHeight

public int getHeight()

Returns the height of this Pixa, or 0 if one was not set when it was created.

Returns:

org.jetbrains.dokka.NodeRenderContent@5bc4b7b3: the height of this Pixa, or 0 if one was not set when it was created

getRect

public android.graphics.Rect getRect()

Returns a bounding Rect for this Pixa, which may be (0,0,0,0) if width and height were not specified on creation.

Returns:

org.jetbrains.dokka.NodeRenderContent@18dc0170: a bounding Rect for this Pixa

getBoxGeometry

public kotlin.Array[] getBoxGeometry(int index)

Returns a geometry array for the Box at the specified index. See Box.INDEX_* for indices.

Parameters:

index - The index of the Box to get the geometry of.

Returns:

org.jetbrains.dokka.NodeRenderContent@4d7e6e8f: a bounding Rect for the Box at the specified index

getBoxGeometry

public boolean getBoxGeometry(int index,
                              @Size
                              kotlin.Array[] dimensions)

Fills an array with the geometry of the Box at the specified index. See Box.INDEX_* for indices.

Parameters:

index - The index of the Box to get the geometry of.

dimensions - The array to fill with Box geometry. Must be at least 4 elements.

Returns:

org.jetbrains.dokka.NodeRenderContent@5c4701c7: true on success

getBoxRect

public android.graphics.Rect getBoxRect(int index)

Returns a bounding Rect for the Box at the specified index.

Parameters:

index - The index of the Box to get the bounding Rect of.

Returns:

org.jetbrains.dokka.NodeRenderContent@22405cd3: a bounding Rect for the Box at the specified index

getBoxRects

public java.util.ArrayList<android.graphics.Rect> getBoxRects()

Returns an ArrayList of Box bounding Rects.

Returns:

org.jetbrains.dokka.NodeRenderContent@5a6f0e6a: an ArrayList of Box bounding Rects

replacePix

public void replacePix(int index,
                       Pix pix,
                       Box box)

Replaces the Pix and Box at the specified index with the specified Pix and Box, both of which may be recycled after calling this method.

Parameters:

index - The index of the Pix to replace.

pix - The Pix to replace the existing Pix.

box - The Box to replace the existing Box.

mergeAndReplacePix

public void mergeAndReplacePix(int indexA,
                               int indexB)

Merges the Pix at the specified indices and removes the Pix at the second index.

Parameters:

indexA - The index of the first Pix.

indexB - The index of the second Pix, which will be removed after merging.

writeToFileRandomCmap

public boolean writeToFileRandomCmap(java.io.File file)

Writes the components of this Pix to a bitmap-formatted file using a random color map.

Parameters:

file - The file to write to.

Returns:

org.jetbrains.dokka.NodeRenderContent@64db09be: true on success

iterator

public java.util.Iterator<com.googlecode.leptonica.android.Pix> iterator()