Java Solaris Communities Sun Store Join SDN My Profile Why Join?
 
Bug Database
Bug Detail
Quick Lists
Top 25 Bugs
Top 25 RFE's
Recently Closed Bugs
Printable Page Printable Page


Bug Database
Bug ID: 4659779
Votes 0
Synopsis Argument 'element' in ImageFunction.getElements(...) is not documented
Category jai:doc
Reported Against 1.1.1
Release Fixed
State 1-Dispatched, bug
Priority: 4-Low
Related Bugs
Submit Date 28-MAR-2002
Description




FULL PRODUCT VERSION :
java version "1.4.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-b92)
Java HotSpot(TM) Client VM (build 1.4.0-b92, mixed mode)


Windows NT Version 4.0 service pack 6a

DESCRIPTION OF THE PROBLEM :
Java Doc for ImageFunction.getElements(...) said:

Returns all values of a given element for a specified set of coordinates [...]

Parameters:
    startX - The X coordinate of the upper left [...]
    startY - The Y coordinate of the upper left  [...]
    deltaX - The horizontal increment.
    deltaY - The vertical increment.
    countX - The number of points in the horizontal direction.
    countY - The number of points in the vertical direction.
    real   - A pre-allocated float array of length at least
             countX*countY in which the real parts of all
             elements will be returned.
    imag   - A pre-allocated float array of length at least
             countX*countY in which the imaginary parts of
             all elements will be returned; [...]


Argument 'int element' is not documented anywhere. We have to guess from class description and the 'getNumElements()' description. This is a little bit confusing since the word 'element' seems to be used in two context:

1) for the value at each position
2) for elements in 'real' and 'imag' array, which are computed at different positions.


This bug can be reproduced always.
(Review ID: 144685) 
======================================================================
Work Around
N/A
Evaluation
N/A
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang