Interface IImageAddressSpaceBuilder
- All Known Implementing Classes:
ImageAddressSpaceBuilder
public interface IImageAddressSpaceBuilder
Factory for building an com.ibm.dtfj.image.ImageAddressSpace.
An ImageAddressSpace factory contains various ImageProcess factories,
each pertaining to a specific ImageProcess and distinguished by unique ids.
In most cases, there will only be one ImageProcess factory associated with
one ImageAddressSpace factory.
-
Method Summary
Modifier and TypeMethodDescriptionaddImageSection
(String name, long base, long size) Create a new image section with the given name, base address and size and add it to the list in the ImageAddressSpace.To associate a new image process to the image address space being built by this image address space factory, use this interface to create a new image process factory for the aforementioned image process.Returns the current image process builder (factory) associated with the image address space factory.getImageProcessBuilder
(String builderID) In multiple image process scenarios, each image process is associated with it's own image process factory, and the latter are distinguished by unique id values.
-
Method Details
-
getCurrentImageProcessBuilder
IImageProcessBuilder getCurrentImageProcessBuilder()Returns the current image process builder (factory) associated with the image address space factory. Usually, there is only one image process, thus one image process factory. In the event that multiple image processes exist for one image address space, the current image process factory may be the last image process factory generated by the image address space factory.- Returns:
- current (usually the only) ImageProcess factory. Value must not be null.
-
getImageProcessBuilder
In multiple image process scenarios, each image process is associated with it's own image process factory, and the latter are distinguished by unique id values.- Parameters:
builderID
- unique id of the image process factory- Returns:
- image process factory if found, or null
-
generateImageProcessBuilder
To associate a new image process to the image address space being built by this image address space factory, use this interface to create a new image process factory for the aforementioned image process. At least one image process must exist for an image address space, therefore consequently, at least one image process factory must be created for each image address space factory.- Parameters:
id
- unique id for image process factory to be added to the image address space factory- Returns:
- generated image process factory
- Throws:
BuilderFailureException
- if error generating image process factory
-
addImageSection
Create a new image section with the given name, base address and size and add it to the list in the ImageAddressSpace.
-