Java Doc for DilateDescriptor.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.DilateDescriptor

DilateDescriptor
public class DilateDescriptor extends OperationDescriptorImpl (Code)
An OperationDescriptor describing the "Dilate" operation. Dilation for gray scale images can be charaterized by "slide, add and max", while for binary images by "slide and set". As always, the kernel is expected to come with a key position.

Dilation, unlike convolution and most neighborhood operations, actually can grow the image region. But to conform with other image neighborhood operations, the border pixels are set to 0. For a 3 x 3 kernel with the key point at the center, there will be a pixel wide 0 stripe around the border.

When applied to multi-band images the dilation operator processes each band independently using the methodology which would be applied to single band images of the same data type.

Gray scale dilation is a spatial operation that computes each output sample by adding elements of a kernel to the samples surrounding a particular source sample and taking the maximum. A mathematical expression is:

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

 max{ I(x-i, y-j) + K(xKey+i, yKey+j): some (i,j) restriction }
 where the (i,j) restriction means:
 all possible (i,j) so that both I(x-i,y-j) and K(xKey+i, yKey+j)
 are defined, that is, these indices are in bounds.
 

Intuitively in 2D, the kernel is like an umbrella and the key point is the handle. When the handle moves all over the image surface, the upper outbounds of all the umbrella positions is the dilation. Thus if you want the image to dilate in the upper right direction, the following kernel would do with the bold face key position.

0050
0500
000

Note also that zero kernel have effects on the dilation! That is because of the "max" in the add and max process. Thus a 3 x 1 zero kernel with the key position at the bottom of the kernel dilates the image upwards.

After the kernel is rotated 180 degrees, Pseudo code for dilation operation is as follows. Of course, you should provide the kernel in its (unrotated) original form. Assuming the kernel K is of size M rows x N cols and the key position is (xKey, yKey).

 // gray-scale dilation:
 for every dst pixel location (x,y){
 dst[x][y] = -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 &&
 (xKey+i, yKey+j) are in bounds of K){
 tmp = src[x + i][y + j]+ K[xKey + i][yKey + j];
 dst[x][y] = max{tmp, dst[x][y]};
 }
 }
 }
 }
 

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

Binary Image Dilation requires the kernel K to be binary, that is, have values 0 or 1 for all kernel entries. Intuitively, starting from dst image being a duplicate of src, binary dilation slides the kernel K to place the key position at every non-zero point (x,y) in src image and set dst positions under ones of K to 1.

After the kernel is rotated 180 degrees, the pseudo code for dilation operation is as follows. (Of course, you should provide the kernel in its original unrotated form.)

 // binary dilation
 for every dst pixel location (x,y){
 dst[x][y] = src[x][y];
 for (i = -xKey; i < M - xKey; i++){
 for (j = -yKey; j < N - yKey; j++){
 if(src[x+i,y+i]==1 && Key(xKey+i, yKey+j)==1){
 dst[x][y] = 1; break;
 }
 }
 }
 }
 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 Dilate
LocalName Dilate
Vendor com.sun.media.jai
Description Performs kernel based Dilate on an image.
DocURL http://java.sun.com/products/java-media/jai/forD evelopers/jai-apidocs/javax/media/jai/operator/DilateDescriptor.html
Version 1.1
arg0Desc The dilate kernel.

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

Reference: An Introduction to Nonlinear Image Processing, by Edward R. Bougherty and Jaakko Astola, Spie Optical Engineering Press, 1994.
See Also:   javax.media.jai.OperationDescriptor
See Also:   javax.media.jai.KernelJAI
See Also:   javax.media.jai.operator.ErodeDescriptor
since:
   JAI 1.1




Constructor Summary
public  DilateDescriptor()
     Constructor.

Method Summary
public static  RenderedOpcreate(RenderedImage source0, KernelJAI kernel, RenderingHints hints)
     Performs binary kernel based Dilate 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 "Dilate" operation.


Constructor Detail
DilateDescriptor
public DilateDescriptor()(Code)
Constructor.




Method Detail
create
public static RenderedOp create(RenderedImage source0, KernelJAI kernel, RenderingHints hints)(Code)
Performs binary kernel based Dilate 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 "Dilate" 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.