Java Doc for ErodeDescriptor.java in  » 6.0-JDK-Modules » Java-Advanced-Imaging » javax » media » jai » operator » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » 6.0 JDK Modules » Java Advanced Imaging » javax.media.jai.operator 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   javax.media.jai.OperationDescriptorImpl
      javax.media.jai.operator.ErodeDescriptor

ErodeDescriptor
public class ErodeDescriptor extends OperationDescriptorImpl (Code)
An OperationDescriptor describing the "Erode" operation.

Gray Scale Erosion is a spatial operation that computes each output sample by subtracting elements of a kernel from the samples surrounding a particular source sample. The mathematical formulation for erosion operation is:

For a kernel K with a key position (xKey, yKey), the erosion of image I at (x,y) is given by:

 max{ f:  f + K(xKey+i, yKey+j) <= I(x+i,y+j): all (i,j)}
 "all" possible (i,j) means that both I(x+i,y+j) and K(xKey+i, yKey+j)
 are in bounds. Otherwise, the value is set to 0.
 "f" represents all possible floats satisfying the restriction.
 

Intuitively, the kernel is like an unbrella and the key point is the handle. At every point, you try to push the umbrella up as high as possible but still underneath the image surface. The final height of the handle is the value after erosion. Thus if you want the image to erode from the upper right to bottom left, the following would do.

00X
0X0
X00

Note that even if every entry of a kernel is zero, the erosion changes the image. Different key positions will also lead to different erosion results for such zero kernels.

Pseudo code for the erosion operation is as follows. Assuming the kernel K is of size M rows x N cols and the key position is (xKey, yKey).

 // erosion
 for every dst pixel location (x,y){
 tmp = infinity;
 for (i = -xKey; i < M - xKey; i++){
 for (j = -yKey; j < N - yKey; j++){
 if((x+i, y+j) are in bounds of src){
 tmp = min{tmp, src[x + i][y + j] - K[xKey + i][yKey + j]};
 }
 }
 }
 dst[x][y] = tmp;
 if (dst[x][y] == infinity)
 dst[x][y] = 0;
 }
 

The kernel cannot be bigger in any dimension than the image data.

Binary Image Erosion requires the kernel to be binary, that is, to have values 0 and 1 for each kernel entry. Intuitively, binary erosion slides the kernel key position and place it at every point (x,y) in the src image. The dst value at this position is set to 1 if the entire kernel lies within the image bounds and the src image value is 1 wherever the corresponding kernel value is 1." Otherwise, the value after erosion at (x,y) is set to 0. Erosion usually shrinks images, but it can fill holes with kernels like

 [1 0 1] 
and the key position at the center.

Pseudo code for the binary erosion operation is as follows.

 // erosion
 for every dst pixel location (x,y){
 dst[x][y] = 1;
 for (i = -xKey; i < M - xKey; i++){
 for (j = -yKey; j < N - yKey; j++){
 if((x+i,y+j) is out of bounds of src ||
 src(x+i, y+j)==0 && Key(xKey+i, yKey+j)==1){
 dst[x][y] = 0; break;
 }
 }
 }
 }
 The following can be used as references for the underlying
 connection between these two algorithms.
 

Reference: An Introduction to Nonlinear Image Processing, by Edward R. Bougherty and Jaakko Astola, Spie Optical Engineering Press, 1994. It should be noted that this operation automatically adds a value of Boolean.TRUE for the JAI.KEY_REPLACE_INDEX_COLOR_MODEL to the given configuration so that the operation is performed on the pixel values instead of being performed on the indices into the color map if the source(s) have an IndexColorModel. This addition will take place only if a value for the JAI.KEY_REPLACE_INDEX_COLOR_MODEL has not already been provided by the user. Note that the configuration Map is cloned before the new hint is added to it. The operation can be smart about the value of the JAI.KEY_REPLACE_INDEX_COLOR_MODEL RenderingHints, i.e. while the default value for the JAI.KEY_REPLACE_INDEX_COLOR_MODEL is Boolean.TRUE, in some cases the operator could set the default.

Resource List
Name Value
GlobalName Erode
LocalName Erode
Vendor com.sun.media.jai
Description Performs kernel based Erode on an image.
DocURL http://java.sun.com/products/java-media/jai/forD evelopers/jai-apidocs/javax/media/jai/operator/ErodeDescriptor.html
Version 1.1
arg0Desc The erode kernel.

Parameter List
Name Class Type Default Value
kernel javax.media.jai.KernelJAI NO_PARAMETER_DEFAULT


See Also:   javax.media.jai.KernelJAI
since:
   JAI 1.1



Constructor Summary
public  ErodeDescriptor()
     Constructor.

