Package ome.services
Class RenderingBean
- java.lang.Object
-
- ome.services.RenderingBean
-
- All Implemented Interfaces:
java.io.Serializable
,ome.api.ServiceInterface
,ome.api.StatefulServiceInterface
,omeis.providers.re.RenderingEngine
@Transactional(readOnly=true) public class RenderingBean extends java.lang.Object implements omeis.providers.re.RenderingEngine, java.io.Serializable
Provides theRenderingEngine
service. This class is an Adapter to wrap theRenderer
so to make it thread-safe.The multi-threaded design of this component is based on dynamic locking and confinement techniques. All access to the component's internal parts happens through a
RenderingEngineImpl
object, which is fully synchronized. Internal parts are either never leaked out or given away only if read-only objects. (The only exception are theCodomainMapContext
objects which are not read-only but are copied upon every method invocation so to maintain safety.)Finally the
RenderingEngine
component doesn't make use of constructs that could compromise liveness.- Since:
- 3.0-M3
- See Also:
RenderingEngine
, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description protected static java.lang.String
NULL_RENDERER
Message if the rendering engine is not ready.
-
Constructor Summary
Constructors Constructor Description RenderingBean(ome.io.nio.PixelsService dataService, LocalCompress compress, Executor ex, SecuritySystem secSys, omeis.providers.re.lut.LutProvider lutProvider)
Compression service Bean injector.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description void
activate()
void
addCodomainMap(omeis.providers.re.codomain.CodomainMapContext mapCtx)
Deprecated.void
addCodomainMapToChannel(omeis.providers.re.codomain.CodomainMapContext mapCtx, int w)
Implemented as specified by theRenderingEngine
interface.void
close()
protected void
errorIfInvalidState()
protected void
errorIfNullPixels()
Throws anApiUsageException
if the pixels are not set.protected void
errorIfNullRenderer()
Reloads the rendering engine ifnull
and has been made passive or throws anApiUsageException
if the rendering engine is not set.protected void
errorIfNullRenderingDef()
Throws anApiUsageException
if the rendering settings are not set.java.util.List
getAvailableFamilies()
Implemented as specified by theRenderingEngine
interface.java.util.List
getAvailableModels()
Implemented as specified by theRenderingEngine
interface.double
getChannelCurveCoefficient(int w)
Implemented as specified by theRenderingEngine
interface.ome.model.enums.Family
getChannelFamily(int w)
Implemented as specified by theRenderingEngine
interface.java.lang.String
getChannelLookupTable(int w)
boolean
getChannelNoiseReduction(int w)
Implemented as specified by theRenderingEngine
interface.double[]
getChannelStats(int w)
Implemented as specified by theRenderingEngine
interface.double
getChannelWindowEnd(int w)
Implemented as specified by theRenderingEngine
interface.double
getChannelWindowStart(int w)
Implemented as specified by theRenderingEngine
interface.java.util.List<omeis.providers.re.codomain.CodomainMapContext>
getCodomainMapContext(int w)
Implemented as specified by theRenderingEngine
interface.float
getCompressionLevel()
Implemented as specified by theRenderingEngine
interface.ome.system.EventContext
getCurrentEventContext()
Implemented as specified by theRenderingEngine
interface.int
getDefaultT()
Implemented as specified by theRenderingEngine
interface.int
getDefaultZ()
Implemented as specified by theRenderingEngine
interface.ome.model.enums.RenderingModel
getModel()
Implemented as specified by theRenderingEngine
interface.ome.model.core.Pixels
getPixels()
Implemented as specified by theRenderingEngine
interface.double
getPixelsTypeLowerBound(int w)
Implemented as specified by theRenderingEngine
interface.double
getPixelsTypeUpperBound(int w)
Implemented as specified by theRenderingEngine
interface.ome.model.display.QuantumDef
getQuantumDef()
Implemented as specified by theRenderingEngine
interface.long
getRenderingDefId()
java.util.List<java.util.List<java.lang.Integer>>
getResolutionDescriptions()
int
getResolutionLevel()
int
getResolutionLevels()
int[]
getRGBA(int w)
Implemented as specified by theRenderingEngine
interface.java.lang.Class<? extends ome.api.ServiceInterface>
getServiceInterface()
Returns the service corresponding to this class.int[]
getTileSize()
boolean
isActive(int w)
Implemented as specified by theRenderingEngine
interface.boolean
isPixelsTypeSigned()
Implemented as specified by theRenderingEngine
interface.void
load()
Implemented as specified by theRenderingEngine
interface.void
loadRenderingDef(long renderingDefId)
Implemented as specified by theRenderingEngine
interface.void
lookupPixels(long pixelsId)
Implemented as specified by theRenderingEngine
interface.boolean
lookupRenderingDef(long pixelsId)
Implemented as specified by theRenderingEngine
interface.void
passivate()
void
removeCodomainMap(omeis.providers.re.codomain.CodomainMapContext mapCtx)
Deprecated.void
removeCodomainMapFromChannel(omeis.providers.re.codomain.CodomainMapContext mapCtx, int w)
Implemented as specified by theRenderingEngine
interface.omeis.providers.re.RGBBuffer
render(omeis.providers.re.data.PlaneDef pd)
Implemented as specified by theRenderingEngine
interface.int[]
renderAsPackedInt(omeis.providers.re.data.PlaneDef pd)
Implemented as specified by theRenderingEngine
interface.byte[]
renderCompressed(omeis.providers.re.data.PlaneDef pd)
Implemented as specified by theRenderingEngine
interface.int[]
renderProjectedAsPackedInt(int algorithm, int timepoint, int stepping, int start, int end)
Implemented as specified by theRenderingEngine
interface.byte[]
renderProjectedCompressed(int algorithm, int timepoint, int stepping, int start, int end)
Implemented as specified by theRenderingEngine
interface.boolean
requiresPixelsPyramid()
long
resetDefaultSettings(boolean save)
Implemented as specified by theRenderingEngine
interface.long
saveAsNewSettings()
Implemented as specified by theRenderingEngine
interface.void
saveCurrentSettings()
Implemented as specified by theRenderingEngine
interface.void
setActive(int w, boolean active)
Implemented as specified by theRenderingEngine
interface.void
setChannelLookupTable(int w, java.lang.String lookup)
void
setChannelWindow(int w, double start, double end)
Implemented as specified by theRenderingEngine
interface.void
setCodomainInterval(int start, int end)
Implemented as specified by theRenderingEngine
interface.void
setCompressionLevel(float percentage)
Implemented as specified by theRenderingEngine
interface.void
setDefaultT(int t)
Implemented as specified by theRenderingEngine
interface.void
setDefaultZ(int z)
Implemented as specified by theRenderingEngine
interface.void
setModel(ome.model.enums.RenderingModel model)
Implemented as specified by theRenderingEngine
interface.void
setOverlays(java.util.Map<byte[],java.lang.Integer> overlays)
Deprecated.As of release 5.1.0, replaced byPlaneDef.setShapeIds(List)
.void
setQuantizationMap(int w, ome.model.enums.Family family, double coefficient, boolean noiseReduction)
Implemented as specified by theRenderingEngine
interface.void
setQuantumStrategy(int bitResolution)
Implemented as specified by theRenderingEngine
interface.void
setResolutionLevel(int resolutionLevel)
void
setRGBA(int w, int red, int green, int blue, int alpha)
Implemented as specified by theRenderingEngine
interface.void
updateCodomainMap(omeis.providers.re.codomain.CodomainMapContext mapCtx)
Deprecated.void
updateSettings(ome.model.display.RenderingDef settings)
Implemented as specified by theRenderingEngine
interface.
-
-
-
Field Detail
-
NULL_RENDERER
protected static final java.lang.String NULL_RENDERER
Message if the rendering engine is not ready.- See Also:
- Constant Field Values
-
-
Constructor Detail
-
RenderingBean
public RenderingBean(ome.io.nio.PixelsService dataService, LocalCompress compress, Executor ex, SecuritySystem secSys, omeis.providers.re.lut.LutProvider lutProvider)
Compression service Bean injector.- Parameters:
dataService
- The pixels servicecompress
- anICompress
.ex
- Reference to the executor.secSys
- Reference to the security system.lutProvider
- Reference to the lookup table provider.
-
-
Method Detail
-
getServiceInterface
public java.lang.Class<? extends ome.api.ServiceInterface> getServiceInterface()
Returns the service corresponding to this class.- Returns:
- See above.
-
getRenderingDefId
public long getRenderingDefId()
- Specified by:
getRenderingDefId
in interfaceomeis.providers.re.RenderingEngine
-
passivate
@Transactional(readOnly=true) public void passivate()
- Specified by:
passivate
in interfaceome.api.StatefulServiceInterface
-
activate
@Transactional(readOnly=true) public void activate()
- Specified by:
activate
in interfaceome.api.StatefulServiceInterface
-
close
public void close()
- Specified by:
close
in interfaceome.api.StatefulServiceInterface
-
lookupPixels
public void lookupPixels(long pixelsId)
Implemented as specified by theRenderingEngine
interface.- Specified by:
lookupPixels
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.lookupPixels(long)
-
lookupRenderingDef
public boolean lookupRenderingDef(long pixelsId)
Implemented as specified by theRenderingEngine
interface.- Specified by:
lookupRenderingDef
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.lookupRenderingDef(long)
-
loadRenderingDef
public void loadRenderingDef(long renderingDefId)
Implemented as specified by theRenderingEngine
interface.- Specified by:
loadRenderingDef
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.loadRenderingDef(long)
-
load
public void load()
Implemented as specified by theRenderingEngine
interface.- Specified by:
load
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.load()
-
setOverlays
public void setOverlays(java.util.Map<byte[],java.lang.Integer> overlays)
Deprecated.As of release 5.1.0, replaced byPlaneDef.setShapeIds(List)
.Implemented as specified by theRenderingEngine
interface.- Specified by:
setOverlays
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.setOverlays(Map)
-
getCurrentEventContext
public ome.system.EventContext getCurrentEventContext()
Implemented as specified by theRenderingEngine
interface.- Specified by:
getCurrentEventContext
in interfaceome.api.StatefulServiceInterface
- See Also:
StatefulServiceInterface.getCurrentEventContext()
-
render
public omeis.providers.re.RGBBuffer render(omeis.providers.re.data.PlaneDef pd)
Implemented as specified by theRenderingEngine
interface.- Specified by:
render
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.render(PlaneDef)
-
renderAsPackedInt
public int[] renderAsPackedInt(omeis.providers.re.data.PlaneDef pd)
Implemented as specified by theRenderingEngine
interface.- Specified by:
renderAsPackedInt
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.render(PlaneDef)
-
renderCompressed
public byte[] renderCompressed(omeis.providers.re.data.PlaneDef pd)
Implemented as specified by theRenderingEngine
interface.- Specified by:
renderCompressed
in interfaceomeis.providers.re.RenderingEngine
- See Also:
LocalCompress.compressToStream(BufferedImage, java.io.OutputStream)
-
renderProjectedAsPackedInt
public int[] renderProjectedAsPackedInt(int algorithm, int timepoint, int stepping, int start, int end)
Implemented as specified by theRenderingEngine
interface.- Specified by:
renderProjectedAsPackedInt
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.renderAsPackedInt(PlaneDef)
-
renderProjectedCompressed
public byte[] renderProjectedCompressed(int algorithm, int timepoint, int stepping, int start, int end)
Implemented as specified by theRenderingEngine
interface.- Specified by:
renderProjectedCompressed
in interfaceomeis.providers.re.RenderingEngine
- See Also:
LocalCompress.compressToStream(BufferedImage, java.io.OutputStream)
-
resetDefaultSettings
public long resetDefaultSettings(boolean save)
Implemented as specified by theRenderingEngine
interface.- Specified by:
resetDefaultSettings
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.resetDefaultSettings(boolean)
-
setCompressionLevel
public void setCompressionLevel(float percentage)
Implemented as specified by theRenderingEngine
interface.- Specified by:
setCompressionLevel
in interfaceomeis.providers.re.RenderingEngine
- See Also:
LocalCompress.setCompressionLevel(float)
-
getCompressionLevel
public float getCompressionLevel()
Implemented as specified by theRenderingEngine
interface.- Specified by:
getCompressionLevel
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getCompressionLevel()
-
saveAsNewSettings
@Transactional(readOnly=false) public long saveAsNewSettings()
Implemented as specified by theRenderingEngine
interface.- Specified by:
saveAsNewSettings
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.saveAsNewSettings()
-
updateSettings
public void updateSettings(ome.model.display.RenderingDef settings)
Implemented as specified by theRenderingEngine
interface.- Specified by:
updateSettings
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.updateSettings(RenderingDef)
-
saveCurrentSettings
@Transactional(readOnly=false) public void saveCurrentSettings()
Implemented as specified by theRenderingEngine
interface.- Specified by:
saveCurrentSettings
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.saveCurrentSettings()
-
getChannelCurveCoefficient
public double getChannelCurveCoefficient(int w)
Implemented as specified by theRenderingEngine
interface.- Specified by:
getChannelCurveCoefficient
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getChannelCurveCoefficient(int)
-
getChannelFamily
public ome.model.enums.Family getChannelFamily(int w)
Implemented as specified by theRenderingEngine
interface.- Specified by:
getChannelFamily
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getChannelFamily(int)
-
getChannelNoiseReduction
public boolean getChannelNoiseReduction(int w)
Implemented as specified by theRenderingEngine
interface.- Specified by:
getChannelNoiseReduction
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getChannelNoiseReduction(int)
-
getChannelStats
public double[] getChannelStats(int w)
Implemented as specified by theRenderingEngine
interface.- Specified by:
getChannelStats
in interfaceomeis.providers.re.RenderingEngine
-
getChannelWindowEnd
public double getChannelWindowEnd(int w)
Implemented as specified by theRenderingEngine
interface.- Specified by:
getChannelWindowEnd
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getChannelWindowEnd(int)
-
getChannelWindowStart
public double getChannelWindowStart(int w)
Implemented as specified by theRenderingEngine
interface.- Specified by:
getChannelWindowStart
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getChannelWindowStart(int)
-
getRGBA
public int[] getRGBA(int w)
Implemented as specified by theRenderingEngine
interface.- Specified by:
getRGBA
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getRGBA(int)
-
isActive
public boolean isActive(int w)
Implemented as specified by theRenderingEngine
interface.- Specified by:
isActive
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.isActive(int)
-
getChannelLookupTable
public java.lang.String getChannelLookupTable(int w)
- Specified by:
getChannelLookupTable
in interfaceomeis.providers.re.RenderingEngine
-
setChannelLookupTable
public void setChannelLookupTable(int w, java.lang.String lookup)
- Specified by:
setChannelLookupTable
in interfaceomeis.providers.re.RenderingEngine
-
getDefaultT
public int getDefaultT()
Implemented as specified by theRenderingEngine
interface.- Specified by:
getDefaultT
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getDefaultT()
-
getDefaultZ
public int getDefaultZ()
Implemented as specified by theRenderingEngine
interface.- Specified by:
getDefaultZ
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getDefaultZ()
-
getModel
public ome.model.enums.RenderingModel getModel()
Implemented as specified by theRenderingEngine
interface.- Specified by:
getModel
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getModel()
-
getQuantumDef
public ome.model.display.QuantumDef getQuantumDef()
Implemented as specified by theRenderingEngine
interface.- Specified by:
getQuantumDef
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getQuantumDef()
-
getPixels
public ome.model.core.Pixels getPixels()
Implemented as specified by theRenderingEngine
interface.- Specified by:
getPixels
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getPixels()
-
getAvailableModels
public java.util.List getAvailableModels()
Implemented as specified by theRenderingEngine
interface.- Specified by:
getAvailableModels
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getAvailableModels()
-
getAvailableFamilies
public java.util.List getAvailableFamilies()
Implemented as specified by theRenderingEngine
interface.- Specified by:
getAvailableFamilies
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getAvailableFamilies()
-
addCodomainMap
@Deprecated public void addCodomainMap(omeis.providers.re.codomain.CodomainMapContext mapCtx)
Deprecated.Implemented as specified by theRenderingEngine
interface.- Specified by:
addCodomainMap
in interfaceomeis.providers.re.RenderingEngine
-
addCodomainMapToChannel
public void addCodomainMapToChannel(omeis.providers.re.codomain.CodomainMapContext mapCtx, int w)
Implemented as specified by theRenderingEngine
interface.- Specified by:
addCodomainMapToChannel
in interfaceomeis.providers.re.RenderingEngine
-
removeCodomainMap
@Deprecated public void removeCodomainMap(omeis.providers.re.codomain.CodomainMapContext mapCtx)
Deprecated.Implemented as specified by theRenderingEngine
interface.- Specified by:
removeCodomainMap
in interfaceomeis.providers.re.RenderingEngine
-
removeCodomainMapFromChannel
public void removeCodomainMapFromChannel(omeis.providers.re.codomain.CodomainMapContext mapCtx, int w)
Implemented as specified by theRenderingEngine
interface.- Specified by:
removeCodomainMapFromChannel
in interfaceomeis.providers.re.RenderingEngine
-
updateCodomainMap
@Deprecated public void updateCodomainMap(omeis.providers.re.codomain.CodomainMapContext mapCtx)
Deprecated.Implemented as specified by theRenderingEngine
interface.- Specified by:
updateCodomainMap
in interfaceomeis.providers.re.RenderingEngine
-
setActive
public void setActive(int w, boolean active)
Implemented as specified by theRenderingEngine
interface.- Specified by:
setActive
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.setActive(int, boolean)
-
setChannelWindow
public void setChannelWindow(int w, double start, double end)
Implemented as specified by theRenderingEngine
interface.- Specified by:
setChannelWindow
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.setChannelWindow(int, double, double)
-
setCodomainInterval
public void setCodomainInterval(int start, int end)
Implemented as specified by theRenderingEngine
interface.- Specified by:
setCodomainInterval
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.setCodomainInterval(int, int)
-
setDefaultT
public void setDefaultT(int t)
Implemented as specified by theRenderingEngine
interface.- Specified by:
setDefaultT
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.setDefaultT(int)
-
setDefaultZ
public void setDefaultZ(int z)
Implemented as specified by theRenderingEngine
interface.- Specified by:
setDefaultZ
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.setDefaultZ(int)
-
setModel
public void setModel(ome.model.enums.RenderingModel model)
Implemented as specified by theRenderingEngine
interface.- Specified by:
setModel
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.setModel(RenderingModel)
-
setQuantizationMap
public void setQuantizationMap(int w, ome.model.enums.Family family, double coefficient, boolean noiseReduction)
Implemented as specified by theRenderingEngine
interface.- Specified by:
setQuantizationMap
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.setQuantizationMap(int, Family, double, boolean)
-
setQuantumStrategy
public void setQuantumStrategy(int bitResolution)
Implemented as specified by theRenderingEngine
interface.- Specified by:
setQuantumStrategy
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.setQuantumStrategy(int)
-
setRGBA
public void setRGBA(int w, int red, int green, int blue, int alpha)
Implemented as specified by theRenderingEngine
interface.- Specified by:
setRGBA
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.setRGBA(int, int, int, int, int)
-
isPixelsTypeSigned
public boolean isPixelsTypeSigned()
Implemented as specified by theRenderingEngine
interface.- Specified by:
isPixelsTypeSigned
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.isPixelsTypeSigned()
-
getPixelsTypeLowerBound
public double getPixelsTypeLowerBound(int w)
Implemented as specified by theRenderingEngine
interface.- Specified by:
getPixelsTypeLowerBound
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getPixelsTypeLowerBound(int)
-
getResolutionLevel
public int getResolutionLevel()
- Specified by:
getResolutionLevel
in interfaceomeis.providers.re.RenderingEngine
-
getResolutionLevels
public int getResolutionLevels()
- Specified by:
getResolutionLevels
in interfaceomeis.providers.re.RenderingEngine
-
getResolutionDescriptions
public java.util.List<java.util.List<java.lang.Integer>> getResolutionDescriptions()
- Specified by:
getResolutionDescriptions
in interfaceomeis.providers.re.RenderingEngine
-
getTileSize
public int[] getTileSize()
- Specified by:
getTileSize
in interfaceomeis.providers.re.RenderingEngine
-
requiresPixelsPyramid
public boolean requiresPixelsPyramid()
- Specified by:
requiresPixelsPyramid
in interfaceomeis.providers.re.RenderingEngine
-
setResolutionLevel
public void setResolutionLevel(int resolutionLevel)
- Specified by:
setResolutionLevel
in interfaceomeis.providers.re.RenderingEngine
-
getPixelsTypeUpperBound
public double getPixelsTypeUpperBound(int w)
Implemented as specified by theRenderingEngine
interface.- Specified by:
getPixelsTypeUpperBound
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getPixelsTypeUpperBound(int)
-
getCodomainMapContext
public java.util.List<omeis.providers.re.codomain.CodomainMapContext> getCodomainMapContext(int w)
Implemented as specified by theRenderingEngine
interface.- Specified by:
getCodomainMapContext
in interfaceomeis.providers.re.RenderingEngine
- See Also:
RenderingEngine.getCodomainMapContext(int)
-
errorIfInvalidState
protected void errorIfInvalidState()
-
errorIfNullPixels
protected void errorIfNullPixels()
Throws anApiUsageException
if the pixels are not set.
-
errorIfNullRenderingDef
protected void errorIfNullRenderingDef()
Throws anApiUsageException
if the rendering settings are not set.
-
errorIfNullRenderer
protected void errorIfNullRenderer()
Reloads the rendering engine ifnull
and has been made passive or throws anApiUsageException
if the rendering engine is not set.
-
-