Gets the parameters associated with the OpAtom at the specified index and validates that the atoms are of the correct type.
Because the arguments are validated and the types are checked so you can rely on the fact that the returned array contains a valid number of Atoms of the correct types.
Only the top level atoms are checked. So for example, the TJ operator takes an ArrayAtom consisting of NumAtoms and StringAtoms. This function will
ensure that there is one ArrayAtom available as a parameter. However it will not ensure that all items inside the array are NumAtoms or StringAtoms.
Also resource lookups are not done so, for example, it is not checked that a font name actually exists in the font resource dictionary.
If the operator takes no parameters a zero length array will be returned.
If the operator parameters are incorrect or if the operator is not recognized then the return value will be null. In this unusual
situation you may wish to set the OpAtom.Text to white space to remove the invalid operator from
the content stream. While this does not fix the underlying problem, it will at least prevent applications like Acrobat from reporting an error.
|