Method Summary
public static  RenderedOpcreate(RenderedImage source0, KernelJAI kernel, RenderingHints hints)
     Performs binary kernel based Erode operation on the image.

Creates a ParameterBlockJAI from all supplied arguments except hints and invokes JAI.create(StringParameterBlockRenderingHints) .
See Also:   JAI
See Also:   ParameterBlockJAI
See Also:   RenderedOp
Parameters:
  source0 - RenderedImage source 0.
Parameters:
  kernel - The binary convolution kernel.
Parameters:
  hints - The RenderingHints to use.May be null.

public  PropertyGenerator[]getPropertyGenerators()
     Returns an array of PropertyGenerators implementing property inheritance for the "Erode" operation.


Constructor Detail
ErodeDescriptor
public ErodeDescriptor()(Code)
Constructor.




Method Detail
create
public static RenderedOp create(RenderedImage source0, KernelJAI kernel, RenderingHints hints)(Code)
Performs binary kernel based Erode operation on the image.

Creates a ParameterBlockJAI from all supplied arguments except hints and invokes JAI.create(StringParameterBlockRenderingHints) .
See Also:   JAI
See Also:   ParameterBlockJAI
See Also:   RenderedOp
Parameters:
  source0 - RenderedImage source 0.
Parameters:
  kernel - The binary convolution kernel.
Parameters:
  hints - The RenderingHints to use.May be null. The RenderedOp destination.
throws:
  IllegalArgumentException - if source0 is null.
throws:
  IllegalArgumentException - if kernel is null.




getPropertyGenerators
public PropertyGenerator[] getPropertyGenerators()(Code)
Returns an array of PropertyGenerators implementing property inheritance for the "Erode" operation. An array of property generators.



Fields inherited from javax.media.jai.OperationDescriptorImpl
final protected String[][] resources(Code)(Java Doc)
final protected String[] sourceNames(Code)(Java Doc)
final protected String[] supportedModes(Code)(Java Doc)

Methods inherited from javax.media.jai.OperationDescriptorImpl
public boolean arePropertiesSupported()(Code)(Java Doc)
protected static Class getDefaultSourceClass(String modeName)(Code)(Java Doc)
public Class getDestClass(String modeName)(Code)(Java Doc)
public Class getDestClass()(Code)(Java Doc)
public Object getInvalidRegion(String modeName, ParameterBlock oldParamBlock, RenderingHints oldHints, ParameterBlock newParamBlock, RenderingHints newHints, OperationNode node)(Code)(Java Doc)
public String getName()(Code)(Java Doc)
public int getNumParameters()(Code)(Java Doc)
public int getNumSources()(Code)(Java Doc)
public Class[] getParamClasses()(Code)(Java Doc)
public Object getParamDefaultValue(int index)(Code)(Java Doc)
public Object[] getParamDefaults()(Code)(Java Doc)
public Number getParamMaxValue(int index)(Code)(Java Doc)
public Number getParamMinValue(int index)(Code)(Java Doc)
public String[] getParamNames()(Code)(Java Doc)
public ParameterListDescriptor getParameterListDescriptor(String modeName)(Code)(Java Doc)
public PropertyGenerator[] getPropertyGenerators(String modeName)(Code)(Java Doc)
public PropertyGenerator[] getPropertyGenerators()(Code)(Java Doc)
public Class getRenderableDestClass()(Code)(Java Doc)
public Class[] getRenderableSourceClasses()(Code)(Java Doc)
public ResourceBundle getResourceBundle(Locale locale)(Code)(Java Doc)
public String[][] getResources(Locale locale)(Code)(Java Doc)
public Class[] getSourceClasses(String modeName)(Code)(Java Doc)
public Class[] getSourceClasses()(Code)(Java Doc)
public String[] getSourceNames()(Code)(Java Doc)
public String[] getSupportedModes()(Code)(Java Doc)
public boolean isImmediate()(Code)(Java Doc)
public boolean isModeSupported(String modeName)(Code)(Java Doc)
public boolean isRenderableSupported()(Code)(Java Doc)
public boolean isRenderedSupported()(Code)(Java Doc)
protected static Class[][] makeDefaultSourceClassList(String[] supportedModes, int numSources)(Code)(Java Doc)
public boolean validateArguments(String modeName, ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
public boolean validateArguments(ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
protected boolean validateParameters(String modeName, ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
protected boolean validateParameters(ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
public boolean validateRenderableArguments(ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
protected boolean validateRenderableSources(ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
protected boolean validateSources(String modeName, ParameterBlock args, StringBuffer msg)(Code)(Java Doc)
protected boolean validateSources(ParameterBlock args, StringBuffer msg)(Code)(Java Doc)

Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.