Gets the parameter associated with the OpAtom at the specified index and validates that the atom is of the correct type.
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.
If the atom is not of the correct type, is not available in the array (e.g. because the array is too small) or the operator is
unrecognized then the return value will be null. If the operator does not take any parameters the return will be null.
The Atom is the actual object in the supplied array so changing the value of the Atom will change the value in the array.
If the index does not point to an OpAtom or is not inside the array bounds then an exception will be thrown.
This function supports all the standard PDF operator types as defined in the PDF Specification apart from BI, ID and EI which are used for inline images.
The reason these are not supported is because this sequence is read as a DictAtom with embedded data so you should never encounter it.
|